Installing CWM Client

Transcription

1 CHAPTER 6 This chapter provides an introduction to CWM Client in CWM Release 15.1 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) 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 either of two methods. 1. Start the web browser, connect to the CWM server ( 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. 6-1

2 Setting Up a Windows Based CWM Client Chapter 6 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.1 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.1 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 (Windows version) Sun Microsystem s Java Web Start version

3 Chapter 6 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: 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 3 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 On the desktop, right click on the My Computer icon. Select Properties. 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. 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 3 Step 4 Step 5 Step 6 Quit Netscape Navigator. Start Internet Explorer. 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). Exit Internet Explorer. Click on the Windows Start button -> Search -> For Files or Folders. 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. 6-3

4 Setting Up a Windows Based CWM Client Chapter 6 Step 8 Step Start Netscape Navigator. When the Netscape Navigator window asks if it should be the default browser, choose 'Yes'. Exit Netscape Navigator. 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 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. Ensure that the web browser is installed and running on the client machine. Connect to the CWM server machine using its workstation name followed by:1551 (for example or 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. 6-4

5 Chapter 6 Setting Up a Windows Based CWM Client 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 Setting Up a Windows Based CWM Client Chapter 6 Figure 6-2 Client Help Page Step 4 Step 5 Step 6 Step 7 Step 8 Although not shown, the help page also contains installation instructions for installing the Java tools. 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). Browse to the selected location on the window and click Save. A progress bar is displayed and the program is downloaded. 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. Select the I agree button on the license agreement window and click Next. The j2re-1_4_2_02 install wizard starts. 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. 6-6

7 Chapter 6 Setting Up a Solaris Based CWM Client 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.1 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 Release 15.1 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 (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 3 Step 4 Step 5 Log in to the CWM workstation as user root. Insert the CWM Documentation CD-ROM into the CD-ROM drive. 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 # ls Copy the Netscape file to the workstation hard drive. cp /cdrom/cdrom0/1500tools/nscpcom.476.sparc.tar /tmp Copy the gzip utility to the workstation hard drive. cp /cdrom/cdrom0/1500tools/gzip /tmp 6-7

8 Setting Up a Solaris Based CWM Client Chapter 6 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 Step 7 Step 8 Step Change to the tmp directory. cd /tmp Change the permission of the copied gzip file so that it can be executed. chmod 1555 /tmp gzip Unzip the Netscape Communicator file../gzip -d /tmp/nscpcom.476.sparc.tar Untar the file. tar xvf /tmp/nscpcom.476.sparc.tar Install Netscape Communicator. pkgadd -d /tmp NSCPcom The pkgadd command installs the Netscape Communicator package in the /opt/nscpcom directory. 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 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. Ensure that the web browser is installed and running on the client machine. Connect to the CWM server machine using its workstation name followed by:1551 (for example or 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. 6-8

9 Chapter 6 Setting Up a Solaris Based CWM Client 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 for both Solaris and Windows. It also contains installation instructions for installing the Java tools. 6-9

10 Setting Up a Solaris Based CWM Client Chapter 6 Figure 6-4 Client Help Page Follow these steps to install J2RE v1.4.2 on Solaris. Download the j2re-1_4_2_02-solaris-sparc.sh file by choosing the Java Runtime Sol-bin link from the table above. Save the downloaded file to the /tmp directory. Step 3 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 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 6-10

11 Chapter 6 Launching CWM Client $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 is now installed in the /usr directory. Configuring Java Plug-in 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 3 Step 4 Start an editor and open the.cshrc file in the /usr/users/svplus directory. Add the following line to the.cshrc file. setenv NPX_PLUGIN_PATH /usr/j2re1_4_2/plugin/sparc/ns4 Save the changes. 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. 6-11

12 Launching CWM Client Chapter 6 Web Browser Method To launch CWM Client using the web browser, perform the following steps. Check that the web browser is installed and running on the client machine. Connect to the CWM server machine using its workstation name followed by :1551 (for example or 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. 6-12

13 Chapter 6 Launching CWM Client Desktop Shortcut Method To add a CWM Client application desktop shortcuts, perform the following steps: Step 3 Ensure that the web browser is installed and running on the client machine. Connect to the CWM server using its workstation name followed by:1551 (for example, or is the software port number for the CWM Client web page. Drag any of the CWM applications launch points to the desktop. 6-13

14 Launching CWM Client Chapter