Installing the Cisco Prime Optical 9.5 Client
This chapter describes how to install and start the Cisco Prime Optical 9.5 client on Windows, Solaris, or Linux. When you install the Prime Optical client, you automatically install Cisco Edge Craft, the local craft application used to manage ONS 15305 NEs.
Note•You can have multiple versions of the Windows Prime Optical client installed simultaneously (in different folders). When installing the Prime Optical client, you can remove earlier versions or leave them installed.
•You must have administrator privileges on the local workstation. The client software must be shut down before you install the Prime Optical client.
•Cisco Edge Craft is not supported on Windows 7 client workstations.
•Cisco Edge Craft is an SNMP-based application. Verify that the workstation performing the installation can reach the ONS 15305 devices through UDP port 161, before launching Cisco Edge Craft.
This chapter contains the following sections:
•Installing the Prime Optical Client
•Logging Into the Prime Optical Client on Windows
•Starting Cisco Edge Craft on Windows
•Starting Cisco Edge Craft on Solaris or Linux
•Configuring Windows 7 to Launch Cisco Transport Controller
•Specifying the Default Browser to Display the Online Help
•Special Considerations when Proxy Server Is Enabled
•Verifying the Mozilla Firefox Version for Solaris or Linux
6.1 Installing the Prime Optical Client
The Prime Optical client uses Java Web Start technology. When the Prime Optical administrator updates or patches the server, the client is updated automatically.
To launch the Prime Optical client on your workstation:
Step 1 Enter the following URL in your web browser:
where server-name is the name of the server where Prime Optical is installed.
Step 2 In the Cisco Prime Optical login screen, click Start.
Depending on your browser, one of the following occurs:
•If you are using Internet Explorer, the Prime Optical client is installed automatically.
•If you are using Mozilla Firefox, you are prompted to open the PrimeOptical.jnlp file or save it to your desktop. After you open and run the .jnlp file, the Prime Optical client is installed automatically.
•The Java Runtime Engine (JRE) 1.6 must be installed on the machine. If the client does not start, check that Java Web Start is associated to the browser with the correct javaws.
For Windows operating systems, the installer creates the following:
•A Prime Optical desktop icon.
•A C:\Cisco\PrimeOptical_9.5_X (where X is the build number) installation folder that contains all of the installation-related files.
For Solaris and Linux operating systems, the installer creates a /cisco/PrimeOptical_9.5_X (where X is the build number) installation folder that contains all of the installation-related files.
6.2 Logging Into the Prime Optical Client on Windows
The following procedure applies only when Prime Optical is installed as a standalone product. When Prime Optical is installed as part of the Prime Central suite, the suite offers single sign-on (SSO). With SSO, when you log into the Prime Central portal, you do not have to log in separately to Prime Optical.
Step 1 After you install the Prime Optical client, the Cisco Prime Optical - Login window opens.
For subsequent logins, you can do one of the following to launch the Prime Optical client:
•Enter http://server-name in a browser and click the Start button.
•Double-click the Prime Optical desktop icon.
•On the workstation where the Prime Optical server is installed, enter the following command:
Step 2 The first time you log in, enter the default username and password:
Note The username and password are case sensitive. After you enter the password, the Password field displays a fixed-length string of 15 asterisks (*), regardless of the actual length of the password.
Step 3 Complete one of the following options to specify the server to connect to:
•If you want the Prime Optical client to connect to the Prime Optical server directly (without going through a SOCKS server), enter the server IP address or hostname in the Server field.
Note Do not enter a hostname unless Domain Name System (DNS) is enabled in your network. If you installing Prime Optical as part of the Prime Central suite, DNS must be enabled on the Prime Optical client.
•If you want to configure a SOCKS v5 proxy server IPv4 address and port value to manage connectivity through network firewalls, do the following:
–Click Configure Settings. The Configure Settings dialog box opens.
–Check the Connect server Through SOCKS Server check box. Then, for the SOCKS host, enter the hostname or IP address and the TCP port number.
–(Optional) Check the Save as Default check box to save the SOCKS settings for the next time you log in.
–Click Save. The Configure Settings dialog box closes. (See "Setting Up Client-Server Encrypted Connections Through SSH Tunneling and SOCKS Proxy Forwarding." for more information on SOCKS.)
Note Click Show Advisory Message to view the default login text, which can be customized to display information for the particular server that you want to connect to. To display your own custom message, you must create a text file that contains your custom text. Save the file with the filename OtherLegal.txt in the /opt/CiscoTransportManagerServer/webServer/htdocs/config directory.
By default, the /config directory does not exist in the original installation. To create the directory, enter the following commands as the root user:
Step 4 Click Login.
Step 5 Click OK at the advisory message.
Step 6 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 15 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 7 Change the password; then, click OK.
Step 8 Click OK in the login advisory dialog box.
6.3 Starting Cisco Edge Craft on Windows
Step 1 Choose Start > Programs > Accessories > Command Prompt to open a Windows DOS Command Prompt window.
Step 2 Change directories to the Prime Optical-home-directory/CiscoEdgeCraft/bin directory.
Step 3 Double-click 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, do the following:
a. Enter the IP address of the NE that you want to connect to.
b. Ignore the User field.
c. Enter the Password string.
The password string represents the NE community string, which is set in the NE flash memory by using the command-line interface (CLI).
d. Click Logon.
6.4 Starting Cisco Edge Craft on Solaris or Linux
Step 1 Depending on the option you chose during installation, execute the link that you specified, or enter the following command:
Step 2 At the Cisco Edge Craft login screen, do the following:
a. Enter the IP address of the NE that you want to connect to.
b. Ignore the User field.
c. Enter a password string. The password string represents the NE community string, which is set in the NE flash memory by using the CLI.
d. Click Logon.
6.5 Configuring Windows 7 to Launch Cisco Transport Controller
If you plan to use Cisco Transport Controller (CTC) on a Windows 7 workstation, do the following:
Step 1 In Internet Explorer 8, disable the Protected Mode for a zone:
a. Choose Tools > Internet Options.
b. Click the Security tab.
c. Select the appropriate zone; then, uncheck the Enable Protected Mode check box.
The Protected Mode status ("Protected Mode: On" or "Protected Mode: Off") is visible in the bottom right corner of the IE status bar.
Step 2 Configure the security zone level to Medium.
Step 3 Disable automatic TCP tuning. To do this, open the CMD prompt and enter the following command:
netsh interface tcp set global autotuninglevel=disabled
Note To re-enable automatic tuning, enter:
netsh interface tcp set global autotuninglevel=normal
Note, however, that you cannot use CTC on a Windows 7 workstation when automatic tuning is enabled.
6.6 Specifying the Default Browser to Display the Online Help
In Windows, Prime Optical uses the default browser to display the online help. If you want to use a specific browser to launch the online help, make that the default browser for your workstation.
Note During testing, Cisco uses Internet Explorer and Mozilla Firefox 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.
On Solaris, the online help for Cisco Edge Craft requires Adobe Acrobat Reader to be installed and included 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 (usually /usr/openwin/bin [Solaris] or /usr/bin [Linux]) and the full path name. Also, verify that the DISPLAY variable is set correctly.
6.7 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, do the following:
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 Mozilla Firefox, do the following:
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.
6.8 Verifying the Mozilla Firefox Version for Solaris or Linux
Step 1 To verify the Mozilla Firefox version for the Solaris or Linux client, enter the following command on the command line:
If the which mozilla command returns output that is similar to the following, Mozilla Firefox is not in your path:
no mozilla found /usr/bin /usr/bin/bin .....
Step 2 To correct the path, enter the following commands:
ln -s /usr/sfw/bin/mozilla /usr/bin/mozilla
Step 3 Verify that the which mozilla command output reads as follows:
Step 4 To verify the correct version of Mozilla Firefox, enter the following command:
Step 5 Verify that in the output, you see the correct Mozilla Firefox version: