EMEN2 Installation Example

This document provides a walk-through of installing and starting EMEN2, with typical commands and terminal output. More detailed information about each step is available in the main installation guide. For this example, we will install EMEN2 on Mac OS X 10.7, 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. For EMAN2 binary users on Linux, make sure to use $HOME/Python/bin/python instead of the plain "python" below. You will also not need to "sudo" for easy_install.

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

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 restart -h $HOME/db.test -e default,em,site
Starting emen2
INFO :: Opening Database Environment: /Volumes/irees/db.test