Differences between revisions 5 and 9 (spanning 4 versions)
⇤ ← Revision 5 as of 2012-07-11 11:38:03 →
Size: 3175
Editor: IanRees
Comment:
← Revision 9 as of 2012-07-11 11:52:40 → ⇥
Size: 3287
Editor: IanRees
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
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. 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.
Line 7: Line 7:
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. 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.
Line 59: Line 59:
At this point, the database is setup and ready to start the web server.
Line 75: Line 73:
mp:~ irees$ emen2ctl start -h $HOME/db.test -e default,em,site mp:~ irees$ emen2ctl restart -h $HOME/db.test -e default,em,site
Line 79: Line 77:

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

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

EMEN2/Install/Example (last edited 2012-07-11 11:52:40 by IanRees)