SPECTRUM Web Operator - CA Technologies - CA...

SPECTRUM Web OperatorInstallation Guide

Document 5110


Document 5110

NoticeCopyright 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 [email protected]; 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.2100U.S. toll-free: 877.468.1448Web site: http://www.aprisma.com

http://www.aprisma.com/manuals/trademark-list.htm


Document 5110

Contents

Notice ........................................................................................... 2

Preface ......................................................................................... 5

Intended Audience ..................................................................... 5

Text Conventions ....................................................................... 5

Document Feedback ................................................................... 6

Online Documents ...................................................................... 6

Overview ...................................................................................... 7

About SPECTRUM Web Operator ................................................... 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


Document 5110

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


Document 5110

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 SPECTRUM Web Operator. 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.)

Courier and Italic in angle brackets (<>)

Type the following:

DISPLAY=<workstation name>:0.0 export display

The directory where you installed SPECTRUM

(The user supplies a value for the variable.)

<$SPECROOT> Navigate to:

<$SPECROOT>/app-defaults

Solaris and Windows directory paths

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.

<$SPECROOT>/app-defaults on Solaris is equivalent to <$SPECROOT>\app-defaults on Windows.


Document 5110

Document Feedback

Please send feedback regarding SPECTRUM documents to the following e-mail address:

[email protected]

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.

On-screen text Courier The following line displays:

path=”/audit”

User-typed text Courier Type the following path name:

C:\ABC\lib\db

Element Convention Used Example

mailto:[email protected]

http://www.aprisma.com/manuals


Document 5110

Overview

In This Section

About SPECTRUM Web Operator [Page 7]

Where to Start [Page 8]

Does Your System Meet Installation Requirements? [Page 9]

SpectroSERVER Considerations [Page 11]

MySQL Considerations [Page 11]

About SPECTRUM Web Operator

SPECTRUM Web Operator 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


Document 5110

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 Procedure

First time server installation on Solaris

Installing Web Operator Server on Solaris [Page 19]

First time server installation on Windows

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 Solaris [Page 13]

Upgrading from version 2.6 to 6.6 on Windows

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

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

Upgrading From Version 6.5.0 or 6.5.1 to 6.6 on Windows [Page 17]


Document 5110

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)

Table 4: Web Operator Server Requirements (Windows)

Component Requirement

Operating System Sun SPARCstation/Solaris 2.7 and 2.8

Processor 400 MHz Ultra10

Free Hard Disk Space 200 MB

Note: For the Web Operator Suite, additional space is required for the alarm and event databases, approximately 57 KB per 1000 events.

RAM 1 GB

Java Components Java 2 SDK, Standard Edition, version 1.3.1


Operating System Microsoft Windows NT 4.0 and Windows 2000 Intel-based Systems

Processor 900 MHz Pentium III

Free Hard Disk Space 210 MB

Note: For the Web Operator Suite, additional space is required for the alarm and event databases, approximately 57 KB per 1000 events.

RAM 1 GB


Document 5110

Minimum Requirements for the Web Operator Client

Before installing the SPECTRUM Web Operator client, make sure your workstation meets the requirements listed in Table 5: Web Operator Client Requirements.

Table 5: Web Operator Client Requirements

Documentation Requirements

Before installing Web Operator, read the SPECTRUM Software Release Notice (0743), which describes new features and identifies any known anomalies.

Service Pack 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


Operating System Microsoft Windows NT 4.0 and Windows 2000 Intel-based Systems

Processor Pentium II

RAM 128 MB

Service Pack Windows NT 4.0 - Service Pack 6a or higher

Windows 2000 - Service Pack 1 supported, if present

Java Components 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.



Document 5110

SpectroSERVER Considerations

� Although you can install SPECTRUM Web Operator on your production SpectroSERVER host workstation, doing this on a single-CPU workstation may degrade the performance of the SpectroSERVER, as well as SPECTRUM Web Operator.

To maximize the performance of the SpectroSERVER and the SPECTRUM Web Operator in a single-CPU environment, we recommend that you do not install SPECTRUM Web Operator 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 SPECTRUM Web Operator, 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 SPECTRUM Web Operator.

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


Document 5110

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.

Note: For more information about preference files and customizing Web Operator, see the SPECTRUM Web Operator Administrator Guide (5079).

In This Section

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]


Document 5110

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 SPECTRUM Web Operator 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 SPECTRUM 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.


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


