Admin Troubleshooting Guide

The following are some common problems and suggestions for fixing them. Please check the Applibase web site for updated versions of this page, if you do not find a solution here.

I changed the administrator password and now the server does not restart

Changing the password for the startup user, i.e. the username/password configured to startup the DataCaster server, causes server startup to fail. The new password needs to be made available for startup using the StoreStartupPasswd tool, which stores a masked version of teh password in the stpasswd file. Alternately, a plain text password may also be entered in the stpasswd file.

The database does not startup, and reports an Index needs repair

Occasionally when the server crashes in the middle of some activity, the index files can be corrupted and unusable. In such cases, the index will need to be repaired to create a new index file to be used by the database. You will need to use the IndexRepair tool to fix the index with the problem before you can use the database again. In most cases, all the lost data will be recovered, but it is possible to have some index pages completely lost. Therefore, it is important to have backups to minimize potential fo rloss of data.

Indexes in the DEFINITION_SCHEMA are slightly different from the normal indexes in other schemas. Usually index repair of DEFINITION_SCHEMA indexes is automatically performed when the database restarts. However, in some cases, e.g. repeated failures, you will need to run index repair on the definition schema files.