The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter explains following procedures that can be performed on a Cisco Unity Connection server
Follow the given tasks to migrate from physical server to a virtual machine:
– To replace the publisher server, see the Replacing a Publisher Server section.
– To replace the subscriber server, see the Replacing a Subscriber Server section.
Note If you are deploying Unity Connection networking (Intersite, Intrasite, or HTTPS), see the Networking Guide for Cisco Unity Connection, Release 10.x, before replacing the Unity Connection server, available at http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/10x/networking/guide/10xcucnetx.html.
While you are upgrading the publisher server in a Unity Connection cluster, the subscriber server continues to provide services to the users and callers.
Note In case of a standalone server, replace the server during off-peak hours to avoid call-processing interruptions and impact to services.
Step 1 Manually change the status of subscriber server to Primary:
a. Sign in to Cisco Unity Connection Serviceability.
b. Expand Tools and select Cluster Management.
c. On the Cluster Management page, from the Server Manager menu, locate the subscriber server and check the following:
Step 2 Manually change the status of publisher server to Deactivated:
a. Sign in to the Real-Time Monitoring Tool and select Port Monitor.
b. In the Node field, select the publisher server and then select Start Polling. Note whether any voice messaging ports are currently handling calls for the server.
c. Return to the Cluster Management page of Cisco Unity Connection Serviceability and do any one of th following:
d. From the Server Manager menu, in the Change Server Status column for the publisher server, select Deactivate and then select OK.
Step 3 Install the replacement publisher server, see Installing the Publisher Server section.
a. Shut down the publisher server using the CLI command utils system shutdown. On the Cluster Management page of the subscriber server, the publisher has Not Functioning status.
b. Install the virtual machine. The following settings on the virtual machine must be same as that on the physical server, otherwise the transfer of data from the physical server to the virtual machine will fail:
Step 4 Configure the cluster on the replaced publisher server:
a. Sign in to Cisco Unity Connection Administration on the publisher server.
b. Expand System Settings and select Cluster.
c. On the Find and List Servers page, select Add New.
d. On the New Server Configuration page, in the Hostname/IP Address field, enter the hostname or IP address of the subscriber server. Enter the description and select Save.
Step 5 If Unity Connection is installed as a cluster, you can restore the publisher using the subscriber data.
a. Run the utils cuc cluster renegotiate CLI command on the subscriber server. The publisher automatically restarts after running this command.
b. Run the show cuc cluster status CLI command on the subscriber server to confirm that the new Unity Connection cluster is configured correctly.
Note If third-party certificates are deployed in Unity Connection then after successfully replacing the publisher server, you must reconfigure third party certificates for the newly build publisher server. For information on how to configure the certificates, see Security chapter of Cisco Unified Communications Operating System Administration Guide for Cisco Unity Connection Release 10.x available at https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/10x/os_administration/guide/10xcucosagx.html
While you are upgrading the subscriber server in a Unity Connection cluster, the publisher server continues to provide services to users and callers.
To Replace a Subscriber Server
Step 1 Manually change the status of publisher server to Primary:
a. Sign in to Cisco Unity Connection Serviceability.
b. Expand Tools and select Cluster Management.
c. On the Cluster Management page, from the Server Manager menu, locate the publisher server and check the following:
Step 2 Manually change the status of subscriber server to Deactivated:
a. Sign in to the Real-Time Monitoring Tool, expand <Unity Connection> option and select Port Monitor.
b. In the Node field, select the subscriber server and select Start Polling. Note whether any voice messaging ports are currently handling calls for the server.
c. Return to the Cluster Management page of Cisco Unity Connection Serviceability.
d. From the Server Manager menu, in the Change Server Status column for the subscriber server, select Deactivate and select OK.
Step 3 Make sure that the hostname or IP address of the subscriber server is configured correctly on the publisher server as mentioned in Step 4 of replacing a publisher server.
Step 4 Install the replaced subscriber server, see Installing the Subscriber Server section.
a. Shut down the subscriber server using the CLI command utils system shutdown. On the Cluster Management page of the publisher server, the subscriber has Not Functioning status.
b. Reinstall the Unity Connection server. You must specify the same security password of the subscriber server that you are replacing and it should also match the security password for the publisher server. Otherwise, the Unity Connection cluster will not function. If you do not know the security password, you can change it on the publisher server before you install the subscriber server using the CLI command set password user.
Step 5 Check the cluster status by running the show cuc cluster status CLI command on the subscriber server.
Note If third-party certificates are deployed in Unity Connection then after successfully replacing the subscriber server, you must reconfigure third party certificates for the newly build subscriber server. For information on how to configure the certificates, see Security chapter of Cisco Unified Communications Operating System Administration Guide for Cisco Unity Connection Release 10.x available at https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/10x/os_administration/guide/10xcucosagx.html
To Migrate from Cisco Unity 4.x and Later to Unity Connection 7.x and Later
Step 1 If you are running the current version of Cisco Unity on a physical server then you must replace it with a virtual machine. For more information, see the Migrating a Physical Server to a Virtual Machine section.
However, if you are already running the current version on a virtual machine, make sure it is compatible with the upgraded version. See the Cisco Unity Connection 10.x Supported Platform List at http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/10x/supported_platforms/10xcucspl.html.
Step 2 Migrate the Cisco Unity licenses to a virtual machine. To migrate the licenses, a user sends a license request to the Cisco licensing support. The content for the requested license file is analyzed and an appropriate license file is sent back to the user, which is further installed on the Unity Connection server.
Step 3 Download the following tools:
Step 4 If you want to use the Migration Export tool and if you do not have a secure shell (SSH) server application installed on a server that is accessible to the Cisco Unity server, then install an SSH server application. The migration tool imports Cisco Unity data into Unity Connection 10.x that uses SSH to access the exported user data and messages.
Step 5 (Optional) Use the Migration Export tool to export Cisco Unity data and messages. The data exported through the tool is required only if COBRAS fails for some reason.
Step 6 If you have a secure shell (SSH) server application installed on a server that is accessible to the Cisco Unity server, export the data to the SSH server. If you do not have an SSH server, you can export data to any network location. You can set up an SSH server later if necessary.
Step 7 Use COBRAS to export Cisco Unity data and, optionally, messages. For more information, see Help for the tool at http://www.ciscounitytools.com/Applications/General/COBRAS/COBRAS.html.
Step 8 Install and configure Unity Connection 10.x. For more information, see Installing Cisco Unity Connection chapter.
Step 9 Restore Cisco Unity data on the Unity Connection server using COBRAS Import tool.
Table 5-1 Replacing the Non-Functional Server
|
|
---|---|
|
|
If Unity Connection is installed as a cluster and publisher is not functioning. |
|
If Unity Connection is installed as a cluster and subscriber is not functioning. |
Install the subscriber server, see the Installing the Subscriber Server section. |
– Replace the subscriber server, see the Installing the Subscriber Server section. – Check the cluster status using CLI command show cuc cluster status. |
Before changing the IP address of a standalone Unity Connection server or a cluster, you need to determine whether the server is defined by hostname or IP address.
Note You can also use Cisco Prime Collaboration Deployment for readdressing. For more information on Cisco PCD, see http://www.cisco.com/c/en/us/products/cloud-systems-management/prime-collaboration/index.html.
To Determine Whether Unity Connection is Defined by Hostname or IP Address
Step 1 Sign in to Cisco Unity Connection Administration of the server of which the IP address needs to be changed.
Step 2 Expand System Settings and select Cluster.
Note You need to select Cluster even if you want to change the IP address or hostname of a standalone server.
Step 3 Select Find to locate the server of which you need to change the IP address or hostname:
1. When you change the IP address or hostname of the Unity Connection server, make sure to apply the same changes on all the associated components that refer the Unity Connection server by IP address or hostname:
2. Bookmarks on client computers to the following web applications:
3. You can change the IP address and hostname of a Unity Connection server or cluster following the steps mentioned in the Changing the IP Address or Hostname of a Unity Connection Server or Cluster section.
4. (Only in case of changing IP address of a Unity Connection server) If the Unity Connection server is configured to get an IP address from a DHCP server, you cannot manually change the IP address of the server. Instead, you must do one of the following:
Note To change the IP address or hostname of a Unity Connection cluster, follow the steps mentioned in the “Changing the IP Address or Hostname of a Unity Connection Server” section first on the publisher server and then on the subscriber server.
Do the following steps to change the IP address or Hostname of a standalone server or a cluster defined by hostname or IP address. In case of a cluster, follow the steps first on the publisher server and then on the subscriber server.
To Change the IP Address of a Standalone or a Cluster Server
Step 1 Sign in to the standalone server or the publisher server using Real-Time Monitoring Tool. Expand Tools> Alert and select Alert Central. In the Systems tab, make sure the ServerDown is black. If ServerDown is red, then resolve all the problems and change it to black. Repeat the same step for the subscriber server (in case of a cluster).
Step 2 Check the server status:
a. Sign in to Cisco Unity Connection Serviceability.
b. Expand Tools and select Cluster Management.
c. On the Cluster Management page, check whether server status is Primary or Secondary. If there is any other status value then resolve the problem.
Step 3 Check the network connectivity and DNS server configuration by running the utils diagnose module validate_network CLI command.
Step 4 Backup the database using Disaster Recovery System. See the “Backing Up and Restoring Cisco Unity Connection Components” chapter.
Step 5 If intrasite, HTTPS, and SRSV networking is configured, remove the server from the Unity Connection site. For instructions, see the Networking Guide for Cisco Unity Connection, Release 10.x, available at http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/10x/networking/guide/10xcucnetx.html.
Step 6 On a DNS server, change the DNS record of the Unity Connection server to the new IP address. Update both the forward (A) and reverse (PTR) records.
Step 7 (Applicable only when you change the IP address or Hostname of a standalone server or a cluster defined by an IP address) Change the IP addresses of a standalone server or the publisher server in Connection Administration:
a. Sign in to Cisco Unity Connection Administration.
b. Expand System Settings, and select Cluster.
c. Select Find to display a list of servers in the cluster.
d. Select the name of the standalone server or publisher server.
e. Change the value of the Hostname/IP Address field to the new IP address.
Step 8 On the standalone or publisher server, change the IP address, Hostname, and default gateway (if applicable):
a. Sign in to Cisco Unified Operating System Administration.
b. From the Settings menu, select IP > Ethernet.
c. In the Host Information, enter the value of Hostname.
d. If you want an alternate hostname for the server, run the set web-security CLI command. In the Hostname, change the hostname of the server.
For more information on the CLI commands, see the applicable version of the Command Line Interface Reference Guide for Cisco Unified Communications Solutions at http://www.cisco.com/en/US/products/ps6509/prod_maintenance_guides_list.html
Note ● For more information on the CLI commands, see the applicable version of the Command Line Interface Reference Guide for Cisco Unified Communications Solutions at http://www.cisco.com/en/US/products/ps6509/prod_maintenance_guides_list.html
e. In the Port Information, change the value of the IP Address and Subnet Mask field (if applicable).
f. If you are moving the server to a different subnet that requires a new default gateway address, change the value of the Default Gateway field in the Gateway Information.
Step 9 If you change the IP address or Hostname of a standalone server, skip to Step 10. (Applicable only when you change the IP address or Hostname of a publisher server in case of a cluster) On the subscriber server, change the IP address of the publisher server:
a. Sign in to Cisco Unified Operating System Administration.
b. From the Settings menu, select IP > Publisher.
c. Change the IP address of the publisher server.
Step 10 Sign in to Real-Time Monitoring Tool and confirm that the server is available and running.
This completes the process of changing the IP address of the standalone server.
Step 11 For the cluster, repeat Step 1 to Step 9 on subscriber server also.
This completes the process of changing the IP address of a cluster.
After installing a new server or on an existing server, you may need to add some new language(s) and remove some already installed languages depending on the user requirement.
Note Languages are not licensed and Unity Connection 10.x does not enforce a limit on the number of languages you can install and use. However, the more languages you install, the less hard disk space is available for storing voice messages.
Do the following tasks to download and install languages in addition to English (United States):
1. Download the Unity Connection languages that you want to install and do the following steps:
a. Sign in as a registered user on the following Cisco.com link https://software.cisco.com/download/navigator.html?mdfid=280082558 :
b. Expand Unified Communications Applications > Voicemail and Unified Messaging > Cisco Unity Connection, and select the applicable Unity Connection version.
c. On the Select a Software Type page, select Cisco Unity Connection Locale Installer.
d. On the Select a Release page, select the applicable Unity Connection version. The download links for the languages appear on the right side of the page.
e. Select the name of a file to download. On the Download Image page, note down the MD5 value and follow the on screen prompts to complete the download.
Note Make sure that the MD5 checksum matches the checksum that is listed on Cisco.com. If the values do not match, the downloaded file is damaged. Do not attempt to use a damaged file to install software as the results will be unpredictable. If the MD5 values do not match, download the file again until the value for the downloaded file matches the value listed on Cisco.com.
2. (Unity Connection cluster only) Make sure that the subscriber server status is Primary and the publisher server status is Secondary in order to install the Unity Connection languages. Follow the given steps:
a. Sign in to Cisco Unity Connection Serviceability.
b. Expand Tools and select Cluster Management.
c. For subscriber server, select Make Primary.
3. On the standalone or publisher server, install the Unity Connection languages that you downloaded. Do any one of the following:
4. If you are using additional languages because you want the Cisco Personal Communications Assistant to be localized: Download and install the corresponding Unity Connection locales on the publisher server.
5. (Unity Connection cluster only) Change the publisher server status to Primary and follow the same steps on subscriber server to install the same Unity Connection languages that were installed on publisher server.
You can install language files on the Unity Connection server either through CD/DVD or by accessing the files through a remote source. See the following sections:
To Install Unity Connection Language Files from a Disk
Step 1 Stop the Connection Conversation Manager and Connection Mixer services:
a. Sign in to Cisco Unity Connection Serviceability. Expand the Tools menu and select Service Management.
b. From the Critical Services menu, in the Connection Conversation Manager row, select Stop.
c. Wait for the service to stop.
d. From the Critical Services menu, in the Connection Mixer row, select Stop.
e. Wait for the service to stop.
Step 2 Insert the languages disk in the disk drive.
Step 3 Sign in to Cisco Unified Operating System Administration.
Step 4 From the Software Upgrades menu, select Install/Upgrade. The Software Installation/Upgrade window appears.
Step 5 In the Source list, select DVD/CD.
Step 6 In the Directory field, enter the path of the folder that contains the language file.
If the language file is in the root folder or if you created an ISO image DVD, enter a slash (/) in the Directory field.
Step 7 To continue the installation of language files, select Next.
Step 8 Select the language that you want to install, and select Next.
Step 9 Monitor the progress of the download.
Step 10 If you want to install another language: Select Install Another, and repeat all the steps.
If you are finished with installing languages: Restart the services:
a. Sign in to Cisco Unity Connection Serviceability.
b. Expand the Tools menu and select Service Management.
c. In the Critical Services menu, in the Connection Conversation Manager row, select Start.
d. Wait for the service to start.
e. In the Critical Services menu, in the Connection Mixer row, select Start.
f. Wait for the service to start.
Note You need to restart Cisco Tomcat service after you have installed language file from a disk.
In this procedure, do not use the web browser controls (for example, Refresh/Reload) while accessing Cisco Unified Operating System Administration. However, you can use the navigation controls in the administration interface.
To Install Unity Connection Language Files from a Network Location or from a Remote Server
Step 1 Stop the Connection Conversation Manager and Connection Mixer services:
a. Sign in to Cisco Unity Connection Serviceability. Expand Tools menu and select Service Management.
b. In Critical Services, for the Connection Conversation Manager row, select Stop.
c. Wait for the service to stop.
d. In the Critical Services menu, in the Connection Mixer row, select Stop.
e. Wait for the service to stop.
Step 2 Sign in to Cisco Unified Operating System Administration.
Step 3 From the Software Upgrades menu, select Install/Upgrade. The Software Installation/Upgrade window appears.
Step 4 In the Source list, select Remote Filesystem.
Step 5 In the Directory field, enter the path of the folder that contains the language file on the remote system.
If the language file is located on a Linux or Unix server, you must enter a forward slash at the beginning of the folder path. (For example, if the language file is in the languages folder, you must enter /languages.)
If the language file is located on a Windows server, make sure that you are connecting to an FTP or SFTP server, and use the appropriate syntax:
Step 6 In the Server field, enter the server name or IP address.
Step 7 In the User Name field, enter your user name on the remote server.
Step 8 In the User Password field, enter your password on the remote server.
Step 9 In the Transfer Protocol list, select the applicable option.
Step 11 Select the language that you want to install, and select Next.
Step 12 Monitor the progress of the download.
Note If you loose your connection with the server or close your browser during the installation process, you may see the following message when you try to access the Software Upgrades menu again:
Warning: Another session is installing software, click Assume Control to take over the installation.
If you are sure you want to take over the session, select Assume Control.
Step 13 If you want to install another language, : Select Install Another, and repeat all the above steps.
Step 14 If you are finished with installing languages: Restart the services:
a. Sign in to Cisco Unity Connection Serviceability.
b. Expand Tools menu and select Service Management.
c. In the Critical Services menu, in the Connection Conversation Manager row, select Start. Wait for the service to start.
d. In the Critical Services menu, in the Connection Mixer row, select Start. Wait for the service to start.
Note You need to restart Cisco Tomcat service after you have installed language file from a disk.
To Remove a Unity Connection Language File
Step 1 Sign in to the command line interface as a platform administrator.
Note Make sure to stop Connection Conversation Manager and Connection Mixer services before uninstalling the languages.
Step 2 Run the show cuc locales CLI command to display a list of installed language files.
Step 3 In the command results, find the language that you want to remove, and note the value of the Locale column for the language.
Step 4 Run the delete cuc locale <code> CLI command to remove the language, where <code> is the value of the Locale column that you get in Step 3.
When the command completes, the following information appears: