Cisco TelePresence Touch 12 Installation Guide

Understanding COP and Loads Files for the Cisco TelePresence System

Revised: November 13, 2013, OL-25603-01

This section contains information about the COP file and how you use it, and includes the following topics:

•Understanding COP Files

•Differences in Unified CM Between the CTT 12 and Cisco Unified IP Phone

•COP File Naming Convention

•Contents of the COP File

•Upgrading Systems That Are Running Cisco TelePresence Software Versions Prior To 1.7.4

Understanding COP Files

Before you can use the Cisco TelePresence Touch 12 (CTT 12), you install a Cisco Options Package (COP) file to Cisco Unified Communications Manager (Unified CM). The COP file is a zipped file that contains the codec and control device (for example, CTT 12 or Cisco Unified IP Phone) image files, and a loads file that lists the contents of the COP file. For more information, see the "Contents of the COP File" section.

The COP file is the default method of file distribution for all releases 1.8.0 and beyond, whether your system uses either a CTT 12 or a Cisco Unified IP Phone for call control.

Systems that are running a miminum Cisco TelePresence System software release of 1.7.4 can use a COP file to upgrade and install their software, even though the CTT 12 is not supported on any releases prior to 1.8.0. Systems that are running Cisco TelePresence System software releases 1.8.0 and above must use a COP file to upgrade and install their software. For COP file-specific information about systems that are running software prior to 1.7.4, see the "Upgrading Systems That Are Running Cisco TelePresence Software Versions Prior To 1.7.4" section.

After you use a COP file to upgrade your system, you perform all subsequent upgrades by using the COP file. You perform the upgrade by specifying the file name in Unified CM and omitting all file extensions. Specifying a codec image file with a specific file extension, or specifying a file that is not included in a COP file, might result in the CTT 12 reporting a version mismatch.

Find the COP file in the "Download" section of the Cisco support site for your product, located at the following URL:

http://www.cisco.com/cisco/web/support/index.html

Differences in Unified CM Between the CTT 12 and Cisco Unified IP Phone

You do not register the CTT 12 in Unified CM. This configuration method differs from the configuration for a Cisco TelePresence system that uses a Cisco Unified IP Phone for call control, where you register both the codec and Cisco Unified IP Phone in Unified CM. With a system that uses a CTT 12 device, you only register the codec in Unified CM.

To upgrade your system, you specify the name of the COP file, with no file types or extensions, in Unified CM. You specify the name either in the Unified CM Device Defaults Load Information field (to specify this file for all devices of the same type) or the Device Phone Load Name field (to specify this file for a single device).

Note If your system is running a CTS version earlier than 1.7.4, you first specify the file name with an .sbn or .SPA extension, then you specify the file name with no extension. For summary steps, see the "Upgrading Systems That Are Running Cisco TelePresence Software Versions Prior To 1.7.4" section; for detailed steps, see the "Upgrading the CTS Software for Systems That Are Running Cisco TelePresence Software Versions Prior to 1.7.4" section.

Unified CM automatically extracts the codec and CTT 12 files from the COP file and applies them to your Cisco TelePresence system.

Figure 1-1 shows how the codec and CTT 12 retrieve the files in the COP file from Unified CM. This example shows a COP file for systems that use the CTS-CODEC-SING-G1 or CTS-CODEC-PRI-G2R codec. The process for systems that use the CTS-CODEC-PRIM or CTS-CODEC-PRI-G2 codec is the same; however, the codec file name is different. For more information, see the "COP File Naming Convention" section.

Figure 1-1 COP File Extraction Process for the Codec and CTT 12

For more information, see the "Upgrading Systems That Are Running Cisco TelePresence Software Versions Prior To 1.7.4" section and "Upgrading the CTS Software for Systems That Are Running Cisco TelePresence Software Versions 1.7.4 and Above" section.

COP File Naming Convention

The COP file uses the following naming convention:

CTS.r-r-r-bbbR-K9.Pv.cop.sgn

where:

r-r-r is the Cisco TelePresence System (CTS) software release,

bbb is the build name, and

v specifies the file version.

