Upgrade Guide for Cisco Unity Connection Release 7.x
Renaming Cisco Unity Connection 7.x Servers
Downloads: This chapterpdf (PDF - 160.0KB) The complete bookPDF (PDF - 2.41MB) | Feedback

Renaming Cisco Unity Connection 7.x Servers

Table Of Contents

Renaming Cisco Unity Connection 7.x Servers

Renaming a Single 7.x Server Without a Connection Cluster

Renaming the 7.x Publisher Server in a Connection Cluster

Renaming the 7.x Subscriber Server in a Connection Cluster


Renaming Cisco Unity Connection 7.x Servers


This chapter contains the following sections:

Renaming a Single 7.x Server Without a Connection Cluster

Renaming the 7.x Publisher Server in a Connection Cluster

Renaming the 7.x Subscriber Server in a Connection Cluster

Renaming a Single 7.x Server Without a Connection Cluster

Revised May 2009

Do the following tasks to change the host name of a single Connection server without a cluster.

1. If you created and installed an SSL certificate on the server that you are renaming: Create a new certificate signing request, and get a new signed certificate before you begin to rename the server.


Note If you do not get a new signed certificate before you rename the server, when you use web applications to access the Connection server, a security alert displays and explains that there is a problem with the security certificate.


a. Run the CLI command set web-security to assign an alternate host name to the server that you are renaming. See the set web-security command in the applicable Command Line Interface Reference Guide for Cisco Unified Communications Solutions at http://www.cisco.com/en/US/products/ps6509/prod_maintenance_guides_list.html.

b. Create a certificate signing request. Then download the certificate signing request to the server on which you installed Microsoft Certificate Services or another application that issues certificates, or download the request to a server that you can use to send the certificate signing request to an external certification authority (CA). Do the "To Create and Download a Certificate Signing Request" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

c. If you are using Microsoft Certificate Services to export the root certificate and issue the server certificate, do the "To Export the Root Certificate and Issue the Server Certificate (Only When You Are Using Microsoft Certificate Services to Issue the Certificate)" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

If you are using another application to issue the certificate, see the documentation for the application for information on issuing certificates.

If you are using an external CA to issue the certificate, send the certificate signing request to the external CA. When the external CA returns the certificate, continue with Step 2.

2. If Digital Networking is configured, remove the server from the digital network. See the "Using Digital Networking" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.


Caution Re-adding a server to a digital network can be a time-consuming process. Ensure that you thoroughly understand the work required to re-add a server to a digital network before you begin this procedure.

3. Rename the server. Do the "To Rename a Single 7.x Server Without a Connection Cluster" procedure.

4. If you created and installed an SSL certificate on the server that you are renaming: Upload the root certificate and the server certificate to the Connection server. Do the "To Upload the Root and Server Certificates to the Cisco Unity Connection Server" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

5. If you created and installed an SSL certificate on the server that you are renaming: Restart the Connection IMAP Server service so that Connection and the IMAP email clients use the new SSL certificates. Do the "To Restart the Connection IMAP Server Service" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

6. If the server was part of a digital network before you renamed the server: Re-add the server to the digital network. See the "Using Digital Networking" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

To Rename a Single 7.x Server Without a Connection Cluster


Step 1 On a DNS server, change the DNS record of the Connection server to the new host name.

Step 2 Confirm that the DNS change propagates to the server. Log on to the server by using an SSH application, and run the CLI command utils network host <hostname>.

Do not proceed if the new host name does not resolve to the correct IP address.

Step 3 Optional: On the Connection server, change the SMTP domain in Cisco Unity Connection Administration:

a. Expand System Settings > SMTP Configuration, and click Server.

b. Click Change SMTP Domain, and change the value of the SMTP Domain field.

c. Click Save.

Step 4 In Connection Administration, change the host name of the server:

a. Expand System Settings, and click Cluster.

b. Click Find to display a list of servers.

c. Click the host name of the server that you want to rename.

d. On the Server Configuration page, change the value of the Host Name/IP Address field to the new name.

e. Click Save.

Step 5 In Cisco Unified Operating System Administration, change the host name of the server:

a. From the Settings menu, click IP > Ethernet.

b. Change the host name of the Connection server.

c. Click Save. The server automatically restarts.

Step 6 Log on to the server by using an SSH application, and run the CLI command utils system restart to restart the server.


Renaming the 7.x Publisher Server in a Connection Cluster

Revised May 2009

