SPECTRUM Web Operator

Transcription

1

2 Notice Copyright Notice Copyright 2002 by Aprisma Management Technologies, Inc. All rights reserved worldwide. Use, duplication, or disclosure by the United States government is subject to the restrictions set forth in DFARS (c)(1)(ii) and FAR Liability Disclaimer Aprisma Management Technologies, Inc. ( Aprisma ) reserves the right to make changes in specifications and other information contained in this document without prior notice. In all cases, the reader should contact Aprisma to inquire if any changes have been made. The hardware, firmware, or software described in this manual is subject to change without notice. IN NO EVENT SHALL APRISMA, ITS EMPLOYEES, OFFICERS, DIRECTORS, AGENTS, OR AFFILIATES BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATED TO THIS MANUAL OR THE INFORMATION CONTAINED IN IT, EVEN IF APRISMA HAS BEEN ADVISED OF, HAS KNOWN, OR SHOULD HAVE KNOWN, THE POSSIBILITY OF SUCH DAMAGES. Trademark, Service Mark, and Logo Information SPECTRUM, IMT, and the SPECTRUM IMT/VNM logo are registered trademarks of Aprisma Management Technologies, Inc., or its affiliates. APRISMA, APRISMA MANAGEMENT TECHNOLOGIES, the APRISMA MANAGEMENT TECHNOLOGIES logo, MANAGE WHAT MATTERS, DCM, VNM, SpectroGRAPH, SpectroSERVER, Inductive Modeling Technology, Device Communications Manager, SPECTRUM Security Manager, and Virtual Network Machine are unregistered trademarks of Aprisma Management Technologies, Inc., or its affiliates. For a complete list of Aprisma trademarks, service marks, and trade names, go to: All referenced trademarks, service marks, and trade names identified in this document, whether registered or unregistered, are the intellectual property of their respective owners. No rights are granted by Aprisma Management Technologies, Inc., to use such marks, whether by implication, estoppel, or otherwise. If you have comments or concerns about trademark or copyright references, please send an to spectrum-docs@aprisma.com; we will do our best to help. Restricted Rights Notice (Applicable to licenses to the United States government only.) This software and/or user documentation is/are provided with RESTRICTED AND LIMITED RIGHTS. Use, duplication, or disclosure by the government is subject to restrictions as set forth in FAR (June 1987) Alternate III(g)(3) (June 1987), FAR (June 1987), or DFARS (c)(1)(ii) (June 1988), and/or in similar or successor clauses in the FAR or DFARS, or in the DOD or NASA FAR Supplement, as applicable. Contractor/manufacturer is Aprisma Management Technologies, Inc. In the event the government seeks to obtain the software pursuant to standard commercial practice, this software agreement, instead of the noted regulatory clauses, shall control the terms of the government's license. Virus Disclaimer Aprisma makes no representations or warranties to the effect that the licensed software is virus-free. Aprisma has tested its software with current virus-checking technologies. However, because no antivirus system is 100-percent effective, we strongly recommend that you write protect the licensed software and verify (with an antivirus system with which you have confidence) that the licensed software, prior to installation, is virus-free. Contact Information Aprisma Management Technologies, Inc., 273 Corporate Drive, Portsmouth, NH USA Phone: U.S. toll-free: Web site: Page 2

3 Contents Notice... 2 Preface... 5 Intended Audience... 5 Text Conventions... 5 Document Feedback... 6 Aprisma Technical Assistance Center (ATAC) Contact Information... 6 Online Documents... 6 Overview... 7 About... 7 Where to Start... 8 Does Your System Meet Installation Requirements?... 8 Minimum Requirements for Web Operator Servers... 9 Minimum Requirements for the Web Operator Client...10 Documentation Requirements...11 Installation Considerations...11 Upgrading From an Earlier Version Of Web Operator Upgrading from Version 2.0 to on Solaris...13 Upgrading from Version 2.0 to on Windows...15 Upgrading from Version 2.5 or 2.6 to on Solaris...17 Upgrading from Version 2.5 or 2.6 to on Windows...19 Installing Web Operator Server on Solaris Setting up the Server Environment on Solaris...21 Installing Java 2 SDK on Solaris...22 Running the Installation Software on Solaris...23 Installing Web Operator Server on Windows 2000/NT Setting up the Server Environment on Windows...25 Installing Java 2 SDK on Windows...26 Running the Installation Software on Windows...27 Page 3

4 Installing Web Operator Client on Solaris Installing Java JRE, Including Plug-in on Solaris...30 Setting the Plug-in Path on Solaris...33 Installing Web Operator Client on Windows Installing Java JRE, Including Plug-in, on Windows...34 Starting Web Operator Uninstalling Web Operator Uninstalling Web Operator on Solaris...37 Uninstalling Web Operator on Windows...38 Configuring Web Operator for Non-DNS Environments About Non-DNS Environments...39 Changing the ServerName Option on Solaris...39 Changing the ServerName option on Windows NT and Windows Index Page 4

