Aeolus: How to get started

From Pmgwiki

(Difference between revisions)
Jump to: navigation, search
(Directions for installing and running Aeolus code)
(clean up docs)
Line 6: Line 6:
#** service postgresql initdb (or run initdb somehow else)
#** service postgresql initdb (or run initdb somehow else)
#** chkconfig postgresql on
#** chkconfig postgresql on
-
#** (the following is adapted from aeolus/auditing/graphdb/SQLEventStore.java)
 
#** sudo -u postgres createuser --superuser YOUR_UNIX_USERNAME
#** sudo -u postgres createuser --superuser YOUR_UNIX_USERNAME
#** createdb AeolusAuthority
#** createdb AeolusAuthority
#** edit pg_hba.conf and change 127.0.0.1 entry to "trust" (fedora)
#** edit pg_hba.conf and change 127.0.0.1 entry to "trust" (fedora)
#** restart postgres server /etc/rc.d/init.d/postgresql restart
#** restart postgres server /etc/rc.d/init.d/postgresql restart
-
#* java 1.6
+
#* java 1.6 (OpenJDK 1.7 recommended)
#* ant
#* ant
# Download code: (download link coming soon)
# Download code: (download link coming soon)
Line 17: Line 16:
#** svn co svn+ssh://<Your-Name-Here>@lirone.csail.mit.edu/space/svnroot/aeolus aeolus<br>
#** svn co svn+ssh://<Your-Name-Here>@lirone.csail.mit.edu/space/svnroot/aeolus aeolus<br>
#** alternatively use eclipse to check out the sources from the repo
#** alternatively use eclipse to check out the sources from the repo
-
# You can look at the documentation on line at [http://pmg.csail.mit.edu/aeolus/javadoc]
+
# Build code using Eclipse or ant
-
# Build code
+
#* Eclipse: browse to build.xml, right click on build.xml and then choose Ant Build from the menu<br>
-
#*use eclipse to browse to build.xml
+
#* ant: run "ant" in the aeolus directory (uses build.xml)
-
#* right click on build.xml and then choose Ant Build from the menu<br>
+
-
#* Alternatively run "ant" in the aeolus directory (uses build.xml)
+
# Create environment
# Create environment
#* Create database (once)
#* Create database (once)
Line 33: Line 30:
#* ./run-vn edu.mit.csail.aeolus.apps.<insert dir-name>.<insert class-name>    This starts the application
#* ./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
#** Note: do not use ".class" in the class name
 +
#** <b>Important:</b> You can use ./run-vn -logging false <args-as-above> to turn off auditing. (The system is much slower with auditing enabled.)
# Misc notes
# Misc notes
#* Note: aeolus-apps.jar contains all the classes in apps (or at least approximately)
#* 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: 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
#* Note: the Aeolus class loader always needs a full, absolute pathname
 +
 +
The API documentation is available here: [http://pmg.csail.mit.edu/aeolus/]

Revision as of 21:50, 13 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
      • 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 (OpenJDK 1.7 recommended)
    • 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. Build code using Eclipse or ant
    • Eclipse: browse to build.xml, right click on build.xml and then choose Ant Build from the menu
    • ant: run "ant" in the aeolus directory (uses build.xml)
  4. 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>';
  5. 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
      • Important: You can use ./run-vn -logging false <args-as-above> to turn off auditing. (The system is much slower with auditing enabled.)
  6. 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

The API documentation is available here: [1]

Personal tools