Appion

h1. Install Web Server Prerequisites

The myamiweb files are mostly php scripts that run at the web server. PHP, PHP-devel, gd, and fftw3 packages are required before installation of myamiweb and the mrc extension that handles the display of mrc files. Some of these packages may be found on the SuSE Linux DVD or included in common package repository. MySQL and the Apache Web Server can be downloaded from their respective websites.

h3. Install Supporting Packages

* Use the installation tools available for your linux distribution.

For example, to install gd as php extension you may use

<pre>

CentOS> sudo yum install php-gd

SuSE10.2 and above> zypper install php-gd

</pre>

Likewise, use the SuSE Linux YaST2 utility or zypper (openSuSE 10.2 and above) to install.

"An older list of required CENTOS rpms and instruction":http://emg.nysbc.org/boards/10/topics/685 can be found in the Forum.

* Use the following table to find and install the prerequisite packages required for your distribution of linux:

*Prerequisite packages for myamiweb:*

The following table lists the packages required for running the web server on CentOS 5 for Appion/Leginon 2.2 and earlier.

|_.Name:|_.Download site:|_.yum package name|_.SuSE rpm name|

| Apache| "www.apache.org":http://www.apache.org| httpd| apache2|

| php| "www.php.net":http://www.php.net| php| php|

| php-devel*| "rpmfind.net/linux/RPM/Development_Languages_PHP.html":http://rpmfind.net/linux/RPM/Development_Languages_PHP.html| php-devel| php-devel|

| php-mysql*| "rpmfind.net/linux/RPM/Development_Languages_PHP.html":http://rpmfind.net/linux/RPM/Development_Languages_PHP.html| php-mysql| php-mysql|

| php-gd | "www.php.ned/gd":http://www.libgd.org  (Use gd2)| php-gd | php-gd |

| fftw3 library (including development libraries and header *)| "www.fftw.org":http://www.fftw.org  (Use fftw3.x)| fftw3-devel| fftw3-devel|

| libssh2 developmental libraries | http://www.libssh2.org | libssh2-devel | |

| phpMyAdmin (optional)| http://www.phpmyadmin.net | phpMyAdmin| |

| GCC, the GNU Compiler Collection | http://gcc.gnu.org | gcc| |

| Apache SSL module | | mod_ssl | |

<pre>

#CentOS> 

sudo yum install \

  php-gd gcc phpMyAdmin libssh2-devel php-pecl-ssh2 \

  mod_ssl httpd php-mysql php-devel php fftw3-devel

</pre>

To run the web server on CentOS 6, for Appion/Leginon 2.2-redux or later, in addition to the packages listed above, the following packages are also required:

|_.Name:|_.Download site:|_.yum package name|_.SuSE rpm name|

| | | php-pecl-ssh2| |

| | | svn| |

| | | python-imaging| |

| | | python-devel| |

| | | mod_python| |

| | | scipy| |

| | | fs| |

| | | PyFFTW3| |

<pre>

yum install php-gd gcc phpMyAdmin libssh2-devel php-pecl-ssh2 mod_ssl httpd php-mysql php-devel php fftw3-devel svn python-imaging python-devel mod_python scipy

easy_install fs PyFFTW3

</pre>

*Notes:* 

* RPM.pbone.net http://rpm.pbone.net/ provides a nice interface to search for module names on RPM based systems.

* You may need to install Extra Packages for Enterprise Linux (EPEL) to install fftw3. See [[appion:Download_additional_Software|Download Additional Software]] for more information.

* 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. (TODO: This is too scary and cumbersome.)

______

[[Differences between Linux flavors|< Differences between Linux flavors]] | [[Configure php.ini|Configure php.ini >]]

______