Determine whether a product installation problem on an
operating system such as AIX®, Linux®, Windows®, or i5/OS® 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,
when present, describes any failure of an Ant script. Determine if
any of the following configuration scripts failed. If so, use the
configuration script recovery procedures. Use the investigative action
to manually verify that the following configuration scripts ran successfully
during the configuration of the
WebSphere ESB product.
If any script failed, use the recovery action steps to complete the
function of the script.
To diagnose failed Ant configuration scripts,
perform 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 install_root/bin/wbi_migration.sh script
on Linux and UNIX® platforms, install_root\bin\wbi_migration.bat on Windows platforms, or for the install_root/bin/wbi_migration script
on i5/OS platforms.
- Recovery action: Issue the following command: chmod
755 install_root/bin/wbi_migration.sh on Linux and UNIX platforms, chmod 755 install_root\bin\wbi_migration.bat on Windows platforms or chmod
755 install_root/bin/wbi_migration on i5/OS platforms.
- Investigative action: Open the install_root/bin/wbi_migration.sh on Linux and UNIX platforms, install_root\bin\wbi_migration.bat on Windows platforms, or install_root/bin/wbi_migration script
on i5/OS platforms in an editor
and verify that real values exist instead of the following values: ${JAVAROOT}, ${MIGRATIONJAR}, ${WASROOT},
and ${PRODUCTID}.
- 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 install_root/firststeps/wbi/firststeps.sh script
(Linux, and UNIX), the install_root\firststeps\wbi\firststeps.bat script
(Windows platforms), or
the install_root /firststeps/wbi/firststeps script
(i5/OS platforms):
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 of 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 any Ant script
configuration errors by performing the corrective actions in this
procedure, the installation is complete.
What to do next
Start the First steps console.