Troubleshooting installation
Use logging and tracing to troubleshoot any problems that occur when you install WebSphere® Application Server.
Logging and tracing
- An easy way to view the logs is to open Installation Manager and go to File > View Log. An individual log file can be opened by selecting it in the table and then clicking the Open log file icon.
- Logs are located in the logs directory of Installation Manager's application
data location. For example:
- The main log files are time-stamped XML files in the logs directory, and they can be viewed using any standard web browser.
- The log.properties file in the logs directory specifies the
level of logging or tracing that Installation Manager uses. To turn on tracing for the WebSphere Application Server plug-ins, for example, create a
log.properties file with the following content:
Restart Installation Manager as necessary, and Installation Manager outputs traces for the WebSphere Application Server plug-ins.com.ibm.ws=DEBUG com.ibm.cic.agent.core.Engine=DEBUG global=DEBUG
Troubleshooting
- In some cases, you might need to bypass existing checking mechanisms in Installation Manager.
- On some network file systems, disk space might not be reported correctly at times; and you might
need to bypass disk-space checking and proceed with your installation. To disable disk-space checking, specify the following system property in the config.ini file in IM_install_root/eclipse/configuration and restart Installation Manager:
where size is a positive integer and unit is blank for bytes, k for kilo, m for megabytes, or g for gigabytes. For example:cic.override.disk.space=sizeunit
Installation Manager will report a disk-space size of Long.MAX_VALUE. Instead of displaying a very large amount of available disk space, N/A is displayed.cic.override.disk.space=120 (120 bytes) cic.override.disk.space=130k (130 kilobytes) cic.override.disk.space=140m (140 megabytes) cic.override.disk.space=150g (150 gigabytes) cic.override.disk.space=true
- To bypass operating-system prerequisite checking, add disableOSPrereqChecking=true to the config.ini file in IM_install_root/eclipse/configuration and restart Installation Manager.
- On some network file systems, disk space might not be reported correctly at times; and you might
need to bypass disk-space checking and proceed with your installation.
- If a fatal error occurs when you try to install the product, take the following steps:
- Make a backup copy of your current product installation directory in case IBM support needs to review it later.
- Use Installation Manager to uninstall everything that you have installed under the product installation location (package group). You might run into errors, but they can be safely ignored.
- Delete everything that remains in the product installation directory.
- Use Installation Manager to reinstall the product to the same location or to a new one.


File name: tins_troubleshoot.html