Users Guide

Troubleshooting Your Application | Troubleshooting
700 OMNM 6.5.3 User Guide
Upgrade/Data Migration Fails
I. Unexpected Database Behavior after Upgrade: If you observe unexpected behavior after an
application upgrade, review installation logs. Confirm evidence appears that the upgrade executed
dbevolve . If not...
Solution: Execute the following steps
1 Shut down the application.
2 Open a shell/command prompt on (the primary) application server.
3 Execute command dbpostinstall .
This step resolves potential database changes between application versions. You must run the
command for both MySql and Oracle database environments too.
II. Upgrade Fails with Database Connection Failure: If an upgrade installation fails with the
message with the
app_setup.log error Connecting to database...>>>>> ERROR:
OWSessionIDRDBMS : Failed to make database connection
, the problem is that the
database is not running on the host being upgraded. To cure this problem, manually start the
database, and then re-try the upgrade installation. The following are the startup commands for the
embedded database:
Windows:
net start mysql
You should see the following response in the shell where you execute this command:
The MySQL service was started successfully.
NOTE:
If you substitute the word stop for start in the above, these commands manually stop the database.
Versions
Before you begin more in-depth troubleshooting, you may need to know what versions of various
components are installed to ensure they are compatible. To see these before installing, consult the
version.txt file in the installation source’s root directory, or after the application is running,
view its
Manage > Show Versions screen. Differences between version.txt and Show Versions
may occur when you install additional applications or patches.
Another way to see the versions for currently installed modules: open a shell (
Start > Run cmd in
Windows, for example), and type
oware ( . /etc/.dsienv in Linux) and [Enter]. Then type
showversions . The currently installed modules and their versions appear in the shell. You can
also use the
Manage > Show Versions menu in web client to find this information.
Search Indexes
Sometimes this software may display Control Panel objects like Users, Roles, and Organizations
inaccurately. This occurs because Search Indexes need to be re-indexed every so often, especially
when changes to Roles, Users and Organizations are frequent.
To re-index go to Control Panel > Server Administration and then click on the
Reindex all search
indexes
. Reindexing is not instantaneous; expect this to take some time.