Install the MRC PHP Extension » History » Version 65
Amber Herold, 04/28/2011 09:37 AM
1 | 21 | Amber Herold | h1. Install the MRC PHP Extension |
---|---|---|---|
2 | 1 | Amber Herold | |
3 | 9 | Amber Herold | MRC Tools is installed as a php extension and is required for displaying mrc files live on the web browser. |
4 | 1 | Amber Herold | |
5 | 6 | Amber Herold | h2. Make sure you have installed the prerequisite packages |
6 | 1 | Amber Herold | |
7 | 24 | Amber Herold | You may find installation information for the following packages under [[Install Web Server Prerequisites]]. |
8 | 6 | Amber Herold | |
9 | h3. php-devel |
||
10 | |||
11 | 27 | Neil Voss | You can check whether php-devel is installed by typing: |
12 | <pre>phpize</pre> |
||
13 | 46 | Amber Herold | Do not worry about any error message as long as the command is found. |
14 | |||
15 | 4 | Amber Herold | |
16 | 6 | Amber Herold | h3. php-GD/FFTW3-devel |
17 | 4 | Amber Herold | |
18 | 6 | Amber Herold | Make sure that php-GD and FFTW 3 devel libraries are installed. |
19 | 4 | Amber Herold | |
20 | 8 | Amber Herold | *TODO:* provide a screenshot of info.php when correctly installed. |
21 | 4 | Amber Herold | |
22 | 11 | Amber Herold | *Note:* |
23 | 10 | Amber Herold | MRCtools are compiled and added to php extension with php-devel package. MRCtools use GD and FFTW3 that need to be compiled from their development libraries while the extension is compiled. If GD and FFTW3 sources were downloaded and compiled directly on your computer, these development files are included. If (as in most cases) GD and FFTW3 are installed from rpm, they are not included. An error message will appear when you attempt to compile mrctools. In this case, you will need separate download and installation of GD-devel and FFTW3-devel. Search http://rpmfind.net/linux/rpm2html/ for GD-devel and FFTW3-devel for the rpm distribution needed for your system. More information on the gd library can be found "here":http://www.php.net/manual/en/image.requirements.php. If you find that you can only view images as png instead of jpg, it may be that you do not have gd _jpeg_ support installed. |
24 | 1 | Amber Herold | |
25 | 10 | Amber Herold | h2. MRC Tools Installation |
26 | 4 | Amber Herold | |
27 | 64 | Amber Herold | # Go to the myami/programs/php_mrc directory |
28 | |
||
29 | # Compile and install the MRC module |
||
30 | 1 | Amber Herold | <pre> |
31 | 27 | Neil Voss | phpize |
32 | 1 | Amber Herold | ./configure |
33 | make |
||
34 | 27 | Neil Voss | sudo make install |
35 | 4 | Amber Herold | </pre> |
36 | 64 | Amber Herold | |
37 | # Check that the mrc.so module exists in your php module directory |
||
38 | |
||
39 | 48 | Amber Herold | (e.g., @/usr/lib64/php/modules@ on 64bit CentOS/RHEL/Fedora). If you are unsure where the php module directory is, use http://localhost/info.php to find it under *extension_dir*. |
40 | 64 | Amber Herold | |
41 | 1 | Amber Herold | <pre> |
42 | ls /usr/lib64/php/modules |
||
43 | mrc.so |
||
44 | 54 | Eric Hou | </pre> |
45 | For Suse |
||
46 | <pre> |
||
47 | ls /usr/lib64/php5/extensions |
||
48 | mrc.so |
||
49 | 1 | Amber Herold | </pre> |
50 | 64 | Amber Herold | # Edit your php configuration file, @php.ini@. |
51 | |
||
52 | 1 | Amber Herold | If your linux distro does not have a /etc/php.d/ or /etc/php.d/conf.d/ directory where other .ini files reside, you may need to follow the alternate instructions below titled: _Alternative approach if mrc module does not show up in info.php output_. |
53 | 64 | Amber Herold | |
54 | 1 | Amber Herold | * Confirm the location of "additional .ini files parsed" from the info.php web page (/etc/php.d in this example) |
55 | and create a file called "mrc.ini" in this directory. This may be done with the following series of commands: |
||
56 | <pre> |
||
57 | 31 | Neil Voss | cd /etc/php.d |
58 | 1 | Amber Herold | sudo touch /etc/php.d/mrc.ini |
59 | 31 | Neil Voss | sudo chmod 666 mrc.ini |
60 | 33 | Neil Voss | echo "; Enable mrc extension module" > mrc.ini |
61 | 1 | Amber Herold | echo "extension=mrc.so" >> mrc.ini |
62 | sudo chmod 444 mrc.ini |
||
63 | cat mrc.ini |
||
64 | </pre> |
||
65 | 64 | Amber Herold | |
66 | 31 | Neil Voss | *OR* |
67 | 64 | Amber Herold | |
68 | 32 | Neil Voss | * Add the "mrc.so" extension to the end of the *extension section* |
69 | <pre> |
||
70 | extension=mrc.so |
||
71 | 4 | Amber Herold | </pre> |
72 | 64 | Amber Herold | |
73 | # Restart your webserver |
||
74 | |
||
75 | 1 | Amber Herold | Example commands: |
76 | 50 | Amber Herold | <pre> |
77 | #SuSe |
||
78 | /etc/init.d/apache2 restart |
||
79 | 64 | Amber Herold | |
80 | 50 | Amber Herold | #CentOS |
81 | 4 | Amber Herold | sudo /sbin/service httpd restart |
82 | </pre> |
||
83 | 64 | Amber Herold | |
84 | 59 | Neil Voss | bq. *Note:* Sometimes, the MRC module will not work even after restarting the webserver. Try restarting the whole computer @sudo reboot@. |
85 | 64 | Amber Herold | |
86 | # Verify the mrc tools installation |
||
87 | |
||
88 | 4 | Amber Herold | Visit or refresh http://yourhost/info.php which you created earlier. It should have a section looking like this (The version should correspond to what you've just installed): |
89 | 64 | Amber Herold | |
90 | 4 | Amber Herold | !http://emg.nysbc.org/software/leginon/images/images/phpmrc.png! |
91 | 64 | Amber Herold | |
92 | 4 | Amber Herold | If mrc is not listed, the extension did not get added in the right order. |
93 | 1 | Amber Herold | |
94 | 51 | Amber Herold | h3. Alternative approach if mrc module does not show up in info.php output |
95 | 4 | Amber Herold | |
96 | 1. find in the info.php web page the location of "additional .ini files parsed" in the first table (such as /etc/php.d/conf.d/*). |
||
97 | |||
98 | 2. Go to the directory and make a copy of any ini file to use as a template for mrc.ini |
||
99 | 1 | Amber Herold | |
100 | 4 | Amber Herold | <pre> |
101 | >cd [additional_ini_directory] |
||
102 | 1 | Amber Herold | >cp gd.ini mrc.ini |
103 | </pre> |
||
104 | 4 | Amber Herold | |
105 | 1 | Amber Herold | 3. Edit mrc.ini to the following |
106 | |||
107 | 4 | Amber Herold | <pre> |
108 | ; comment out next line to disable mrc extension in php |
||
109 | 1 | Amber Herold | extension=mrc.so |
110 | </pre> |
||
111 | 4 | Amber Herold | |
112 | 1 | Amber Herold | 4. Comment out mrc extension from php.ini (found in /etc/php.ini/ on a typical PHP installation) |
113 | |||
114 | 4 | Amber Herold | <pre> |
115 | 1 | Amber Herold | ;extension=mrc.so |
116 | </pre> |
||
117 | 4 | Amber Herold | |
118 | 16 | Amber Herold | 5. Restart your webserver |
119 | 1 | Amber Herold | |
120 | 4 | Amber Herold | <pre> |
121 | 1 | Amber Herold | > /etc/init.d/httpd restart |
122 | </pre> |
||
123 | 4 | Amber Herold | |
124 | 1 | Amber Herold | h4. Test the MRC module installation |
125 | |||
126 | 62 | Anchi Cheng | In the myami/php_mrc (or myami/programs/php_mrc if installing from trunk) directory, you will find two test scripts, "ex1.php" and "ex2.php" and a test MRC image "mymrc.mrc". |
127 | 1 | Amber Herold | |
128 | 55 | Jim Pulokas | Copy them to your top level web directory (for example on CentOS: /var/www/html/): |
129 | 43 | Neil Voss | <pre> |
130 | 55 | Jim Pulokas | cp ex1.php ex2.php mymrc.mrc /var/www/html/ |
131 | 39 | Neil Voss | </pre> |
132 | 37 | Neil Voss | |
133 | 44 | Neil Voss | Run the scripts with the following commands and visit the corresponding pages from the web server: |
134 | 56 | Jim Pulokas | The expected results are shown below. If you get the same images, you've installed the extension properly. |
135 | Note: the "display" command is part of the ImageMagick package, which you may have to install. |
||
136 | 1 | Amber Herold | |
137 | 44 | Neil Voss | web server: http://localhost/ex1.php |
138 | |||
139 | 1 | Amber Herold | <pre> |
140 | 41 | Neil Voss | php -q ex1.php | display |
141 | 1 | Amber Herold | </pre> |
142 | |||
143 | * gd module test result: |
||
144 | !http://emg.nysbc.org/attachments/57/ex1.php.png! |
||
145 | 44 | Neil Voss | |
146 | web server: http://localhost/ex2.php |
||
147 | 1 | Amber Herold | |
148 | <pre> |
||
149 | 41 | Neil Voss | php -q ex2.php | display |
150 | 1 | Amber Herold | </pre> |
151 | 3 | Amber Herold | |
152 | * fftw module test result: |
||
153 | !http://emg.nysbc.org/attachments/58/ex2.php.png! |
||
154 | 1 | Amber Herold | |
155 | Test files work but images not showing up in the ImageViewers? |
||
156 | 60 | Anchi Cheng | [[appion:Troubleshooting Notes|Here's one way this was fixed.]] |
157 | 22 | Amber Herold | |
158 | ______ |
||
159 | |||
160 | 58 | Amber Herold | [[Download Appion and Leginon Files|< Download Appion and Leginon Files]] | [[Install the Web Interface|Install the Web Interface >]] |
161 | 25 | Amber Herold | |
162 | |||
163 | ______ |