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 contains information on how to edit server details for a deployed system. This includes assigning a new node to a cluster, removing a node from a cluster, viewing the presence status and changing server address details.
If you have an up and running system, and you need to make any of the following changes to the server addressing, refer to the procedures in the document Changing the IP Address and Hostname for Cisco Unified Communications Manager and the IM and Presence Service at https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-maintenance-guides-list.html.
This applies to the following types of address changes:
Changing the server IP Address
Changing the server hostname
Changing the node name (for example, if you are using an IP address to define the node name and you want to use a hostname instead).
Changing the default domain for the IM and Presence Service
Follow this procedure if you need to safely remove an IM and Presence Service node from its presence redundancy group and cluster.
 Caution |
Removing a node will cause a service interruption to users on the remaining node(s) in the presence redundancy group. This procedure should only be performed during a maintenance window. |
| Step 1 |
On the page, disable High Availability if it is enabled. |
||
| Step 2 |
On the page, unassign or move all the users off the node that you want to remove. |
||
| Step 3 |
To remove the node from its presence redundancy group, choose Not-Selected from the Presence Server drop down list on the presence redundancy group's Presence Redundancy Group Configuration page. Select OK when a warning dialog box indicates that services in the presence redundancy group will be restarted as a result of unassigning the node.
|
||
| Step 4 |
In Cisco Unified CM Administration, delete the unassigned node from the . Click OK when a warning dialog box indicates that this action cannot be undone. |
||
| Step 5 |
Shut down the host VM or server for the node you have unassigned. |
||
| Step 6 |
Restart the Cisco XCP Router on all nodes. |
If you delete a subsequent node (subscriber) from Cisco Unified Communications Manager Administration and you want to add it back to the cluster, perform the following procedure.
| Step 1 |
In Cisco Unified Communications Manager Administration, add the server by choosing . |
||
| Step 2 |
After you add the subsequent node to Cisco Unified Communications Manager Administration, perform an installation on the server by using the disk that Cisco provided in the software kit for your version.
|
||
| Step 3 |
After you install Cisco UnifiedCM, configure the subsequent node, as described in the installation documentation that supports your version of Cisco UnifiedCM. |
||
| Step 4 |
Access the Cisco Unified Reporting, RTMT, or the CLI to verify that database replication is occurring between existing nodes; if necessary, repair database replication between the nodes. |
Use Cisco Unified Communications Manager Administration to add a new node to a cluster before installing the node. The server type you select when adding the node must match the server type you install.
You must configure a new node on the first node using Cisco Unified Communications Manager Administration before you install the new node. To install a node on a cluster, see the Cisco Unified Communications Manager Installation Guide.
For Cisco Unified Communications Manager Video/Voice servers, the first server you add during an initial installation of the Cisco Unified Communications Manager software is designated the publisher node. All subsequent server installations or additions are designated as subscriber nodes. The first Cisco Unified Communications Manager IM and Presence node you add to the cluster is designated the IM and Presence Service database publisher node.
 Note |
You cannot use Cisco Unified Communications Manager Administration to change the server type after the server has been added. You must delete the existing server instance, and then add the new server again and choose the correct server type setting. |
| Step 1 |
Select . The Find and List Servers window displays. |
| Step 2 |
Click Add New. The Server Configuration - Add a Server window displays. |
| Step 3 |
From the Server Type drop-down list box, choose the server type that you want to add, and then click Next.
|
| Step 4 |
In the Server Configuration window, enter the appropriate server settings. For server configuration field descriptions, see Server Settings. |
| Step 5 |
Click Save. |
Use Cisco Unified Communications Manager Administration to view the status of critical services and self-diagnostic test results for the IM and Presence Service node.
| Step 1 |
Select . The Find and List Servers window appears. |
| Step 2 |
Select the server search parameters, and then click Find. Matching records appear. |
| Step 3 |
Select the IM and Presence server that is listed in the Find and List Servers window. The Server Configuration window appears. |
| Step 4 |
Click on the Presence Server Status link in the IM and Presence Server Information section of the Server Configuration window. The Node Details window for the server appears. |
If you make any system configuration changes, or system upgrades, that require you to disable High Availability and then restart either the Cisco XCP router, Cisco Presence Engine, or the server itself, you must allow sufficient time for Cisco Jabber sessions to be recreated before you enable High Availability. Otherwise, Presence won't work for Jabber clients whose sessions aren't created.
Make sure to follow this process:
| Step 1 |
Before you make any changes, check the Presence Topology window in Cisco Unified CM IM and Presence Administration window (). Take a record of the number of assigned users to each node in each Presence Redundancy Group. |
||||
| Step 2 |
Disable High Availability in each Presence Redundancy Group and wait at least two minutes for the new HA settings to synchronize. |
||||
| Step 3 |
Do whichever of the following is required for your update:
|
||||
| Step 4 |
After the restart, monitor the number of active sessions on all nodes. |
||||
| Step 5 |
For each node, run the |
||||
| Step 6 |
Once all of your sessions are created, you can enable High Availability within the Presence Redundancy Group.
|
The following table lists the locations where you can configure a host name for the Unified Communications Manager server, the allowed number of characters for the host name, and the recommended first and last characters for the host name. Be aware that, if you do not configure the host name correctly, some components in Unified Communications Manager, such as the operating system, database, installation, and so on, may not work as expected.
|
Host Name Location |
Allowed Configuration |
Allowed Number of Characters |
Recommended First Character for Host Name |
Recommended Last Character for Host Name |
|---|---|---|---|---|
|
Host Name/ IP Address field in Cisco Unified Communications Manager Administration |
You can add or change the host name for a server in the cluster. |
2-63 |
alphabetic |
alphanumeric |
|
Hostname field Cisco Unified Communications Manager installation wizard |
You can add the host name for a server in the cluster. |
1-63 |
alphabetic |
alphanumeric |
|
Hostname field in Cisco Unified Communications Operating System |
You can change, not add, the host name for a server in the cluster. |
1-63 |
alphabetic |
alphanumeric |
|
set network hostname hostname Command Line Interface |
You can change, not add, the host name for a server in the cluster. |
1-63 |
alphabetic |
alphanumeric |
 Tip |
The host name must follow the rules for ARPANET host names. Between the first and last character of the host name, you can enter alphanumeric characters and hyphens. |
Before you configure the host name in any location, review the following information:
After you install the Unified Communications Manager publisher node, the host name for the publisher automatically displays in this field. Before you install a Unified Communications Manager subscriber node, enter either the IP address or the host name for the subscriber node in this field on the Unified Communications Manager publisher node.
In this field, configure a host name only if Unified Communications Manager can access the DNS server to resolve host names to IP addresses; make sure that you configure the Cisco Unified Communications Manager name and address information on the DNS server.
Tip |
In addition to configuring Unified Communications Manager information on the DNS server, you enter DNS information during the Cisco Unified Communications Manager installation. |
During the installation of a Unified Communications Manager subscriber node, you enter the hostname and IP address of the Unified Communications Manager publisher node, so that Unified Communications Manager can verify network connectivity and publisher-subscriber validation. Additionally, you must enter the host name and the IP address for the subscriber node. When the Unified Communications Manager installation prompts you for the host name of the subscriber server, enter the value that displays in the Server Configuration window in Cisco Unified Communications Manager Administration; that is, if you configured a host name for the subscriber server in the Host Name/IP Address field.
Feedback