New and Changed Information for Cisco Unified Communications Manager 8.0(x)
Installation, Upgrade, DRS, and CLI
Downloads: This chapterpdf (PDF - 429.0KB) The complete bookPDF (PDF - 11.5MB) | Feedback

Installation, Upgrade, DRS, Cisco Unified Communications Operating System, and CLI

Table Of Contents

Installation, Upgrade, DRS, Cisco Unified Communications Operating System, and CLI

Server Requirements

Installation, Upgrade, and Migration

Before You Upgrade to Cisco Unified Communications Manager 8.0(1)

Bridge Upgrade

Maintaining Correct Time Zone Data

Enabling Write-Back Cache for Improved Upgrade Performance

Backing Up Customized Announcements After An Upgrade to 8.0(1)

Data Migration Assistant

Cisco Unified Communications Operating System

Bulk Certificate Management

Upgrade and Rollback Considerations

Disaster Recovery System

Command Line Interface

Commands Added in 8.0(1)

set cert

set password age minimum

set password history

set registry

show itl

utils core active

utils disaster_recovery cancel_backup

utils disaster_recovery device list

utils disaster_recovery schedule

utils network arp

CLI Commands Deleted


Installation, Upgrade, DRS, Cisco Unified Communications Operating System, and CLI


This chapter contains information on the following topics:

Server Requirements

Installation, Upgrade, and Migration

Data Migration Assistant

Cisco Unified Communications Operating System

Disaster Recovery System

Command Line Interface

Server Requirements

The following information does not apply to Cisco Unified Communications Manager Business Edition systems.

Some servers are no longer supported in Cisco Unified Communications Manager 8.0(1).

Make sure that you install and configure Cisco Unified Communications Manager on a Cisco Media Convergence Server (MCS) or a Cisco-approved HP server configuration or a Cisco-approved IBM server configuration. To identify which MCS are compatible with this release of Cisco Unified Communications Manager, refer to Supported Cisco Unified Communications Manager Releases by Server at the following URL:

http://www.cisco.com/en/US/prod/collateral/voicesw/ps6790/ps5748/ps378/prod_brochure0900aecd8062a4f9.html


Tip Make sure that the matrix shows that your server model supports Cisco Unified Communications Manager Release 8.0(1).



Tip Be aware that some servers that are listed in the Cisco Unified Communications Manager Software Compatibility Matrix may require additional hardware support for Cisco Unified Communications Manager Release 8.0(1). Make sure that your server meets the minimum hardware requirements, as indicated in the footnotes of the Cisco Unified Communications Manager Software Compatibility Matrix. http://www.cisco.com/en/US/docs/voice_ip_comm/cucm/compat/ccmcompmatr.html


Installation, Upgrade, and Migration

This section contains information about the changes to installation, upgrade, and migration for Cisco Unified Communications Manager Release 8.0(1).

Before You Upgrade to Cisco Unified Communications Manager 8.0(1)

Maintaining Correct Time Zone Data

Enabling Write-Back Cache for Improved Upgrade Performance

Backing Up Customized Announcements After An Upgrade to 8.0(1)

Before You Upgrade to Cisco Unified Communications Manager 8.0(1)

The following information does not apply to Cisco Unified Communications Manager Business Edition systems.

Cisco has limited the supported direct upgrade paths to Cisco Unified Communications Manager 8.0(1). Before you upgrade to Cisco Unified Communications Manager 8.0(1), review the following documentation:

Supported Cisco Unified Communications Manager Releases by Server at

http://www.cisco.com/en/US/prod/collateral/voicesw/ps6790/ps5748/ps378/prod_brochure0900aecd8062a4f9.html

Cisco Unified Communications Manager Software Compatibility Matrix at

http://www.cisco.com/en/US/docs/voice_ip_comm/cucm/compat/ccmcompmatr.html

Release Notes for Cisco Unified Communications Manager Release 8.0(1) at

