CHAPTER 7 Troubleshooting
Installation Guide 105
Recovering from a failed installation
If the installation does not succeed, the installation program displays error
messages. Review the error messages and your Adaptive Server error log to
determine the cause of the installation failure. For default error log locations,
see Table 7-3 on page 101.
If installation fails after files are created
If the installation program quits while you are configuring Adaptive Server:
1 View the contents of the log file generated by Adaptive Server. For default
error log locations, see Table 7-3 on page 101.
2 Take any suggested actions to correct the problem.
3 If the installation fails after the installation program has created any
operating system files, such as the
master device or system procedures
device files, delete those files.
4 If the installation fails after the installation program starts the Adaptive
Server that you are attempting to install, shut down that server.
Troubleshooting resource file installations
If you encounter problems during the build, configuration, or upgrade process
of Adaptive Server using the
srvbuild[res], sqlloc[res], or sqlupgrade[res], it may
be that these utilities did not allow enough time for Adaptive Server to shut
down properly.
You can set the SYBSHUTWAIT environment variable to force the utilities to
wait for Adaptive Server to shut down. For example, this command forces the
utility to wait for two minutes to allow Adaptive Server to shut down before
proceeding with the next task:
% setenv SYBSHUTWAIT 120
If Adaptive Server fails the pre-upgrade eligibility test
If Adaptive Server fails the pre-upgrade test, sqlupgrade displays:
Server SERVER_NAME failed preupgrade eligibility test.
See log for more information.