Cisco Unity Reconfiguration and Upgrade Guide (With IBM Lotus Domino)
Changing the Domino Server

Table Of Contents

Changing the Domino Server

Changing the Domino Server Specified in the Subscriber Address Book Settings for Cisco Unity 4.0(5) and Later

Changing the Domino Server Specified in the Primary Subscriber Address Book Settings for Cisco Unity 4.0(4) and Earlier

Changing the Domino Server to Which Cisco Unity Sends Voice Messages


Changing the Domino Server


When you installed Cisco Unity, you chose a Domino server and directory database (or address book) to be used as the primary subscriber address book in which Cisco Unity stores data and from which subscribers and distribution lists are imported. By default, Cisco Unity also sends all voice messages to the Domino server that you specified during installation, to be routed to the Domino servers on which Cisco Unity subscribers are homed. Use the sections in this chapter to change either of the server settings—for example, if you plan to replace the Domino server that you originally specified during installation.

This chapter contains the following sections:

Changing the Domino Server Specified in the Subscriber Address Book Settings for Cisco Unity 4.0(5) and Later

Changing the Domino Server Specified in the Primary Subscriber Address Book Settings for Cisco Unity 4.0(4) and Earlier

Changing the Domino Server to Which Cisco Unity Sends Voice Messages

Changing the Domino Server Specified in the Subscriber Address Book Settings for Cisco Unity 4.0(5) and Later


Caution Most Cisco Unity features do not work while you are making these changes. Do not do the procedures in this section during regular business hours.

Do the four procedures in this section in the order listed to change the Domino server that Cisco Unity uses for importing subscribers and lists from the primary subscriber address book, and that it monitors for changes to the Domino directory.

In Cisco Unity 4.0(5) and later, you can add one additional (secondary) subscriber address book, and up to eight monitored address books, by using the Cisco Unity Administrator. The procedures in this section will also alter the server name on any subscriber or monitored address books that use the server name that you are changing.

If Cisco Unity is configured for failover, do the procedures on the primary Cisco Unity server first. The procedures alert you when to switch to the secondary Cisco Unity server.

To Change Cisco Unity Person Records in the Domino Directory


Step 1 If Cisco Unity is not currently running, start it.

Step 2 Start Domino Administrator.

Step 3 Open the Unity Messaging person record.

Step 4 Change the value of the Mail Server field to the name of the new Domino server that Cisco Unity uses to access the primary subscriber address book. Include any OUs and the organization, if required. Use the format <ServerName>/<OU>/.../<Organization>.

Step 5 Save the change, and close the record.

Step 6 Repeat Step 3 through Step 5 for the Example Administrator person record.

Step 7 Repeat Step 3 through Step 5 for the Example Subscriber person record, if applicable. (In Cisco Unity 4.0(3), the Example Subscriber person record was eliminated; however, you may still have an Example Subscriber person record if you upgraded from an earlier version of Cisco Unity, as the account is not removed during the upgrade process.)

Step 8 Wait for or force the changes to replicate to replicas of the directory throughout the domain.


Cisco Unity monitors the Domino directory for changes, and replicates those changes in the SQL Server or MSDE database on the Cisco Unity server. The changes you made to the Domino directory in the preceding procedure must replicate to the Cisco Unity database before you can continue changing the Domino server that Cisco Unity uses to access the primary subscriber address book. The following procedure confirms that the changes have replicated.

To Confirm that Changes to the Domino Directory Have Replicated to the Cisco Unity Database


Step 1 Start the Cisco Unity Administrator.

Step 2 On the Subscriber pages, find and display information on the Example Administrator account.

Step 3 At the bottom of the Profile page, under Domino Information, confirm that the value of the Server field is the name of the new Domino server that Cisco Unity uses to access the primary subscriber address book. (You entered this value in the preceding procedure.)

Step 4 Close the Cisco Unity Administrator.


