Created On:  01 November 2010

Problem:

CaliberRM server fails to start successfully after a change is made to the machine's hostname.  Are there changes required to CaliberRM Server's configuration when the machine's hostname is changed?

Resolution:

Yes, changes to CaliberRM Server settings are required. Please follow the steps below when changing the machine's hostname to ensure a smooth transition:

1. Stop CaliberRM server and perform a full backup of the CaliberRM Database.

2. Set the services 'SQM Database' and 'SQM Monitor' to 'Manual' startup. (The default value of 'Automatic' will cause the CaliberRM Server processes to start when the machine is rebooted. And caliber_srv.exe will fail to start.)

3. Change the machine's hostname and restart the machine.

4. Navigate to "Start" || "Control Panel" || "CaliberRM Server Settings".

5. Select the tab "Global Properties".

6. Update text field "Database Server" to the new hostname. Click on button "Apply".

7. Select the tab "MPX". 

8. If checkbox "Enabled" is checked, update text field "Broker Name" to the new hostname and click on the button "Apply".

9. To verify that the changes are applied successfully, examine the following registry keys (the latter is required only if MPX is enabled):

"HKEY_LOCAL_MACHINE\SOFTWARE\Borland\CaliberRM\x.0\Server\Versant\server"

"HKEY_LOCAL_MACHINE\SOFTWARE\Borland\CaliberRM\x.0\Server\MPX\Broker"

10. Modify the value of the system environment variable, VERSANT_DBID_NODE, to the new hostname.

Verify by running the command "oscp -i" to ensure that the environment variable "Versant osc-dbid node name" is now showing the new hostname.

11. If the database has not been deleted, you may restart the database by executing the command 'startdb SQMDB'.

12. Once the database is started successfully, proceed to start the CaliberRM server processes  using 'dbmgr -start'.

If you have deleted the CaliberRM database, you will need additional steps as shown below to restore the database.

i. Create a new database using the following command:
makedb -g SQMDB

If you encounter the error, "E7104: UT_ER_NO_DBID", then you will need to execute the command "dbid -N" to create a new osc-dbid file before running 'makedb -g SQMDB' again.

ii. Restore the database backup taken in Step 1 using the following command:
vbackup -dev [FULL path to database backup] -restore SQMDB

iii. When database is restored, execute step 11 and 12 to start the CaliberRM server processes.
Incident #2459937