Do the following tasks to change the host name of the publisher server in a Connection cluster.

1. If you created and installed an SSL certificate on the server that you are renaming: Create a new certificate signing request, and get a new signed certificate before you begin to rename the server.


Note If you do not get a new signed certificate before you rename the server, when you use web applications to access the Connection server, a security alert displays and explains that there is a problem with the security certificate.


a. Run the CLI command set web-security to assign an alternate host name to the server that you are renaming. See the set web-security command in the applicable Command Line Interface Reference Guide for Cisco Unified Communications Solutions at http://www.cisco.com/en/US/products/ps6509/prod_maintenance_guides_list.html.

b. Create a certificate signing request. Then download the certificate signing request to the server on which you installed Microsoft Certificate Services or another application that issues certificates, or download the request to a server that you can use to send the certificate signing request to an external certification authority (CA). Do the "To Create and Download a Certificate Signing Request" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

c. If you are using Microsoft Certificate Services to export the root certificate and issue the server certificate, do the "To Export the Root Certificate and Issue the Server Certificate (Only When You Are Using Microsoft Certificate Services to Issue the Certificate)" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

If you are using another application to issue the certificate, see the documentation for the application for information on issuing certificates.

If you are using an external CA to issue the certificate, send the certificate signing request to the external CA. When the external CA returns the certificate, continue with Step 2.

2. If Digital Networking is configured, remove the server from the digital network. See the "Using Digital Networking" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.


Caution Re-adding a server to a digital network can be a time-consuming process. Ensure that you thoroughly understand the work required to re-add a server to a digital network before you begin this procedure.

3. Rename the server. Do the "To Rename the 7.x Publisher Server in a Connection Cluster" procedure.

4. If you created and installed an SSL certificate on the server that you are renaming: Upload the root certificate and the server certificate to the Connection server. Do the "To Upload the Root and Server Certificates to the Cisco Unity Connection Server" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

5. If you created and installed an SSL certificate on the server that you are renaming: Restart the Connection IMAP Server service so that Connection and the IMAP email clients use the new SSL certificates. Do the "To Restart the Connection IMAP Server Service" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

6. If the server was part of a digital network before you renamed the server: Re-add the server to the digital network. See the "Using Digital Networking" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

To Rename the 7.x Publisher Server in a Connection Cluster


Step 1 On a DNS server, change the DNS record of the publisher server to the new host name.

Step 2 Confirm that the DNS change propagates to the publisher server. Log on to the publisher server by using an SSH application, and run the CLI command utils network host <hostname>.

Do not proceed if the new host name does not resolve to the correct IP address.

Step 3 Repeat Step 2 on the subscriber server.

Step 4 Optional: On the publisher server, change the SMTP domain in Cisco Unity Connection Administration:

a. Expand System Settings > SMTP Configuration, and click Server.

b. Click Change SMTP Domain, and change the value of the SMTP Domain field.

c. Click Save.

Step 5 On the publisher server, change the host name of the publisher server in Connection Administration:

a. Expand System Settings, and click Cluster.

b. Click Find to display a list of servers.

c. Click the host name of the server that you want to rename.

d. On the Server Configuration page, change the value of the Host Name/IP Address field to the new name.

e. Click Save.

Step 6 On the subscriber server, change the name by which the subscriber server knows the publisher server:

a. In Cisco Unified Operating System Administration, from the Settings menu, click IP > Publisher.

b. Change the host name of the publisher server.

c. Click Save.

Log on to the subscriber server by using an SSH application, and run the CLI command utils system restart to restart the server.

Step 7 On the publisher server, change the name of the publisher server in Cisco Unified Operating System Administration.

a. From the Settings menu, click IP > Ethernet.

b. Change the host name of the publisher server.

c. Click Save. The publisher server automatically restarts.

d. Wait for the publisher server to finish restarting. When you can log on to Connection Administration on the publisher server, continue with Step 8.

Step 8 Log on to the subscriber server by using an SSH application, and run the CLI command utils system restart to restart the server.

Step 9 Wait for the subscriber server to finish restarting. When you can log on to Connection Administration on the subscriber server, continue with Step 10.

Step 10 On the publisher server, run the CLI command utils dbreplication reset all to reset replication.

Step 11 Wait until the replication reset process is complete. To determine when the process is completed:

a. Log on to Real-Time Monitoring Tool (RTMT) by connecting to the publisher server.