To Change the Domino Server Used to Access the Subscriber Address Book(s)


Step 1 Exit the Cisco Unity software.

Step 2 On the Windows Start menu, click Run.

Step 3 Run cmd.

Step 4 Start OSQL by entering OSQL -E on the command line.


Caution Use -E, not -e.

Step 5 Enter
use UnityDb
and press Enter.

Step 6 Enter
go
and press Enter.

Step 7 To check the existing Domino server name, enter
SELECT Server from DominoAddressBook
WHERE Type = 7
go
and press Enter. The name of the server is returned in the output.

Step 8 To change the Domino server name, enter
UPDATE DominoAddressBook
SET Server = '<New server name>'
WHERE Server = '<Old server name>'
go
and press Enter.

Step 9 Enter
exit
and press Enter to close OSQL.

Step 10 Restart the Cisco Unity server.

Step 11 If Cisco Unity is configured for failover, continue with the next procedure, "To Confirm Replication and Restart the Secondary Cisco Unity Server."


In a failover configuration, once the changes you made on the primary server in the preceding procedure have replicated to the secondary server, the secondary server must be restarted. Use the following procedure to confirm that the changes have replicated, and then restart the secondary server.

To Confirm Replication and Restart the Secondary Cisco Unity Server


Step 1 On the secondary server, start the Cisco Unity Administrator.

Step 2 Go to the System > Configuration > Subscriber Address Books page.

Step 3 Under Primary Address Book, confirm that the value of the Domino Server field is the name of the new Domino server that Cisco Unity uses to access the primary subscriber address book. If a secondary subscriber address book has been configured with the same Domino server, the server name should also be updated under Secondary Address Book.

Step 4 Close the Cisco Unity Administrator.

Step 5 Once you have confirmed the replication, restart the secondary Cisco Unity server.


Changing the Domino Server Specified in the Primary Subscriber Address Book Settings for Cisco Unity 4.0(4) and Earlier


Caution Most Cisco Unity features do not work while you are making these changes. Do not do the procedures in this section during regular business hours.

Do the three procedures in this section in the order listed to change the Domino server that Cisco Unity uses for importing subscribers and lists from the primary subscriber address book, and that it monitors for changes to the Domino directory.

If Cisco Unity is configured for failover, do the procedures on the primary Cisco Unity server first. The procedures alert you when to do them on the secondary Cisco Unity server.

To Change Cisco Unity Person Records in the Domino Directory


Step 1 If Cisco Unity is not currently running, start it.

Step 2 Start Domino Administrator.

Step 3 Open the Unity Messaging person record.

Step 4 Change the value of the Mail Server field to the name of the new Domino server that Cisco Unity uses to access the primary subscriber address book. Include any OUs and the organization, if required. Use the format <ServerName>/<OU>/.../<Organization>.

Step 5 Save the change, and close the record.

Step 6 Repeat Step 3 through Step 5 for the Example Administrator person record.

Step 7 Repeat Step 3 through Step 5 for the Example Subscriber person record, if applicable. (In Cisco Unity 4.0(3), the Example Subscriber person record was eliminated; however, you may still have an Example Subscriber person record if you upgraded from an earlier version of Cisco Unity, as the account is not removed during the upgrade process.)

Step 8 Wait for or force the changes to replicate to replicas of the directory throughout the domain.


Cisco Unity monitors the Domino directory for changes, and replicates those changes in the SQL Server or MSDE database on the Cisco Unity server. The changes you made to the Domino directory in the preceding procedure must replicate to the Cisco Unity database before you can continue changing the Domino server that Cisco Unity uses to access the primary subscriber address book. The following procedure confirms that the changes have replicated.

To Confirm that Changes to the Domino Directory Have Replicated to the Cisco Unity Database


Step 1 Start the Cisco Unity Administrator.

Step 2 On the Subscriber pages, find and display information on the Example Administrator account.

