Notice Copyright Notice Copyright 2002-present 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 252.227-7013(c)(1)(ii) and FAR 52.227-19. 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: http://www.aprisma.com/manuals/trademark-list.htm 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 e-mail 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 52.227-14 (June 1987) Alternate III(g)(3) (June 1987), FAR 52.227-19 (June 1987), or DFARS 52.227-7013(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 03801 USA Phone: 603.334.2100 U.S. toll-free: 877.468.1448 Web site: http://www.aprisma.com Page 2
Contents Notice... 2 Preface... 5 Intended Audience... 5 Text Conventions... 5 Document Feedback... 6 Online Documents... 6 Overview... 7 About... 7 Where to Start... 8 Does Your System Meet Installation Requirements?... 9 Minimum Requirements for Web Operator Servers... 9 Minimum Requirements for the Web Operator Client...10 Documentation Requirements...10 SpectroSERVER Considerations...11 MySQL Considerations...11 Upgrading from an Earlier Version of Web Operator... 12 Upgrading from Version 2.6 to 6.6 on Solaris...13 Upgrading from Version 2.6 to 6.6 on Windows...14 Upgrading From Version 6.5.0 or 6.5.1 to 6.6 on Solaris...15 Upgrading From Version 6.5.0 or 6.5.1 to 6.6 on Windows...17 Installing Web Operator Server on Solaris... 19 Setting Up the Server Environment on Solaris...19 Installing Java 2 SDK on Solaris...20 Running the Installation Software on Solaris...21 Installing Web Operator Server on Windows NT or 2000... 23 Setting Up the Server Environment on Windows...23 Running the Installation Software on Windows...24 Page 3
Installing Web Operator in Distributed SpectroSERVER Environments... 27 Installing Web Operator in Fault Tolerant Environments... 28 Installing Web Operator Client... 29 Installing Java JRE, Including Plug-in...29 Setting Up Web Operator Client in a Proxy Server Environment...31 Securing Web Operator Clients: Disable Change Password...31 Starting Web Operator... 32 Uninstalling Web Operator... 33 Uninstalling Web Operator on Solaris...33 Uninstalling Web Operator on Windows...34 Index... 35 Page 4
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 Variables (The user supplies a value for the variable.) The directory where you installed SPECTRUM (The user supplies a value for the variable.) Solaris and Windows directory paths Courier and Italic in angle brackets (<>) <$SPECROOT> Unless otherwise noted, directory paths are common to both operating systems, with the exception that slashes (/) should be used in Solaris paths, and backslashes (\) should be used in Windows paths. Type the following: DISPLAY=<workstation name>:0.0 export display Navigate to: <$SPECROOT>/appdefaults <$SPECROOT>/appdefaults on Solaris is equivalent to <$SPECROOT>\appdefaults on Windows. Page 5
Element Convention Used Example On-screen text Courier The following line displays: path= /audit User-typed text Courier Type the following path name: C:\ABC\lib\db Document Feedback Please send feedback regarding SPECTRUM documents to the following e-mail address: spectrum-docs@aprisma.com Thank you for helping us improve our documentation. Online Documents SPECTRUM documents are available online at: http://www.aprisma.com/manuals Check this site for the latest updates and additions. Page 6
Overview In This Section About [Page 7] Where to Start [Page 8] Does Your System Meet Installation Requirements? [Page 9] SpectroSERVER Considerations [Page 11] MySQL Considerations [Page 11] About 6.6 consists of a server-based component and a client-based component, each of which requires different software. The Web Operator server requires the 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 Tomcat Servlet Engine 4.0.3 MySQL Database Management System 3.23.47 Java 2 Software Development Kit (SDK), Standard Edition 1.3.1 Java 2 Runtime Environment (JRE), including plug-in 1.3.1 Page 7
Where to Start Before you begin, read Does Your System Meet Installation Requirements? [Page 9] and then choose the type of installation that meets your requirements (see Table 2). Table 2: Installations and Procedures Type of Installation First time server installation on Solaris First time server installation on Windows Procedure Installing Web Operator Server on Solaris [Page 19] Installing Web Operator Server on Windows NT or 2000 [Page 23] First time client installation Installing Web Operator Client [Page 29] Upgrading from version 2.6 to 6.6 on Solaris Upgrading from version 2.6 to 6.6 on Windows Upgrading from version 6.5.0 or 6.5.1 to 6.6 on Solaris Upgrading from version 6.5.0 or 6.5.1 to 6.6 on Windows Upgrading from Version 2.6 to 6.6 on Solaris [Page 13] Upgrading from Version 2.6 to 6.6 on Windows [Page 14] Upgrading From Version 6.5.0 or 6.5.1 to 6.6 on Solaris [Page 15] Upgrading From Version 6.5.0 or 6.5.1 to 6.6 on Windows [Page 17] Page 8
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. 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 400 MHz Ultra10 200 MB Note: For the Web Operator Suite, additional space is required for the alarm and event databases, approximately 57 KB per 1000 events. 1 GB Java Components Java 2 SDK, Standard Edition, version 1.3.1 Table 4: Web Operator Server Requirements (Windows) Component Operating System Processor Free Hard Disk Space RAM Requirement Microsoft Windows NT 4.0 and Windows 2000 Intel-based Systems 900 MHz Pentium III 210 MB Note: For the Web Operator Suite, additional space is required for the alarm and event databases, approximately 57 KB per 1000 events. 1 GB Page 9
Component Service Pack Requirement Windows NT 4.0 - Service Pack 6a or higher Windows 2000 - Service Pack 1 supported, if present Java Components Java 2 SDK, Standard Edition, version 1.3.1 Windows Components For the Web Operator Suite Event and Alarm Reports, you need Windows Task Scheduler 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. Table 5: Web Operator Client Requirements Component Operating System Processor RAM Service Pack Java Components Requirement Microsoft Windows NT 4.0 and Windows 2000 Intel-based Systems Pentium II 128 MB Windows NT 4.0 - Service Pack 6a or higher Windows 2000 - 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 Important: You must have Cookies, Java, and JavaScript enabled in the Web browser. Documentation Requirements Before installing Web Operator, read the SPECTRUM Software Release Notice (0743), which describes new features and identifies any known anomalies. Page 10
SpectroSERVER 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. Minimize the number of clients connecting to the same SpectroSERVER workstation. Multiple connections slow down, as well as put additional workload on the SpectroSERVER. Keep the number of alarms at an absolute minimum. If installing Web Operator on a SpectroSERVER, make sure that MySQL is running. MySQL Considerations Avoid installing third-party applications that use MySQL. Their presence could cause unwanted and unexpected results, such as errors in running Archive Manager and. If you remove SPECTRUM before installing Web Operator on a server, make sure that you run the SPECTRUM uninstaller (see the instructions for uninstalling SPECTRUM). Running the uninstaller before installing Web Operator ensures that SPECTRUM, the MySQL Database, and the MySQL Service are removed properly. Page 11
Upgrading from an Earlier Version of Web Operator This section explains how to upgrade Web Operator from version 2.6, 6.5.0, or 6.5.1 to version 6.6. 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 and customizing Web Operator, see the SPECTRUM Web Operator Administrator Guide (5079). Upgrading from Version 2.6 to 6.6 on Solaris [Page 13] Upgrading from Version 2.6 to 6.6 on Windows [Page 14] Upgrading From Version 6.5.0 or 6.5.1 to 6.6 on Solaris [Page 15] Upgrading From Version 6.5.0 or 6.5.1 to 6.6 on Windows [Page 17] Page 12
Upgrading from Version 2.6 to 6.6 on Solaris The following procedure explains how to upgrade the SPECTRUM Web Operator server from version 2.6 to version 6.6. It also explains how to retain any global or user preferences you may have created for Alarm Manager or Model Browser in from 2.6. Procedure 1. Do one of the following: If you modified global or user preferences for Alarm Manager or Model Browser in Web Operator 2.6, go to Step 2. If you did not modify global or user preferences for Alarm Manager in Web Operator 2.6, complete the procedures detailed in Installing Web Operator Server on Windows NT or 2000 [Page 23]. 2. In the <$SPECROOT>\WebApps\SG-Support\CsResource\ preferences directory, rename.alarm.prf to walrm.prf. 3. In the <$SPECROOT>\WebApps\SG-Support\CsResource\ preferences directory, rename.browser.prf to browser.prf. 4. Complete the procedures detailed in Installing Web Operator Server on Windows NT or 2000 [Page 23]. 5. After you have successfully installed 6.6, navigate to the following directory: <$SPECROOT>\WebApps\SG-Support\CsResource\ preferences 6. Copy any new Alarm Manager preferences you want to use from the walrm_example.prf file to the walrm.prf file. 7. Copy any new Model Browser preferences you want to use from the browser_example.prf file to the browser.prf file. 8. Navigate to the following directory: <$SPECROOT>\WebApps\SG-Support\CsResource\preferences\walrm 9. Copy any new Alarm Manager preferences you want to use from the walrm_example.prf file to each user preference file. 10. Navigate to the following directory: <$SPECROOT>\WebApps\SG-Support\CsResource\preferences\browser 11. Copy any new Model Browser preferences you want to use from the browser_example.prf file to each user preference file. Page 13
Upgrading from Version 2.6 to 6.6 on Windows The following procedure explains how to upgrade the SPECTRUM Web Operator server from version 2.6 to version 6.6. It also explains how to retain any global or user preferences you may have created for Alarm Manager or Model Browser in from 2.6. Procedure 1. Do one of the following: If you modified global or user preferences for Alarm Manager or Model Browser in Web Operator 2.6, go to Step 2. If you did not modify global or user preferences for Alarm Manager in Web Operator 2.6, complete the procedures detailed in Installing Web Operator Server on Windows NT or 2000 [Page 23]. 2. In the <$SPECROOT>\WebApps\SG-Support\CsResource\ preferences directory, rename.alarm.prf to walrm.prf. 3. In the <$SPECROOT>\WebApps\SG-Support\CsResource\ preferences directory, rename.browser.prf to browser.prf. 4. Complete the procedures detailed in Installing Web Operator Server on Windows NT or 2000 [Page 23]. 5. After you have successfully installed Web Operator 6.6, navigate to the following directory: <$SPECROOT>\WebApps\SG-Support\CsResource\ preferences 6. Copy any new Alarm Manager preferences you want to use from the walrm_example.prf file to the walrm.prf file. 7. Copy any new Model Browser preferences you want to use from the browser_example.prf file to the browser.prf file. 8. Navigate to the following directory: <$SPECROOT>\WebApps\SG-Support\CsResource\ preferences\walrm 9. Copy any new Alarm Manager preferences you want to use from the walrm_example.prf file to each user preference file. 10. Navigate to the following directory: <$SPECROOT>\WebApps\SG-Support\CsResource\preferences\browser 11. Copy any new Model Browser preferences you want to use from the browser_example.prf file to each user preference file. Page 14
Upgrading From Version 6.5.0 or 6.5.1 to 6.6 on Solaris The following procedure explains how to upgrade the SPECTRUM Web Operator server from version 6.5.0 or 6.5.1 to version 6.6. It also explains how to save any global or user preference files you may have created 6.5.0 or 6.5.1. For more information on preference files, see the Administrator Guide (5079). Procedure 1. Do one of the following: If you modified global or user preferences for in Web Operator 6.5.0 or 6.5.1, go to Step 2. If you did not modify global or user preferences for Alarm Manager in Web Operator 6.5.0 or 6.5.1, complete the procedures detailed in Installing Web Operator Server on Windows NT or 2000 [Page 23]. 2. Copy any new preferences you want to use from the example preference file to each application s global preference file. Table 6 shows each application s example and global preference files. Table 6: Global Preference Files Application Example Preference File Global Preference File Alarm Manager walrm_example.prf walrm.prf Model Browser browser_example.prf browser.prf Custom Collections collections_example.prf collections.prf Model Search search_example.prf search.prf Alarm and Event Reports DBWriter_example.prf DBWriter.prf Quick Search qsearch_example.prf qsearch.prf Alarm and Event Report Details dbreader_example.prf dbreader.prf Page 15
3. Copy any new preferences you want to use from the example preference file to each application s user preference file. Table 7 shows each application s example and user preference files. Table 7: User Preference Files Application Example Preference File User Preference File Alarm Manager walrm_example.prf <username>.prf Model Browser browser_example.prf <username>.prf Custom Collections collections_example.prf <username>.prf Model Search search_example.prf <username>.prf Alarm and Event Reports DBWriter_example.prf <username>.prf Quick Search qsearch_example.prf <username>.prf Alarm and Event Report Details dbreader_example.prf <username>.prf Page 16
Upgrading From Version 6.5.0 or 6.5.1 to 6.6 on Windows The following procedure explains how to upgrade the SPECTRUM Web Operator server from version 6.5.0 or 6.5.1 to version 6.6. It also explains how to save any global or user preference files you may have created 6.5.0 or 6.5.1. For more information on preference files, see the Administrator Guide (5079). Procedure 1. Do one of the following: If you modified global or user preferences for in Web Operator 6.5.0 or 6.5.1, go to Step 2. If you did not modify global or user preferences for Alarm Manager in Web Operator 6.5.0 or 6.5.1, complete the procedures detailed in Installing Web Operator Server on Windows NT or 2000 [Page 23]. 2. Copy any new preferences you want to use from the example preference file to each application s global preference file. Table 8 shows each application s example and global preference files. Table 8: Global Preference Files Application Example Preference File Global Preference File Alarm Manager walrm_example.prf walrm.prf Model Browser browser_example.prf browser.prf Custom Collections collections_example.prf collections.prf Model Search search_example.prf search.prf Alarm and Event Reports DBWriter_example.prf DBWriter.prf Quick Search qsearch_example.prf qsearch.prf Alarm and Event Report Details dbreader_example.prf dbreader.prf Page 17
3. Copy any new preferences you want to use from the example preference file to each application s user preference file. Table 9 shows each application s example and user preference files. Table 9: User Preference Files. Application Example Preference File User Preference File Alarm Manager walrm_example.prf <username>.prf Model Browser browser_example.prf <username>.prf Custom Collections collections_example.prf <username>.prf Model Search search_example.prf <username>.prf Alarm and Event Reports DBWriter_example.prf <username>.prf Quick Search qsearch_example.prf <username>.prf Alarm and Event Report Details dbreader_example.prf <username>.prf Page 18
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 19] Installing Java 2 SDK on Solaris [Page 20] Running the Installation Software on Solaris [Page 21] Setting Up the Server Environment on Solaris Procedure 1. Verify that all associated SpectroSERVERS are running. 2. Verify that you are a valid SPECTRUM administrator 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 (92602). Page 19
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 20
Running the Installation Software on Solaris Procedure 1. 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. If autorun does not start, navigate to the WebOperator directory and type./setup.bin and press Enter to run the installation software. 2. Enter the system s root user password. 3. Follow the instructions provided by the Web Operator installation software and enter the installation parameters listed in Table 10 when prompted. Table 10: Solaris Installation Parameters Installation Window Introduction License Agreement SPECTRUM Extraction Key Input No input required. Accept or do not accept the terms of the License Agreement. You must accept the terms of the license agreement to continue the installation. The SPECTRUM software extraction key issued to you by Aprisma. Note: This is the same extraction key used to install SPECTRUM. Make sure the Platform and Version in the SPECTRUM Extraction Key window match the extraction key. Java 2 SDK Location Note: If Java 2 SDK, Standard Edition, version 1.3.1 is already installed on your workstation, this window does not appear. Choose Install Folder 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 20]. The location where you want to install SPECTRUM Web Operator. The default directory is /usr/spectrum. Important: Spaces are not allowed in folder names. Page 21
Table 10: Solaris Installation Parameters Installation Window Port Number SPECTRUM Server Configuration Input The default port number is 80. If you have already assigned port 80 to another application, such as another web server, you can change the default setting to any port greater than 1024 (excluding 8005, 8008, and 8443, which are reserved). The SPECTRUM host containing the home user models, the port on the location server to which the Web Operator server connects (0xdaff by default), and the Osagent port (14000 by default). Note: If your server environment includes a Network Address Translation (NAT) firewall, you must copy the.natrc file to the <$SPECROOT>/WebApps directory on the Web Operator server before continuing past the SPECTRUM Server Configuration window. For more information about the.natrc file, see the Distributed SpectroSERVER Guide (2770). Web Administrator User The User Name and Password of the user that you designate as the Web Operator administrator. Note: The username of the Web Operator administrator must match exactly (case sensitive) with a valid SPECTRUM administrator user. However, you can select any password. SPECTRUM User Name (for DBWriter) Note: This window appears on Web Operator Suite installations only. URL Install Complete 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 for Alarm and Event Reports. Input is not required. You can launch SPECTRUM Web Operator or complete the installation without launching Web Operator. If you launch Web Operator you must return to the URL window and complete the installation at another time. Input is not required. Page 22
Installing Web Operator Server on Windows NT or 2000 This section explains how to install the SPECTRUM Web Operator server on a workstation running Windows NT 4.0 or Windows 2000. 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 23] Running the Installation Software on Windows [Page 24] Setting Up the Server Environment on Windows Procedure 1. Verify that all associated SpectroSERVERS are running. 2. Verify that you are a valid SPECTRUM administrator 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 23
Running the Installation Software 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 and do one of the following: If autorun starts and the Install window appears, click the hyperlink to install Web Operator. If autorun does not start, navigate to the WebOperator directory and double-click setup.exe to start the Web Operator installation software. 3. Follow the instructions provided by the Web Operator installation software and enter the installation parameters listed in Table 11 when prompted. Table 11: Windows Installation Parameters Installation Window Introduction License Agreement SPECTRUM Extraction Key Input No input required. Accept or do not accept the terms of the License Agreement. You must accept the terms of the license agreement to continue the installation. The SPECTRUM software extraction key issued to you by Aprisma. Note: This is the same extraction key used to install SPECTRUM. Make sure the Platform and Version in the SPECTRUM Extraction Key window match the extraction key. Missing Java 2 SDK Note: If Java 2 SDK, Standard Edition, version 1.3.1 is already installed on your workstation, this window does not appear. Click Install JDK and follow the on-screen instructions provided in the install wizard to install Java 2 SDK, Standard Edition, version 1.3.1. Important: Do not install Java 2 SDK in the C:\Program Files directory. Page 24
Table 11: Windows Installation Parameters Installation Window Choose Install Folder Input The location where you want to install SPECTRUM Web Operator. The default directory is C:\win32app\SPECTRUM. Important: Spaces are not allowed in folder names. Port Number SPECTRUM Server Configuration 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 8005, 8008, and 8443, which are reserved). The SPECTRUM host containing the home user models, the port on the location server to which the Web Operator server connects (0xdaff by default), and the Osagent port (14000 by default). Note: If your server environment includes a Network Address Translation (NAT) firewall, you must copy the.natrc file to the <$SPECROOT>/WebApps directory on the Web Operator server before continuing past the Main Location Server window. For more information about the.natrc file, see the Distributed SpectroSERVER Guide (2770). Web Administrator User The User Name and Password of the user that you designate as the Web Operator administrator. Note: The username of the Web Operator administrator must match exactly (case sensitive) with a valid SPECTRUM administrator user. However, you can select any password. SPECTRUM User Name (for DBWriter) and Password Note: This window appears on Web Operator Suite installations only. 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 25
Table 11: Windows Installation Parameters Installation Window URL Install Complete Input Input is not required. You can launch SPECTRUM Web Operator or complete the installation without launching Web Operator. If you launch Web Operator you must return to the URL window and complete the installation at another time. Input is not required. Page 26
Installing Web Operator in Distributed SpectroSERVER Environments This section provides guidelines for installing Web Operator in Distributed SpectroSERVER (DSS) environments. For more information, see the Distributed SpectroSERVER (2770) Guide. Procedure 1. Do one of the following: To install Web Operator on Solaris, complete the procedures in Installing Web Operator Server on Solaris [Page 19]. To install Web Operator on Windows NT or 2000, complete the procedures in Installing Web Operator Server on Windows NT or 2000 [Page 23]. 2. Make sure Web Operator has access to the SpectroSERVER (for example, make sure that Web Operator does not have restricted access on a router s Access Control List). 3. Make sure Web Operator users have access to all SpectroSERVERS from where Model Search, Quick Search and Alarm Manager will connect. 4. To limit the landscapes accessed by DBWriter (a process that gathers alarm and event data), Alarm Manager, Model Search, and Quick Search, see the Administrator Guide (5079). Note: By default, DBWriter attempts to access every Archive Manager on every SpectroSERVER in the landscape map. Setting up a filter limits the landscapes accessed by DBWriter and saves time. 5. Make sure the HOME models of all users are consolidated on the SPECTRUM host that you specified during installation. For more information on HOME models, see the Security and User Maintenance (2602) Guide. Page 27
Installing Web Operator in Fault Tolerant Environments This section explains how to set up a backup location server. When the connection is lost between the Web Operator Server and the primary location server, the connection switches to the secondary location server. Procedure 1. Using a text editor, open the following file: <$SPECROOT>/WebApps/.LocalRegFile 2. In the BackupLocationServers= parameter, add the secondary location server s host name (for example, hostname.aprisma.com) and server port (for example 0xdaff), as shown in the following example: BackupLocationServers=hostname.aprisma.com,0xdaff 3. Save and close.localregfile. Page 28
Installing Web Operator Client In This Section Installing Java JRE, Including Plug-in [Page 29] Setting Up Web Operator Client in a Proxy Server Environment [Page 31] Installing Java JRE, Including Plug-in This procedure explains how to install the Java JRE, including plug-in. You need the Java JRE to access the Web Operator Alarm Reports and Event Reports applications. 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: http://<hostname>/spectrum/install-java.jsp 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: http://<hostname>:<portnumber>/spectrum/install-java.jsp 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 Installing the Java 2 Runtime Environment window (see Figure 1), click Java 2 Runtime Environment to download the JRE. Page 29
Figure 1: Installing the Java 2 Runtime Environment Window 3. In the File Download message, click Save. 4. In the Save As dialog box, 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; 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; then click Next. Page 30
Setting Up Web Operator Client in a Proxy Server Environment This procedure is required if you are running Web Operator in a proxy server environment. Procedure 1. On the workstation running the Web Operator client, open the Control Panel. 2. Double-click Java Plug-in 1.3.1. 3. In the Java (TM) Control Panel dialog box, click the Proxies tab. 4. Remove the check from the Use Browser Settings box. 5. Click Apply. 6. Close the Java (TM) Control Panel dialog box. 7. Start Web Operator as described in Starting Web Operator [Page 32]. Securing Web Operator Clients: Disable Change Password The Change Password link at the bottom of Web Operator pages can be removed for security and operator ease of use. This is done by editing WACdisableChangePass in the wac.prf preference file to reflect true. For more information, see the Administrator Guide (5079). Note: The existing wac.prf file is not overwritten during an upgrade. Page 31
Starting Web Operator This section explains how to start Web Operator on 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: http://<hostname>/spectrum 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: http://<hostname>:<portnumber>/spectrum Note: <hostname> is the name of the workstation on which you installed and <portnumber> is the port number specified during the installation. 2. In your Web browser s user authentication dialog box, type your user name and password; then click OK. The home page appears. 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 32
Uninstalling Web Operator In This Section Uninstalling Web Operator on Solaris [Page 33] Uninstalling Web Operator on Windows [Page 34] 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 WebOperator server, do one of the following: If you are using tcsh or csh, enter the following command: setenv PATH $PATH:<location of Java SDK>/jre/bin If you are using sh or ksh, enter the following command: export PATH=$PATH:<location of Java SDK>/jre/bin Note: <location of Java SDK> is the directory in which you installed the Java SDK (for example: /opt/ j2sdk1_3_1). 3. Navigate to the UninstallerData directory. 4. Run the Web Operator uninstaller../uninstallwebop Page 33
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 34
Index Symbols.hostrc file [19], [23].natrc file [22], [25] C chmod command [20] Client requirements [10] D DBWriter scheduling [25] SPECTRUM user name [22], [25] Distributed SpectroSERVER [27] Documentation requirements [10] E Extraction key [21], [24] F Fault Tolerant Environments [28] I Installation software (Solaris) [21] Installation software (Windows) [24] J Java 2 Runtime Environment installing (Windows) [29] required version [7] Java 2 SDK installing (Solaris) [20] installing (Windows) [24] Page 35
location on applications CD [20] required version [7] L Location server port [22], [25] M Microsoft s IIS Web Server [25] MySQL required version [7] with third-part applications [11] N Network Address Translation firewall [22], [25] O Osagent port [22], [25] P Password administrator [22], [25] Preference files additional information [12] preference files retaining global or user preferences (version 2.6 Windows) [13], [14] Proxy Server [31] S Server requirements Solaris [9] Windows [9] SpectroSERVER [11], [19] SPECTRUM host name [22], [25] Starting Web Operator [32] Page 36
T Tomcat Servlet Engine required version [7] U Uninstalling Web Operator Solaris [33] Windows [34] Upgrading version 2.6 to 6.6 (Solaris) [13] version 2.6 to 6.6 (Windows) [14] version 6.5.0 or 6.5.1 to 6.6 (Solaris) [15] version 6.5.0 or 6.5.1 to 6.6 (Windows) [17] User name administrator [22], [25] W Windows Task Scheduler [25] Page 37