http://www.cisco.com/en/US/docs/voice_ip_comm/cucm/rel_notes/8_0_1/cucm-rel_notes-801.html

Cisco Unified Communications Operating System Administration Guide at

http://www.cisco.com/en/US/docs/voice_ip_comm/cucm/cucos/8_0_1/cucos/osg_801_cm.html

Bridge Upgrade

The bridge upgrade provides a migration path for customers who use discontinued server models.

A bridge upgrade works on unsupported or discontinued hardware for the purpose of creating a DRS backup. The DRS backup can be restored on new hardware after a fresh installation completes.

When the system boots the new version, a warning appears on the console informing the user that the system functionality has been limited to making a DRS backup. Because of the restricted visibility of the console, the warning displays during both CLI and GUI sessions.

The ability to upload licenses is disabled in Cisco Unified Communications Manager Administration. If a user tries to upload licenses, a message tells them that the system only permits DRS Backups.

Bridge upgrades result in a new entry being added to the system history log file.

Maintaining Correct Time Zone Data

To ensure that Cisco Unified Communications Manager Release 8.0(1) includes the latest time zone information, you can install a COP file that updates the time zone information after you install Cisco Unified Communications Manager Release 8.0(1). You do not need to upgrade Cisco Unified Communications Manager Release 8.0(1) to get these updates. After major time zone change events, Cisco contacts you to let you know that you can download COP file ciscocm.dst-updater.YYYYv-1.el4.8.0.1.cop to install on the servers in your Release 8.0(1) cluster. (In the preceding file name example, "YYYY" represents the release year of the COP file, and "v" specifies the file version number.).


Note Be aware that COP files that contain "8.0.1" in their filenames are compatible with only Release 8.0(1).


For information about how to install a COP file, follow the installation instructions that you get with the file.

Enabling Write-Back Cache for Improved Upgrade Performance

A disabled write-cache on the server also causes the upgrade process to run more slowly. Multiple factors, including dead batteries on older servers, can cause the write-cache to get disabled.

Before starting an upgrade, verify the status of the write-cache on the MCS-7828-H4 and MCS-7835/45 disk controllers. You do not need to verify the write-cache status on the MCS-7816, MCS-7825, or other MCS-7828 servers. To verify write-cache status, access the Cisco Unified Operating System Administration, and choose Show > Hardware.

If you determine that your write-cache is disabled because of a dead battery, you need to replace the hard disk controller cache battery. Follow your local support procedures to get this battery replaced.

If you upgrade from Cisco Unified Communications Manager Release 7.1(3) to a later release in the future, the following warning will display when you start the upgrade if your server write-back cache is disabled. The warning requires you to approve this information before you continue your upgrade:

Warning: The hard disk controller write-back cache is disabled. To enable the cache, replace the disk controller battery. After the new battery charges fully, the write-back cache enables automatically. If you run an upgrade with a disabled write-back cache, you will slow the upgrade process and cause call processing failures.

If you replaced the battery, use the Show Hardware menu on the OS Administration windows to see the battery recharge status.

Backing Up Customized Announcements After An Upgrade to 8.0(1)

After an upgrade to Cisco Unified Communications Manager 8.0(1), you may need to perform additional tasks to ensure that customized announcements are backed up through the Disaster Recovery System. For information on this topic, see the "Installation/Upgrade (Migration) and Backup Considerations for Announcements" section on page 2-16.

Data Migration Assistant

The following information does not apply to Cisco Unified Communications Manager Business Edition systems.

Data Migration Assistant is not supported with Cisco Unified Communications Manager 8.0(1) because you cannot upgrade from Unified CM 4.X releases to Cisco Unified Communications Manager 8.0(1).

Cisco has limited the supported direct upgrade paths to Cisco Unified Communications Manager 8.0(1). Before you upgrade to Cisco Unified Communications Manager 8.0(1), identify the supported upgrade paths by reviewing the Cisco Unified Communications Manager Software Compatibility Matrix at the following URL:

