Table Of Contents
Installing the CTM R7.2 Client and Cisco Edge Craft
5.1 Installing the CTM Client and Cisco Edge Craft on Microsoft Windows
5.1.1 Uninstalling the Previous Version of the CTM Client or Cisco Edge Craft
5.1.2 Installing the CTM Client and Cisco Edge Craft
5.1.3 Specifying the Default Browser to Display the Online Help
5.1.4 Enabling the SSH Remote Access CLI for MGX
5.2 Starting the CTM Client in Microsoft Windows
5.3 Starting Cisco Edge Craft in Microsoft Windows
5.4 Installing the CTM Client and Cisco Edge Craft on Sun Solaris
5.4.1 Uninstalling the Previous Version of the CTM Client or Cisco Edge Craft
5.4.2 Installing the CTM Client and Cisco Edge Craft
5.4.3 Requirements to Display the Online Help
5.5 Starting the CTM Client in Sun Solaris
5.6 Starting Cisco Edge Craft in Sun Solaris
Installing the CTM R7.2 Client and Cisco Edge Craft
This chapter describes how to install and start the CTM client and Cisco Edge Craft on Microsoft Windows or Sun Solaris. Cisco Edge Craft is the local craft application used to manage ONS 15302 and ONS 15305 NEs.
Note
You can have multiple versions of the Windows CTM client installed simultaneously (in different folders). When installing the CTM R7.2 client you can remove earlier versions, or leave them installed.
Note
You cannot have multiple versions of the Solaris CTM client installed on a Solaris workstation.
This chapter contains the following sections:
•
Installing the CTM Client and Cisco Edge Craft on Microsoft Windows
•
Starting the CTM Client in Microsoft Windows
•
Starting Cisco Edge Craft in Microsoft Windows
•
Installing the CTM Client and Cisco Edge Craft on Sun Solaris
•
Starting the CTM Client in Sun Solaris
•
Starting Cisco Edge Craft in Sun Solaris
Note
For an explanation of error messages that you might encounter during the CTM client installation, see Appendix A, "Understanding Installation Error Messages."
5.1 Installing the CTM Client and Cisco Edge Craft on Microsoft Windows
This section describes how to install the CTM client and Cisco Edge Craft on your Windows 2000 Professional, Windows 2000 Terminal Server, or Windows XP Professional workstation.
Note
You must have administrator privileges on the local workstation and the client software must be shut down before installing the CTM client.
5.1.1 Uninstalling the Previous Version of the CTM Client or Cisco Edge Craft
If you installed a previous version of the CTM client and you want to install another version of the CTM client in the same location on your system, it is recommended that you uninstall the previous version before installing the CTM R7.2 client or Cisco Edge Craft. If you want to have another version of the CTM client in your system (without uninstalling the previous version), choose a different folder to install the CTM client.
To uninstall a CTM client, see B.3 Uninstalling the CTM Client and Cisco Edge Craft on Microsoft Windows, page B-2.
5.1.2 Installing the CTM Client and Cisco Edge Craft
Step 1
Insert the CTM client installation CD and navigate to ctmc\win32\setup.exe. Double-click setup.exe.
Step 2
Click Next at the Introduction screen.
Step 3
At the Destination Folder screen, complete the following substeps:
a.
Specify where you want to install the CTM client. The default destination folder is C:\Cisco\TransportManagerClient7_2. You can click Change to choose a different destination.
b.
Specify whether you want to create a CTM desktop icon, a CTM shortcut in the Start menu, or both. If you choose the Start menu shortcut option, specify the destination folder for the shortcut. The default shortcut folder is Programs\Cisco Transport Manager.
c.
Click Next.
Note
If the destination directory that you specified is a new directory, you will receive the message "Specified directory does not exist, create it?" Click Yes.
Step 4
At the Select Default Memory Configuration screen, specify the size of your server installation (small, medium, large, or high end). Click Next.
Step 5
At the Launch Cisco Edge Craft screen, specify whether you want to install Cisco Edge Craft at the same time as the CTM client. If you choose to install Cisco Edge Craft, it will be installed in the <CTM_home_directory>/CiscoEdgeCraft/ folder. Click Next.
Note
If you do not choose to install Cisco Edge Craft in Step 5, you cannot install it manually during a second installation. Instead, if you decide to install Cisco Edge Craft later, you will need to uninstall the CTM client and then repeat the CTM client installation, this time checking the check box to install Cisco Edge Craft.
Note
If your Cisco Edge Craft is bundled and installed with a CTM client, you cannot upgrade it with a standalone Cisco Edge Craft package.
Note
Cisco Edge Craft is an SNMP-based application. Verify that the machine performing the installation can reach the ONS 1530x devices through port UDP 161 before launching it.
Step 6
The Pre-Installation Summary screen shows the items that will be installed and the space that is required. Click Install.
Step 7
The Install Complete screen summarizes the results of the installation. Click Done.
Step 8
Eject the CTM client installation CD.
5.1.3 Specifying the Default Browser to Display the Online Help
In Microsoft Windows, CTM uses the default browser to display the online help. If you want to use a specific browser to launch the CTM online help, make that the default browser for your workstation.
Note
During testing, Cisco uses Internet Explorer, Netscape, and Mozilla to display the online help; other browsers have not been tested.
The online help for Cisco Edge Craft requires Adobe Acrobat Reader. Acrobat Reader is not required in your PATH environment variable, but the PDF file type must be associated with Acrobat Reader.
5.1.3.1 Special Considerations when Proxy Server Is Enabled
If you are using a proxy-server enabled web browser, complete one of the following options, depending on your browser type.
For Internet Explorer, complete the following steps:
Step 1
Choose Tools > Internet Options.
Step 2
Click the Connections tab.
Step 3
Click the LAN Settings button.
Step 4
Complete one of the following options:
•
Uncheck the Use a proxy server for your LAN check box.
•
If the Use a proxy server for your LAN check box must remain checked, click Advanced. Enter your server IP address in the Do not use proxy server addresses beginning with field. Separate each address with a semicolon.
Step 5
Click OK.
For Netscape and Mozilla, complete the following steps:
Step 1
Choose Edit > Preferences.
Step 2
Expand Advanced and choose Proxies.
Step 3
Complete one of the following options:
•
If you do not want to use a proxy, click Direct connection to the Internet.
•
If you do not have a proxy location (URL), click Manual proxy configuration. In the No Proxy for field, enter the domains that you do not want to use a proxy for. Use a comma to separate domains.
Step 4
Click OK.
5.1.4 Enabling the SSH Remote Access CLI for MGX
This procedure explains how to use the SSH client from SSH Communications Security or Tectia. Other SSH clients from other vendors are not supported. This procedure applies only to MGX devices.
Step 1
Obtain SSH Tectia from www.ssh.com.
Step 2
Install SSH Tectia.
Step 3
Open the local PC folder where Tectia is installed.
Step 4
Change the name of the ssh-client-g3.exe executable to sshclient.exe.
Note
The ssh-client-g3.exe filename is valid in Tectia release 5.1.3.8; the filename might be different for other release numbers.
Step 5
Verify that the executable file exists in the current path. To do this, open a DOS shell and launch the sshclient.exe executable manually.
Step 6
If the executable file does not exist in the current path, set the path environment to the directory path of putty.exe. To do this, complete the following substeps:
a.
Right-click My Computer and choose Properties.
b.
Click the Advanced tab; then, click Environment Variables.
c.
Select the PATH variable and add an entry for the PuTTY directory path.
d.
Click OK; then, click OK to close the System Properties dialog box.
5.2 Starting the CTM Client in Microsoft Windows
Step 1
Depending on the option you chose during installation, double-click the CTM desktop icon or choose the CTM Start menu shortcut to start the client.
Note
It is not necessary to restart the workstation.
Step 2
The first time you log in, use the default username and password:
•
Username: SysAdmin
•
Password: Ctm123!
Note
The username and password are case sensitive. After you enter the password, the Password field displays a fixed-length string of 12 asterisks (*), regardless of the actual length of the password.
Step 3
Enter the CTM server hostname or IP address and click OK.
Note
Do not enter a hostname unless Domain Name System (DNS) is enabled in your network.
Step 4
By default, for security reasons you are prompted to change the password after you log in for the first time. Click Yes. The password complexity is configurable in the Control Panel > Security Properties pane. By default, the password must:
•
Contain at least six characters, but not more than 12 characters.
•
Contain at least two alphabetic characters (A-Z, a-z). Of the alphabetic characters, at least one must be uppercase and one must be lowercase.
•
Contain at least one numeric character (0-9).
•
Contain at least one special character (+ # % , . ; & !). The default special character set is TL1+UNIX.
•
Allow a special character as the first or last character.
•
Allow a numeric character as the first or last character.
•
Not contain the username or any circular shift of the username. An uppercase letter and its corresponding lowercase letter are considered equivalent. For example, if the username is Arthur, the password cannot contain the string arthur, rthura, thurar, hurart, urarth, or rarthu.
•
Differ from the old password by at least three characters. For example, if the old password is MikeBrady5!, the new password cannot be mikebrady5% because only the last character is different. However, the new password MikeBrady2!99 is acceptable because it differs from MikeBrady5! by three characters.
Step 5
Change the password; then, click OK.
Step 6
Click OK in the login advisory dialog box.
Step 7
If your CTM client software version is older than the CTM server software version, you are prompted with the following dialog box:
CTM client needs to be upgraded for proper operation. Do you want to start the upgrade
now? Selecting "No" will exit the application.
Click Yes. The CTM server automatically upgrades your CTM client to the newer version. Click OK at the "Proceeding with upgrade" prompt and follow the prompts to install the newer client version.
Note
The default SysAdmin user has limited privileges. Create new CTM users with SuperUser privileges to have access to all CTM operations. See the Cisco Transport Manager Release 7.2 User Guide for information about user profiles and creating CTM users.
5.3 Starting Cisco Edge Craft in Microsoft Windows
Step 1
Open a Windows DOS Command Prompt window. To do this, choose Start > Programs > Accessories > Command Prompt.
Step 2
Change directories to the <CTM_home_directory>/CiscoEdgeCraft/ bin directory.
Note
You can click Change to choose a different destination directory.
Step 3
Run the CiscoEdgeCraft.exe file. The Cisco Edge Craft login screen appears.
Note
It is not necessary to restart the workstation.
Step 4
At the Cisco Edge Craft login screen, complete the following substeps:
a.
Enter the community string. The community string represents the NE password, which is set in the NE Flash memory by using the command-line interface (CLI).
b.
Enter the IP address of the NE that you want to connect to.
c.
Click Logon.
5.4 Installing the CTM Client and Cisco Edge Craft on Sun Solaris
This section describes how to install the CTM client and Cisco Edge Craft on your Sun Solaris 8 workstation.
5.4.1 Uninstalling the Previous Version of the CTM Client or Cisco Edge Craft
If you installed a previous version of the CTM client or Cisco Edge Craft, you must delete the directory where the previous client is installed before installing the CTM R7.2 client or Cisco Edge Craft. See B.4 Uninstalling the CTM Client and Cisco Edge Craft on Sun Solaris, page B-3.
5.4.2 Installing the CTM Client and Cisco Edge Craft
Step 1
Log in as the root user and insert the CTM client installation CD.
Step 2
From a terminal window, enter the following commands:
cd /cdrom/cdrom0/ctmc/solaris/Disk1
The CTM client installation begins. Wait for up to 60 seconds while the following message appears:
Installing Cisco Transport Manager client...
Step 3
Click Next at the Introduction screen.
Step 4
At the Destination Folder screen, complete the following substeps:
a.
Specify where you want to install the CTM client. The default destination folder is /opt/CiscoTransportManagerClient. You can click Change to choose a different destination.
b.
If you want to add a CTM icon to the Common Desktop Environment (CDE) front panel or add a CTM entry to the CDE Workspace menu, check the appropriate check box(es):
•
Add Icon to CDE Front Panel
•
Add Entry to CDE Workspace Menu
These options allow you to launch the CTM client without having to open a terminal or console window and invoke the ctmc-start command. If you choose either option, you might have to perform one of the following actions to see the changes:
— Restart your CDE Window Manager
— Log out of CDE; then, log back in
— Reboot the system
c.
Click Next.
Note
If the destination directory that you specified is a new directory, you will receive the message "Specified directory does not exist, create it?" Click Yes.
Note
Do not specify any mount point as the target installation directory for the client installation, or the installation data might be lost when the workstation restarts.
Step 5
At the Select Default Memory Configuration screen, specify the size of your network (small, medium, large, or high end). Click Next.
Step 6
At the Launch Cisco Edge Craft screen, specify whether you want to install Cisco Edge Craft at the same time as the CTM client. If you choose to install Cisco Edge Craft it will be installed in the /opt/CiscoTransportManagerClient/CiscoEdgeCraft folder. Click Next.
Note
If your Cisco Edge Craft is bundled and installed with a CTM client, you cannot upgrade it with a standalone Cisco Edge Craft package.
Note
Cisco Edge Craft is an SNMP-based application. Verify that the machine performing the installation can reach the ONS 1530x devices through port UDP 161 before launching it.
Step 7
At the CTM Group Information screen, enter the name of the UNIX group to which you want to assign administrator privileges. The default is the group name of the root user. You can uncheck the Ignore user-entered group name check box and enter the group name of your choice. After you specify the CTM group name, click Next.
Note
The group name must exist on the UNIX workstation in order for the CTM installation to proceed. The users that belong to the group must have the umask 002 command configured.
Step 8
The Pre-Installation Summary screen shows the items that will be installed and the space that is required. Click Install.
Step 9
The Install Complete screen summarizes the results of the installation. Click Done.
Step 10
Enter the following commands to eject the CTM client installation CD:
Note
If you do not choose to install Cisco Edge Craft in Step 6, you cannot install it manually during a second installation. Instead, if you decide to install Cisco Edge Craft later, you will need to uninstall the CTM client and then repeat the CTM client installation, this time checking the check box to install Cisco Edge Craft.
5.4.3 Requirements to Display the Online Help
The online help for Cisco Edge Craft requires Adobe Acrobat Reader in your PATH environment variable.
Tip
If you cannot launch the online help, open a command prompt from another window and enter the xhost + command, providing the full pathname. Also, verify that the DISPLAY variable is set correctly.
5.5 Starting the CTM Client in Sun Solaris
Step 1
At the console, enter one of the following commands, depending on the size of your network configuration:
•
If you are connecting to a small server, enter:
•
If you are connecting to a medium server, enter:
•
If you are connecting to a large server, enter:
•
If you are connecting to a high-end server, enter:
Caution 
In the Bourne shell, if you enter
ctmc-start to start the client and then execute
Ctrl+C in the xterm window where the client was launched, the CTM client will terminate.
Note
The installation program creates a soft link on /usr/bin for ctmc-start. If the soft link is missing, enter <install_directory>/ctmc-start at the console.
The following message appears:
Starting Cisco Transport Manager client. Please wait.
Wait 10 to 20 seconds for the CTM client application to start.
Step 2
The first time you log in, enter the default username and password:
Username: SysAdmin
Password: Ctm123!
Note
The username and password are case sensitive. After you enter the password, the Password field displays a fixed-length string of 12 asterisks (*), regardless of the actual length of the password.
Step 3
Enter the CTM server hostname or IP address and click OK.
Note
Do not enter a hostname unless DNS is enabled in your network.
Step 4
By default, for security reasons you are prompted to change the password after you log in for the first time. Click Yes. The password complexity is configurable in the Control Panel > Security Properties pane. By default, the password must:
•
Contain at least six characters, but not more than 12 characters.
•
Contain at least two alphabetic characters (A-Z, a-z). Of the alphabetic characters, at least one must be uppercase and one must be lowercase.
•
Contain at least one numeric character (0-9).
•
Contain at least one special character (+ # % , . ; & !). The default special character set is TL1+UNIX.
•
Allow a special character as the first or last character.
•
Allow a numeric character as the first or last character.
•
Not contain the username or any circular shift of the username. An uppercase letter and its corresponding lowercase letter are considered equivalent. For example, if the username is Arthur, the password cannot contain the string arthur, rthura, thurar, hurart, urarth, or rarthu.
•
Differ from the old password by at least three characters. For example, if the old password is MikeBrady5!, the new password cannot be mikebrady5% because only the last character is different. However, the new password MikeBrady2!99 is acceptable because it differs from MikeBrady5! by three characters.
Step 5
Change the password; then, click OK.
Step 6
Click OK in the login advisory dialog box.
Step 7
If your CTM client software version is older than the CTM server software version, you are prompted with the following dialog box:
CTM client needs to be upgraded for proper operation. Do you want to start the upgrade
now? Selecting "No" will exit the application.
Click Yes. The CTM server automatically upgrades your CTM client to the newer version. Click OK at the "Proceeding with upgrade" prompt and follow the prompts to install the newer client version.
Note
The default SysAdmin user has limited privileges. Create new CTM users with SuperUser privileges to have access to all CTM operations. See the Cisco Transport Manager Release 7.2 User Guide for information about user profiles and creating CTM users.
5.6 Starting Cisco Edge Craft in Sun Solaris
Step 1
Depending on the option you chose during installation, execute the link that you specified, or enter the following command:
/opt/CiscoTransportManagerClient/CiscoEdgeCraft/bin/CiscoEdgeCraft
Step 2
At the Cisco Edge Craft login screen, complete the following substeps:
a.
Enter the community string. The community string represents the NE password, which is set in the NE Flash memory by using the CLI.
b.
Enter the IP address of the NE that you want to connect to.
c.
Click Logon.