Aeolus: How to get started

From Pmgwiki

Revision as of 21:31, 8 June 2012

Directions for installing and running Aeolus code

1. Prerequisites
   • Postgres database
     • Install the rpms or packages (postgresql, postgresql-server, postgresql-jdbc)
     • service postgresql initdb (or run initdb somehow else)
     • chkconfig postgresql on
     • (the following is adapted from aeolus/auditing/graphdb/SQLEventStore.java)
     • sudo -u postgres createuser --superuser YOUR_UNIX_USERNAME
     • createdb AeolusAuthority
     • edit pg_hba.conf and change 127.0.0.1 entry to "trust" (fedora)
     • restart postgres server /etc/rc.d/init.d/postgresql restart
   • java 1.6
   • ant
2. Download code: (download link coming soon)
   • For people with pmg accounts
     • svn co svn+ssh://<Your-Name-Here>@lirone.csail.mit.edu/space/svnroot/aeolus aeolus
       
     • alternatively use eclipse to check out the sources from the repo
3. You can look at the documentation on line at [1]
4. Build code
   • use eclipse to browse to build.xml
   • right click on build.xml and then choose Ant Build from the menu
     
   • Alternatively run "ant" in the aeolus directory (uses build.xml)
5. Create environment
   • Create database (once)
     • AUTHORITY SERVER (per authority/server/AuthorityManager.java)
       • CREATE DATABASE AeolusAuthority;
       • CONNECT AeolusAuthority;
       • GRANT ALL ON * TO 'aeolus'@'localhost' IDENTIFIED BY '<find-the-password-in-the-AuthorityManager-code>';
6. Run code
   • cd aeolus
   • ./run-server This starts the AS (aka the Authority Server)
   • ./run-vn edu.mit.csail.aeolus.apps.<insert dir-name>.<insert class-name> This starts the application
     • Note: do not use ".class" in the class name
7. Misc notes
   • Note: aeolus-apps.jar contains all the classes in apps (or at least approximately)
   • Note: need to add aeolus-apps.jar to the class path if using shared state
   • Note: the Aeolus class loader always needs a full, absolute pathname