http://www.cisco.com/en/US/docs/voice_ip_comm/cucm/compat/ccmcompmatr.html

Cisco Unified Communications Operating System

This section contains information about changes that affect the Cisco Unified Communications Operating System for Cisco Unified Communications Manager Release 8.0(1).

Bulk Certificate Management

For more information about Bulk Certificate Management, see the "Bulk Certificate Management" section on page 3-13.

Upgrade and Rollback Considerations

For important information about upgrading from Cisco Unified Communications Manager Release 7.x to Release 8.0(1), see the "Upgrading from Cisco Unified Communications Manager Release 7.x to Release 8.0." section on page 3-7.

For important information about reverting from Cisco Unified Communications Manager Release 8.0(1) to Release 7.x, see the"Rolling Back the Cluster to a Pre-8.0 Release" section on page 3-8.

Disaster Recovery System

Refer to the topic "Bridge Upgrade" in the preceding section Installation, Upgrade, and Migration.

For information on backing up customized announcements, see the "Installation/Upgrade (Migration) and Backup Considerations for Announcements" section on page 2-16.

Command Line Interface

This section contains information about the changes to the Command Line Interface Reference Guide for Cisco Unifed Communications Solutions for Cisco Unified Communications Manager Release 8.0(1).

Commands Added in 8.0(1)

CLI Commands Deleted

Commands Added in 8.0(1)

set cert

set password age minimum

set password history

set registry

show itl

utils core active

utils disaster_recovery cancel_backup

utils disaster_recovery device list

utils disaster_recovery schedule

utils network arp

set cert

This command affect the certificates available in the preconfigured SFTP location.

Command syntax

set cert

bulk [unit]

export [unit]

import [unit]

sftp

Parameters

bulk consolidates all the certificates in the preconfigured SFTP location, and exports the consolidated file to the same SFTP location.

export exports all the available certificates for this unit in this cluster to the preconfigured SFTP location.

import imports the certificates available in the SFTP location into the specified unit trust-store.

sftp prompts for the SFTP server information to be used for bulk operations.

Options

unit is mandatory

Bulk Example

admin:set cert bulk all

Successfully consolidated certificates for unit tomcat.
Successfully consolidated certificates for unit tftp

Export Example

admin:set cert export all

Successfully exported tomcat certificate(s) to sftp server.
Successfully exported tftp certificate(s) to sftp server.

Import Example

admin:set cert import all

Successfully imported tomcat certificates.
Successfully imported tftp certificates.									

SFTP Example

admin:set cert sftp
SFTP Ip Address :1.1.1.1
SFTP server port [22] :
User Id :user
Password :****
Remote Directory :/tmp
Sftp configuration update is successful.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set password age minimum

Use this command to modify the value of minimum password age for OS admin accounts in days.

Command syntax

set password age minimum [days]

Parameters

days minimum password age in days.

Usage Guidelines

Acceptable values specify 0 - 10.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set password history

This command modifies the number of passwords that get maintained in the history for OS admin accounts. New passwords matching remembered passwords get rejected.

Command syntax

set password history [number]

Parameters

number number of passwords to maintain in history.

Usage Guidelines

To disable, enter 0.

Default specifies 10.

Upper limit specifies 20.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set registry

This command sets a registry entry to a new value.

Command syntax

set registry [system | component] param value

Parameters

system specifies the registry system name.

component specifies the registry component name.

Options

param the name of the parameter to set.

value the value to assign to the param.

Example

admin:set registry cm dbl/sdi numlines 500
system = cm
   component = dbl/sdi
      numlines old value = 10000
      numlines new value = 500

Requirements

Command privilege level: 99

Allowed during upgrade: No

show itl

This command displays the ITL file contents or prints an error message if the ITL file is not valid.

Command syntax

show itl

Parameters

