Changes between Version 52 and Version 53 of buildInstructions

Show
Ignore:
Timestamp:
11/17/10 16:33:22 (9 years ago)
Author:
ibaldin (IP: 152.54.9.21)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • buildInstructions

    v52 v53  
    77 
    88{{{ 
    9 $ mkdir orca 
    10 $ cd orca 
     9$ export ORCA_SRC=$HOME/orca 
     10$ mkdir $ORCA_SRC 
     11$ cd $ORCA_SRC 
    1112}}} 
    1213 
    13 2. Retrieve the bootstrap directory from subversion. 
     142. Due to the difference in source tree organization:  
     15  * For Bella 2.2 and up follow step 2a and then proceed to steps 6 and 7.  
     16  * For Bella 2.1 and before, follow steps 2b, 3, 4, 5, 6, 7. 
     17 
     182a. Retrieve the source tree in its entirety 
     19 
     202b. Retrieve the bootstrap directory from subversion. 
    1421 
    1522For the latest version of the code (unstable, currently in development, may be broken) use: 
     
    4249 
    4350  '''NOTE:''' You may get an error message about the --trust-server-cert option. Edit build-all/helper.sh file (look for the option and remove it). 
    44 5. If this is the first time you are building orca, you will need to register the certificate of our web server, so 
    45 that maven can download the necessary dependencies (our server uses https). You should omit this step if you have already installed the certificate. 
    4651 
    47 The web server certificate must be installed in the keystore of your java installation. To do this, we require 
    48 that you set JAVA_HOME to point to the root of your java installation. Note also that $JAVA_HOME/bin must be on the path. 
     525. Prepare the source tree for building 
     53{{{ 
     54$ ant prepare.build 
     55}}} 
     56 
     57'''Note:''' maven will download a large number of files.  It will whine about not being able to find some where it looked first, but then it will usually find them OK somewhere else.  If some of the downloads fail, please retry the command (it is safe). You need to be connected to the Internet 
     58while performing this step. 
     59 
     606. If this is the first time you are building orca, you will need to register the certificate of our web server, so that maven can download the necessary dependencies (our server uses https). You should omit this step if you have already installed the certificate. 
     61 
     62The web server certificate must be installed in the keystore of your java installation. To do this, we require that you set JAVA_HOME to point to the root of your java installation. Note also that $JAVA_HOME/bin must be on the path. 
    4963Please do not use Open JDK, since it has issues with its keytool implementation. 
    5064 
     
    6276$ ant get.certificate.sudo 
    6377}}} 
    64 6. Prepare the source tree for building 
    65 {{{ 
    66 $ ant prepare.build 
    67 }}} 
    68  
    69 '''Note:''' maven will download a large number of files.  It will whine about not being able to find some where it looked first, but then it will usually find them OK somewhere else.  If some of the downloads fail, please retry the command (it is safe). You need to be connected to the Internet 
    70 while performing this step. 
    7178 
    72797. Build the whole tree and install all artifacts to the local repository (the resulting jars end up in ~/.m2/repository/) 
     
    7683}}} 
    7784 
    78 '''NOTE 1''': maven will download a large number of files.  It will whine about not being able to find some where it looked first, but then it will usually find them OK somewhere else.  If some of the downloads fail, please retry the command (it is safe). You need to be connected to the Internet 
    79 while performing this step.  Some maven tasks will whine that they have nothing to do: that is normal. 
     85'''NOTE 1''': maven will download a large number of files.  It will whine about not being able to find some where it looked first, but then it will usually find them OK somewhere else.  If some of the downloads fail, please retry the command (it is safe). You need to be connected to the Internet while performing this step.  Some maven tasks will whine that they have nothing to do: that is normal. 
    8086 
    8187'''NOTE 2''': if maven fails due to a unit test in one of the modules, you can install without running unit tests like so:  
     
    8490}}} 
    8591 
    86 '''NOTE 3:''' ''ant up'' will do incremental updates of the source tree. 
     92'''NOTE 3:''' ''ant up'' will do incremental updates of the source tree. (Bella 2.1 and before, for Bella 2.2 and after use simple ''svn up'') 
    8793 
    8894'''NOTE 4:''' Once you have the entire project built and installed to your local repository, you can reinstall any subproject by running ''mvn install'' in the projects subdirectory. This is much faster than recompiling the entire tree.