Installing CWM Client

Transcription

1 Overview of CWM Client 7 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. 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) 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 to be installed. However, this is a component of JRE 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. 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. 7-1

2 Setting Up a Windows Based CWM Client 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 (Windows version) Sun Microsystems Java Plug-in (Windows version, used for CiscoView) 7-2

3 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. Then follow the download and install instructions. The browser requires that the it s path be set using the following procedure: Step 1 Step 2 Step 3 Locate the appropriate browser executable file (netscape.exe for Netscape Communicator and IEXPLORE.EXE for Internet Explorer). 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 and select Properties. 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 Step 2 Step 3 Step 4 Step 5 Step 6 Quit Netscape Navigator. Start Internet Explorer. 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). Exit Internet Explorer. Click on the Windows Start button -> Search -> For Files or Folders. Find the file named 'prefs.js', typically under Documents and Settings\All Users\Application Data\Netscape\Users\default\. 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. 7-3

4 Setting Up a Windows Based CWM Client Step 8 Step 9 Step 10 Step 11 Start Netscape Navigator. When Netscape Navigator asks if it should be the default browser, answer 'Yes'. Exit Netscape Navigator. 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 Java plug-in (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 Step 2 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 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. 7-4

5 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. 7-5

6 Setting Up a Windows Based CWM Client Figure 7-2 Client Help Page The JRE tool should be installed first. Step 4 Step 5 Step 6 Step 7 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. a convenient location and the name of the downloaded file (for example, the Windows JRE filename is Java Runtime Win.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. A software license agreement window is displayed. Click Yes on the license agreement window. A window requesting the destination for the JRE is displayed as shown in Figure

7 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 or later Sun Microsystems JRE version (Solaris version) Sun Microsystems Java Plug-in (Solaris version used for CiscoView) 7-7

8 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 Step 2 Step 3 Step 4 Step 5 Log in to the CWM workstation as user root. Insert the CWM server 11 CD #2 into the CD-ROM drive. 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 Copy the Netscape file to the workstation hard drive. cp /cdrom/cdrom0/110tools/nscpcom.sparc.tar.gz /tmp Copy the gzip utility to the workstation hard drive. cp /cdrom/cdrom0/110tools/gzip /tmp 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 Step 7 Step 8 Step 9 Step 10 Step 11 Change to the tmp directory cd /tmp Change the permission of the copied gzip file so that it can be executed. chmod 555 /tmp gzip Unzip the Netscape Communicator file../gzip -d /tmp/nscpcom.sparc.tar.gz Untar the file. tar xvf /tmp/nscpcom.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. 7-8

9 Setting Up a Solaris Based CWM Client Installing Java Tools The following Java tools are required to run CWM client: Java Web Start Java Runtime Environment (JRE) version Java plug-in (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 Step 2 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 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. 7-9

10 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. 7-10

11 Setting Up a Solaris Based CWM Client Figure 7-5 Client Help Page 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.) 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. 7-11

12 Installing Java Web Start Installing Java Web Start When JRE 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 Step 2 Step 3 Step 4 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. a convenient location and the name of the downloaded file (for example, the Windows filename is Java Web Start 1.0.1Win.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. A software license agreement window is displayed. 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 With the completion of step 5 above, JRE and Java Web Start have been downloaded and installed. As part of the JRE installation process, the Java Plug-in (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. 7-12

13 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 Step 2 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_3_1/plugin/sparc/ns4 Save the changes. Close the editor. 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 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

14 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. 7-14

15 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 7-15

16 Launching CWM Client 7-16