Setting up the Ant tasks environment

To run Decision Center Ant tasks, you must first set up the appropriate environment variables.

Before you begin

When preparing to run Ant tasks, make sure that the following conditions are met.

You must have version 1.7.1 (or later) of Ant set up on your system. If Ant is not installed or your version is older than version 1.7.1, you must set up your environment to use the correct version of Ant.
To test your current version of Ant, type the following command in a Windows Command Prompt or UNIX shell: ant -version

You can download Ant from the Apache web site, or you can use the Ant 1.7.1 distribution that is packaged at <ODM_InstallDir>/shared/tools/ant, where <ODM_InstallDir> is your Operational Decision Manager installation directory.
Make sure that any environment variables required by WebSphere® Application Server are correctly set up. To do so, use the setupCmdLine.bat or setupCmdLine.sh script in the <WAS_Install_Dir>/profiles/<profile_name>/bin directory. This script sets up a full WebSphere Application Server environment, including the WAS_HOME, WAS_LOGGING, and WAS_CLASSPATH variables. For more information:
- WebSphere Application Server 8.0 information center
- WebSphere Application Server 8.5 information center

About this task

Communication between the Ant tasks and Decision Center supports the HTTP or HTTPS communication protocols. For more information, see Ant task communication protocol.

Procedure

To set up your environment to use Ant:

Set the ANT_HOME environment variable to <ODM_InstallDir>/shared/tools/ant.
Add the directory <ODM_InstallDir>/shared/tools/ant/bin to your PATH environment variable.

Results

The Decision Center Ant tasks are defined in <InstallDir>/teamserver/bin/build.xml and executed by commands of the form:

ant <taskName> <parameters list>

Note: To run these Ant tasks, you must use the same Java™ virtual machine version and vendor as the one used by the application server.

Ant task parameters start with -D. Use them to set values such as the following ones:

-Dserver.url=<server url>: Specifies the URL of the target application server.
-DdatasourceName=<data source name>: Specifies the JNDI name of the data source to use for the task. The default value is jdbc/ilogDataSource.

Example

ant execute-schema -Dserver.url=<protocol://host:port>/teamserver/ -DdatasourceName=jdbc/ilogDataSource -Dfile=my_sql_file.sql

The <protocol://host:port> URL is defined in the file <ODM_InstallDir>/teamserver/bin/teamserver-anttasks.properties. If your browser is not running on the same host as the application server, replace localhost with the address of the computer. If your web application is mapped to a host on a port that is different from the port number shown, change the port number to your host port number.

The file <ODM_InstallDir>/teamserver/bin/teamserver-anttasks.properties defines the value of some common parameters and others that depend on the application server. If these parameters are properly defined in this file, you do not have to include them in your Ant task command. The content of the teamserver-anttasks.properties file is as follows:

# Default properties
# ------------------------------------
rtsAdmin.login=rtsAdmin
rtsAdmin.password=rtsAdmin

protocol=http
server.host=localhost
server.port=9080
server.url=${protocol}://${server.host}:${server.port}/teamserver

datasourceName=jdbc/ilogDataSource

outputFile=output.sql

languagePackPath = .
languagePackOutputPath = ./generated

persistenceLocale =
selector =
branch =
override = false