Installing the CTM R9.1.0.350.3 Patch
-------------------------------------

This readme describes how to download and install the CTM R9.1.0.350.3 patch. 

Note: 
- Caveats are categorized as a server fix (S), client fix (C), or both (CS).

The following caveats are fixed in the CTM R9.1.0.350.3 patch:

CSCtd50557 (C): Cannot install the client patch if the installation directory name contains a blank space.
CSCtd77921 (CS): Adding an SVLAN drop fails and may cause traffic loss.

For detailed caveat information, see the Release Notes for Cisco Transport Manager R9.1 at
http://cisco.com/en/US/products/sw/opticsw/ps2204/prod_release_notes_list.html.

Alternately, if you have a Cisco.com account and a Cisco service contract, you can use the Bug Toolkit to reference 
and monitor all caveats recorded against this product, including those recorded subsequent to the publication of this 
document. To access the Bug Toolkit, visit http://www.cisco.com/pcgi-bin/Support/Bugtool/launch_bugtool.pl.

The following NE Software Releases are supported in the CTM R9.1.0.350.3 patch:
- Cisco ONS 15327 Release 4.1.8.2
- Cisco ONS 15454 SONET Release 4.1.8.2
- Cisco ONS 15454 SONET Release 8.5.1

CTM R9.1.0.350.3 is intended for customers who are currently using CTM R9.1.0.318.

Note: Install the CTM R9.1.0.350.3 patch only in a non-high availability setup. If you are using a high availability
setup, contact your Cisco account representative before installing the patch.

Complete the following procedures to upgrade to the CTM R9.1.0.350.3 patch.


Determining What CTM Patch Is Currently Installed in the CTM System
-------------------------------------------------------------------

To check your current CTM release and patch level, log into the CTM server as the root user
and enter the following command:

showctm

The first line of the output gives you the release and patch level. Before proceeding, make sure that the 
output results to the following:

- Cisco Transport Manager Server Version: 9.1 Build: 318


Backing Up the CTM Database Before Installing the CTM R9.1.0.350.3 Patch
------------------------------------------------------------------------

Before installing the CTM R9.1.0.350.3 patch, it is strongly recommended that you back up the existing database.
To back up the CTM database, refer to the following sections in Chapter 4 of the Cisco Transport Manager
Release 9.1 User Guide:

- Backing Up the CTM Database from the CTM GUI
- Backing Up the CTM Database from the CLI



Downloading the CTM R9.1.0.350.3 Patch
--------------------------------------

Step 1: Go to http://tools.cisco.com/support/downloads/pub/Redirect.x?mdfid=278875317.

Step 2: At the Select a Product screen, expand Cisco Transport Manager.

Step 3: Click Cisco Transport Manager 9.1.

Step 4: At the Log In screen, enter your registered Cisco.com username and password; then, click Log In.

Note: If you do not have a Cisco.com username and password, you can register for them at
http://tools.cisco.com/RPF/register/register.do.

Step 5: At the Select a Release screen, click Expand all and click 9.1.0.350.3.

Step 6: In the right pane, click Download Now.

Step 7: At the Download screen, click Proceed With Download.

Step 8: At the License Agreement screen, read the terms of the license agreement and click Agree.

Step 9: At the Select a download option screen, select one of the following options:
- Download Manager Option: Select this option if you have Java version 1.4.2.xx installed on your computer.
- Non Java Download Option: Select this option if you do not have Java installed on your computer.

Step 10: Download the CTM9.1.0.350.3.patch.zip file to a temporary directory (such as /temp) on the CTM server.

Step 11: In Solaris, enter the following commands to extract the file to the temporary directory:

cd /<directory_name>
unzip CTM9.1.0.350.3.patch.zip

For example, to extract the file to the /temp directory, enter:

cd /temp
unzip CTM9.1.0.350.3.patch.zip

This creates a directory called 350, which contains all of the patch-related files.

Step 12: Enter the following command to enter the directory:
cd 350

Step 13: In Windows, download the CTM9.1.0.350.3.patch.zip file to the client workstation. Extract the file using a tool such as WinZip, as follows:

a. Open the CTM9.1.0.350.3.patch.zip file in WinZip.

b. Click the Extract button.

c. Verify that the Use folder names check box is checked.

d. In the Extract to drop-down list, select the location where you want to extract the files.

e. Click Extract.



Installing the CTM R9.1.0.350.3 Server Patch
--------------------------------------------

To apply the CTM R9.1.0.350.3 patch to the server, complete the following steps:

