Changes between Version 18 and Version 19 of buildInstructions

Show
Ignore:
Timestamp:
05/28/09 08:08:16 (10 years ago)
Author:
aydan (IP: 173.95.179.211)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • buildInstructions

    v18 v19  
    2222  ''ant get.all'' 
    2323 
    24 5. Prepare the tree by building pom files 
     245. If this is the first time you are building orca, you will need to register the certificate of our web server, so 
     25that maven can download the necessary dependencies (our server uses https). You should omit this step if you have already installed the certificate. 
     26 
     27The web server certificate must be installed in the keystore of your java installation. To do this, we require 
     28that you set JAVA_HOME to point to the root of your java installation. Note also that $JAVA_HOME/bin must be on the path. 
     29Please do not use Open JDK, since it has issues with its keytool implementation. 
     30 
     31Our scripts assume that your installation's keystore is under: $JAVA_HOME/jre/lib/security/cacerts. 
     32 
     33'''Note:''' Mac users, your JAVA_HOME should be set to something like this: /System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home 
     34 
     35If you do not require sudo to modify your installation's keystore use the following command: 
     36 
     37  "ant get.certificate" 
     38 
     39If this fails with permission denied errors, please try the following: 
     40   
     41  "ant get.certificate.sudo" 
     42 
     436. Prepare the source tree for building 
    2544    
    2645  ''ant prepare.build'' 
    2746 
    28 6. Build the whole tree and install all artifacts to the local repository 
     47Note: maven will download a large number of files. If some of the downloads fail, please retry the command. You need to be connected to the Internet 
     48while performing this step. 
     49 
     507. Build the whole tree and install all artifacts to the local repository 
    2951 
    3052  ''mvn install'' 
    3153 
     54Note: maven will download a large number of files. If some of the downloads fail, please retry the command. You need to be connected to the Internet 
     55while performing this step for the first time. 
     56 
    3257'''NOTE:''' ''ant up'' will do incremental updates of the source tree. 
    3358 
    34 7. Create the security configuration by going to tools/config and running 
     59== Preparing GENI-ORCA  for Use == 
     60 
     61Once you have built and installed all artifacts in your local maven repository you have some more setup steps to go through before you can 
     62use the system. These have to do with generating a certificate and a keystore and linking/copying them in the right place. If your filesystem 
     63supports symbolic links, simply use the provided ant task: 
     64 
     65   "ant prepare.use" 
     66 
     67This task will generate the admin security configuration and place links to it in the relevant directories. It will also initialize and link other directories 
     68needed to build/test drivers.  
     69 
     70If your file system does not support symbolic links or you want more control over the process you can try the following steps: 
     71 
     721. Create the security configuration by going to tools/config and running 
    3573  ''ant security.create.admin.config'' 
    3674 
    3775'''NOTE:''' Make sure there is no existing runtime directory before you run this command unless you know what you are doing. 
    3876 
    39 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). 
     772. 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). 
    4078 
    41 9. Create the webapp with the new information by running 
     79== Generating the GENI-ORCA web application == 
     80 
     811. Create the webapp with the new information by running 
    4282 
    4383  ''mvn package'' 
     
    4585in orca/webapp. 
    4686 
    47 10. Deploy into an '''already running''' tomcat instance on the local machine by typing 
     872. Deploy into an '''already running''' tomcat instance on the local machine by typing 
    4888 
    4989  ''ant deploy'' 
    5090 
    51 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. 
     913. Wait until the actors start ticking before you log into the portal. Check in the log file (tomcat/logs/log) or just wait 45-60 seconds. Either tomcat or ORCA has an annoying race condition during webapp initialization. 
     92