Version 18 (modified by varun, 10 years ago)


Building GENI-ORCA

1. Create a work directory and change into it.

mkdir orca

cd orca

2. Retrieve the bootstrap directory from subversion.

svn co build-all

This will create the subdirectory build-all in the current directory.

Note: The ORCA directory structure and these instructions support versions of subversion before 1.5, which didn't have shallow extractions. Thus some of the instructions may seem unusual to svn 1.5+ users.

3. Soft link to the build.xml file.

ln -s build-all/build.xml build.xml

4. Use ant to get the source.

ant get.all

5. Prepare the tree by building pom files


6. Build the whole tree and install all artifacts to the local repository

mvn install

NOTE: ant up will do incremental updates of the source tree.

7. Create the security configuration by going to tools/config and running

ant security.create.admin.config

NOTE: Make sure there is no existing runtime directory before you run this command unless you know what you are doing.

8. Copy the resulting runtime/ directory to the orca/webapp directory. You should be able to softlink instead, but maven has some annoying behavior with softlinks. Copying is easier, as long as you remember to re-copy every time you regenerate the certificate (which should be never).

9. Create the webapp with the new information by running

mvn package

in orca/webapp.

10. Deploy into an already running tomcat instance on the local machine by typing

ant deploy

11. Wait till the actors start ticking before you log into the portal. Check in the log file or just wait 45-60 seconds. Either tomcat or ORCA has an annoying race condition during webapp initialization.