Cisco WAN Manager Installation and Configuration Guide, 15.0
Installing CWM Client

Table Of Contents

Installing CWM Client

Overview of CWM Client

Setting Up a Windows Based CWM Client

Hardware

Software

Web Browser

Making Netscape Communicator the Default Browser

Installing Java Tools

Setting Up a Solaris Based CWM Client

Hardware

Software

Web Browser

Installing Java Tools

Configuring Netscape for Web Start use on Solaris Platforms:

Configuring Java Plug-in 1.4.2

Launching CWM Client

Web Browser Method

Java Web Start Application Manager Method

Desktop Shortcut Method


Installing CWM Client


This chapter provides an introduction to CWM Client in CWM Release 15 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.

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.4.2 software, and Sun Microsystem's Java Web Start tool all of which must need to be installed on the client machine.

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 (http://cwmserver:1551/ where cwmserver is the name of your CWM server machine), and click one of the CWM client 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 CWM Client for the first time. However, they can be used for subsequent downloads and launches.


Each of these methods produces the same results.


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

If installing a web browser after Web Start is installed, it is required to either manually set the MIME type (JNLP), or re-install Web Start. Reinstalling Web Start will automatically set the JNLP MIME type. To manually set the MIME Type for Netscape, choose Edit-> Preferences-> Navigator-> Helper Applications section. Add the file extension is jnlp and the MIME Type is application/x-java-jnlp-file.

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 15 on a Microsoft Windows based PC are as follows:

Intel Pentium III (or compatible) processor with a clock speed of at least 750 Mhz

512 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 15 on a Microsoft Windows based PC are as follows:

Microsoft Windows 2000 operating systems

IP connectivity to a CWM server machine

Netscape Communicator version 4.76 or later

Sun Microsystems JRE version 1.4.2 (Windows version)

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. Follow the download and install instructions.

The browser requires that 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. Select Properties.

Step 3 Click on the Advanced tab. 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 OK.


Making Netscape Communicator the Default Browser

For users who 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. 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'. This file is 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.

Step 8 Start Netscape Navigator.

Step 9 When the Netscape Navigator window asks if it should be the default browser, choose '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

CWM Client requires the following Java tool.

Java Runtime Environment (J2RE) version 1.4.2

This tool is included in the CWM Server CD-ROM. It is stored in the CWM server machine automatically when the CWM server software is installed. This program is 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 6-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.

Figure 6-1 CWM Web Page

Step 3 Click on the CWM Client Help tab at the top of the page.

This help page contains a table of links to download J2RE 1.4.2 for both Solaris and Windows. This is shown is shown in Figure 6-2.

Figure 6-2 Client Help Page

Although not shown, the help page also contains installation instructions for installing the Java tools.

Step 4 Click on the appropriate Jave runtime link (in the Solaris column or in 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 the name of the downloaded file (for example, the Windows J2RE filename is j2re-1_4_2_01-windows-i586.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 name or icon.

A software license agreement window is displayed.

Step 7 Select the I agree button on the license agreement window and click Next. The j2re-1_4_2_01 install wizard starts.

Step 8 In the Setup Type window, select either the Typical or Custom button.
If you select Typical, click Next to start the installation.
If you select Custom, specify a destination location for the installation and click Next to start the installation.


Note Installing J2RE also installs Java Web Start automatically.



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 requirements to run CWM Client Release 15 on a Sun Solaris based system are as follows.

Sun Ultra 15 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 requirements to run CWM Client Release 15 on a Sun Solaris based system are as follows.

Solaris version 2.8

IP connectivity to a CWM server machine

Netscape Communicator version 4.76 or later

Sun Microsystems J2RE version 1.4.2 (Solaris version)

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 Documentation CD-ROM 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 Documentation CD-ROM into the CD-ROM drive.

Step 3 The NSCPcom.sparc.tar.gz file is located on the CD-ROM in the 1500tools 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/500tools
# ls 

Step 4 Copy the Netscape file to the workstation hard drive.

cp /cdrom/cdrom0/500tools/NSCPcom.sparc.tar.gz /tmp

Step 5 Copy the gzip utility to the workstation hard drive.

cp /cdrom/cdrom0/500tools/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. FTP the NSCPcom.sparc.tar.gz and the gzip files 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 1555 /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.


Installing Java Tools

The following Java tool is required to run CWM client:

Java Runtime Environment (JRE) version 1.4.2

This tool is included in the CWM Server CD-ROM. It is stored in the CWM server machine automatically when the CWM server software is installed. This program is then available for downloading to the CWM client machine.

To install the Java tools, perform the following steps.


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 6-3. 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.

Figure 6-3 CWM Web Page

Step 3 Click on the Help Tab link at the top of the page. The resulting window is shown in Figure 6-4.

This page contains a table of links to download Java Web Start and JRE 1.4.2 for both Solaris and Windows. It also contains installation instructions for installing the Java tools.

Figure 6-4 Client Help Page

Follow these steps to install J2SE v1.4.2 on Solaris.


Step 1 Download the j2re-1_4_2_01-solaris-sparc.sh file by choosing the Java Runtime 1.4.2
Sol-bin link from the table above. Save the downloaded file to the /tmp directory.

Step 2 Login as root to install J2SE v1.4.2 in /usr, type these commands:

# cd /usr

# chmod +x /tmp/j2re-1_4_2_01-solaris-sparc.sh

# /tmp/j2re-1_4_2_01-solaris-sparc.sh

Step 3 Answer yes to licensing agreement

The previous steps install J2SE v1.4.2 in /usr/j2re1.4.2_01. Web Start is installed at /usr/j2re1.4.2_01/javaws.

Configuring Netscape for Web Start use on Solaris Platforms:

The J2SE installation script will update the $HOME/.mailcap and $HOME/.mime.types files for the user that installed the JRE (Java TM Runtime Environment). These files enable Netscape to invoke Web Start when a JNLP link is encountered. Note, since the JRE installation will normally be run as root, any other users will need to manually update their own $HOME/.mailcap and $HOME/.mime.types files for Netscape to recognize Web Start applications. The following entries should be made in $HOME/.mailcap and $HOME/.mime.types if Web Start is installed in /usr/javaws:

$HOME/.mailcap should contain this line:

application/x-java-jnlp-file; /usr/javaws/javaws %s

$HOME/.mime.types should contain this line:

type=application/x-java-jnlp-file desc="Java Web Start" exts="jnlp"

A software license agreement window is displayed. Click Yes on the license agreement window.

The JRE 1.4.2 is now installed in the /usr directory.


Configuring Java Plug-in 1.4.2

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_4_2/plugin/sparc/ns4

Step 3 Save the changes.

Step 4 Close the editor



Note Entering 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 (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 6-5.

Figure 6-5 CWM Web Page

Step 4 To launch a CWM application, click on one of the menu items.


Java Web Start Application Manager Method

To use the Java Web Start Application Manager, first start the Application Manager either do this either by clicking the Java Web Start icon on the desktop or by choosing Java Web Start in the Windows Start Menu.

Figure 6-6 shows an example of the Java Web Start Application Manager window.

Figure 6-6 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 the text does not say Downloaded Applications, 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 6-7). To create a 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 on the Start Menu).

Figure 6-7 Java Web Start Shortcut Window