Install the Web Interface » History » Version 45
Anchi Cheng, 01/10/2011 11:03 AM
| 1 | 1 | Amber Herold | h1. Install the Web Interface |
|---|---|---|---|
| 2 | |||
| 3 | 6 | Amber Herold | Install Leginon and Appion web tools for viewing images and performing image processing through the web server. |
| 4 | 1 | Amber Herold | |
| 5 | 41 | Jim Pulokas | h2. 1. Install pyami |
| 6 | 1 | Amber Herold | |
| 7 | 44 | Amber Herold | TODO: put the prereqs for this in Web Preq page rather than linking to the processing page. |
| 8 | |||
| 9 | 43 | Jim Pulokas | If you have not yet installed Leginon/Appion python packages on this server, the web interface will at least need the myami/pyami package to do MRC to JPEG conversion. First [[Install supporting packages|install the supporting packages]]. Then install myami/pyami as follows: |
| 10 | 41 | Jim Pulokas | <pre> |
| 11 | cd myami |
||
| 12 | cd pyami |
||
| 13 | python setup.py install |
||
| 14 | </pre> |
||
| 15 | This will install the script "mrc2any" into /usr/bin/mrc2any (for typical linux system). You can customize the location with options to the setup.py command. |
||
| 16 | To be sure where it was installed, run: |
||
| 17 | <pre> |
||
| 18 | which mrc2any |
||
| 19 | </pre> |
||
| 20 | |||
| 21 | You will need to know that location when configuring below. |
||
| 22 | |||
| 23 | |||
| 24 | h2. 2. Move the myami/myamiweb directory to your Apache web directory |
||
| 25 | |||
| 26 | 1 | Amber Herold | Example: |
| 27 | 20 | Neil Voss | <pre> |
| 28 | 25 | Amber Herold | cd myami |
| 29 | |||
| 30 | #CentOS example |
||
| 31 | sudo cp -vr myamiweb /var/www/html/ |
||
| 32 | 33 | Amber Herold | |
| 33 | 25 | Amber Herold | #this is temporary for setup, revert to 755 when finished with this page |
| 34 | 1 | Amber Herold | sudo chmod 777 /var/www/html/myamiweb |
| 35 | </pre> |
||
| 36 | 6 | Amber Herold | |
| 37 | 41 | Jim Pulokas | h2. 3. Configure your installation |
| 38 | 6 | Amber Herold | |
| 39 | There is a setup wizard available to help you set the configuration parameters for your installation. If you prefer not to use the wizard, there are instructions for manually editing the configuration file. If this is your first time creating the web tool configuration file, we recommend using the setup wizard. |
||
| 40 | |||
| 41 | |||
| 42 | 36 | Anchi Cheng | h3. Configuration using the setup wizard |
| 43 | |||
| 44 | 40 | Anchi Cheng | * Run the online setup wizard by visiting http://yourhost/myamiweb/setup or http://localhost/myamiweb/setup to create the myami website’s config file. |
| 45 | 37 | Anchi Cheng | * You need to know your database setup before you start. If you have been using the parameters in this instruction, here is a [[Explanation of Sample Names|summary]]. |
| 46 | 6 | Amber Herold | * You also need to decide whether you would like to enable the [[appion:What does User Authentication do to myamiweb|user management system]]. |
| 47 | * The setup wizard will check your database connection, create required database tables, and perform default data initialization. |
||
| 48 | |||
| 49 | 17 | Neil Voss | h3. Manual configuration instructions (Advanced User) |
| 50 | 1 | Amber Herold | |
| 51 | 5 | Eric Hou | Go to [[Install the Web Interface Advanced]] for the advanced configuration. |
| 52 | 32 | Amber Herold | |
| 53 | 41 | Jim Pulokas | h2. 4. Revert permissions |
| 54 | 19 | Neil Voss | |
| 55 | 1 | Amber Herold | <pre> |
| 56 | 26 | Amber Herold | sudo chmod 755 /var/www/html/myamiweb |
| 57 | 19 | Neil Voss | </pre> |
| 58 | |||
| 59 | 41 | Jim Pulokas | h2. 5. Test the installation |
| 60 | 9 | Amber Herold | |
| 61 | 18 | Neil Voss | Visit http://yourhost/myamiweb or http://localhost/myamiweb to confirm functionality. |
| 62 | 1 | Amber Herold | |
| 63 | 45 | Anchi Cheng | h2. 6. Turn off error checking in php.ini |
| 64 | |||
| 65 | Edit the following items in php.ini (found as /etc/php.ini on CentOS and /etc/php5/apache2/php.ini on SuSE) so that they look like the following: |
||
| 66 | |||
| 67 | bq. display_errors = Off |
||
| 68 | |||
| 69 | 1 | Amber Herold | ______ |
| 70 | |||
| 71 | 31 | Amber Herold | [[Install the MRC PHP Extension|< Install the MRC PHP Extension]] | [[Install phpMyAdmin|Install phpMyAdmin >]] |
| 72 | 1 | Amber Herold | |
| 73 | ______ |