EMEN2 Installation Example

This document provides a walk-through of installing and starting EMEN2, and typical commands and terminal output. For this example, we will install EMEN2 using easy_install, then setup a new database environment in $HOME/db.test.

Install EMEN2 using easy_install

Make sure you have all EMEN2 dependencies packages installed first. The easiest way to do this is to use an EMAN2 binary package, which provides everything EMEN2 needs to run as well.

mp:~ irees$ sudo easy_install emen2
Searching for emen2
Reading http://pypi.python.org/simple/emen2/
Reading http://blake.grid.bcm.edu/emanwiki/EMEN2/
Best match: emen2 2.1b9
Downloading http://pypi.python.org/packages/source/e/emen2/emen2-2.1b9.tar.gz#md5=84a6f339029f4383cc8766b902330cc2
Processing emen2-2.1b9.tar.gz
Running emen2-2.1b9/setup.py -q bdist_egg --dist-dir /tmp/easy_install-zvleeC/emen2-2.1b9/egg-dist-tmp-WPecsd
Adding emen2 2.1b9 to easy-install.pth file
Installing emen2ctl script to /usr/local/bin

Installed /Library/Python/2.7/site-packages/emen2-2.1b9-py2.7.egg
Processing dependencies for emen2
Finished processing dependencies for emen2

Create database

mp:~ irees$ python -m emen2.db -h $HOME/db.test --create
INFO :: Copying default DB_CONFIG file: /Volumes/irees/db.test/DB_CONFIG
INFO :: Opening Database Environment: /Volumes/irees/db.test

=== Setup Admin (root) account ===
Admin (root) email (default root@localhost): 
Password: 
COMMIT :: user/user.put: root
COMMIT :: user/index/email.addrefs: root@localhost -> 1
INFO :: Committed 1 items
COMMIT :: group/group.put: admin
COMMIT :: group/group.put: readadmin
COMMIT :: group/group.put: create
COMMIT :: group/group.put: anon
COMMIT :: group/group.put: authenticated
COMMIT :: group/index/permissions.addrefs: root -> 1
COMMIT :: record/record.sequence: 1
COMMIT :: record/record.put: 0
COMMIT :: record/index/modifyuser.addrefs: root -> 1
COMMIT :: record/index/creator.addrefs: root -> 1
COMMIT :: record/index/creationtime.addrefs: 2012-07-11T11:23:43+00:00 -> 1
COMMIT :: record/index/groups.addrefs: authenticated -> 1
COMMIT :: record/index/modifytime.addrefs: 2012-07-11T11:23:43+00:00 -> 1
COMMIT :: record/index/name_folder.addrefs: Root -> 1
COMMIT :: record/index/performed_by.addrefs: root -> 1
COMMIT :: record/index/rectype.addrefs: folder -> 1
COMMIT :: record/index/date_occurred.addrefs: 2012-07-11T11:23:43+00:00 -> 1
INFO :: Committed 1 items

At this point, the database is setup and ready to start the web server.

Start test web server

mp:~ irees$ python -m emen2.web -h $HOME/db.test -e default,em,site
INFO :: Opening Database Environment: /Volumes/irees/db.test
INFO :: Opening Database Environment: /Volumes/irees/db.test
....

The server defaults to http://localhost:8080

Daemonize EMEN2 using emen2ctl

mp:~ irees$ emen2ctl start -h $HOME/db.test -e default,em,site
Starting emen2
INFO :: Opening Database Environment: /Volumes/irees/db.test

This will daemonize EMEN2, and write a log file to $HOME/db/twistd/emen2.log.