Appion

h2. Why CentOS?

If you have a new computer(s) for your Leginon/Appion installation, we recommend installing CentOS because it is considered to be more stable than other varieties of Linux.

CentOS is the same as Red Hat Enterprise Linux (RHEL), except that it is free and supported by the community.

We have most experience in the installation on CentOS and this installation guide has specific instruction for the process.

see [[Select_Linux_distribution_to_use|Linux distribution recommendation]] for more.

h2. Download the ISO disk of CentOS 

*Latest version tested at NRAMM:* CentOS 5.8 for Leginon/Appion 2.2, CentOS 6.3 for Leginon/Appion 2.2-redux and trunk

*Note:* All formally released versions of Appion (versions 1.x and 2.x) run on CentOS 5.x. Also available is 2.2-redux, which has the same features as 2.2, but runs on CentOS 6.x. Appion developers, please note that the development branch of Appion is targeting CentOS 6.x and Appion 3.0 will run on CentOS 6.x.  

 # ISO files are available at

 ## http://wiki.centos.org/Download

 ## http://mirrors.kernel.org/centos/

 # Click on i386 for 32bit machines or x86_64 for 64bit machines

 # Pick a mirror and download the appropriate file such as 'CentOS-5.8-i386-bin-DVD-1of2.iso ' 

h2. Confirm download went correctly

Perform a SHA1SUM confirmation:

<pre>

sha1sum CentOS-5.8-i386-bin-DVD-1of2.iso

</pre>

The result should be the same as in the sha1sum file provided by CentOS. This is found at the same location you downloaded the .iso file.

For example:

* http://centos.mirrors.tds.net/pub/linux/centos/5.4/isos/x86_64/sha1sum.txt for 64bit

* http://centos.mirrors.tds.net/pub/linux/centos/5.4/isos/i386/sha1sum.txt for 32bit

h2. Burn ISO file to DVD disk 

Use dvdrecord in Linux to burn disk.

<pre>

dvdrecord -v -dao gracetime=10 dev=/dev/dvd speed=16 CentOS-5.8-i386-bin-DVD-1of2.iso 

</pre>

h2. Install CentOS with default packages 

 * Setup network, root, password as desired

 * This installation guide assumes that *"Desktop - GNOME"* is selected

 * More information available at [http://wiki.centos.org/Documentation CentOS Documentation]

h2. Add yourself to the sudoers file 

*Note:* This step is optional, however you will need root access to complete the Appion Installation.

Make sure you have root permission.

Open the file in an editor. ex. vi /etc/sudoers

Look for the line: root ALL=(ALL) ALL.

Add this line below the root version:

<pre>

your_username ALL=(ALL)       ALL

</pre>

Logout and log back in with your username.

The CentOS installation is complete.