Step 1: Notify all CTM users before shutting down the CTM server:

a. In the Domain Explorer window, choose File > Notify Users. The Notify Users dialog box opens.

b. In the Message Targets area, click the All CTM Users radio button.

c. Type the message in the Message area. Customize the message as appropriate for your organization. A sample message might read:

The CTM server will be shut down in 5 minutes. Please log out of the CTM client before then.

d. Click Send.

e. Wait an appropriate amount of time for the CTM users to log out.

Step 2: At the end of the grace period, log out all of the CTM clients:

a. Log into the CTM server using an account with SuperUser privileges.

b. In the Domain Explorer window, choose Administration > CTM Users.

c. In the CTM Users table, choose Administration > Logged In CTM Users.

d. In the Logged In CTM Users table, select a user and choose Administration > Log Out User (or click the Log Out User tool).
Note: This menu option is disabled if you selected your own session.

e. Click Yes at the following prompt:

This operation will log out the selected CTM user. The process will take approximately 1 minute and this CTM client will be unusable until then. 
Do you wish to continue?

Wait until the CTM server completes the operation. The CTM GUI is frozen for approximately 1 minute until the
request is complete. Log out all of the users listed in the Logged In CTM Users table to make sure that all user
sessions are terminated.

Step 3: As the root user, enter the following command at the UNIX prompt to stop the CTM server:

ctms-stop

Step 4: To patch the server, enter the following command in the 350 directory where the patch was extracted:

./server_patch.sh

Note: The script might take awhile to complete, depending on the database size. Do not interrupt the script 
before it finishes.

Step 5: As the root user, enter the following command at the UNIX prompt on the CTM server workstation to start the CTM server:

ctms-start

Step 6: As the root user, enter the following command at the UNIX prompt on the CTM server workstation to verify the patch installation:

showctm

You should see the following version string in the first line of output for the preceding command:

Cisco Transport Manager Server Version: 9.1 Build: 350 Patches: 3



Installing the CTM R9.1.0.350.3 Client Patch in Windows
-------------------------------------------------------

The following steps describe how to patch a CTM client installation in Windows. Before proceeding,
make sure that there are no instances of the client running in the system. To shut down a running client,
choose File > Exit in the Domain Explorer; then, click OK in the confirmation dialog box.

Step 1: Locate the 350 patch directory that was extracted with the WinZip utility.

Step 2: Using the command prompt, go to the directory where the patch files were extracted,locate the client_patch.bat file, 
and enter the following command:

client_patch

You can also use the Windows Explorer folder view to access the directory where the patch files were extracted
and double-click the client_patch.bat file.

Step 3: Double-click the CTM 9.1 desktop icon or choose the CTM 9.1 Start menu shortcut to start the client.

Step 4: To verify the patch installation on the CTM client, do one of the following:

- Option 1

a. From the Domain Explorer, select Help > About Cisco Transport Manager. 

b. Verify that the version string in the About Cisco Transport Manager dialog is the following:

Client: 9.1 Build: 350 (client configuration size)

c. Click OK.

- Option 2 (Available only on specific user account types)

a. From the Domain Explorer, select Administration > Control Panel.

b. Click CTM to open the CTM Properties pane. 

c. Click the Client Configuration tab. Verify that the Version field indicates the correct CTM client version number:

9.1 [9.1.0.350]



Installing the CTM R9.1.0.350.3 Client Patch in Solaris
-------------------------------------------------------

The following steps describe how to patch a CTM client installation in Solaris. Before proceeding,
make sure that there are no instances of the client running in the system. To shut down a running client,
choose File > Exit in the Domain Explorer; then, click OK in the confirmation dialog box.

Step 1: Go to the 350 directory where the patch files were extracted with the unzip command.

Step 2: Enter the following command:

./client_patch.sh

Step 3: Enter the following command to start the CTM client:

ctmc-start

Step 4: To verify the patch installation on the CTM client, do one of the following:

- Option 1

a. From the Domain Explorer, select Help > About Cisco Transport Manager. 

b. Verify that the version string in the About Cisco Transport Manager dialog is the following:

Client: 9.1 Build: 350 (client configuration size)

c. Click OK.

- Option 2 (Available only on specific user account types)

a. From the Domain Explorer, select Administration > Control Panel.

b. Click CTM to open the CTM Properties pane. 

c. Click the Client Configuration tab. Verify that the Version field indicates the correct CTM client version number:

9.1 [9.1.0.350]