Appion

Appion Home » Appion Manual » Complete Installation » Web Server Installation »

Install the Web Interface » History » Revision 5

Revision 4 (Eric Hou, 05/10/2010 02:42 PM) → Revision 5/56 (Eric Hou, 05/10/2010 04:49 PM)

h1. Install the Web Interface 

 Install Leginon and Appion web tools for viewing images and image processing through the web server. 
 If you are installing your web server on a different machine than your processing server,  
 you need to download the myami code. 
 *TODO:* add a link to the myami code  

  


 1. Move the myami/myamiweb directory to your Apache web directory 

 Example: 
 <pre> 
 > cd [webdirectory]     // /var/www/html in this example 
 > cp [path_to_myami_download_location]/myami/myamiweb . 
 </pre> 

 2. Automatically setup: 
 Run online setup wizard by visiting http://yourhost/myamiweb/setup to create the myami website’s config file.  
 The setup wizard will also check your database connection, database tables’ creation and default data initialization. 
 If this is your first time creating the web tool configure file. We recommend you to use the setup wizard. 

 3. Manually setup (Advance User): 
 Copy config.php.template to config.php and edit the latter by adding these MySQL parameters: 
 "config.php" should be located in /var/www/html/myamiweb/ on CentOS and /srv/www/htdocs/myamiweb/ on SuSE. 

 * <pre> 
 <?php 
 // --- define site myamiweb tools base path 
 * --- // 

 // This should be changed if the myamiweb directory is located 
 *  
 // in a sub-directory of the Apache web directory. 
 * // ex. myamiweb is in /var/www/html/applications/myamiweb/ then 
 * // change to    define('BASE_PATH',"applications/myamiweb"); 

 <pre> 
 define('BASE_PATH',"myamiweb");  
 </pre> 

 * myamiweb login system 

 <pre> 
  

 // Browse to the administration tools in myamiweb prior to  
 // changing this to true to populate DB tables correctly. 
 define('ENABLE_LOGIN', false); 	
 </pre> 


 * Administrator email title and email address 

 <pre> 
 define('EMAIL_TITLE', 'The name of your institute'); 
 define('ADMIN_EMAIL', "example@institute.edu"); 
 </pre> "example@scripps.edu"); 

 * SMTP Server setup (not required but recommended): 

 <pre> 
 define('ENABLE_SMTP', false); 
 define('SMTP_HOST', 'mail.institute.edu'); 	 //your smtp host 
 </pre> 

 * When SMTP server requires authentication 

 <pre> 
 // --- Check this with your email administrator -- // 
 // --- Set it to true if your SMTP server requires authentication -- // 
 define('SMTP_AUTH', false); 

 // --- If SMTP_AUTH is not required(SMTP_AUTH set to false, -- // 
 // --- no need to fill in 'SMTP_USERNAME' & SMTP_PASSWORD -- // 
 define('SMTP_USERNAME', ""); 
 define('SMTP_PASSWORD', ""); 
 </pre> 

 * Setup your MySQL database server parameters: 

 <pre> parameters 
 define('DB_HOST', ""); "localhost"); 		 // DB Host name 
  
 define('DB_USER', ""); 		 "usr_object"); 	 // DB User name 
 define('DB_PASS', ""); 		 		         // DB Password 
 define('DB_LEGINON', ""); "leginondb"); 	 // Leginon database name 
 define('DB_PROJECT', ""); "projectdb"); 	 // Project database name 
 </pre> 

 * Enable the processing plug-in by uncommenting out the following line in the file`myamiweb/config.php` 

 <pre> 
 addplugin("processing"); 
 </pre> 

 * Add processing host information Copy `myamiweb/processing/config_processing.php.template` to `myamiweb/processing/config_processing.php` 
 * Edit `myamiweb/processing/config_processing.php` 

 <pre> 
 // --- Please enter your processing host information associate with -- // $PROCESSING_DB_HOST = "your_db_host"; 
 // --- Maximum number of the processing nodes 									 -- // 
 // --- $PROCESSING_HOSTS[] $PROCESSING_DB_USER = array('host' => 'host1.school.edu', 'nproc' => 4); -- // "usr_object"; 
 // --- $PROCESSING_HOSTS[] $PROCESSING_DB_PASS = array('host' => 'host2.school.edu', 'nproc' => 8); -- // 

 // $PROCESSING_HOSTS[] "";  
 $PROCESSING_DB = array('host' => '', 'nproc' => ); ""; 
 </pre> 

 * Microscope spherical aberration constant 

 <pre> Remember that the last line should be kept empty as this will be set dynamically. 
 $DEFAULTCS = "2.0"; 
 </pre> 

 * IMAGIC and Other features: 
 
 <pre> 
 // Check if IMAGIC is installed and running, otherwise hide all functions 
 define('HIDE_IMAGIC', false); 

 // hide processing tools still under development. 
 define('HIDE_FEATURE', true); 
 </pre> 

 We will not include the processing host or cluster registration now. It is covered in the last part of this document. 

 4. 3. Test the set-up by visiting http://yourhost/myamiweb 

 ______ 

 [[Install the MRC PHP Extension|< Install the MRC PHP Extension]] | [[Potential Problems|Potential Problems >]] 

 ______