Install Appion and Leginon using the auto-installation tool share » History » Version 40
Anchi Cheng, 09/10/2013 10:27 AM
1 | 24 | Bridget Carragher | h1. Quick Install of Appion and Leginon using the auto-installation tool |
---|---|---|---|
2 | 1 | Amber Herold | |
3 | 35 | Amber Herold | *NOTICE:* We are in the process of releasing a new version of the installation tool. There are a few bugs right now, so you might want to hold off on using it until this notice is removed. |
4 | 34 | Amber Herold | |
5 | 25 | Bridget Carragher | As of Appion/Leginon 2.1.0, there is an quick installation script available for use. It currently installs both Appion and Leginon on a single computer running the CentOS Linux operating system. This is not really intended for production systems but is instead perhaps a useful way to evaluate the software prior to undertaking a more complex installation across multiple CPU's. Please note that the auto-installation is intended for use with a clean installation of CentOS and might fail if you already have several other packages installed. |
6 | 1 | Amber Herold | |
7 | 24 | Bridget Carragher | Follow the instructions below to install Appion and Leginon using the auto-installation script. |
8 | 1 | Amber Herold | |
9 | # "Install CentOS":http://emg.nysbc.org/projects/appion/wiki/Instructions_for_installing_CentOS_on_your_computer. |
||
10 | 22 | Amber Herold | *Disable SELinux during the installation.* You can check to see if it is enabled after the centOS installation with: |
11 | <pre> |
||
12 | /usr/sbin/selinuxenabled |
||
13 | echo $? |
||
14 | </pre> |
||
15 | 28 | Sargis Dallakyan | If SELinux is enabled, the return value is 0. If it is disabled, the return value is 1. If you need to disable SELinux, follow the instructions for disabling SELinux found in the troubleshooting section of this document. |
16 | 18 | Amber Herold | The Auto-Installer currently assumes that you have a fresh centOS installation and that you have not set up a mysql database. |
17 | 20 | Amber Herold | |
18 | 1 | Amber Herold | # Login to CentOS as the root user |
19 | 20 | Amber Herold | |
20 | 37 | Anchi Cheng | # [[Appion:Regkey_request|Request a registration key]] which will be needed during installation. We ask that you register so that we can inform the owners of processing packages such as EMAN, XMIPP and SPIDER how many people are recieving their software from us. These numbers help them gain funding to maintain the software. |
21 | 30 | Amber Herold | |
22 | 29 | Amber Herold | # Download "centosAutoInstallation.py":http://emg.nysbc.org/projects/appion/repository/changes/branches/myami-2.2/install/centosAutoInstallation.py |
23 | 20 | Amber Herold | |
24 | 11 | Amber Herold | # Open a Terminal, go to the download directory and run: |
25 | 1 | Amber Herold | <pre> |
26 | python centosAutoInstallation.py |
||
27 | </pre> |
||
28 | 32 | Amber Herold | # Enter an administrator's email address, and root password when prompted. |
29 | |
||
30 | # You may choose to install several of the third party software packages that Appion uses for image processing. If you do not allow the installer to install them at this time, you can follow the manual installation instructions found toward the end of this page. |
||
31 | 1 | Amber Herold | |
32 | 24 | Bridget Carragher | # Wait. Depending on how many packages are updated during _yum update_, installation could take anywhere between 6 minutes and 2 hours. |
33 | 1 | Amber Herold | |
34 | 21 | Amber Herold | # When the installation completes: |
35 | 33 | Amber Herold | ## A log file will be created called installation.log. You may want to view it and look for any errors. |
36 | 23 | Amber Herold | ## The Leginon start page may be displayed. If you are not using Leginon, close this window. |
37 | 21 | Amber Herold | ## A web browser will be launched with the Appion and Leginon tools loaded. |
38 | 39 | Anchi Cheng | |
39 | 40 | Anchi Cheng | {{include(testing auto-installation)}} |
40 | 1 | Amber Herold | |
41 | 3 | Amber Herold | h1. Troubleshooting |
42 | 1 | Amber Herold | |
43 | 5 | Amber Herold | h2. SELinux is Enabled |
44 | |||
45 | 18 | Amber Herold | If your installation completes and you see a Welcome to Leginon window, a second Leginon window that appears blank and a web page with the Web Tools Setup wizard in a System updating state as shown below, you have installed CentOs with Security Enhanced Linux enabled. You need to disable SE Linux: |
46 | |||
47 | 19 | Amber Herold | # Edit file "/etc/selinux/config" |
48 | # Change "SELINUX=enforcing" to "SELINUX=disabled" |
||
49 | # Save the file |
||
50 | # Restart your computer |
||
51 | 5 | Amber Herold | |
52 | Once SELinux is disabled, the configuration will complete on its own. |
||
53 | 1 | Amber Herold | |
54 | 16 | Amber Herold | You may need to [[reconfigure the database]] if the Tools web page is not displayed. |
55 | |||
56 | 1 | Amber Herold | !SELinuxInstall.png! |
57 | 2 | Amber Herold | |
58 | 4 | Amber Herold | |
59 | |||
60 | 3 | Amber Herold | h2. A database was previously configured |
61 | 4 | Amber Herold | |
62 | If you see the errors shown in the screen below, you may have previously configured a database with mysql. You will need to re-install CentOS and run the installation script again. |
||
63 | 2 | Amber Herold | |
64 | |||
65 | |||
66 | !Screenshot.png! |