Installing CWM Client Overview of CWM Client

Chapter 7 Installing CWM Client Overview of CWM Client

7 Installing CWM Client

This chapter provides an introduction to CWM Client in CWM Release 11 and describes the installation and launch processes.

Overview of CWM Client

CWM Client is a software component of CWM that permits the user to access and use the features of a CWM server workstation from a network connected client system. CWM Client is a Java based software package that is designed to run on either a Sun Solaris or a Windows 2000 based client machine under Sun Microsystem’s Java Web Start utility.

Note In release 11 the installation and launching procedures are much different from those in earlier versions of CWM. In earlier versions, the client software was installed directly onto the client machine using a special installation program.

CWM Client Release 11 software is distributed on the CWM server CD-ROMs and is installed on the CWM server workstation as part of the normal CWM server installation process. The process of launching the client software in the client machine consists of first downloading it to the client machine and then starting the client program. This process is managed from the client machine using a web browser, Java runtime environment (JRE) 1.3.1 software, and Sun Microsystem’s Java Web Start tool all of which must have been installed in the client machine. In addition, launching CiscoView in the client machine requires the Java Plug-in 1.3.1 to be installed. However, this is a component of JRE 1.3.1 and is installed along with the JRE. On the client machine, the user can download CWM Client and start the program using any of three methods. 1. Start the web browser, connect to the CWM server, and click the displayed icon for CWM or one its applications. This method must be used the first time that CWM is downloaded and launched. 2. Start Java Web Start and click the CWM Client icon. 3. Click a CWM Client shortcut icon on the client desktop.

Note The second and third methods listed above cannot be used to download the Client for the first time. However, they can be used for subsequent downloads and launches.

Each of these methods produces the same results.

Cisco WAN Manager Installation Guide for Solaris 8 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 7-1 Chapter 7 Installing CWM Client Setting Up a Windows Based CWM Client

Note The Java Web Start installation registers the file extension.jnlp and the MIME type application/x-java-jnlp-file with the operating system, so that Java Web Start will be launched from the browser when a link to a JNLP file is activated. In a Windows based machine, the installer also installs shortcuts to the Application Manager on the desktop and in the Windows Start menu.

If Netscape 6/6.01 is being used as the network browser, set up the Java Web Start MIME type (JNLP) in the Edit->Preferences->Navigator->Helper Applications section. The file extension is jnlp and the MIME Type is application/x-java-jnlp-file. It should be handled by the javaws executable file in your Java Web Start directory.

If the CWM Client software has previously been downloaded and cached, Java Web Start contacts the CWM server and checks to see if a newer version of the CWM Client software exists. If there is a newer version it is downloaded, cached, and launched otherwise the current version is launched.

Setting Up a Windows Based CWM Client

This section describes the hardware, software, and web browser requirements for a Windows based CWM client.

Hardware

The minimum hardware requirements to run CWM Client release 11 on a Microsoft Windows based PC are as follows: • Intel Pentium III (or compatible) processor with a clock speed of at least 200 Mhz • 256 Mbytes of RAM • 50 Mbytes of free disk space • Ethernet connectivity to a CWM server machine

Software

The software requirements to run CWM Client release 11 on a Microsoft Windows based PC are as follows: • MicroSoft Windows 2000 operating system • IP connectivity to a CWM server machine • Netscape Communicator browser version 4.76 or later • Sun Microsystems Java Web Start version 1.01 or later • Sun Microsystems JRE version 1.3.1 (Windows version) • Sun Microsystems Java Plug-in 1.3.1 (Windows version, used for CiscoView)

Cisco WAN Manager Installation Guide for Solaris 8 7-2 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 Chapter 7 Installing CWM Client Setting Up a Windows Based CWM Client

Web Browser

Either Microsoft Internet Explorer or Netscape Communicator can be used on a PC based client. Microsoft Internet Explorer is included in the Windows software and unless removed will always be installed in a Windows system. If the user prefers Netscape Communicator, and it is not already installed, it can be downloaded over the Internet. Using Internet Explorer to access Netscape Communicator, go to the following URL: www.netscape.com Click the download button at the top of the page. Then follow the download and install instructions. The browser requires that the it’s path be set using the following procedure:

Step 1 Locate the appropriate browser executable file (netscape.exe for Netscape Communicator and IEXPLORE.EXE for Internet Explorer). Note its path. The default paths for these files are: • C:\Program Files\Netscape\Communicator\Program • C:\Program Files\Internet Explorer Step 2 On the desktop, right click on the My Computer icon and select Properties. Step 3 Click on the Advanced tab and then click on the Environment Variables button. Step 4 On the Variable Value line, append a semicolon ; , followed by the path noted in Step 1. For example, if using Netscape Communicator, append, ;C:\Program Files\Netscape\Communicator\Program Step 5 Click on OK.

