= 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 [[EMEN2/Install|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 [[EMEN2/Dependencies|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
}}}