None

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

utils core active

This command affects existing core files.

Command syntax

utils core active

list

analyze core_file_name

Parameters

list displays the existing core files.

analyze displays the stack trace for the specified core file.

Options

core_file_name name of core file from which to get stack trace.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

utils disaster_recovery cancel_backup

This command cancels the ongoing backup.

Command syntax

utils disaster_recovery cancel_backup confirm

Usage Guidelines

After you enter the command, you must confirm that you want to cancel the backup. Enter Y to cancel the backup or any other key to continue the backup.

Example

admin:utils disaster_recovery cancel_backup yes
Cancelling backup...
Backup cancelled successfully.

Requirements

Command privilege level: 1

Allowed during upgrade: No

utils disaster_recovery device list

This command display the device name, device type and device path for all the backup device.

Command syntax

utils disaster_recovery device list

Parameters

None

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

utils disaster_recovery schedule

This command affects schedules that are configured.

Command syntax

utils disaster_recovery schedule

list

Command privilege level: 1

Allowed during upgrade: Yes

add schedulename devicename featurelist datetime frequency

Command privilege level: 1

Allowed during upgrade: No

enable schedulename

Command privilege level: 1

Allowed during upgrade: No

disable schedulename

Command privilege level: 1

Allowed during upgrade: No

delete [schedulename|*]

Command privilege level: 1

Allowed during upgrade: No

Parameters

list displays the schedules that are configured.

add adds the configured schedules.

enable enables the specified schedule.

disable disables the specified schedule

delete deletes the specified schedule.

Options

schedulename (mandatory) name of the scheduler

devicename(mandatory) name of the device for which scheduling is done

featurelist (mandatory) comma-separated feature list to backup

datetime (mandatory) date when the scheduler is set. Format specified (yyyy/mm/dd-hh:mm) 24 hr clock

frequency (mandatory) frequency at which the scheduler is set to take a backup. Examples: once, daily, weekly and monthly

* all

List Example

admin:utils disaster_recovery schedule list
schedule name device name Schedule Status
----------------------------------------
schedule1      dev1         enabled
schedule2      dev2         disabled

Enable Example

utils disaster_recovery schedule enable schedule1
Schedule enabled successfully.

Disable Example

utils disaster_recovery schedule disable schedule1
Schedule disabled successfully.

Requirements

Command privilege level: 1

Allowed during upgrade: No

utils network arp

This command lists the contents of the Address Resolution Protocol table.

Command syntax

utils network arp

list [host hostname][options]

Command privilege level: 0

Allowed during upgrade: Yes

set host addr

Command privilege level: 1

Allowed during upgrade: No

delete host

Command privilege level: 1

Allowed during upgrade: Yes

Options

host (optional) specifies host you want to list/set/delete.

hostname (optional) the hostname of the specified host.

options (optional) page, numeric

page pauses output.

numeric shows hosts as dotted IP addresses.

addr (mandatory) the hardware address (MAC) of the host.

Format XX:XX:XX:XX:XX:XX

Format XX:XX:XX:XX:XX:XX

List Usage Guidelines

In the Flags column, C=cached, M=permanent, P=published.

List Example

admin: utils network arp list
Address                  HWtype  HWaddress           Flags Mask           Iface
sjc21-3f-hsrp.cisco.com  ether   00:00:0C:07:AC:71   C                    eth0
philly.cisco.com         ether   00:D0:B7:85:98:8E   C                    eth0
Entries: 2      Skipped: 0      Found: 2

Set Example

admin: utils network arp set myhost 11:22:33:44:55:66

Delete Example

admin: utils network arp delete myhost

For More Information

Command Line Interface Reference Guide for Cisco Unifed Communications Solutions

CLI Commands Deleted

The following commands are not available in this release.

utils iothrottle threshold

set workingdir install

For More Information

Command Line Interface Reference Guide for Cisco Unifed Communications Solutions