|
Size: 2432
Comment:
|
Size: 616
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| Generally, you will want to create a user account for running emen2, e.g. 'emen2.' This has the benefit of working well with the default config file. Running as any other user also works fine, you will just have to change one or two paths in config.yml. | = Installing and configuring EMEN2 = |
| Line 3: | Line 3: |
| 1. Download the latest EMEN2 source code release and untar | <<TableOfContents>> |
| Line 5: | Line 5: |
| {{{ cd /home/emen2 tar -xvzf emen2.03.28.2010.tar.gz cd emen2 }}} |
= Install Dependencies = |
| Line 11: | Line 7: |
| 2. Create a directory for the Database Environment (referred to as $DB_HOME going forward. Reasonable default is /home/emen2/db/ ) | You will first need to install the various [[EMEN2/Dependencies|EMEN2 dependencies]]. They are all straight-forward to install, and can generally be installed using Python's easy_install system. |
| Line 13: | Line 9: |
| {{{ mkdir /home/emen2/db cp config/config.sample.yml /home/emen2/db/config.yml }}} |
= Download EMEN2 = |
| Line 18: | Line 11: |
| Recommended: Set the $DB_HOME environment variable to this path for convenience. Place this in your .bash_profile or similar. | Download the latest EMEN2: |
| Line 20: | Line 13: |
| {{{ export DB_HOME=/home/emen2/db }}} |
http://ncmi.bcm.edu/ncmi/software/software_details?selected_software=EMEN2 |
| Line 24: | Line 15: |
| 3. Copy emen2/config.sample.yml to $DB_HOME/config.yml | = Create EMEN2 Environment = |
| Line 26: | Line 17: |
| Edit the various settings in config.yml. See [[EMEN2/config.yml]]. Primarily, you will want to check the path and network settings. A simple configuration will have most EMEN2 directories (db, applog, archive, db_hotbackup, emen2files, etc.) placed under the path specified by the "&root" element, which is /home/emen2/ by default. | = Edit Configuration = |
| Line 28: | Line 19: |
| {{{ root: &root /home/emen2/ }}} |
= Initialize EMEN2 Environment = |
| Line 33: | Line 21: |
| 4. After config.yml is to your liking, run | = Test Web Server = |
| Line 35: | Line 23: |
| {{{ python ./setup.py }}} |
= Optional: Import = |
| Line 39: | Line 25: |
| The rest of the $DB_HOME environment will be created, skeleton parameter/protocol definitions will be installed, and a root user created. You will be prompted on the shell for a root password. | = Optional: Accelerator Module = |
| Line 41: | Line 27: |
| 5. Test web server {{{ python ./TwistSupport.py }}} You should be able to connect to this web server instance once it is "listening..." The default port is 8080. You may login with the root password you specified previously. 6. Optional: Import Parameter/Protocol definitions from the NCMI Database. {{{ python ./clients/clone.py -- --defs }}} Note: the first "--" is intentional and required at the moment. Command arguments for the local database go before "--", arguments to the cloning script go after ("--defs") You will be prompted for two sets of credentials. First, an NCMI DB account, and second, the root password for the local database. If you do not have an NCMI DB account, you may specify "anonymous" as the username, and your email address as the password. 6. Daemon After you are satisfied with your setup, you can run EMEN2 in the background {{{ python ./emen2control.py --start }}} |
= Run as daemon = |
Installing and configuring EMEN2
Contents
Install Dependencies
You will first need to install the various EMEN2 dependencies. They are all straight-forward to install, and can generally be installed using Python's easy_install system.
Download EMEN2
Download the latest EMEN2:
http://ncmi.bcm.edu/ncmi/software/software_details?selected_software=EMEN2
Create EMEN2 Environment
Edit Configuration
Initialize EMEN2 Environment
Test Web Server
Optional: Import
Optional: Accelerator Module