Making Netscape Communicator the Default Browser

For users that prefer Netscape Navigator, use the following procedure to change the default browser from Internet Explorer to Netscape Navigator.

Step 1 Quit Netscape Navigator. Step 2 Start Internet Explorer. Step 3 Click on Tools -> Internet Options -> Programs, then unselect the “Internet Explorer should check to see whether it is the default” box. (Versions other than 5.5 may have different menus). Step 4 Exit Internet Explorer. Step 5 Click on the Windows Start button -> Search -> For Files or Folders. Step 6 Find the file named 'prefs.js', typically under Documents and Settings\All Users\Application Data\Netscape\Users\default\.

Note There may be several copies of this file if the workstation has multiple users and / or multiple versions of Netscape installed.

Step 7 Using Windows Explorer rename prefs.js to prefs.sav.js.

Cisco WAN Manager Installation Guide for Solaris 8 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 7-3 Chapter 7 Installing CWM Client Setting Up a Windows Based CWM Client

Step 8 Start Netscape Navigator. Step 9 When Netscape Navigator asks if it should be the default browser, answer 'Yes'. Step 10 Exit Netscape Navigator. Step 11 Remove the new prefs.js and rename the prefs.sav.js to prefs.js.

Installing Java Tools

The following Java tools are required to run CWM client: • Java Web Start • Java Runtime Environment (JRE) version 1.3.1 • Java plug-in 1.3.1 (required to launch CiscoView). These tools are included in the CWM Server CD-ROMs and are stored in the CWM server machine automatically when the CWM server software is installed. These programs are then available for downloading to the CWM client machine.

