Diagnosing a failing Apache Ant configuration script

Determine whether a product installation problem on an operating system is caused by a failing Apache Ant configuration script.

Before you begin

Start diagnosing installation problems by looking at the troubleshooting procedure. See Troubleshooting installation. After the installation completes successfully, several Ant scripts configure the product. The following procedure describes what to do when an Ant script fails. When the installation log does not indicate a failure, determine how to correct any problems with failing Ant configuration scripts.

About this task

The install_root/logs/wbi/installconfig.log file, describes any failure of an Apache Ant script. Determine if any of the following configuration scripts failed. If so, use the configuration script recovery procedures.

To diagnose failed configuration scripts, complete the following steps.

Procedure

Diagnose the failed 90SConfigWBIMigrationScript.ant configuration script. This script changes the permissions of the following script to 755: install_root/bin/wbi_migration. This script also replaces the following tokens in the install_root/bin/wbi_migration script:

From:	To the value that you selected during installation:
`${JAVAROOT}`	`install_root/java/jre/bin/java`
`${MIGRATIONJAR}`	`install_root/bin/migration/migrationGUI/migrationGUI.jar`
`${WASROOT}`	`install_root`
`${PRODUCTID}`	`${WS_CMT_PRODUCT_TYPE}`

Investigative action: Verify that the permissions are 755 for the following directories:
- install_root/bin/wbi_migration.sh
- install_root\bin\wbi_migration.bat
- install_root/bin/wbi_migration
Recovery action: Issue the following command:
- chmod 755 install_root/bin/wbi_migration.sh
- chmod 755 install_root\bin\wbi_migration.bat
- chmod 755 install_root/bin/wbi_migration
Investigative action: Open the following file in an editor and verify that real values exist instead of the following values: ${JAVAROOT}, ${MIGRATIONJAR}, ${WASROOT}, and ${PRODUCTID}.
- install_root/bin/wbi_migration.sh
- install_root\bin\wbi_migration.bat
- or install_root/bin/wbi_migration
Recovery action: Change the following tokens to actual values in the wbi_migration script: ${JAVAROOT}, ${MIGRATIONJAR}, ${WASROOT}, and ${PRODUCTID}.

Diagnose the failed 85SConfigNoProfileFirstStepsWBI.ant. This script copies all files from the install_root/properties/version/install.wbi/firststeps.wbi directory to the install_root/firststeps/wbi/html/noprofile directory. This script also replaces the following tokens in the following files:

install_root/firststeps/wbi/firststeps.sh
install_root\firststeps\wbi\firststeps.bat
install_root/firststeps/wbi/firststeps

From:	To the value that you selected during installation:
`${JAVAROOT}`	`install_root/java/jre/bin/java`
`${PROFILEROOT}`	`install_root`
`${HTMLSHELLJAR}`	`install_root/lib/htmlshellwbi.jar`
`${CELLNAME}`	`${WS_CMT_CELL_NAME}`

Investigative action: Verify that all files are copied from the install_root/properties/version/install.wbi/firststeps.wbi directory to the install_root/firststeps/wbi/html/noprofile directory.
Recovery action: Copy all the files from the install_root/properties/version/install.wbi/firststeps.wbi directory to the install_root/firststeps/wbi/html/noprofile directory.
Investigative action: Open the install_root/firststeps/wbi/firststeps script in an editor. Verify that real values exist instead of the following values: ${JAVAROOT}, ${PROFILEROOT}, ${HTMLSHELLJAR}, and ${CELLNAME}.
Recovery action: Change the following tokens to actual values in the install_root/firststeps/wbi/firststeps script. ${JAVAROOT}, ${PROFILEROOT}, ${HTMLSHELLJAR}, and ${CELLNAME}.

Results

After you correct any installation errors and anyApache Ant script configuration errors by completing the corrective actions in this procedure, the installation is complete.

What to do next

Start the First steps console.