Project

General

Profile

Install the MRC PHP Extension » History » Version 76

Amber Herold, 09/04/2012 12:45 PM

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