Page History

...

1. Download the Berkley DB XML version suitable for your platform from
   http://www.oracle.com/technetwork/database/berkeleydb/downloads/index.html
   
   

   Info
   The version used for this installation guide is Berkley DB XML 2.5.16.

    

   
   
   1. Install the software.
   2. Select the Java integration option. On Unix, you may need to run this command from the installation folder: sh buildall.sh --enable-java.
   3. On Windows, modify the PATH environment variable to include the DB XML executables. The database executables must be included in the PATH for the software to work properly.
   4. Optionally, download a pre-built Windows x64 version of Berkley DB XML from the ATS download location. Follow the instructions that are included with the downloaded file to configure your Windows 64-bit environment.
2. Install Java 6 JDK with the latest updates from:
   http://www.oracle.com/technetwork/java/javase/downloads/index.html
3. Download the ATS software package, ATS-1.1.rar, and store it in a folder.
4. Uncompress the ATS package, ATS-1.1.rar. The archive file contains the folder ATS-1.1 that includes AIM Template Service executables.
   
   1. Windows – click the compressed file to open; drag its content out to a folder, e.g. C:\ATS-1.1
   2. Unix – unrar ATS-1.1.rar. A new folder called ATS-1.1 is created.
5. Create the certificate.
   
   1. [optional] Create your certificate(s) to run ATS over HTTPS.
6. Edit serverConfig.txt.
   
   1. Go to “ATS-1.1” folder from above.
   2. Edit serverConfig.txt as follows.
      
      1. port = 4433 (AIM template service server port)
      2. dbpath = C:\ATS-1.1\xmldb (Path to a location where you want to store ATS data)
      3. CaGridSecurityUrl = (URL for STS authentication service)
      4. keystorepath = (path to the keystore) (optional. required if running over https)
      5. keystorename = (name of the keystore file) (optional. required if running over https)
7. Create the database as follows.
   
   1. Create a writable database folder, e.g. C:\ATS-1.1\xmldb – must correspond to the value of dbpath specified in serverConfig.txts
   2. [optional] Open command line and change to the database folder
   3. [optional] In the database folder, run dbxml. This opens the XML DB shell.
   4. [optional] In the XML DB shell, run createContainer ats_prod.dbxml. This creates an empty AIM Template Service database.
8. Run the ATS application.
   
   1. Windows
      
      1. Open the Administrator command line prompt.
      2. Go to the ATS-1.1 folder.

      3. Type %JAVA_HOME%\bin\java” -Djavax.net.ssl.trustStore=certificates/stsClient.jks -Djavax.net.ssl.trustStorePassword=yearkiwi -jar AimTemplateService.jar

         Info
         Set the JAVA_HOME environment variable to point to your JDK location.

   2. Unix

...

1. 1. 
      

      1. Open a terminal window.

...

1. 1. 1. Navigate to the ATS-1.

...

1. 1. 1. 1 folder

...

1. 1. 1. .

      2. Type java -Djava.library.path=/home/john /dbxml-2.5.16/install/lib/ -Djavax.net.ssl.trustStore=certificate/stsClient.jks -Djavax.net.ssl.trustStorePassword=yearkiwi -jar AimTemplateService.jar

         Info

...

1. 1. 1. The java.library.path value depends on where you have installed Oracle DB XML

...

1. 1. 1. .

   2. Watch console output for errors and warnings.

2. Validate the installation as follows.
   1. Open web browser on another computer.
   2. Navigate to http[s]://<your server name>:<your port>/
   3. Login using caGRID login credentials or as a guest.

Return to top of page