The Pv variable differs depending on the contents of the COP file and the codec that is used by the system. For the example in Figure 1-2, the COP file, codec image file, and CTT 12 file have a version of P1. For the example in Figure 1-3, the COP and codec files have a version of P2, while the CTT 12 file has a version of P1.

Contents of the COP File

The COP file can contain multiple files, including any of the following types of files:

•Codec image files

•CTT 12 image files

•Midlet files

For the purpose of understanding how COP files are used with the CTT 12, assume that the COP file contains three files: A loads file, a codec image file, and a CTT 12 image file.

The loads file lists the file names of the specific codec and CTT 12 image files. Figure 1-2 and Figure 1-3 show sample loads files.

Figure 1-2 Sample Loads File—Systems That Use the CTS-CODEC-PRIM or CTS-CODEC-PRI-G2 Codec

<loads>

  <copname>cmterm-CTS.1-8-0-123R-K9.P1</copname>

  <images>

    <ctsmainImage>CTS.1-8-0-123R-K9.P1.sbn</ctsmainImage>

    <ctsdevImage>CTSDEV.1-8-0-123R-K9.P1.SPA</ctdevImage>

  </images>

</loads>

Figure 1-3 Sample Loads File—Systems That Use the CTS-CODEC-SING-G1 or CTS-CODEC-PRI-G2R Codec

<loads>

  <copname>cmterm-CTS.1-8-0-123R-K9.P2</copname>

  <images>

    <ctsmainImage>CTS.1-8-0-123R-K9.P2.SPA</ctsmainImage>

    <ctsdevImage>CTSDEV.1-8-0-123R-K9.P1.SPA</ctdevImage>

  </images>

</loads>

The loads file contains the following entries:

•<copname>: The COP file name.

Note When you specify the COP file name, remove the cmterm- in front of the file name. For specific examples of the COP file name when configuring a device in Unified CM, see Chapter 3 "Upgrading From a Cisco Unified IP Phone to a Cisco TelePresence Touch 12."

•<ctsmainImage>: The codec image file name. Note that the file types in the examples in Figure 1-2 and Figure 1-3 are different; the file types are based on the type of codec that the system uses.

•<ctsdevImage>: The CTT 12 image file name.

Upgrading Systems That Are Running Cisco TelePresence Software Versions Prior To 1.7.4

Systems that are running CTS software version 1.7.4 or older cannot process loads files and will report a "file not found" error, even in cases where the file is present. To upgrade your system, complete the following steps.

Note Do not physically connect the CTT 12 to your system until Step 9 of this procedure.

Tip You can upgrade your system using these steps, skipping Step 9, even if your system uses a Cisco Unified IP Phone for call control.

Step 1 Install the COP file into the Unified CM server.

This action extracts the codec and CTT 12 image files from the COP file and stores them in the Unified CM TFTP directory.

Step 2 Restart the TFTP server.

Step 3 Upgrade your codec by entering the complete file name, including either the .sbn or .SPA file type, in one of the following places:

•To specify this file for all devices of a specified type, enter the file name in the Unified CM Device Defaults Load Information field.

•To specify this file for a single device enter the file name in the Device Phone Load Name field (e).

Step 4 Save and apply your changes in Unified CM, which reboots the codec and upgrades your system to a minimum of release 1.8.0.

Note For Cisco TelePresence System 500-32 systems running Cisco TelePresence Software version 1.7.1.1, you must first upgrade your system to version 1.7.x before upgrading your system to 1.8.0. For more information, see the "Special Restriction for CTS-500-32 Systems Running Cisco TelePresence System Software Version 1.7.1.1" section.

Step 5 Connect the CTT 12 to your system and specify the COP file with no file extension.

Step 6 Save and apply your changes in Unified CM, which reboots the codec and upgrades your CTT 12 to the correct software release.

Step 7 Upgrade your codec by specifying the loads file name, which is the name of the COP file with no file extensions, either in the Unified CM Device Defaults Load Information field (to specify this file for all devices of the same type) or the Device Phone Load Name field (to specify this file for a single device).

Step 8 Save and apply your changes in Unified CM, which restarts the codec and enables your system to support the CTT 12.

Step 9 Connect the CTT 12 to your system.

Figure 1-4 shows the upgrade path that is available depending on your Cisco TelePresence system software version.

Figure 1-4 Upgrade Path