Step 1 Ensure that the web browser is installed and running on the client machine. Step 2 Connect to the CWM server machine using its workstation name followed by :1551 (for example http://cwmhost:1551 or http://cwmhost.company.com:1551). 1551 is the software port number for the CWM Client web page The CWM server machine displays the CWM Client Launcher web page as shown in Figure 7-1. This page is made up of three panes. The top right pane shows the CWM logo, the top left pane shows a list of CWM applications, and the bottom pane contains the CWM Client Help Page link used to install the Java tools.

Cisco WAN Manager Installation Guide for Solaris 8 7-4 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 Chapter 7 Installing CWM Client Setting Up a Windows Based CWM Client

Figure 7-1 CWM Web Page

Step 3 Click on the CWM Client Help Page link at the bottom pane of the page. The resulting window is shown in Figure 7-2. This page contains a table of links to download Java Web Start and JRE 1.3 for both Solaris and Windows. It also contains installation instructions for installing the Java tools.

Cisco WAN Manager Installation Guide for Solaris 8 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 7-5 Chapter 7 Installing CWM Client Setting Up a Windows Based CWM Client

Figure 7-2 Client Help Page

Note The JRE tool should be installed first.

Step 4 Click on the appropriate Jave runtime link (In the Solaris column or the Windows column depending upon the type of client machine being used.) The download program displays a window requesting the user to specify where the download is to be saved. Note a convenient location and the name of the downloaded file (for example, the Windows JRE filename is Java Runtime 1.3.1 Win.exe). Step 5 Browse to the selected location on the window and click Save. A progress bar is displayed and the program is downloaded. Step 6 Using Solaris or Windows on the client machine, browse to the selected location and double click on the downloaded program. A software license agreement window is displayed. Step 7 Click Yes on the license agreement window. A window requesting the destination for the JRE is displayed as shown in Figure 7-3.

Cisco WAN Manager Installation Guide for Solaris 8 7-6 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 Chapter 7 Installing CWM Client Setting Up a Solaris Based CWM Client

Figure 7-3 Choose Destination Location Window

Accept the default destination by clicking Next. A progress bar is displayed while the JRE is installed.

Setting Up a Solaris Based CWM Client

This section describes the hardware, software, and web browser requirements for a Solaris based CWM client.

Hardware

The minimum hardware requirement s to run CWM Client Release 11 on a Sun Solaris based system are as follows. • Sun Ultra 5 with SCSI controller with a clock speed of at least 300 Mhz • 512 Mbytes of RAM • 50 Mbytes of free disk space • Ethernet connectivity to a CWM server machine

Software

The software requirement s to run CWM Client Release 11 on a Sun Solaris based system are as follows. • Solaris version 2.7 or 8 • IP connectivity to a CWM server machine • Netscape Communicator browser version 4.76 or later • Sun Microsystems Java Web Start version 1.0.1 or later • Sun Microsystems JRE version 1.3.1 (Solaris version) • Sun Microsystems Java Plug-in 1.3.1 (Solaris version used for CiscoView)

Cisco WAN Manager Installation Guide for Solaris 8 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 7-7 Chapter 7 Installing CWM Client Setting Up a Solaris Based CWM Client

Web Browser

The Solaris version of Netscape Communicator is used on a Solaris based client. The Sun Microsystems Netscape Communicator for the Solaris package (version 4.76) is included on the Cisco-provided CWM Server CD #2 under the file name of NSCPcom.sparc.tar.gz Install Netscape Communicator using the following steps.

Step 1 Log in to the CWM workstation as user root. Step 2 Insert the CWM server 11 CD #2 into the CD-ROM drive. Step 3 The NSCPcom.sparc.tar.gz file is located on the CD-ROM in the 110tools directory. You can check that it is present by changing to the tools directory and listing the files by entering the following commands. # cd /cdrom/cdrom0/110tools # ls

Step 4 Copy the Netscape file to the workstation hard drive. cp /cdrom/cdrom0/110tools/NSCPcom.sparc.tar.gz /tmp

Step 5 Copy the gzip utility to the workstation hard drive. cp /cdrom/cdrom0/110tools/gzip /tmp

Note If the CWM CD-ROMs are not available at the site of the client machine, the CD-ROM should be inserted in the CWM server machine and the NSCPcom.sparc.tar.gz and the gzip files FTP’d to the /tmp directory in the client machine. This method has the same effect as performing Steps 1–4

Step 6 Change to the tmp directory cd /tmp

Step 7 Change the permission of the copied gzip file so that it can be executed. chmod 555 /tmp gzip

Step 8 Unzip the Netscape Communicator file. ./gzip -d /tmp/NSCPcom.sparc.tar.gz

Step 9 Untar the file. tar xvf /tmp/NSCPcom.sparc.tar

Step 10 Install Netscape Communicator pkgadd -d /tmp NSCPcom

The pkgadd command installs the Netscape Communicator package in the /opt/NSCPcom directory. Step 11 Add the /opt/NSCPcom directory to the PATH variable.

Cisco WAN Manager Installation Guide for Solaris 8 7-8 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 Chapter 7 Installing CWM Client Setting Up a Solaris Based CWM Client

Installing Java Tools

Step 1 Ensure that the web browser is installed and running on the client machine. Step 2 Connect to the CWM server machine using its workstation name followed by :1551 (for example http://cwmhost:1551 or http://cwmhost.company.com:1551). 1551 is the software port number for the CWM Client web page The CWM server machine displays the CWM Client Launcher web page as shown in Figure 7-4. This page is made up of three panes. The top right pane shows the CWM logo, the top left pane shows a list of CWM applications, and the bottom pane contains the CWM Client Help Page link used to install the Java tools.

Cisco WAN Manager Installation Guide for Solaris 8 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 7-9 Chapter 7 Installing CWM Client Setting Up a Solaris Based CWM Client

Figure 7-4 CWM Web Page

Step 3 Click on the CWM Client Help Page link at the bottom pane of the page. The resulting window is shown in Figure 7-5. This page contains a table of links to download Java Web Start and JRE 1.3 for both Solaris and Windows. It also contains installation instructions for installing the Java tools.

Cisco WAN Manager Installation Guide for Solaris 8 7-10 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 Chapter 7 Installing CWM Client Setting Up a Solaris Based CWM Client

Figure 7-5 Client Help Page

Note The JRE tool should be installed before Java Web Start.

Step 4 Click on the appropriate Jave runtime link (In the Solaris column or the Windows column depending upon the type of client machine being used.)

Note To avoid mime type problems with downloading, right click the download link and choose “Save Link/Target As...”.

The download program displays a window requesting the user to specify where the download is to be saved. Save the downloaded file in the /tmp directory. Log in as root and type these commands: # cd /usr # chmod +x /tmp/j2re-1_3_1-solsparc.sh # /tmp/jr2-i_3_1-solsparc.sh

Step 5 A software license agreement window is displayed. Click Yes on the license agreement window. The JRE 1.3/1 is now installed in the /usr directory.

Cisco WAN Manager Installation Guide for Solaris 8 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 7-11 Chapter 7 Installing CWM Client Installing Java Web Start

Installing Java Web Start

When JRE 1.3.1 has been downloaded and installed, Java Web Start should be installed using the following procedure. This procedure is applicable to both Solaris and Windows based clients.

Step 1 Return to the CWM Help Page and click on the appropriate Java Web Start link (Solaris or Windows column). The download program displays a window requesting the user to specify where the download is to be saved. Note a convenient location and the name of the downloaded file (for example, the Windows filename is Java Web Start 1.0.1Win.exe). Step 2 Browse to the selected location on the window and click Save. A progress bar is displayed and the program is downloaded. Step 3 Using Solaris or Windows on the client machine, browse to the selected location and double click on the downloaded program. A software license agreement window is displayed. Step 4 Click Yes on the license agreement window. A window requesting the destination for the Java Web Start is displayed as shown in Figure 7-6.

Figure 7-6 Java Web Start Setup: Installation Directory Window

Step 5 Accept the default destination by clicking Next. A progress bar is displayed while the Java Web Start is installed.

Configuring Java Plug-in 1.3.1

With the completion of step 5 above, JRE 1.3.1 and Java Web Start have been downloaded and installed. As part of the JRE 1.3.1 installation process, the Java Plug-in 1.3.1 (required by CiscoView) has also been installed. On Windows based clients, no further action is required and CiscoView can be launched from within CWM client.

Cisco WAN Manager Installation Guide for Solaris 8 7-12 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 Chapter 7 Installing CWM Client Launching CWM Client

On Solaris based clients, the path to the plug-in has to be set in the .cshrc file. Set the path using the following procedure.

Step 1 Start an editor and open the .cshrc file in the /usr/users/svplus directory. Step 2 Add the following line to the .cshrc file. setenv NPX_PLUGIN_PATH /usr/j2re1_3_1/plugin/sparc/ns4

Step 3 Save the changes. Step 4 Close the editor

Note Executing the source .cshrc command will cause the PATH change to take effect immediately.

Launching CWM Client

This section describes the methods by which the user can launch CWM Client. When the client machine is running Solaris or Windows 2000 and the network browser and Java tools have been installed, there are several methods available for launching the Cisco CWM Client. The first time (but only the first time) that CWM Client is to be launched, the user must start the web browser and connect to the CWM Server to display the CWM Client Launch page. The client can then be launched by clicking on the appropriate part of the page. After the client has been launched for the first time, subsequent launches can be performed either through the web browser (described above), through the Java Web Start Manager or through a CWM application desktop shortcut icon. In each case the CWM Client is launched. The software is downloaded or not from the CWM server depending upon whether it is resident in the client machine. Any local copy of CWM Client is checked at the server to see if it is the latest version. If it is not, the most current version is downloaded and launched. This feature ensures that if a later version CWM Client is installed on the CWM server, it will automatically be available at the client machine.

Web Browser Method

To launch CWM Client using the web browser, perform the following steps.

Step 1 Check that the web browser is installed and running on the client machine. Step 2 Connect to the CWM server machine using its workstation name followed by :1551 (for example http://cwmhost:1551 or http://cwmhost.company.com:1551). 1551 is the software port number for the CWM Client web page Step 3 The CWM server machine displays its web page as shown in Figure 7-7.

Cisco WAN Manager Installation Guide for Solaris 8 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 7-13 Chapter 7 Installing CWM Client Launching CWM Client

Figure 7-7 CWM Web Page

Step 4 To launch CWM, click on the Cisco WAN Manager picture in the top right pane. To launch a specific CWM application, click on one of the menu items in the top left pane.

Java Web Start Application Manager Method

To use the Java Web Start Application Manager, first start the Application Manager either by clicking the Java Web Start icon on the desktop or selecting Java Web Start in the Windows Start Menu. Figure 7-8 shows an example of the Java Web Start Application Manager window.

Cisco WAN Manager Installation Guide for Solaris 8 7-14 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 Chapter 7 Installing CWM Client Launching CWM Client

Figure 7-8 Java Web Start Application Manager Window

Click on the appropriate icon to launch the desired application. Only applications that have previously been downloaded (by another method) will show up in this window. Make sure that the text above the icons says Downloaded Applications. If it does not use the View menu to select Downloaded Applications.

Desktop Shortcut Method

If the same CWM application is launched two times, Java Web Start will ask the user if a desktop shortcut should be created (see Figure 7-9). To create an shortcut click the appropriate box(es) and click Yes. Thereafter, the application can be started merely by clicking the shortcut (either on the desktop or the Start Menu).

Figure 7-9 Java Web Start Shortcut Window

Cisco WAN Manager Installation Guide for Solaris 8 Release 11, Part Number 78-14230-01, Rev. F0, October 2003 7-15 Chapter 7 Installing CWM Client Launching CWM Client

Cisco WAN Manager Installation Guide for Solaris 8 7-16 Release 11, Part Number 78-14230-01, Rev. F0, October 2003