Project

General

Profile

Install the MRC PHP Extension » History » Revision 41

Revision 40 (Neil Voss, 05/12/2010 03:33 PM) → Revision 41/80 (Neil Voss, 05/12/2010 03:34 PM)

h1. Install the MRC PHP Extension 

 MRC Tools is installed as a php extension and is required for displaying mrc files live on the web browser. 

 h2. Make sure you have installed the prerequisite packages 

 You may find installation information for the following packages under [[Install Web Server Prerequisites]]. 

 h3. php-devel 

 You can check whether php-devel is installed by typing: 
 <pre>phpize</pre> 
 Do not worry about any error message and long as the command is found. 

 h3. php-GD/FFTW3-devel 

 Make sure that php-GD and FFTW 3 devel libraries are installed. 

 *TODO:* provide a screenshot of info.php when correctly installed. 

 *Note:* 
 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. 

 h2. MRC Tools Installation 

 mrctools is installed from the php devel directory. This is usually located in /usr/include/php/ext where you will find other php extension source such as gd. After the installation, mrc.so should be placed in php's extension directory. The location of the extension directory can be found by looking for "extension_dir" in http://your_host/info.php. 

 h3. Go to myami/php_mrc directory 

 h3. Compile and install the MRC module 

 <pre> 
 phpize 
 ./configure  
 make 
 sudo make install 
 </pre> 

 h3. Check that the mrc.so module exists in your php module directory (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*. 

 <pre> 
 ls /usr/lib64/php/modules 
   mrc.so 
 </pre> 



 h3. Edit your php configuration file, @php.ini@. 

 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 (in part 2). 

 * Confirm the location of "additional .ini files parsed" from the info.php web page (/etc/php.d in this example) 
 and create a file called    "mrc.ini" in this directory. 
 <pre> 
 cd /etc/php.d 
 sudo touch /etc/php.d/mrc.ini 
 sudo chmod 666 mrc.ini 
 echo "; Enable mrc extension module" > mrc.ini 
 echo "extension=mrc.so" >> mrc.ini 
 sudo chmod 444 mrc.ini 
 cat mrc.ini 
 </pre> 

 *OR* 

 * Add the "mrc.so" extension to the end of the *extension section* 
 <pre> 
 extension=mrc.so 
 </pre> 

 h3. Restart your webserver 

 <pre> 
 /etc/init.d/apache2 restart #SuSe 
 sudo /sbin/service httpd restart #CentOS 
 </pre> 

 h3. Verify the mrc tools installation 

 h4. Check php information 

 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): 

 !http://emg.nysbc.org/software/leginon/images/images/phpmrc.png! 

 If mrc is not listed, the extension did not get added in the right order. 

 h4. Alternative approach if mrc module does not show up in info.php output 

 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/*). 

 2. Go to the directory and make a copy of any ini file to use as a template for mrc.ini 

 <pre> 
       >cd [additional_ini_directory] 
       >cp gd.ini mrc.ini 
 </pre> 

 3. Edit mrc.ini to the following 

 <pre> 
       ; comment out next line to disable mrc extension in php 
       extension=mrc.so 
 </pre> 

 4. Comment out mrc extension from php.ini (found in /etc/php.ini/ on a typical PHP installation) 

 <pre> 
       ;extension=mrc.so 
 </pre> 

 5. Restart your webserver 

 <pre> 
       > /etc/init.d/httpd restart 
 </pre> 

 h4. Test the MRC module installation 

 Download this MRC file "mymrc.mrc":http://emg.nysbc.org/attachments/55/mymrc.mrc and the following 2 scripts into the same directory to test the PHP mrc extension.  
 * gd module testing script "ex1.php":http://emg.nysbc.org/attachments/53/ex1.php 
 * fftw module testing script "ex2.php":http://emg.nysbc.org/attachments/54/ex2.php 

 <pre> 
 cd $HOME 
 mkdir testmrc 
 cd testmrc 
 wget http://emg.nysbc.org/attachments/download/55/mymrc.mrc 
 wget http://emg.nysbc.org/attachments/download/53/ex1.php 
 wget http://emg.nysbc.org/attachments/download/54/ex2.php 
 </pre> 

 Run the scripts with the following commands: 
 The expected results are shown below. If you get the same images, you've installed the extension properly. 

 <pre> 
 > php -q ex1.php | display 
 </pre> 

 * gd module test result: 
 !http://emg.nysbc.org/attachments/57/ex1.php.png! 

 <pre> 
 > php -q ex2.php | display 
 </pre> 

 * fftw module test result: 
 !http://emg.nysbc.org/attachments/58/ex2.php.png! 

 Test files work but images not showing up in the ImageViewers? 
 [[Troubleshooting Notes|Here's one way this was fixed.]] 

 ______ 

 [[Check php information|< Check php information]] | [[Install the Web Interface|Install the Web Interface >>]] 


 ______