Appion

h1. Start with existing CentOS 5.3 64-bit installation

{{>toc}}

h2. 3 Download additional software 

h3. 3.1 Install the additional package repositories 

*NOTE*

There are several additional CentOS repositories that you can install.

These repositories provide additional packages, such as patented software (MP3 players),

closed source applications (Flash plugin, Adobe Acrobat Reader)

and lesser used packages (python numpy, Gnu Scientific Library).

But some repositories install packages over other packages,

which can cause problems and conflicts (ATrpms is bad at this). So I recommend only installing

EPEL and RPM Fusion. Read more here:

"CentOS Additional Repositories":http://wiki.centos.org/AdditionalResources/Repositories 

h4. 3.1.1 Extra Packages for Enterprise Linux (EPEL) 

* http://fedoraproject.org/wiki/EPEL

* contains a wealth of packages required for appion

.Download repository rpm and install

<pre>

$ sudo rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/`uname -i`/epel-release-5-3.noarch.rpm

</pre>

h4. 3.1.2 RPM Fusion 

* http://rpmfusion.org/

* good for mp3 and other patent limited software

.Download repository rpms and install

<pre>

$ sudo rpm -Uhv http://download1.rpmfusion.org/free/el/updates/testing/5/`uname -i`/rpmfusion-free-release-5-0.1.noarch.rpm

$ sudo rpm -Uvh http://download1.rpmfusion.org/nonfree/el/updates/testing/5/`uname -i`/rpmfusion-nonfree-release-5-0.1.noarch.rpm

</pre>

h3. 3.2 Update current packages 

.Update the updater to make life easier

<pre>

$ sudo yum -y update yum

</pre>

.Update all packages

<pre>

$ sudo yum -y update

</pre>

*NOTE*

Download was over 129 MB (in July 2009). If you have a slow internet connection you can setup presto/deltarpms, "see this email]":http://www.linux-archive.org/centos-development/222706-presto-deltarpm.html 

You may want to restart your computer when this completes.

h4. .Install Complete list of additional packages:

* *python tools*: python-tools python-devel

* *general applications*: subversion ImageMagick grace gnuplot python-matplotlib

* *Tilt Picker*: wxPython numpy scipy python-imaging

* *FindEM*: gcc-gfortran compat-gcc-34-g77

* *Ace 2*: gcc-objc fftw3-devel gsl-devel

* *Sinedon*: mysql mysql-server MySQL-python

* *DBEM*: httpd php php-mysql phpMyAdmin

* *Xmipp MPI*: gcc-c++ openmpi-devel libtiff-devel

* *MRC tools*: php-devel gd-devel re2c fftw2-devel php-gd

* *UCSF Chimera imaging*: xorg-x11-server-Xvfb

<pre>

$ sudo yum -y install \

python-tools python-devel python-matplotlib \

subversion ImageMagick grace gnuplot \

wxPython numpy scipy python-imaging \

gcc-gfortran compat-gcc-34-g77 \

gcc-objc fftw3-devel gsl-devel \

mysql mysql-server MySQL-python \

httpd php php-mysql phpMyAdmin  \

gcc-c++ openmpi-devel libtiff-devel \

php-devel gd-devel re2c fftw2-devel php-gd \

xorg-x11-server-Xvfb

</pre>

If you have an nVidia video card and setup RPM fusion, install the nVidia binary, will speed things up especially for UCSF Chimera

<pre>

$ sudo yum -y install nvidia-x11-drv

</pre>

.Clean up packages to save drive space

<pre>

$ sudo yum clean all

</pre>

.Re-index the hard drive, this will come in handy later

<pre>

$ sudo updatedb

</pre>

.Enable servers on reboot

<pre>

$ sudo /sbin/chkconfig httpd on

</pre>

<pre>

$ sudo /sbin/chkconfig mysqld on

</pre>

You can further configure this with the GUI and turn off unnecessary items

<pre>

$ system-config-services

</pre>

.Reboot the computer

<pre>

$ sudo reboot

</pre>

----

h2. 4 MRC PHP Extension Installation and Testing

[[MRC PHP Extension Installation and Testing]]

----

h2. 5 Setup MySQL (appiondata) databases 

[[Setup MySQL database]]

----

h2. 6 Compile and setup Appion python programs 

[[Setup Appion programs]]

h2. 7 Install webpages (myamiweb)

Refer to [[Start_with_existing_ANY_Linux_flavor_OS#3-Web-server-side-installation|Web server side installation]]

h3. Install MRC Tools 

h4. Compile MRC tools 

* Go to your php devel directory and untar the archive

* If unsure where it is, use info.php to find it under *extension_dir*

<pre>

$ cd /usr/include/php/ext/

$ sudo mkdir mrc

$ sudo chmod 777 mrc

$ sudo chown $USER mrc

</pre>

* Unpackage MRC Tools from http://emg.nysbc.org/software/mrctools/

<pre>

$ tar zxvf ~/php_mrc.tgz

$ cd mrc/

</pre>

* Compile and install the MRC module

<pre>

$ phpize

$ ./configure 

$ make

$ sudo make install

</pre>

h4. Configure PHP for MRC Tools 

* Edit your php configuration file php.ini to add "mrc.so" extension.

<pre>

$ sudo nano /etc/php.d/mrc.ini

</pre>

* add mrc.so to extensions

<pre>

; Enable mrc extension module

extension=mrc.so

</pre>

* To test MRC tools, go to this website:

http://emg.nysbc.org/software/mrctools/mrc_so.php

h3. Configure PHP 

* increase the memory limit, EM images are big 64MB:

<pre>

memory_limit = 256M; Maximum amount of memory

</pre>

* Turn error display on:

<pre>

display_errors = On

</pre>

<pre>

error_reporting = E_ALL & ~E_NOTICE

</pre>

* restart the webserver

<pre>

$ sudo /sbin/service httpd restart

</pre>

h3. Install DBEM and project php source 

Please consult the other [[Start_with_existing_ANY_Linux_flavor_OS#3-Web-server-side-installation|Install guide]]

h3. Configuration 

h4. configure apache 

* allow REMOTE_HOST lookups in apache

<pre>

$ sudo nano /etc/httpd/conf/httpd.conf

</pre>

* turn _HostnameLookups_ to On

<pre>

HostnameLookups On

</pre>

* restart the webserver

<pre>

$ sudo /sbin/service httpd restart

</pre>

h4. configure project_1_2, dbem_1_5_1, and dbem_1_5_1/processing 

Please consult the other [[Start_with_existing_ANY_Linux_flavor_OS#3-Web-server-side-installation|Install guide]]

h3. Initialize database tables from the web tools 

Please consult [[Start_with_existing_ANY_Linux_flavor_OS#4-Create-a-test-project-and-processing-database|Create a test project and processing database]]

h3. Potential problems 

h4. Firewall settings 

You may need to configure your firewall to allow incoming HTTP (port 80) and MySQL (port 3306) traffic:

<pre>

$ system-config-securitylevel

</pre>

h4. Security-enhanced linux 

"Security-enhanced linux (SELinux)":http://en.wikipedia.org/wiki/Security-Enhanced_Linux  may be preventing your files from loading. To fix this run the following command:

<pre>

$ sudo /usr/bin/chcon -R -t httpd_sys_content_t /var/www/html/

</pre>

see "this website":http://docs.fedoraproject.org/selinux-apache-fc3/sn-simple-setup.html  for more details on SELinux

----

h2. 8 Install external packages 

*Please follow individual package installation instruction provided with them*

h3. Compile Xmipp for OpenMPI 

[[Install Xmipp]]

h2. 9 Install a PBS job submission system

[[Install PBS]]