Step 3 At the bottom of the Profile page, under Domino Information, confirm that the value of the Server field is the name of the new Domino server that Cisco Unity uses to access the primary subscriber address book. (You entered this value in the preceding procedure.)

Step 4 Close the Cisco Unity Administrator.


To Change the Domino Server Used to Access the Primary Subscriber Address Book


Step 1 Exit the Cisco Unity software.

Step 2 Start Regedit.


Caution Changing the wrong registry key or entering an incorrect value can cause the server to malfunction. Before you edit the registry, confirm that you know how to restore it if a problem occurs. (Refer to the "Restoring" topics in Registry Editor Help.) If you have any questions about changing registry key settings, contact Cisco TAC.

Step 3 If you do not have a current backup of the registry, click Registry > Export Registry File, and save the registry settings to a file.

Step 4 Expand the key
HKEY_LOCAL_MACHINE\Software\Active Voice\Directory Connectors\DirSynchDomino\1.00\
Mail Servers\AddressBook1.

Step 5 Double-click ServerName, and change the Value field to the name of the new Domino server that Cisco Unity uses to access the primary subscriber address book. Include any OUs and the organization, if required. Use the format <ServerName>/<OU>/.../<Organization>.

Step 6 Expand the key
HKEY_LOCAL_MACHINE\Software\Active Voice\Directory Connectors\DirSynchDomino\1.00\
Monitored Servers\AddressBook1.

Step 7 Double-click ServerName, and change the Value field to the name of the new Domino server that Cisco Unity uses to access the primary subscriber address book. Include any OUs and the organization, if required. Use the format <ServerName>/<OU>/.../<Organization>.

Step 8 Delete the key LastResynchTime.

Deleting this key causes Cisco Unity to resynchronize the Cisco Unity database with the directory. Depending on the size of the directory, this can take several minutes to an hour or more.

Step 9 Shut down and restart the Cisco Unity server.

Step 10 If Cisco Unity is configured for failover, do Step 1 through Step 9 on the secondary Cisco Unity server.


Changing the Domino Server to Which Cisco Unity Sends Voice Messages

Cisco Unity sends all voice messages to one Domino server to be routed to the Domino servers on which Cisco Unity subscribers are homed. The procedure in this section changes the Domino server to which Cisco Unity sends messages for routing to Domino mailboxes.


Note The Domino server to which Cisco Unity sends messages for routing does not need to be the same server as the Domino server that Cisco Unity uses to access the primary subscriber address book. The procedure is optional.


If Cisco Unity is configured for failover, do the procedure on the primary Cisco Unity server first. The procedure alerts you when to do it on the secondary Cisco Unity server.

To Change the Domino Server to Which Cisco Unity Sends All Voice Messages


Step 1 Move the Unity Server mail file from the Domino server to which Cisco Unity sends all voice messages to the new Domino server:

a. On the Windows Start menu, click Programs > Lotus Applications > Lotus Domino Administrator.

b. Click the Files tab.

c. In the left pane, click Mail.

d. In the right pane, right-click Unity Server, and click Move.

e. Click the Domino server to which you want Cisco Unity to begin sending all voice messages for routing.

f. Click OK.

Step 2 On the Cisco Unity server, start Lotus Notes.

Step 3 In the lower right corner of the Welcome screen, in the Notes status bar, click the location list, and click Edit Current.


Caution Do not change the current location, or Cisco Unity will stop working.

Step 4 Click the Servers tab.

Step 5 Change the value of the Home/Mail Server field to the name of the new Domino server to which Cisco Unity sends voice messages. Include any OUs and the organization, if required. Use the format <ServerName>/<OU>/.../<Organization>.

Step 6 Click Save and Close.

Step 7 Close Notes.

Step 8 Restart the Cisco Unity server.

Step 9 If Cisco Unity is configured for failover, do Step 1 through Step 8 on the secondary Cisco Unity server.