NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Required Software Name and Version

Description

Java 2 Platform Standard Edition 6.0 Update 18 (J2SE 6.0)

http://java.sun.com/products/archive/j2se/6u18/index.htmlBe

sure to download the correct Java SDK for your operating environment. For example, for Linux AMD 64, you would download jdk -for linus, linux-amd64-rpm.bin. For Windows, you might download jdk -for Window,windows-i586-p.exe.

The J2SE Development Kit (JDK) supports creating J2SE applications.

Apache Ant, 1.7.0

Apache Ant is a Java-based build tool.

MySQL, 5.0.45

MySQL is an open-source database software application.

...

  • After extracting the zip, you must set the environment variables, described in the following section, so that Ant is available in the system PATH.

Apache Ant Environment Variables

...


Info
titleNote

The purpose of setting operating system environment variables is so that the Java SDK and Ant build tool are available to run from anywhere in the system.

...

To set the environmental variables in Linux, follow these steps:#As

  1. As the root user, enter the following in the /etc/profile file. A PATH variable should already be created in this file, so be sure to define the JAVA_HOME and ANT_HOME export before the PATH export. Replace <some_path> with the correct path fragment for Java and Ant installations.
    export JAVA_HOME=<some_path>/jdk1.6.0_18
    export ANT_HOME=<some_path>/apache-ant-1.7.0
    export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH

...

  1. Log out and log back in so that the system recognizes your changes.

Verifying the Environment Variables in Linux

...

  1. From the command line, enter:
    echo $JAVA_HOME
    echo $ANT_HOME
    Both of these commands should return the location where you installed these tools.|
  2. To verify your Java SDK installation, enter java –version from a command prompt. You should see java version "1.6.0_18".
  3. To verify your Ant installation, enter: ant –version from a command prompt. You should see: Apache Ant version 1.7.0 compiled on December 13 2006.

...

  1. In Windows, select Control Panel, then select the System application. In the System Properties window, select the Advanced tab.|
  2. On the Advanced tab, click the Environment Variables button. To add a new system variable, select the New button.
    1. In the Variable name text box, enter JAVA_HOME.
    2. In the Variable value text box, enter the location of your Java installation.|
  3. Click the New button again.
    1. In the Variable name text box, enter ANT_HOME.
    2. In the Variable value text box, enter the location of your Ant installation.|
  4. Select the PATH system environment variable, and select the Edit button. This opens the Edit System Variable dialog box, displayed here as an example.
    !worddav627431e6bafa77efdc88f204e39b04fc.png|height=147,width=346# # In the Variable value text box, prepend the following text in front of the text that already exists in the Variable Value field.
    %JAVA_HOME%\bin;%ANT_HOME%\bin;
  5. Click OK. |
Verifying the Environment Variables in Windows

To verify the environment variables have been set correctly, follow these steps:

  1. From the command line, enter:
    {{ echo %JAVA_HOME%_*
    {{ echo %ANT_HOME%_*
    Both of these commands should return the location where you installed these tools.|
  2. To verify your Java SDK installation, enter java –version from a command prompt. You should see java version "1.6.0_18".
  3. To verify your Ant installation, enter ant –version from a command prompt.
    You should see: Apache Ant version 1.7.0 compiled on December 13 2006.|
    Info
    titleNote

    Environment variables for caIntegrator and, optionally, UPT are modified and set in those sections of this document: Installing a New caIntegrator v.1.3 on page and Downloading and Installing UPT (Optional) on page .}}


    MySQL Installation and Configuration

    *

    A MySQL 5.0.45 server must be downloaded, installed and running in order for the caIntegrator installation to work successfully.

To download and install MySQL, follow the steps outlined on the {MySQL website|http://downloads.mysql.com/archives.php?p=mysql-5.0&v=5.0.45].

Tip
titleTip

You should consult the following three links to successfully set up secure and well-performing MySQL servers, in preparation for installing caIntegrator:


Tip
titleMore Tips
  • Record the MySQL root username/password chosen during the MySQL installation process, as you will need to use this as your database.system.user/ database.system.password later in the UPT installation process, should you choose to install UPT.
  • Note the MySQL port chosen during the MySQL installation process, as you will need to use this as your database.port later in both the caIntegrator and UPT (if installing UPT) installation processes.


Working with Properties Files

About Properties

An important component of command-line installation of either caIntegrator or UPT is configuring properties files. Prior to initiating a command-line installation, property variables must be modified. Note the following points about changing or entering variables.

Paths in Properties Files
Info
titleNote

The paths in the .properties files should use forward slashes. For example, you would use application.base.path=C:/apps/caIntegrator-app, not application.base.path=C:\apps\caIntegrator-app. If you use backslashes, you will experience undesirable results.


Spaces in Path Property Values
Info
titleNote

You should not specify paths with spaces included as property values. In Windows, note that the C:\Documents and Settings<username> path contains spaces and should not be used, or anything similar. If you are using Windows, use a path such as C:/apps/caIntegrator. Spaces are fine for property values which do not represent a path.

More About Property Values

...