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

Table of Contents

Renaming Cisco Unity Connection 10.x Servers

Task List for Renaming a Single 10.x Server Without a Unity Connection Cluster

Changing the Hostname of a Single 10.x Server Without a Unity Connection Cluster

Task List for Renaming the Publisher Server in a Unity Connection 10.x Cluster

Changing the Hostname of the Publisher Server in a Unity Connection 10.x Cluster

Task List for Renaming the Subscriber Server in a Unity Connection 10.x Cluster

Changing the Hostname of the Subscriber Server in a Unity Connection 10.x Cluster

Task List for Renaming a Single 10.x Server Without a Unity 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 Unity 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 hostname to the server that you are renaming. For more information, see 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” subsection in the “Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection” section in the “Configuring SSL in Cisco Unity Connection 10.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/administration/guide/10xcucsagx.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” subsection in the “Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection” section in the “Configuring SSL in Cisco Unity Connection 10.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/administration/guide/10xcucsagx.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 the server that you are renaming is a member server in a Unity Connection networking site (the server is not a site gateway): Remove the server from the site. See the “Removing a Location From a Cisco Unity Connection 10.x Site” section in the “Making Changes to the Networking Configuration in Cisco Unity Connection 10.x” chapter of the Networking Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/networking/guide/10xcucnetx.html .

3. Change the hostname of the server. See the “Changing the Hostname of a Single 10.x Server Without a Unity Connection Cluster” section.

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 Unity 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” subsection in the “Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection” section in the “Configuring SSL in Cisco Unity Connection 10.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/administration/guide/10xcucsagx.html .

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

6. If the server was a member server in a Unity Connection networking site before you renamed the server : Re-add the server to the site. See the “Setting up a Cisco Unity Connection Site” section in the “Setting Up Networking Between Cisco Unity Connection 10.x Servers” chapter of the Networking Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/networking/guide/10xcucnetx.html .


Note Verify that replication between locations in the site has completed before continuing with the rest of the task list.


7. Back up the server by using the Disaster Recovery System. See the Disaster Recovery System Administration Guide for Cisco Unity Connection Release 10.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/drs_administration/guide/10xcucdrsag.html .

8. If HTTPS networking is configured, update the directly connected nodes in HTTPS Network. For more information on updating the directly connected nodes, see the Updating the directly connected nodes in HTTPS Networking for IP or Hostname Change section.

Changing the Hostname of a Single 10.x Server Without a Unity Connection Cluster

To Change the Hostname of a Single 10.x Server Without a Unity Connection Cluster


Step 1 On a DNS server, change the DNS record of the Unity Connection server to the new hostname.

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

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

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

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

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

c. Select Save .

Step 4 Optional: In Unity Connection Administration, change the networking display name of the server:

a. Expand System Settings, and select Cluster.

b. Select Find to display the server.

c. Select the hostname of the server that you want to rename.

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

e. Select Save .

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

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

b. Change the hostname of the Unity Connection server.

c. Select Save . The server automatically restarts.

Step 6 In Cisco Unified Operating System Administration, change the hostname of the server:

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

b. Change the hostname of the Unity Connection server.

c. Select Save.

d. The server restarts automatically. Proceed with Step 7 once the server is back to running state.

Step 7 Navigate to Cisco Unified Operating System Administration, and check if the old hostname of the server is replaced by the new hostname.


 

Task List for Renaming the Publisher Server in a Unity Connection 10.x Cluster

The following procedure uses the CLI command set web-security to specify the new server name as the alternate host name for the server. This allows you to continue using the original name for the server while you send the certificate signing request (which will contain both the current name and the new, alternate name) to a certificate authority and wait for the certificate to be returned. If you want to use SSL, and if you want to use the CLI command set web-security to specify a shared alternate name to the two servers in a cluster, you can omit Task 1.a., and you can do the remainder of Task 1.a. after you rename the server, in Task 3. (When the two servers have a shared alternate name, you can configure DNS to automatically reroute client requests to the other server when one server is unavailable.) However, until you install the new certificate, clients will receive certificate warnings because the name of the server does not match the name in the old SSL certificate.

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 Unity 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 and, for the alternatehostname parameter, specify the new name for the server. For more information, see 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” subsection in the “Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection” section in the “Configuring SSL in Cisco Unity Connection 10.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/administration/guide/10xcucsagx.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” subsection in the “Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection” section in the “Configuring SSL in Cisco Unity Connection 10.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/administration/guide/10xcucsagx.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 the server that you are renaming is a member server in a Unity Connection networking site (the server is not a site gateway): Remove the server from the site. See the “Removing a Location From a Cisco Unity Connection 10.x Site” section in the “Making Changes to the Networking Configuration in Cisco Unity Connection10.x” chapter of the Networking Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/networking/guide/10xcucnetx.html .


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