5 Preface In this section: Intended Audience [page 5] Text Conventions [page 5] Document Feedback [page 6] Online Documents [page 6] Intended Audience This guide is intended for SPECTRUM administrators responsible for installing. It provides Web Operator installation information in a task-based format that can be employed as a personal reference guide or as part of a training materials package. Text Conventions The following text conventions are used in this document: Element Convention Used Example User-supplied parameter names Courier and italic in angle brackets <>. The user needs to type the password in place of <password>. On-screen text Courier The following line displays: path= /audit User-typed text Courier Type the following path name: C:\ABC\lib\db Cross-references References to SPECTRUM documents (title and number) Underlined and hypertextblue Italic See Document Feedback [page 6]. SPECTRUM (0675) Page 5

6 Document Feedback Please send feedback regarding SPECTRUM documents to the following address: Thank you for helping us improve our documentation. Aprisma Technical Assistance Center (ATAC) Contact Information Contact the ATAC by calling the toll-free number for your region (listed on the Aprisma support Web site global_atac.shtml, or by calling (603) Online Documents SPECTRUM documents are available online at: Check this site for the latest updates and additions. Page 6

7 Overview In this section: About [page 7] Where to Start [page 8] Does Your System Meet Installation Requirements? [page 8] Installation Considerations [page 11] About consists of a server-based component and a client-based component, each of which requires different software. The Web Operator server requires the Apache Web server, Tomcat servlet engine, MySQL database management system, and Java 2 Software Development Kit (SDK). Client workstations require a Web browser and Java 2 Runtime Environment (JRE). With the exception of a Web browser, the SPECTRUM application CD and Web Operator server provide all the software required to install and run Web Operator. Table 1 lists the software and corresponding version number provided on the CD and Web Operator server. Note: Aprisma has tested and certified the software provided on the SPECTRUM application CD and Web Operator server. Later versions of software have not been tested but can be used at your own discretion. Table 1: Required Software and Versions Software Version Apache Web Server Tomcat Servlet Engine 3.1 MySQL Database Management System Java 2 Software Development Kit (SDK), Standard Edition a (Windows), (Solaris) Page 7

8 Software Java 2 Runtime Environment (JRE), including plug-in Version Where to Start Before you begin, read Does Your System Meet Installation Requirements? [page 8] and then choose the type of installation that meets your requirements. See Table 2: Installations and Procedures: Table 2: Installations and Procedures Type of Installation First time server installation on Solaris First time client installation on Solaris First time server installation on Windows First time client installation on Windows Upgrading from version 2.0 to on Solaris Upgrading from version 2.0 to on Windows Upgrading from version 2.5/ 2.6 to on Solaris Upgrading from version 2.5/ 2.6 to on Windows Procedure Installing Web Operator Server on Solaris [page 21] Installing Web Operator Client on Solaris [page 30] Installing Web Operator Server on Windows 2000/NT [page 25] Installing Web Operator Client on Windows [page 34] Upgrading from Version 2.0 to on Solaris [page 13] Upgrading from Version 2.0 to on Windows [page 15] Upgrading from Version 2.5 or 2.6 to on Solaris [page 17] Upgrading from Version 2.5 or 2.6 to on Windows [page 19] Does Your System Meet Installation Requirements? This section lists the minimum specifications for running SPECTRUM Web Operator. Meeting or exceeding these requirements ensures that Web Operator performs per specification on your system. Also, make sure you carefully read the documentation requirements and installation considerations detailed in this section. Page 8

9 Minimum Requirements for Web Operator Servers Before installing the Web Operator server, make sure your Solaris or Windows workstation meets the requirements listed in Table 3: Web Operator Server Requirements (Solaris), or Table 4: Web Operator Server Requirements (Windows). Table 3: Web Operator Server Requirements (Solaris) Component Requirement Operating System Sun SPARCstation/Solaris 2.7 and 2.8 Processor Free Hard Disk Space RAM UltraSPARC I at 167 MHz (or faster) 80 MB Note: For the Web Operator Suite, additional space is required for the alarm and event databases, approximately 57 KB per 1000 events. 128 MB (minimum) Java Components Java 2 SDK version Table 4: Web Operator Server Requirements (Windows) Component Operating System Processor Free Hard Disk Space RAM Service Pack Requirement Microsoft Windows NT 4.0 and Windows 2000 Intel-based Systems 400 MHz Pentium II 80 MB Note: For the Web Operator Suite, additional space is required for the alarm and event databases, approximately 57 KB per 1000 events. 128 MB (minimum) Windows NT Service Pack 6a or higher Windows Service Pack 1 supported, if present Java Components Java 2 SDK version Windows Components For the Web Operator Suite Event and Alarm Reports, you need Windows Task Scheduler. Page 9

10 Minimum Requirements for the Web Operator Client Before installing the client, make sure your workstation meets the requirements listed in Table 5: Web Operator Client Requirements (Solaris) or Table 6: Web Operator Client Requirements (Windows). Table 5: Web Operator Client Requirements (Solaris) Component Requirement Operating System Sun SPARCstation/Solaris 2.7 and 2.8 Processor RAM Java Components Web Browser UltraSPARC I at 167 MHz (or faster) 128 MB (minimum) Java 2 Runtime Environment (JRE) version 1.3.1, including plug-in Solaris Netscape 4.7x (from Sun) Important: You must have Cookies, Java, and JavaScript enabled in the Web browser. Table 6: Web Operator Client Requirements (Windows) Component Operating System Processor RAM Service Pack Java Components Requirement Microsoft Windows NT 4.0 and Windows 2000 Intel-based Systems Pentium-Pro 200 MHz (or faster) 128 MB (minimum) Windows NT Service Pack 6a or higher Windows Service Pack 1 supported, if present Java 2 Runtime Environment (JRE) version 1.3.1, including plug-in Web Browser Windows Internet Explorer 5.x or 6.0 Windows Netscape 4.7x or 6.1 Important: You must have Cookies, Java, and JavaScript enabled in the Web browser. Page 10

11 Documentation Requirements Before installing Web Operator, read the SPECTRUM Software Release Notice (0743), which describes new features and identifies any known anomalies. Installation Considerations Although you can install on your production SpectroSERVER host workstation, doing this on a single-cpu workstation may degrade the performance of the SpectroSERVER, as well as. To maximize the performance of the SpectroSERVER and the in a single-cpu environment, we recommend that you do not install on your production SpectroSERVER host workstation. If you need to combine both SPECTRUM and Web Operator on a single workstation, install SPECTRUM first, and then install Web Operator. Here are some additional performance related considerations: Avoid installing Web Operator on a workstation where another web server is running. Doing this can result in port and/or Java conflicts. For example, CiscoWorks2000 (which utilizes Apache and is written in Java) conflicts with Web Operator when run on the same workstation. Avoid installing third-party applications that use MySQL. Their presence could cause unwanted and unexpected results, such as errors in running Archive Manager and. Run the Web Operator Suite from a remote workstation separate from the production SpectroSERVER(s). Keep the number of alarms at an absolute minimum. The alarm proxy executable can be very CPU intensive if more than about 50 alarms are left unresolved or uncleared, especially since the alarms automatically refresh frequently. Minimize the number of clients connecting to the same SpectroSERVER workstation. Multiple proxy connections slow down SPECTRUM Web Operator, as well as put additional workload on the SpectroSERVER. Page 11

12 Upgrading From an Earlier Version Of Web Operator This section explains how to upgrade Web Operator from version 2.0, 2.5, or 2.6 to version It also explains how to retain any global or user preferences you may have created in an earlier version of Web Operator. In this section: Note: For more information about preference files, see the Administrator Guide (5079). Upgrading from Version 2.0 to on Solaris [page 13] Upgrading from Version 2.0 to on Windows [page 15] Upgrading from Version 2.5 or 2.6 to on Solaris [page 17] Upgrading from Version 2.5 or 2.6 to on Windows [page 19] Page 12

13 Upgrading from Version 2.0 to on Solaris The following procedure explains how to upgrade the SPECTRUM Web Operator server from version 2.0 to version It also explains how to retain any global or user preferences you may have created for Alarm Manager in 2.0. In 6.5.1, user preference files for Alarm Manager are located in the following directory: <install dir>/webapps/sg-support/csresource/preferences/walrm Procedure Note: <install dir> is the directory in which you installed On the workstation running Web Operator server, log in as root. 2. Stop the Apache Web Server. /etc/rc2.d/s97apachectl stop 3. Remove the S97apachectl file. rm /etc/rc2.d/s97apachectl 4. Remove the K30apachectl file. rm /etc/rc0.d/k30apachectl 5. Do one of the following: If you modified global or user preferences for Alarm Manager in 2.0, go to step 6. If you did not modify user preferences for Alarm Manager in 2.0, complete the procedures detailed in Installing Web Operator Server on Solaris [page 21]. 6. Navigate to the following directory: <install directory>/webapps/web/cgi-bin/alarm/prefs Note: <install directory> is the directory in which you installed Move all user preference files from the prefs directory to a temporary directory (for example, /temp). Page 13

14 8. Complete the procedures detailed in Installing Web Operator Server on Solaris [page 21]. 9. After you have successfully installed 6.5.1, move the user preference files from the temporary directory (for example, /temp) to the walrm directory. The path of walrm is: <new install dir>/webapps/sg-support/csresource/preferences/ walrm Note: <new install dir> is the directory in which you just installed Copy any new preferences you want to use from the walrm_example.prf file to the walrm.prf file. The path of walrm_example.prf and walrm.prf is: <new install dir>/webapps/sg-support/csresource/ preferences 11. Copy any new preferences you want to use from the walrm_example.prf file to each user preference file. The path of walrm_example.prf and each user preference file is: <new install dir>/webapps/sg-support/csresource/ preferences/ walrm Page 14

15 Upgrading from Version 2.0 to on Windows The following procedure explains how to upgrade the SPECTRUM Web Operator server from 2.0 to It also explains how to retain any global or user preferences you may have created for Alarm Manager in 2.0. In 6.5.1, user preference files for Alarm Manager are located in the following directory: <new install dir>\webapps\sgsupport\csresource\ preferences\walrm Procedure Note: <new install dir> is the directory in which you installed If you are using Microsoft s Internet Information Services (IIS) Web Server for the sole purpose of supporting a previous version of, you must uninstall the Web Server, using the Windows Control Panel Add/Remove Programs utility. Note: Rather than the IIS Web Server, SPECTRUM Web Operator requires the Apache Web Server and the Tomcat Server, which it supplies during the Web Operator installation. 2. Do one of the following: If you modified global or user preferences for Alarm Manager in 2.0, go to step 3. If you did not modify global or user preferences for Alarm Manager in 2.0, complete the procedures detailed in Installing Web Operator Server on Windows 2000/NT [page 25]. 3. Navigate to following directory: <install directory>\webapps\web\cgi-bin\alarm\prefs Note: <install directory> is the directory in which you installed Move all user preference files from the prefs directory to a temporary directory (for example, \temp). 5. Complete the procedures detailed in Installing Web Operator Server on Windows 2000/NT [page 25]. Page 15

16 6. After you have successfully installed 6.5.1, move the user preference files from the temporary directory (for example, \temp) to the walrm directory. The path of walrm is: <new install dir>\webapps\sg-support\csresource\ preferences\walrm Note: <new install dir> is the directory in which you just installed Copy any new Alarm Manager preferences you want to use from the walrm_example.prf file to the walrm.prf file. The path of walrm_example.prf and walrm.prf is: <new install dir>\webapps\sg-support\csresource\preferences 8. Copy any new preferences you want to use from the walrm_example.prf file to each user preference file. The path of walrm_example.prf file and each user preference file is: <new install dir>\webapps\sg-support\csresource\ preferences\walrm Page 16

17 Upgrading from Version 2.5 or 2.6 to on Solaris The following procedure explains how to upgrade the SPECTRUM Web Operator server from version 2.5 or 2.6 to version It also explains how to retain any global or user preferences you may have created for Alarm Manager or Model Browser in 2.5 or 2.6. Procedure 1. Do one of the following: If you modified global or user preferences for Alarm Manager or Model Browser in 2.5/2.6, go to step 2. If you did not modify global or user preferences for Alarm Manager or Model Browser in 2.5/2.6, complete the procedures detailed in Installing Web Operator Server on Solaris [page 21]. 2. In the <install dir>/webapps/sg-support/csresource/ preferences directory, move.alarm.prf to walrm.prf and.browser.prf to browser.prf. Note: <install directory> is the directory in which you installed 2.5/ Complete the procedures detailed in Installing Web Operator Server on Solaris [page 21]. 4. After you have successfully installed 6.5.1, navigate to the following directory: <new install dir>/webapps/sg-support/csresource/ preferences Note: <new install dir> is the directory in which you just installed Copy any new Alarm Manager preferences you want to use from the walrm_example.prf file to the walrm.prf file. 6. Copy any new Model Browser preferences you want to use from the browser_example.prf file to the browser.prf file. 7. Navigate to the following directory: <new install dir>/webapps/sg-support/csresource/ preferences/walrm directory Page 17

18 8. Copy any new Alarm Manager preferences you want to use from the walrm_example.prf file to each user preference file. 9. Navigate to the following directory: <new install dir>/webapps/sg-support/csresource/ preferences/ browser 10. Copy any new Model Browser preferences you want to use from the browser_example.prf file to each user preference file. Page 18

19 Upgrading from Version 2.5 or 2.6 to on Windows The following procedure explains how to upgrade the SPECTRUM Web Operator server from version 2.5 or 2.6 to version It also explains how to retain any global or user preferences you may have created for Alarm Manager or Model Browser in from 2.5 or 2.6. Procedure 1. Do one of the following: If you modified global or user preferences for Alarm Manager or Model Browser in 2.5/2.6, go to step 2. If you did not modify global or user preferences for Alarm Manager in 2.5/2.6, complete the procedures detailed in Installing Web Operator Server on Windows 2000/NT [page 25]. 2. In the <install dir>\webapps\sg-support\csresource\ preferences directory, rename.alarm.prf to walrm.prf and.browser.prf to browser.prf. Note: <install directory> is the directory in which you installed 2.5/ Complete the procedures detailed in Installing Web Operator Server on Windows 2000/NT [page 25]. 4. After you have successfully installed 6.5.1, navigate to the following directory: <new install dir>\webapps\sg-support\csresource\ preferences Note: <new install dir> is the directory in which you just installed Copy any new Alarm Manager preferences you want to use from the walrm_example.prf file to the walrm.prf file. 6. Copy any new Model Browser preferences you want to use from the browser_example.prf file to the browser.prf file. Page 19

20 7. Navigate to the following directory: <new install dir>\webapps\sg-support\csresource\ preferences\walrm 8. Copy any new Alarm Manager preferences you want to use from the walrm_example.prf file to each user preference file. 9. Navigate to the following directory: <new install dir>\webapps\sg-support\csresource\ preferences\browser 10. Copy any new Model Browser preferences you want to use from the browser_example.prf file to each user preference file. Page 20

21 Installing Web Operator Server on Solaris This section explains how to install the SPECTRUM Web Operator server on a Sun SPARCstation/Solaris 2.7 or 2.8. To install the Web Operator server, you must complete the following procedures in the order they appear in this section. In this section: Setting up the Server Environment on Solaris [page 21] Installing Java 2 SDK on Solaris [page 22] Running the Installation Software on Solaris [page 23] Starting Web Operator [page 36] Setting up the Server Environment on Solaris Procedure 1. Verify that all associated SpectroSERVERS are running. 2. Verify that you are a valid SPECTRUM user in SPECTRUM s UserEditor, as described in the Security and User Maintenance Guide (2602). 3. Verify that the Solaris workstation on which you are installing has host access to all associated SpectroSERVER workstations. Important: For each SpectroSERVER, there must be an entry in the.hostrc file for the workstations hosting the Web Operator server. For more information, see the Security and User Maintenance Guide (2602). Page 21

22 Installing Java 2 SDK on Solaris Procedure 1. Log in to your Solaris server as root. 2. Insert the SPECTRUM applications CD into the CD drive of your Solaris server. 3. Copy the j2sdk-1_3_1-solsparc.sh file from the weboperator/jdk1_3_1 directory on the CD to the /opt directory on your Solaris server. cp <cd drive>/weboperator/jdk1_3_1/j2sdk-1_3_1-solsparc.sh /opt 4. Change the directory to /opt. cd /opt 5. To allow permission to execute, run the chmod command. chmod +x j2sdk-1_3_1-solsparc.sh 6. Run the self-extracting binary. j2sdk-1_3_1-solsparc.sh 7. Follow the installation wizard instructions. Note: To save disk space on your Solaris server, you can delete j2sdk-1_3_1-solsparc.sh from the /opt directory. Page 22

23 Running the Installation Software on Solaris Procedure 1. Log in to your Solaris server as root. 2. Insert the SPECTRUM applications CD into the CD drive of your Solaris server and do one of the following: If autorun starts and the File Manager - spectrum window appears, double-click Installer. In the Install window, click the hyperlink to install Web Operator Foundation or Web Operator Suite, depending on which application you purchased. If autorun does not start, navigate to the WebOperator directory and open the Foundation or Suite directory, depending on which application you purchased. Type./setup.bin and press Enter to run the installation software. Note: Your license certificate that contains the Web Operator extraction key identifies which application you purchased. 3. Follow the instructions provided by the Web Operator installation software and enter the installation parameters listed in Table 7 [page 23] when prompted. Table 7: Solaris Installation Parameters Parameter Install Folder Java 2 SDK Location Port Number Extraction Key Description The location where you want to install SPECTRUM Web Operator. The location where Java 2 SDK is installed on the Web Operator server. For example, /opt/j2sdk1_3_1, as described in Installing Java 2 SDK on Solaris [page 22]. This port is required for the Apache Web Server. The default port number is 80. If you have already assigned port 80 to another application, such as Microsoft s Internet Information Services (IIS) Web Server, you can change the default setting to any port greater than 1024 (excluding 8007, which is reserved for the Tomcat server). The SPECTRUM software license key issued to you by Aprisma. Page 23

24 Parameter Location Server Name and Location Server Port Description The name of the Main Location Server and the port on the Main Location Server that the Web Operator server connects to. Note: If your server environment includes a Network Address Translation (NAT) firewall, you must copy the.natrc file to the <install dir>/webapps directory on the Web Operator server before continuing past the Main Location Server window. The <install dir> is the directory where you installed SPECTRUM Web operator. For more information about the.natrc file, see the Distributed SpectroSERVER Guide (2770). User Name and Password for Web Operator Administrator This is the logon information for the user that you designate as the Web Operator administrator. The administrator you choose will have access to the User Administration application in Web Operator. Note: The username of the Web Operator administrator must match exactly (case sensitive) with a valid SPECTRUM user. However, you can select any password. Populate with all SPECTRUM Users By default, all SPECTRUM users are added to Web Operator during installation. If you want to add users manually after installation using Web Operator s User Administration application, remove the check from the Populate with all SPECTRUM users box. Note: If you manually add a Web Operator user, you must first add that user to SPECTRUM s UserEditor, as described in the Security and User Maintenance Guide (2602). Web Applications Password SPECTRUM User Name (for DBWriter) If you select the Populate with all SPECTRUM users box, you must enter a default password that allows users to log in to (users can change the default password after they log in). The name of the valid SPECTRUM user (who is also a valid user on the Solaris operating system), who runs and schedules a process called DBWriter. This process gathers alarm and event data. Page 24

25 Installing Web Operator Server on Windows 2000/NT This section explains how to install the SPECTRUM Web Operator server on a workstation running Windows NT 4.0 or Windows To install the Web Operator server, you must complete the following procedures in the order they appear in this section. In this section: Setting up the Server Environment on Windows [page 25] Installing Java 2 SDK on Windows [page 26] Running the Installation Software on Windows [page 27] Starting Web Operator [page 36] Setting up the Server Environment on Windows Procedure 1. Verify that all associated SpectroSERVERS are running. 2. Verify that you are a valid SPECTRUM user in SPECTRUM s UserEditor, as described in the Security and User Maintenance Guide (2602). 3. Verify that the Windows NT or Windows 2000 workstation on which you are installing has host access to all associated SpectroSERVER workstations. Important: For each SpectroSERVER, there must be an entry in the.hostrc file for the workstation hosting the Web Operator server. For more information about the.hostrc file, see the Security and User Maintenance Guide (2602). Page 25

26 Installing Java 2 SDK on Windows Procedure 1. Log in as administrator or a user in the administrators group. Note: You need to have administrator privileges to install, but you cannot be a Domain Administrator. 2. Insert the SPECTRUM applications CD into the CD drive of your Windows NT or 2000 workstation. 3. In the WebOperator/JDK1_3_1 directory, double-click j2sdk-1_3_1-win.exe. 4. Follow the on-screen instructions provided in the install wizard. Page 26

27 Running the Installation Software on Windows Procedure 1. Log in as administrator or a user in the administrators group. 2. Insert the SPECTRUM applications CD into the CD drive of your Windows NT or 2000 workstation. 3. If autorun starts and the Install window appears, click the hyperlink to install Web Operator Foundation or Web Operator Suite, depending on which program you purchased. 4. If autorun does not start, navigate to the WebOperator directory and open the Foundation or Suite directory, depending on which program you purchased. 5. Double-click setup.exe to start the Web Operator installation software. 6. Your license certificate that contains the Web Operator extraction key identifies which application you purchased. 7. Follow the instructions provided by the Web Operator installation software and enter the installation parameters listed in Table 8: Windows Installation Parameters [page 27] when prompted. Table 8: Windows Installation Parameters Parameter Install Folder Port Number Extraction Key Description The location where you want to install SPECTRUM Web Operator. This port is required for the Apache Web Server. The default port number is 80. If you have already assigned port 80 to another application, such as Microsoft s Internet Information Services (IIS) Web Server, you can change the default setting to any port greater than 1024 (excluding 8007, which is reserved for the Tomcat server). The SPECTRUM software license key issued to you by Aprisma. Page 27

28 Parameter Location Server Name and Location Server Port Description The name of the Main Location Server and the port on the Main Location Server that the Web Operator server connects to. Note: If your server environment includes a Network Address Translation (NAT) firewall, you must copy the.natrc file to the <install dir>/webapps directory on the Web Operator server before continuing past the Main Location Server window. The <install dir> is the directory where you installed SPECTRUM Web operator. For more information about the.natrc file, see the Distributed SpectroSERVER Guide (2770). User Name and Password for Web Operator Administrator This is the logon information for the user that you designate as the Web Operator administrator. The administrator you choose will have access to the User Administration application in Web Operator. Note: The username of the Web Operator administrator must match exactly (case sensitive) with a valid SPECTRUM user. However, you can select any password. Populate with all SPECTRUM Users By default, all SPECTRUM users are added to Web Operator during installation. If you want to add users manually after installation using Web Operator s User Administration application, remove the check from the Populate with all SPECTRUM users box. Note: If you manually add a Web Operator user, you must first add that user to SPECTRUM s UserEditor, as described in the Security and User Maintenance Guide (2602). Web Applications Password If you select the Populate with all SPECTRUM users box, you must enter a default password that allows users to log in to (users can change the default password after they log in). Page 28

29 Parameter SPECTRUM User Name (for DBWriter) and Password Note: This option appears for Suite only. Description The user name and password of a valid SPECTRUM user who runs and schedules a process called DBWriter. This process gathers alarm and event data. To schedule the DBWriter process, you must enter the password of a SPECTRUM user in the Windows Task Scheduler. To set the user s password in Task Scheduler: 1. In the Schedule Task message, click OK. 2. In the Reports dialog box, click the Set Password button. 3. Enter the password of a valid SPECTRUM user (who is also a valid user on the Windows operating system), and then click OK. 4. In the Reports dialog box, click the Apply button, and then click OK. Page 29

30 Installing Web Operator Client on Solaris This section explains how to install the Web Operator client on a workstation running Solaris. To install the Web Operator client, you must complete the following procedures in the order they appear in this section. In this section: Installing Java JRE, Including Plug-in on Solaris [page 30] Setting the Plug-in Path on Solaris [page 33] Starting Web Operator [page 36] Installing Java JRE, Including Plug-in on Solaris Procedure 1. Log in to your Solaris client workstation as root. 2. Do one of the following: If the port you specified during installation is 80 (the default), point your Web browser to the following URL: Note: <hostname> is the name of the workstation on which you installed If the port you specified during installation is not 80, point your Web browser to the following URL: Note: <hostname> is the name of the workstation on which you installed and <portnumber> is the port number specified during the installation. Page 30

31 3. In the Netscape message, shown in Figure 1, click OK. Figure 1: Netscape Message 4. In the Login window, shown in Figure 2 [page 31], click the hyperlink to download the JRE from the Web Operator server. Figure 2: Login Window 5. In the Save As window, shown in Figure 3 [page 32], do one of the following: To download the JRE to the default directory (/opt), click OK. To download the JRE to a another directory, select that directory, and then click OK. Note: You must have write access to the directory where you download the JRE. Page 31

32 Figure 3: Save As Window 6. Verify that the JRE downloads successfully, as indicated by the Netscape Download window shown in Figure 4 [page 32]. Figure 4: Netscape Download Window 7. Change the directory to /opt (the default) or whichever directory you selected for the download. cd /opt Page 32

33 8. To allow permission to execute, run the chmod command. chmod +x j2re-1_3_1-solsparc.sh 9. Run the self-extracting binary. j2re-1_3_1-solsparc.sh 10. Type y (yes) to agree to the JRE license terms. 11. After the JRE installation is complete, you must set the NPX_PLUGIN_PATH environment variable. See Setting the Plug-in Path on Solaris [page 33]. Setting the Plug-in Path on Solaris After you have successfully installed the JRE, you must set the NPX_PLUGIN_PATH environment variable so your Web browser can find the plug-in. Procedure 1. Exit Netscape. 2. Do one of the following: If you are using tcsh or csh, enter the following command: setenv NPX_PLUGIN_PATH <path> (for example: setenv NPX_PLUGIN_PATH /opt/j2re1_3_1/ plugin/sparc/ns4) If you are using sh or ksh, enter the following command: export NPX_PLUGIN_PATH=<path> (for example: export NPX_PLUGIN_PATH=/opt/j2re1_3_1/ plugin/sparc/ns4) 3. Start Netscape. 4. In Netscape s Location (Netsite) box, type About Plug-ins, and then press Enter. 5. To verify that Netscape recognizes the JRE Plug-in, make sure Java Plug-in for Netscape Navigator appears in the Installed Plug-Ins list. Page 33

34 Installing Web Operator Client on Windows This section explains how to install Java 2 Runtime Environment (JRE) version 1.3.1, including Plug-in and start Web Operator. To install the Web Operator client, you must complete the following procedures in the order they appear in this section. In this section: Installing Java JRE, Including Plug-in, on Windows [page 34] Starting Web Operator [page 36] Installing Java JRE, Including Plug-in, on Windows Procedure 1. Log in to your Windows NT/2000 client workstation as administrator or a user in the administrators group. Note: You must have administrator privileges to install, but you cannot be a Domain Administrator. 2. Do one of the following: If the port you specified during installation is 80 (the default), point your Web browser to the following URL: Note: <hostname> is the name of the workstation on which you installed. If the port you specified during installation is not 80, point your Web browser to the following URL: Note: <hostname> is the name of the workstation on which you installed and <portnumber> is the port number specified during the installation. Page 34

35 3. Do one of the following: If you are using Netscape, the Login window appears. Click the hyperlink to get the plug-in. In the Plug-in Not Loaded message box, click the Get the Plug-in button. In the Login window, click the hyperlink to download the JRE, including plug-in. If you are using Windows Internet Explorer (IE), the SPECTRUM Web Operator Login window appears. Click the hyperlink to download the JRE, including plug-in. In the File Download window, select Save this program to disk, and then click OK. 4. In the Save As window, do one of the following: To download j2re-1_3_1-win.exe to the default folder, click Save. To download j2re-1_3_1-win.exe to a different folder, select the folder, and then click Save. 5. In the download folder, double-click j2re-1_3_1-win.exe to start the JRE installation. 6. In the Software License Agreement window, click Yes. 7. In the Choose Destination Location window, do one of the following: To install the JRE to the default folder, click Next. To install the JRE to a different folder, click Browse, select the folder, and then click Next. 8. After you have successfully installed the JRE, do one of the following: If you are using Netscape, close the Web Operator Login Page in which you downloaded the JRE, and then click the hyperlink in the second Web Operator Login Page to start Web Operator, as described in the on-screen instructions. If you are using IE, click the hyperlink in the Web Operator Login Page to start. Note: After installing the JRE, you may need to restart your workstation before starting Web Operator. Make sure that you read any on-screen instructions that may appear after the JRE installation is complete. Page 35

36 Starting Web Operator This section explains how to start Web Operator from a client workstation. Procedure 1. Do one of the following: If the port you specified during installation is 80 (the default), point your Web browser to the following URL: Note: <hostname> is the name of the workstation on which you installed. If the port you specified during installation is not 80, point your Web browser to the following URL: Note: <hostname> is the name of the workstation on which you installed and <portnumber> is the port number specified during the installation. 2. In the Login view, enter the Web Operator username and password that you entered during installation. Note: The administrator can use the Web Operator User Administration application to configure user access. For more information about the User Administration application, see the SPECTRUM Web Operator User Guide (5078). 3. Click the Login button. This opens the home view. Note: Any date and time information shown in SPECTRUM Web Operator is localized to reflect the time zone where the client is installed and running. Page 36

37 Uninstalling Web Operator In this section: Uninstalling Web Operator on Solaris [page 37] Uninstalling Web Operator on Windows [page 38] Uninstalling Web Operator on Solaris Procedure 1. On the workstation running the Web Operator server, log in as root. 2. To set the path variable to the location of the Java SDK on the Web Operator server, do one of the following: If you are using tcsh or csh, enter the following command: setenv PATH $PATH:<location of Java SDK> If you are using sh or ksh, enter the following command: export PATH=$PATH:<location of Java SDK> Note: <location of Java SDK> is the directory in which you installed the Java SDK (for example: /opt/ j2sdk1_3_1/jre/bin). 3. Navigate to the UninstallerData directory. 4. Run the Web Operator uninstaller../uninstallwebop Page 37

38 Uninstalling Web Operator on Windows Procedure 1. On the workstation running Web Operator server, log in as administrator or a user in the administrators group. Note: You need to have administrator privileges to uninstall, but you cannot be a Domain Administrator. 2. Open the Windows Control Panel. 3. Double-click Add/Remove Programs. 4. In the Add/Remove Programs window, click SPECTRUM Web Operator to select it. 5. Click Change/Remove and follow the instructions provided by the uninstall wizard. Page 38

39 Configuring Web Operator for Non-DNS Environments In this section: About Non-DNS Environments [page 39] Changing the ServerName Option on Solaris [page 39] Changing the ServerName option on Windows NT and Windows 2000 [page 40] About Non-DNS Environments When you install Web Operator on a server that does not support Domain Name Service (DNS), clients receive a page cannot be found message when attempting to connect. To use Web Operator in environments that do not support DNS, you need to open the httpd.conf file and change the ServerName option from the hostname to the IP address of the Web Operator server. The following procedures explain how to change the ServerName option on Windows and Solaris operating systems. Changing the ServerName Option on Solaris Procedure 1. On the workstation running the Web Operator server, log in as root. 2. Stop the Apache Web Server. /etc/init.d/woapache stop 3. Open the following http.conf file: <install directory>/webapps/apache/conf/http.conf Note: <install directory> is the directory in which you installed Web Operator. 4. In the ServerName attribute, type the IP address (not the hostname) of the Web Operator server. 5. Save and close the http.conf file. Page 39

40 6. Start the Apache Web Server. /etc/init.d/woapache start 7. At the Web Operator client, do one of the following: If the port you specified during installation is 80 (the default), point your Web browser to the following URL: IP>/spectrum Note: <host IP> is the IP address of the workstation on which you installed. If the port you specified during installation is not 80, point your Web browser to the following URL: IP>:<portnumber>/spectrum Note: <host IP> is the IP address of the workstation on which you installed and <portnumber> is the port number specified during the installation. Changing the ServerName option on Windows NT and Windows 2000 Procedure 1. On the workstation running the Web Operator server, open the Windows command prompt. 2. Stop the Apache Web Server. net stop spectrumapache 3. Open the http.conf file. <install directory>\webapps\apache\conf\http.conf Note: <install directory> is the directory in which you installed Web Operator. 4. In the ServerName attribute, type the IP address (not the hostname) of the Web Operator server. 5. Save and close the http.conf file. Page 40

41 6. From the command prompt, start the Apache Web Server. net start spectrumapache 7. Do one of the following: If the port you specified during installation is 80 (the default), point your Web browser to the following URL: IP>/spectrum Note: <host IP> is the IP address of the workstation on which you installed. If the port you specified during installation is not 80, point your Web browser to the following URL: IP>:<portnumber>/spectrum Note: <host IP> is the IP address of the workstation on which you installed and <portnumber> is the port number specified during the installation. Page 41

42 Index Symbols.hostrc file [21], [25].natrc file [24], [28] A alarm proxy [11] Apache default port number [23], [27] starting [41] stopping [13] Apache Web Server required version [7] C chmod command [22], [33] Client System Prerequisites Solaris [10] Windows [10] D DBWriter scheduling [29] SPECTRUM User Name [24], [29] Documentation Requirements [11] Domain Name Service (DNS) non-dns evironments [39] non-dns on Solaris [39] non-dns on Windows [40] E extraction key [23], [27] H http.conf file [40] Page 42

43 httpd.conf file [39] I Installation Software running on Solaris [23] running on Windows [27] Intended Audience [5] J Java 2 Runtime Environment required version [7], [8] Java 2 Runtime Environment (JRE) installing on Solaris [30] installing on Windows [34] Java 2 SDK installing on Solaris [22] installing on Windows [26] required version [7] L Location Server Name [24], [28] Location Server Port [24], [28] M Microsoft s Internet Information Services (IIS) Web Server [15], [23], [27] MySQL required version [7] with third-part applications [11] N Network Address Translation (NAT) firewall [24], [28] NPX_PLUGIN_PATH [33] P Password all SPECTRUM users [24], [28] Web Operator Administrator [24], [28] Page 43

44 Plug-in Path setting on Solaris [33] preference files additional information [12] location of [13] retaining global or user preferences (version 2.0 Solaris) [13] retaining global or user preferences (version 2.0 Windows) [15] retaining global or user preferences (version 2.5 or 2.6 Solaris) [17] retaining global or user preferences (version 2.5 or 2.6 Windows) [19] S Server System Prerequisites Windows [9] Server System Requirements Solaris [9] SpectroSERVER [11], [21] SPECTRUM software license key Solaris [23] Windows [27] SPECTRUM Users adding during installation [24], [28] adding manually [24], [28] Starting Web Operator [36] T Text Conventions [5] Tomcat Servlet Engine required version [7] U Uninstalling Web Operator Solaris [37] Windows [38] Upgrading Web Operator Version 2.0 to 6.5 on Solaris [13] Version 2.0 to 6.5 on Windows [15] Version 2.5/2.6 to 6.5 on Solaris [17] Version 2.5/2.6 to 6.5 on Windows [19] User Name Web Operator Administrator [24], [28] Page 44

45 W Web Operator Foundation [23], [27] Web Operator Suite [23], [27] Windows Task Scheduler [29] Page 45