Unified CM L2 Upgrade Disk Space issues
Unified CM L2 Upgrade Disk Space Issues
The Cisco Unified Communications Manager (Unified CM) system may experience issues during an L2 upgrade if the necessary disk space is not available. The issue is more common if the implementation comprises different types of endpoints where the TFTP directory can significantly increase due to the firmware. You can also have space issues if you enable detailed logs and traces in a particular Cisco Unified Communications node. In this case, the space issue may not show up immediately, but may be seen over time.
The minimum requirement to start a Unified CM upgrade is the ability to copy the upgrade ISO image to the Unified CM disk. For Unified Communications Release 9.0(1) the size of the Unified CM ISO image is approximately 4.9 GB.
For Unified Communications System Release 9.0(1), the components taking the majority of the disk space are: Unified CM database (8.1 GB), CAR database (9.1 GB), Diagnostic Portal database (5.7 GB) and the TFTP data. The CAR database and the Unified CM database are fixed in size, regardless of how many phones you have. The fixed size for the IDS databases is allocated based on the Unified CM disk size. The CAR database is automatically purged once it reaches its limit of two million records.
In the following example, there are two different clusters with the same virtual disks (vDisks), but with a significant difference on the devices provisioned on the clusters. The Unified CM and the CAR databases are the same size on both clusters.
Table 1: Cisco Unified Communications Manager and CAR Database Size Based on 80 GB vDisks
|CLUSTER 1 – 2-80 GB vDisk||CLUSTER 2 – 2-80 GB vDisk|
|Registered IP Phones||24,151||4|
|MTP, Xcoder, CFB, MOH||30||3|
|Unified CM database size||8.1 GB||8.1 GB|
|CAR database size||9.1 GB||9.1 GB|
Based on the information in Table 1, the only significant variable is the TFTP data directory, which is where the phones firmware is located. The TFTP data folder size is determined by the different phones in the Unified CM implementation because a different set of firmware files per model is required. In the example above, the number of devices (IP phones) registered to each cluster requires 5.9 GB of the TFTP data for cluster 1, and 5.5 GB for cluster 2.Because the TFTP data folder contains the phones firmware in the Unified CM deployment, the higher the number of phone models, the greater the space allocated to the TFTP data directory.
The Diagnostic Portal database also affects disk space allocation during a Unified CM upgrade. For Unified CM Release 9.0(1), the size allocated for this is upgrade is about 5.7 GB.
Workaround for Disk Space Issue
Based on the two 80-GB disk drives and the pre-allocated space, the total space required for an upgrade is approximately 29 GB. The most significant variable is the size of the TFTP data on your system. Cisco recommends that for large Unified CM implementations, 80-GB drives can support a commonly deployment environment.
As the Unified CM administrator, follow the steps below to:
- determine the available disk space on your system.
- increase the space to accommodate approximately 29 GB in the /common partition for your L2 upgrade.
Note: You can follow the steps and workarounds described below without the help of Cisco TAC.
Calculate Overall Disk Space
Before starting the Unified CM L2 upgrade, ensure you have the necessary space across all partitions.
From Unified Communications Manager Operating System Administration
Log into the Unified Communications Manager Operating System Administration, and select Show > System from the menu options. This displays the following information:
Figure 1: Space Calculation from Unified Communications Operating System Administration.
From Real Time Monitoring Tool or CLI
You can also get the same information from the Real Time Monitoring Tool (RTMT) or the CLI. From RTMT, select System > Server > Disk Usage. Select the server from the Disk Usage at Host drop-down menu and view the Used Space (MB) for the Common partition. From the CLI, run the command: show status.
On Specific Drives
You can also determine the space on specific drives on your system by running the show diskusage common command. Run this command during off hours or during a maintenance window because it may cause high IOWAIT on your system.
Figure 2: Space Calculation on Specific Drives.
On Individual Subsystems
The show diskusage ? command lets you look at individual subsystems, as follows:
Figure 3: Space Calculation on Individual Subsystems.
Free Up Space for Unified CM L2 Upgrade
To free up space from the /common partition on the Cisco Unified Communications Manager node, follow the instructions below:
Retrieve Core Files Using RTMT
- Use RTMT to retrieve any core files that may have been in the system:
- Log in to RTMP and double-click Collect Crash Dump.
- From the pop-up window, select Cisco Call Manager. Then click Next.
- Click Next twice.
- From the Collection Time portion of the pop-up window, select the radio button for Relative Range, and specify the time in minutes, hours, days, weeks and months.
- On the Download File Options, select whether you want to zip the file. The Download File Location points to the default location. You can change the location by clicking the Browse button. Regardless of whether you zip the file, a pop-up window displays a warning message.
- Wait for RTMT to retrieve any core files.
You can use the CLI to determine if the system has any core files on the active or inactive partitions. The system provides a set of commands to display and delete any existing core files, as follows:
- Log in to the Unified CM CLI as administrator.
- From the CLI, you can display any existing core files. Select the active/inactive partition where you want to display the core files by using the utils core active list or file list activelog core commands.
- Delete the specific core file by using the command: file delete activelog core <core file name>
- Check for available disk space.
Purge Log Files by Changing the Log Partition Watermarks
- Another way to create additional disk space is by changing the high and low watermarks on the system. This informs Unified CM of the numbers of log files to purge once the watermark is reached. Use RTMT as follows:
- Launch RTMT and log in to the desired cluster.
- From the left pane, select Alert Central.
- On the right pane, double-click LogPartitionHighWaterMarkExceeded. Change the threshold value to 60.
- On the right pane, double-click LogPartitionLowWaterMarkExceeded. Change the threshold value to 50.
- This data is polled every five minutes. Allow five to 10 minutes and then check the drive partitions for additional disk space by using one of the methods described above.
If you want to free up more disk space in the common partition, change the LogPartitionHighWaterMarkExceeded and LogPartitionLowWaterMarkExceeded threshold values to lower numbers (for example, 30/20).
After the L2 upgrade finishes, change the thresholds back to their original values. (The defaults are 95 percent for high watermark and 90 percent for low watermark.)
Cisco does not recommend removing files without the support of a technical support engineer. Some files may be required and removing them could affect platform and/or application stability. If after performing the procedures and workarounds described above, you are unable to create sufficient disk space, contact Cisco TAC for additional help.