3. Change the hostname of the server. See the “Changing the Hostname of the Publisher Server in a Unity Connection 10.x Cluster” section.

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 Unity 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” subsection in the “Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection” section in the “Configuring SSL in Cisco Unity Connection 10.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/administration/guide/10xcucsagx.html .

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

6. If the server was a member server in a Unity Connection networking site before you renamed the server : Re-add the server to the site. See the “Setting up a Cisco Unity Connection Site” section in the “Setting Up Networking Between Cisco Unity Connection 10.x Servers” chapter of the Networking Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/networking/guide/10xcucnetx.html .

7. Back up the server by using the Disaster Recovery System. See the Disaster Recovery System Administration Guide for Cisco Unity Connection Release 10.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/drs_administration/guide/10xcucdrsag.html .

8. If HTTPS networking is configured, update the directly connected nodes in HTTPS Network. For more information on updating the directly connected nodes, see the Updating the directly connected nodes in HTTPS Networking for IP or Hostname Change section.

Changing the Hostname of the Publisher Server in a Unity Connection 10.x Cluster

To Change the Hostname of the Publisher Server in a Unity Connection 10.x Cluster


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

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

Do not proceed if the new hostname 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 (this change is automatically replicated to the subscriber server):

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

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

c. Select Save .

Step 5 Optional: On the publisher server, change the networking display name of the server in Unity Connection Administration:

a. Expand Networking , and select Locations .

b. Select the display name of the server that you want to rename.

c. On the Edit Location page, change the value of the Display Name field to the new name. (This field is for display purpose only and need not match the server hostname.)

d. Select Save .

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

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

b. Change the hostname of the publisher server.

c. Select Save . The publisher server automatically restarts.

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

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

b. On the System menu, select 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, select ReplicateCount and select Add .

e. Wait until the value reaches 2.0 .

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

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


 

Task List for Renaming the Subscriber Server in a Unity Connection 10.x Cluster

The following procedure uses the CLI command set web-security to specify the new server name as the alternate host name for the server. This allows you to continue using the original name for the server while you send the certificate signing request (which will contain both the current name and the new, alternate name) to a certificate authority and wait for the certificate to be returned. If you want to use SSL, and if you want to use the CLI command set web-security to specify a shared alternate name to the two servers in a cluster, you can omit Task 1.a., and you can do the remainder of Task 1.a. after you rename the server, in Task 2. (When the two servers have a shared alternate name, you can configure DNS to automatically reroute client requests to the other server when one server is unavailable.) However, until you install the new certificate, clients will receive certificate warnings because the name of the server does not match the name in the old SSL certificate.

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 Unity 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 and, for the alternatehostname parameter, specify the new name for the server. For more information, see 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” subsection in the “Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection” section in the “Configuring SSL in Cisco Unity Connection 10.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/administration/guide/10xcucsagx.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” subsection in the “Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection” section in the “Configuring SSL in Cisco Unity Connection 10.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/administration/guide/10xcucsagx.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.

2. Change the hostname of the server. See the “Changing the Hostname of the Subscriber Server in a Unity Connection 10.x Cluster” section.

3. 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 Unity 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” subsection in the “Securing Cisco PCA and IMAP Email Client Access to Cisco Unity Connection” section in the Configuring SSL in Cisco Unity Connection 10.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/administration/guide/10xcucsagx.html .

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

5. Back up the server by using the Disaster Recovery System. See the Disaster Recovery System Administration Guide for Cisco Unity Connection Release 10.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/drs_administration/guide/10xcucdrsag.html .

Changing the Hostname of the Subscriber Server in a Unity Connection 10.x Cluster

To Change the Hostname of the Subscriber Server in a Unity Connection 10.x Cluster


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

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

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

Step 3 Repeat Step 2 on the subscriber server.On the subscriber server, change the name of the subscriber server in Cisco Unified Operating System Administration.

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

b. Change the hostname of the publisher server.

c. Select Save . The subscriber server automatically restarts.