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 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 the CWM client application Java jar files 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 1.4.2 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 either of two 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.
If a CWM client desktop shortcut has been created, click the desktop icon to launch the application.
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 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 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 Microsystem's JRE version 1.4.2 (Windows version)
•
Sun Microsystem's Java Web Start version 1.4.2
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_02 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_02-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_02 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 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 requirements to run CWM Client on a Sun Solaris based system are as follows.
•
Solaris version 2.8 or 2.9
•
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.476.sparc.tar
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.476.sparc.tar 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/1500tools
Step 4
Copy the Netscape file to the workstation hard drive.
cp /cdrom/cdrom0/1500tools/NSCPcom.476.sparc.tar /tmp
Step 5
Copy the gzip utility to the workstation hard drive.
cp /cdrom/cdrom0/1500tools/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.476.sparc.tar 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.
Step 7
Change the permission of the copied gzip file so that it can be executed.
Step 8
Unzip the Netscape Communicator file.
./gzip -d /tmp/NSCPcom.476.sparc.tar
Step 9
Untar the file.
tar xvf /tmp/NSCPcom.476.sparc.tar
Step 10
Install Netscape Communicator.
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 J2RE v1.4.2 on Solaris.
Step 1
Download the j2re-1_4_2_02-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 J2re v1.4.2_02 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 J2RE 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 J2RE 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) 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
To add a CWM Client application desktop shortcuts, 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 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
Drag any of the CWM applications launch points to the desktop.