Project

General

Profile

Install the MRC PHP Extension » History » Version 63

Amber Herold, 04/28/2011 09:33 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 63 Amber Herold
h3. Go to the myami/programs/php_mrc directory
28 5 Amber Herold
29 28 Neil Voss
h3. Compile and install the MRC module
30
31 1 Amber Herold
<pre>
32 27 Neil Voss
phpize
33
./configure 
34
make
35
sudo make install
36 4 Amber Herold
</pre>
37 17 Amber Herold
38 48 Amber Herold
h3. Check that the mrc.so module exists in your php module directory 
39
40
(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*.
41 29 Neil Voss
42 1 Amber Herold
<pre>
43 30 Neil Voss
ls /usr/lib64/php/modules
44 27 Neil Voss
  mrc.so
45 1 Amber Herold
</pre>
46
47 54 Eric Hou
For Suse
48
49
<pre>
50
ls /usr/lib64/php5/extensions
51
  mrc.so
52
</pre>
53
54 1 Amber Herold
55 4 Amber Herold
56 31 Neil Voss
h3. Edit your php configuration file, @php.ini@.
57 1 Amber Herold
58 49 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_.
59 1 Amber Herold
60 32 Neil Voss
* Confirm the location of "additional .ini files parsed" from the info.php web page (/etc/php.d in this example)
61 57 Amber Herold
and create a file called  "mrc.ini" in this directory. This may be done with the following series of commands:
62 12 Amber Herold
<pre>
63 31 Neil Voss
cd /etc/php.d
64
sudo touch /etc/php.d/mrc.ini
65 33 Neil Voss
sudo chmod 666 mrc.ini
66 34 Neil Voss
echo "; Enable mrc extension module" > mrc.ini
67 1 Amber Herold
echo "extension=mrc.so" >> mrc.ini
68 33 Neil Voss
sudo chmod 444 mrc.ini
69
cat mrc.ini
70 19 Amber Herold
</pre>
71 4 Amber Herold
72 31 Neil Voss
*OR*
73
74 32 Neil Voss
* Add the "mrc.so" extension to the end of the *extension section*
75
<pre>
76
extension=mrc.so
77
</pre>
78 4 Amber Herold
79 36 Neil Voss
h3. Restart your webserver
80 1 Amber Herold
81 50 Amber Herold
Example commands:
82 1 Amber Herold
<pre>
83 50 Amber Herold
#SuSe
84
/etc/init.d/apache2 restart 
85
86
#CentOS
87
sudo /sbin/service httpd restart 
88 4 Amber Herold
</pre>
89
90 59 Neil Voss
bq. *Note:* Sometimes, the MRC module will not work even after restarting the webserver. Try restarting the whole computer @sudo reboot@.
91
92 36 Neil Voss
h3. Verify the mrc tools installation
93 4 Amber Herold
94
95
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):
96
97
!http://emg.nysbc.org/software/leginon/images/images/phpmrc.png!
98
99
If mrc is not listed, the extension did not get added in the right order.
100 1 Amber Herold
101 51 Amber Herold
h3. Alternative approach if mrc module does not show up in info.php output
102 4 Amber Herold
103
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/*).
104
105
2. Go to the directory and make a copy of any ini file to use as a template for mrc.ini
106 1 Amber Herold
107 4 Amber Herold
<pre>
108
      >cd [additional_ini_directory]
109 1 Amber Herold
      >cp gd.ini mrc.ini
110
</pre>
111 4 Amber Herold
112 1 Amber Herold
3. Edit mrc.ini to the following
113
114 4 Amber Herold
<pre>
115
      ; comment out next line to disable mrc extension in php
116 1 Amber Herold
      extension=mrc.so
117
</pre>
118 4 Amber Herold
119 1 Amber Herold
4. Comment out mrc extension from php.ini (found in /etc/php.ini/ on a typical PHP installation)
120
121 4 Amber Herold
<pre>
122 1 Amber Herold
      ;extension=mrc.so
123
</pre>
124 4 Amber Herold
125 16 Amber Herold
5. Restart your webserver
126 1 Amber Herold
127 4 Amber Herold
<pre>
128 1 Amber Herold
      > /etc/init.d/httpd restart
129
</pre>
130 4 Amber Herold
131 1 Amber Herold
h4. Test the MRC module installation
132
133 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". 
134 1 Amber Herold
135 55 Jim Pulokas
Copy them to your top level web directory (for example on CentOS: /var/www/html/):
136 43 Neil Voss
<pre>
137 55 Jim Pulokas
cp ex1.php ex2.php mymrc.mrc /var/www/html/
138 39 Neil Voss
</pre>
139 37 Neil Voss
140 44 Neil Voss
Run the scripts with the following commands and visit the corresponding pages from the web server:
141 56 Jim Pulokas
The expected results are shown below. If you get the same images, you've installed the extension properly.
142
Note:  the "display" command is part of the ImageMagick package, which you may have to install.
143 1 Amber Herold
144 44 Neil Voss
web server: http://localhost/ex1.php
145
146 1 Amber Herold
<pre>
147 41 Neil Voss
php -q ex1.php | display
148 1 Amber Herold
</pre>
149
150
* gd module test result:
151
!http://emg.nysbc.org/attachments/57/ex1.php.png!
152 44 Neil Voss
153
web server: http://localhost/ex2.php
154 1 Amber Herold
155
<pre>
156 41 Neil Voss
php -q ex2.php | display
157 1 Amber Herold
</pre>
158 3 Amber Herold
159
* fftw module test result:
160
!http://emg.nysbc.org/attachments/58/ex2.php.png!
161 1 Amber Herold
162
Test files work but images not showing up in the ImageViewers?
163 60 Anchi Cheng
[[appion:Troubleshooting Notes|Here's one way this was fixed.]]
164 22 Amber Herold
165
______
166
167 58 Amber Herold
[[Download Appion and Leginon Files|< Download Appion and Leginon Files]] | [[Install the Web Interface|Install the Web Interface >]]
168 25 Amber Herold
169
170
______