b. On the System menu, click Performance > Open Performance Monitoring.

c. In the right pane, expand Number of Replicates Created and State of Replication, then double-click Replicate_State.

d. In the Object Instances dialog box, click ReplicateCount and click Add.

e. Wait until the value reaches 2.0.

For more information on possible values and their meaning, right-click Replicate_State, and click Counter Description.

f. On the File menu, click Exit to exit RTMT.

Step 12 Log on to the publisher server by using an SSH application, and run the CLI command utils system restart to restart the server.

This command causes the Connection cluster servers to change server status so the publisher server has the Secondary status and the subscriber server has the Primary status.

Step 13 Run the CLI command utils cuc cluster makeprimary <name_of_publisher_server> to change the publisher server to Primary status.


Renaming the 7.x Subscriber Server in a Connection Cluster

Revised May 2009

Use the following task list to change the host name of the subscriber server in a Connection cluster.

1. If you created and installed an SSL certificate on the server that you are renaming: Create a new certificate signing request, and get a new signed certificate before you begin to rename the server.


Note If you do not get a new signed certificate before you rename the server, when you use web applications to access the Connection server, a security alert displays and explains that there is a problem with the security certificate.


a. Run the CLI command set web-security to assign an alternate host name to the server that you are renaming. See the set web-security command in the applicable Command Line Interface Reference Guide for Cisco Unified Communications Solutions at http://www.cisco.com/en/US/products/ps6509/prod_maintenance_guides_list.html.

b. Create a certificate signing request. Then download the certificate signing request to the server on which you installed Microsoft Certificate Services or another application that issues certificates, or download the request to a server that you can use to send the certificate signing request to an external certification authority (CA). Do the "To Create and Download a Certificate Signing Request" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

c. If you are using Microsoft Certificate Services to export the root certificate and issue the server certificate, do the "To Export the Root Certificate and Issue the Server Certificate (Only When You Are Using Microsoft Certificate Services to Issue the Certificate)" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

If you are using another application to issue the certificate, see the documentation for the application for information on issuing certificates.

If you are using an external CA to issue the certificate, send the certificate signing request to the external CA. When the external CA returns the certificate, continue with Step 2.

2. If Digital Networking is configured, remove the server from the digital network. See the "Using Digital Networking" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.


Caution Re-adding a server to a digital network can be a time-consuming process. Ensure that you thoroughly understand the work required to re-add a server to a digital network before you begin this procedure.

3. Rename the server. Do the "To Rename the 7.x Subscriber Server in a Connection Cluster" procedure.

4. If you created and installed an SSL certificate on the server that you are renaming: Upload the root certificate and the server certificate to the Connection server. Do the "To Upload the Root and Server Certificates to the Cisco Unity Connection Server" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

5. If you created and installed an SSL certificate on the server that you are renaming: Restart the Connection IMAP Server service so that Connection and the IMAP email clients use the new SSL certificates. Do the "To Restart the Connection IMAP Server Service" procedure in the "Creating and Installing an SSL Server Certificate" section in the "Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection" chapter of the System Administration Guide for Cisco Unity Connection Release 7.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/7x/administration/guide/7xcucsagx.html.

To Rename the 7.x Subscriber Server in a Connection Cluster


Step 1 On a DNS server, change the DNS record of the subscriber server to the new host name.

Step 2 Confirm that the DNS change propagates to the publisher server. Log on to the publisher server by using an SSH application, and run the CLI command utils network host <hostname>.

Do not proceed if the new host name does not resolve to the correct IP address.

Step 3 Repeat Step 2 on the subscriber server.

Step 4 On the publisher server, change the name by which the publisher server knows the subscriber server:

a. In Cisco Unity Connection Administration, expand System Settings, and click Cluster.

b. Click Find to display a list of servers.

c. Click the host name of the subscriber server.

d. On the Server Configuration page, change the value of the Host Name/IP Address field to the new name.

Step 5 On the subscriber server, change the name of the subscriber server in Cisco Unified Operating System Administration.

a. From the Settings menu, click IP > Ethernet.

b. Change the host name of the publisher server.

c. Click Save. The subscriber server automatically restarts.

Step 6 Log on to the publisher server by using an SSH application, and run the CLI command utils system restart to restart the server.

Step 7 On the publisher server, run the CLI command utils dbreplication reset all to reset replication.

Step 8 Log on to the publisher server by using an SSH application, and run the CLI command utils system restart to restart the server a second time.