Project

General

Profile

Install the Web Interface Advanced » History » Revision 9

Revision 8 (Amber Herold, 05/08/2012 11:49 AM) → Revision 9/14 (Amber Herold, 06/04/2012 12:51 PM)

h1. Install the Web Interface Advanced 

 h3. Manual configuration instructions (Advanced User) 

 *Note:* You may skip this section if you configured your installation with the setup wizard at http://localhost/myamiweb/setup. 

 Copy config.php.template to config.php and edit the latter by adding these parameters: 
 "config.php" should be located in /var/www/html/myamiweb/ on CentOS and /srv/www/htdocs/myamiweb/ on SuSE. 

 # define site 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> 
 &nbsp; 
 # 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> 
 &nbsp; 
 # Administrator email title and email address 
 <pre> 
 define('EMAIL_TITLE', 'The name of your institute'); 
 define('ADMIN_EMAIL', "example@institute.edu"); 
 </pre> 
 &nbsp; 
 # SMTP Server setup (not required but recommended): 
 <pre> 
 define('ENABLE_SMTP', false); 
 define('SMTP_HOST', 'mail.institute.edu'); 	 //your smtp host 
 </pre> 
 &nbsp; 
 ## 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> 
 &nbsp; 
 # Setup your MySQL database server parameters: 
 <pre> 
 define('DB_HOST', ""); 		 // DB Host name 
 define('DB_USER', ""); 		 // DB User name 
 define('DB_PASS', ""); 		 // DB Password 
 define('DB_LEGINON', ""); 	 // Leginon database name 
 define('DB_PROJECT', ""); 	 // Project database name 
 </pre> 
 &nbsp; 
 # Enable Image Cache 
 If you want to use caching function for faster image loading time in image viewer, change 'ENABLE_CACHE' to true. 
 You can change the 'CACHE_PATH' to other location, but make sure the apache user has write access to this folder. 
 <pre> 
 // --- Enable Image Cache --- // 
 define('ENABLE_CACHE', true); 
 // --- caching location --- // 
 // --- please make sure the apache user has write access to this folder --- // 
 define('CACHE_PATH', '/srv/www/cache/'); 
 define('CACHE_SCRIPT', WEB_ROOT.'/makejpg.php'); 
 </pre> 

 h3. Additional parameters needed for Appion Installations only: 

 [[appion config advanced]] 

 # Enable the processing plug-in by uncommenting out the following line in the file`myamiweb/config.php` 
 <pre> 
 addplugin("processing"); 
 </pre> 
 &nbsp; 
 # 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> 
 &nbsp; 
 # Add processing host information 
 &nbsp; 
 *Appion version 2.2 and later:* 
 The following code should be added and modified for each processing host available.  
 <pre> 
 $PROCESSING_HOSTS[] = array( 
 'host' => 'myhost.inst.edu', 	
 'nproc' => 32,    // number of processors available on the host, not used 
 'nodesdef' => '4', // default number of nodes used by a refinement job 
 'nodesmax' => '280', // maximum number of nodes a user may request for a refinement job 
 'ppndef' => '32', // default number of processors per node used for a refinement job 
 'ppnmax' => '32', // maximum number of processors per node a user may request for a refinement job 
 'reconpn' => '16', // recons per node, not used  
 'walltimedef' => '48', // default wall time in hours that a job is allowed to run 
 'walltimemax' => '240', // maximum hours in wall time a user may request for a job 
 'cputimedef' => '1536', // default cpu time in hours a job is allowed to run (wall time x number of cpu's)  
 'cputimemax' => '10000', // maximum cpu time in hours a user may request for a job 
 'memorymax' => '', // the maximum memory a job may use 
 'appionbin' => 'bin/', // the path to the myami/appion/bin directory on this host 
 'appionlibdir' => 'appion/', // the path to the myami/appion/appionlib directory on this host 
 'baseoutdir' => 'appion', // the directory that processing output should be stored in 
 'localhelperhost' => '', // a machine that has access to both the web server and the processing host file systems to copy data between the systems 
 'dirsep' => '/', // the directory separator used by this host 
 'wrapperpath' => '', // advanced option that enables more than one Appion installation on a single machine, contact us for info  
 'loginmethod' => 'SHAREDKEY', // Appion currently supports 'SHAREDKEY' or 'USERPASSWORD'  
 'loginusername' => '', // if this is not set, Appion uses the username provided by the user in the Appion Processing GUI 
 'passphrase' => '', // if this is not set, Appion uses the password provided by the user in the Appion Processing GUI 
 'publickey' => 'rsa.pub', // set this if using 'SHAREDKEY' 
 'privatekey' => 'rsa' 	   // set this if using 'SHAREDKEY' 
 ); 
 </pre> 
 &nbsp; 
 *Appion version 2.1 and prior:* 
 <pre> 
 // --- Please enter your processing host information associate with -- // 
 // --- Maximum number of the processing nodes 									 -- // 
 // --- $PROCESSING_HOSTS[] = array('host' => 'host1.school.edu', 'nproc' => 4); -- // 
 // --- $PROCESSING_HOSTS[] = array('host' => 'host2.school.edu', 'nproc' => 8); -- // 

 // $PROCESSING_HOSTS[] = array('host' => '', 'nproc' => ); 
 </pre> 
 &nbsp; 
 # Microscope spherical aberration constant 
 &nbsp; 
 Not needed for Appion version 2.2 and later. Version 2.1 and earlier only: 
 <pre> 
 $DEFAULTCS = "2.0"; 
 </pre> 


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

 ______ 

 [[Install the Web Interface| Go back to Install the Web Interface]] 


 ______