Document 5110

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 SPECTRUM Web Operator from 2.6.

Procedure


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


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


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


Document 5110

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 SPECTRUM Web Operator 6.5.0 or 6.5.1. For more information on preference files, see the SPECTRUM Web Operator Administrator Guide (5079).

Procedure


� 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


Document 5110

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


dbreader_example.prf <username>.prf


Document 5110

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 SPECTRUM Web Operator 6.5.0 or 6.5.1. For more information on preference files, see the SPECTRUM Web Operator Administrator Guide (5079).

Procedure


� 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


dbreader_example.prf dbreader.prf


Document 5110

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


dbreader_example.prf <username>.prf


Document 5110

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 SPECTRUM Web Operator 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).


Document 5110

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 thewebOperator/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.


Document 5110

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 Input

Introduction No input required.

License Agreement Accept or do not accept the terms of the License Agreement.

You must accept the terms of the license agreement to continue the installation.

SPECTRUM Extraction Key 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.

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

Choose Install Folder The location where you want to install SPECTRUM Web Operator. The default directory is /usr/SPECTRUM.

Important: Spaces are not allowed in folder names.


Document 5110

SPECTRUM Web Operator Port Number

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

SPECTRUM Server Configuration

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.

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.

SPECTRUM Web Operator URL

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 SPECTRUM Web Operator URL window and complete the installation at another time.

Install Complete Input is not required.

Table 10: Solaris Installation Parameters



Document 5110

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 SPECTRUM Web Operator 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).


Document 5110

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 SPECTRUM Web Operator, 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


Introduction No input required.

License Agreement Accept or do not accept the terms of the License Agreement. You must accept the terms of the license agreement to continue the installation.

SPECTRUM Extraction Key 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.


Document 5110

Choose Install Folder 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.

SPECTRUM Web Operator Port Number

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

SPECTRUM Server Configuration

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.




Document 5110

SPECTRUM Web Operator URL

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 SPECTRUM Web Operator URL window and complete the installation at another time.

Install Complete Input is not required.




Document 5110

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


� 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 SPECTRUM Web Operator 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.


Document 5110

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.


Document 5110

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


� 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 SPECTRUM Web Operator.

� 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 SPECTRUM Web Operator 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.


Document 5110

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.


Document 5110

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 SPECTRUM Web Operator Administrator Guide (5079).

Note: The existing wac.prf file is not overwritten during an upgrade.


Document 5110

Starting Web Operator

This section explains how to start Web Operator on a client workstation.

Procedure


� 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 SPECTRUM Web Operator.

� 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 SPECTRUM Web Operator 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 SPECTRUM Web Operator home page appears.

Note: Any date and time information shown in SPECTRUM Web Operator is localized to reflect the time zone where the SPECTRUM Web Operator client is installed and running.


Document 5110

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


Document 5110

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 SPECTRUM Web Operator, 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.


Document 5110

Index

Symbols.hostrc file [19], [23].natrc file [22], [25]

Cchmod command [20]Client requirements [10]

DDBWriter

scheduling [25]SPECTRUM user name [22], [25]

Distributed SpectroSERVER [27]Documentation requirements [10]

EExtraction key [21], [24]

FFault Tolerant Environments [28]

IInstallation software (Solaris) [21]Installation software (Windows) [24]

JJava 2 Runtime Environment

installing (Windows) [29]required version [7]

Java 2 SDKinstalling (Solaris) [20]installing (Windows) [24]


Document 5110

location on applications CD [20]required version [7]

LLocation server port [22], [25]

MMicrosoft�s IIS Web Server [25]MySQL

required version [7]with third-part applications [11]

NNetwork Address Translation firewall [22], [25]

OOsagent port [22], [25]

PPassword

administrator [22], [25]Preference files

additional information [12]preference files

retaining global or user preferences (version 2.6 Windows) [13], [14]Proxy Server [31]

SServer requirements

Solaris [9]Windows [9]

SpectroSERVER [11], [19]SPECTRUM host name [22], [25]Starting Web Operator [32]


Document 5110

TTomcat Servlet Engine

required version [7]

UUninstalling Web Operator

Solaris [33]Windows [34]

Upgradingversion 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 nameadministrator [22], [25]

WWindows Task Scheduler [25]

SPECTRUM Web Operator - CA Technologies - CA...

Documents

Transcript of SPECTRUM Web Operator - CA Technologies - CA...