OneClick. Installation Guide. Document 5142

Transcription

1 OneClick Installation Guide Document 5142

2 Notice This documentation (the "Documentation") and related computer software program (the "Software") (hereinafter collectively referred to as the "Product") is for the end user's informational purposes only and is subject to change or withdrawal by CA at any time. This Product may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This Product is confidential and proprietary information of CA and protected by the copyright laws of the United States and international treaties. Notwithstanding the foregoing, licensed users may print a reasonable number of copies of the Documentation for their own internal use, and may make one copy of the Software as reasonably required for back-up and disaster recovery purposes, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the provisions of the license for the Software are permitted to have access to such copies. The right to print copies of the Documentation and to make a copy of the Software is limited to the period during which the license for the Product remains in full force and effect. Should the license terminate for any reason, it shall be the user's responsibility to certify in writing to CA that all copies and partial copies of the Product have been returned to CA or destroyed. EXCEPT AS OTHERWISE STATED IN THE APPLICABLE LICENSE AGREEMENT, TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS PRODUCT "AS IS" WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS PRODUCT, INCLUDING WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED OF SUCH LOSS OR DAMAGE. The use of this Product and any product referenced in the Documentation is governed by the end user's applicable license agreement. The manufacturer of this Product is CA. This Product is provided with "Restricted Rights." Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections , , and (c)(1) - (2) and DFARS Section (c)(1)(ii), as applicable, or their successors. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies. Copyright 2006 CA. All rights reserved.

3 Contents Preface Chapter 1: Overview About OneClick OneClick web server installation special considerations SpectroSERVER and OneClick Where to start Does your system meet installation requirements? Minimum requirements for OneClick servers Minimum requirements for OneClick clients Documentation requirements Chapter 2: Installing OneClick server on Solaris Prepare the SpectroSERVER environment (Solaris) Install the Java 2 SDK (Solaris) Install OneClick server (Solaris) Chapter 3: Installing OneClick server on Linux Prepare the SpectroSERVER environment (Linux) Install the Java 2 SDK (Linux) Install OneClick server (Linux) Chapter 4: Installing OneClick server on Windows Prepare the SpectroSERVER environment (Windows) Running the installation software on Windows Chapter 5: Fault tolerant environments and OneClick Fault tolerant OneClick upgrade in place best practices Upgrade with Historical Event Data Preservation Upgrade without historical event data preservation Configuring fault tolerance in sub-netted environments Configuring landscape polling interval in fault tolerant environments Chapter 6: Installing OneClick client OneClick client special considerations Installing Java JRE and Web Start on Solaris and Linux Installing the Java Runtime environment Installing Java JRE, including Plug-in and Web Start on Windows

4 Contents Chapter 7: Starting OneClick client Chapter 8: Uninstalling OneClick Uninstalling OneClick on Solaris or Linux Uninstalling OneClick on Windows Troubleshooting uninstall (Windows Only) Chapter 9: Troubleshooting Server configuration problems (Solaris and Linux) SPECTRUM web administrator user problems (Solaris and Linux) Server configuration problems (Windows) SPECTRUM Web administrator user problems (Windows) OneClick Web server cannot connect to SpectroSERVER with Dual Network Interface Cards (NICs) OneClick client fails to launch (Windows) OneClick client login problems OneClick client and web proxy issues OneClick server error message pcanywhere and OneClick Java auto-updates and OneClick Correcting invalid license error post-installation Preserving existing event format and probable cause files OneClick users cannot see all landscapes in distributed SpectroSERVER Environment OneClick Installation Guide

5 Preface This guide is intended for administrators responsible for installing the OneClick Web server. It provides OneClick installation information in a task-based format that can be employed as a personal reference guide or as part of a training materials package. What is in this book This guide contains the following chapters: Chapter 1, Overview, on page 7 - This chapter discusses general information about OneClick prerequisites. Chapter 2, Installing OneClick server on Solaris, on page 13 - This chapter explains how to install the OneClick server on Solaris 9 and later. Chapter 3, Installing OneClick server on Linux, on page 21 - This chapter explains how to install the OneClick server on Linux. Chapter 4, Installing OneClick server on Windows, on page 29 - This chapter explains how to install the OneClick server on Windows. Chapter 5, Fault tolerant environments and OneClick, on page 37 - This chapter describes procedures and issues applicable to running installations of OneClick in fault tolerant SpectroSERVER environments. Chapter 6, Installing OneClick client, on page 45 - This chapter details some special considerations for installation. Chapter 7, Starting OneClick client, on page 49 - This chapter explains how to start OneClick on a client workstation. Chapter 8, Uninstalling OneClick, on page 51 - This chapter details the procedure for uninstalling OneClick. Chapter 9, Troubleshooting, on page 53 - This chapter identifies problems and error messages that may be generated during OneClick installation and describes corrective action where feasible. Other maintenance and optional configuration issues are also addressed. 5

6 Preface 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.) Courier and Italic in angle brackets (<>) <$SPECROOT> Type the following: DISPLAY=<workstation name>:0.0 export display 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. 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 Underlined and hypertextblue See Document Feedback on page 6. References to SPECTRUM documents (title and number) Italic SPECTRUM Installation Guide (5136) Document Feedback Please send feedback regarding SPECTRUM documents to the following address: Spectrum-docs@aprisma.com Thank you for helping us improve our documentation. Online Documents SPECTRUM documents are available online at: Check this site for the latest updates and additions. 6 OneClick Installation Guide

7 Chapter 1: Overview In this chapter About OneClick on page 7 OneClick web server installation special considerations on page 7 SpectroSERVER and OneClick on page 8 Where to start on page 9 Does your system meet installation requirements? on page 9 About OneClick OneClick consists of a server-based component and a client-based component, each of which requires different software. The OneClick CD and OneClick server provide all the software required to install and run OneClick. The OneClick server includes the Tomcat servlet engine, MySQL database management system, and Java 2 Software Development Kit (SDK). Note that SPECTRUM tests and supports only the version of the JDK that ships with OneClick for use with OneClick. Client workstations require the Java 2 Runtime Environment (JRE) with Java Web Start. This is available at runtime from the OneClick Web Server installation. OneClick web server installation special considerations OneClick and pcanywhere The OneClick Web server cannot be installed on a machine while that machine is running Symantec pcanywhere. Once the pcanywhere Host Service has been stopped, OneClick server can be installed. Then, the pcanywhere Host Service can be re-enabled. Upgrading OneClick server All OneClick clients must be shut down prior to upgrading a OneClick web server. This is because Java Web Start Applications (such as OneClick) cache application jar files on the client host, and these jar files are automatically updated only when the application is restarted. Shutting down all OneClick clients can be accomplished with the Force Logout functionality in the OneClick Client Details web page available from the OneClick main web page. 7

8 Chapter 1: Overview Customized OneClick support files that are not located in the <Install Area>/WebApps/custom directory will not be preserved in the upgrade process. If you create custom support files in a default location, move them to the <Install Area>/WebApps/custom directory and test them before proceeding with the upgrade. For example, if you customize event files in <Install Area>/WebApps/SG-Support/CsEvFormat, move these files to <Install Area>/WebApps/custom/CsEvFormat before upgrading OneClick, then test that the customized functionality. For more examples of how to use the <Install Area>/WebApps/custom directory, see the OneClick Customization Guide (5160). OneClick and Secure Sockets Layer (SSL) See the OneClick Administration Guide (5166) for more information about configuring OneClick to work with SSL. OneClick and web proxies See OneClick client and web proxy issues on page 56 in this document. OneClick and fault tolerance See Fault tolerant OneClick upgrade in place best practices on page 37 and Configuring fault tolerance in sub-netted environments on page 43 in this document and the OneClick Administration Guide (5166) for more information about OneClick Web server fault tolerance. OneClick and firewalls Information about firewall configuration is available in the OneClick Administration Guide (5166). Additional information in the form of OneClick firewall deployment scenarios is available in the Distributed SpectroSERVER (2770) documentation. SpectroSERVER and OneClick Although you can install OneClick on your production SpectroSERVER host workstation, doing this on a single-cpu workstation may degrade the performance of both the SpectroSERVER and OneClick. To maximize the performance of the SpectroSERVER and the OneClick web server in a single- CPU environment, we recommend that you do not install OneClick on your production SpectroSERVER host workstation. If you do need to combine both SPECTRUM and OneClick on a single workstation, install SPECTRUM first, and then install OneClick. When upgrading the SpectroSERVER components of SPECTRUM, you may need to upgrade your installed version of OneClick as well. See the relevant Software Release Notice for more information. If installing OneClick on a SpectroSERVER, make sure that MySQL is running. If you remove SPECTRUM before installing OneClick on a server, make sure that you run the SPECTRUM uninstaller (see the instructions for uninstalling SPECTRUM in the SPECTRUM Installation Guide for your release of SPECTRUM). Running the uninstaller before installing OneClick ensures that SPECTRUM, the MySQL Database, and the MySQL Service are removed properly. 8 OneClick Installation Guide

9 Where to start Where to start Before you begin, read Does your system meet installation requirements? on page 9 and then choose the type of installation that meets your requirements (see Table 1-1). Table 1-1: Installations and Procedures SPECTRUM User Privileges Required Administrator Administrator Administrator Type of Installation First time server installation on Solaris First time server installation on Linux First time server installation on Windows Procedure Installing OneClick server on Solaris on page 13 Installing OneClick server on Linux on page 21 Installing OneClick server on Windows on page 29 Administrator or Operator First time client installation Installing OneClick client on page 45 Does your system meet installation requirements? This section lists the minimum specifications for running OneClick. Meeting or exceeding these requirements ensures that OneClick 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 OneClick servers on page 9 Minimum requirements for OneClick clients on page 11 Minimum requirements for OneClick servers Before installing the OneClick server, make sure your workstation meets the requirements listed by platform in the following tables. OneClick Installation Guide 9

10 Chapter 1: Overview Table 1-2: OneClick Server Requirements (Solaris) Component Operating System Processor Free Hard Disk Space RAM Java Components Requirement Sun SPARCstation/Solaris 2.9 is the minimum supported version for OneClick Server. Note: OneClick Server can connect to any running SpectroSERVER versioned at the same SPECTRUM version, regardless of what OS is running that SpectroSERVER. 360 MHz Ultra II 230 MB 1 GB Java 2 SDK, Standard Edition, version 1.5.0_06 or later Table 1-3: OneClick Server Requirements (Linux) Component Requirement Operating System Red Hat Enterprise Linux 3 Note: OneClick Server can connect to any running SpectroSERVER versioned at the same SPECTRUM version, regardless of what OS is running that SpectroSERVER. Processor Free Hard Disk Space RAM Service Pack Java Components 1 GHz Pentium III 230 MB 1 GB Update 6 or greater Java 2 SDK, Standard Edition, version 1.5.0_06 or later Table 1-4: OneClick Server Requirements (Windows) Component Operating System Processor Free Hard Disk Space RAM Service Pack Java Components Requirement Microsoft Windows 2000, Windows Server 2003, and Windows XP Intel-based Systems Note: OneClick Server can connect to any running SpectroSERVER versioned at the same SPECTRUM version, regardless of what OS is running that SpectroSERVER. 1 GHz Pentium III 230 MB 1 GB Windows Service Pack 2 or later Java 2 SDK, Standard Edition, version 1.5.0_06 or later 10 OneClick Installation Guide

11 Does your system meet installation requirements? Minimum requirements for OneClick clients Before installing the OneClick client, make sure your workstation meets the requirements listed by platform in the following tables. Table 1-5: OneClick Client Requirements (Solaris) Component Requirement Operating System Solaris 9 or 10 Processor RAM Java Components 360 MHz Ultra II 512 MB Java 2 Runtime Environment (JRE) version 1.5.0_06 Table 1-6: OneClick Client Requirements (Linux) Component Operating System and Desktop Environment Processor RAM Service Pack Java Components Requirement Red Hat Enterprise Linux 3 KDE (K Desktop Environment) 1 GHz Pentium III 512 MB Update 6 or greater Java 2 Runtime Environment (JRE) version 1.5.0_06, including plug-in Table 1-7: OneClick Client Requirements (Windows) Component Operating System Processor RAM Service Pack Java Components Requirement Microsoft Windows XP and Windows 2000 Intel-based Systems 1 GHz Pentium III 512 MB Windows Service Pack 2 or later Java 2 Runtime Environment (JRE) version 1.5.0_06, including plug-in OneClick Installation Guide 11

12 Chapter 1: Overview Documentation requirements Before installing OneClick, read the SPECTRUM Software Release Notice for your version of SPECTRUM, which describes new features and identifies any known anomalies. 12 OneClick Installation Guide

13 Chapter 2: Installing OneClick server on Solaris This chapter explains how to install the OneClick server on a Sun SPARCstation/Solaris 2.9 and later. To install the OneClick server, you must complete the following procedures in the order they appear in this chapter. In this chapter Prepare the SpectroSERVER environment (Solaris) on page 13 Install the Java 2 SDK (Solaris) on page 15 Install OneClick server (Solaris) on page 16 Prepare the SpectroSERVER environment (Solaris) Important: When installing OneClick with Report Manager and Business Objects XI: You must first install Business Objects XI from its CD using the license number provided to you by CA. Refer to the Report Manager Installation and Administration Guide (5169) for installation instructions. You must install Business Objects XI and OneClick with Report Manager on the same machine, one that is not also running a SpectroSERVER. Install OneClick with Report Manager from the OneClick CD. See the Report Manager Installation and Administration Guide for more information. Procedure 1. The SpectroSERVER host machine (later referred to in this document as the <SPECTRUM host>) must be running the same SPECTRUM version as the OneClick web server. Note: Certain SpectroSERVER service packs will also require updates to the OneClick web server, while others will not. Check the applicable software release note for details. Verify that the SPECTRUM version installed on the SPECTRUM SpectroSERVER host is the same version as that which you will be installing on the OneClick web server. If not, you must install the correct version of SPECTRUM on the SPECTRUM SpectroSERVER host. 13

14 Chapter 2: Installing OneClick server on Solaris To verify this, navigate to <$SPECROOT>/Install-Tools and view the.history file using the more command. You can print out and write in the host name of your <SPECTRUM host> below for future reference: Important: For each SpectroSERVER, there must be an entry in the.hostrc file for the workstations hosting the OneClick server. For more information, see the Security and User Maintenance Guide (2602) and step 3, below. 2. Verify that all associated SpectroSERVERS are running. 3. Verify that the Solaris workstation on which you are installing OneClick has host access to all associated SpectroSERVER workstations. On each SpectroSERVER host: a. Launch the SPECTRUM Control Panel. b. Select Configure > Host Security. c. Ensure that the Server List contains either a plus sign (unrestricted access) or the host name of the designated OneClick host (the OneClick web server). See the SPECTRUM Control Panel User Guide (5029) for more information. 4. To ensure that you have connectivity to the designated <SPECTRUM host>, ping it using its host name. 5. Identify an existing or create a new SPECTRUM user to designate as the OneClick administrator user. Verify this user is a valid SPECTRUM administrator using SPECTRUM s User Editor: a. Launch the User Editor. b. In the User Editor, select the user model to designate as the OneClick administrator user and verify that its Community String value (listed under User Attributes) is set to ADMIN,0. You can print out and write in the OneClick administrator user below for future reference: Note: In a distributed environment, this administrative user must exist in all landscapes in the distributed environment. For more information see the Distributed SpectroSERVER (2770) guide. 6. Verify that the Solaris workstation on which you are installing OneClick server has access to the SpectroSERVER. 7. You must have host name resolution to the SpectroSERVER from the OneClick server. You can ensure this availability by editing your local hosts file. If you are not using a name service, you must edit your local hosts file (described below). To test host name resolution, from a terminal window, ping the <SPECTRUM host> using just the host portion of its fully qualified domain name. For example, to ping host.company.com: 14 OneClick Installation Guide

15 Install the Java 2 SDK (Solaris) shell> ping host If the ping fails, edit the /etc/hosts file to reflect the IP and name of the <SPECTRUM host>. To add a host name to the Solaris hosts file: a. Login as root b. Edit the /etc/hosts file c. Add an entry as below (host in this example): # # Internet host table # localhost host loghost d. Save this file e. Edit the /etc/nsswitch.conf file f. Find the line in nsswitch.conf which begins with hosts: g. Change this line so that files is the first word after hosts: (this tells the name resolution to use the local /etc/hosts file first before using the domain name services). If the word files is already in this line, but is not the first word after hosts: then move it. If the word files is not in this line, then insert it (for example): hosts: files nis h. Save the file Install the Java 2 SDK (Solaris) Procedure 1. Log in to your Solaris server as root. 2. Uninstall any previously installed 1.3.x or 1.4.x installation of the Java 2 SDK. See java.sun.com/j2se/1.5.0/install.html for more information. 3. Insert the OneClick CD into the CD drive of your Solaris server. 4. Copy the jdk-1_5_0_06-solaris-sparc.sh file from the OneClick/JDK1_5_0 directory on the CD to the /opt directory on your Solaris server: cp <cd drive>/oneclick/jdk1_5_0/jdk-1_5_0_06-solaris-sparc.sh /opt 5. Change the directory to /opt. cd /opt 6. Make the file executable by running the chmod command: chmod +x jdk-1_5_0_06-solaris-sparc.sh 7. Run the self-extracting binary. jdk-1_5_0_06-solaris-sparc.sh 8. Follow the installation wizard instructions. OneClick Installation Guide 15

16 Chapter 2: Installing OneClick server on Solaris Note: To save disk space on your Solaris server, you can delete jdk-1_5_0_06-solarissparc.sh from the /opt directory after you have finished installing it. Install OneClick server (Solaris) Procedure 1. Login as root before beginning the OneClick Server installation. 2. Ensure that the root user has display permissions (use xhost to set permissions). 3. Insert the OneClick 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 OneClick. If autorun does not start, navigate to the <cd drive>/oneclick/ directory and type install.bin and press ENTER to run the installation software. 4. Follow the instructions provided by the OneClick installation software and enter the installation parameters listed in Table 2-1 on page 17 when prompted. 16 OneClick Installation Guide

17 Install OneClick server (Solaris) Table 2-1: Solaris Installation Parameters Installation Window Introduction License Agreement SPECTRUM Extraction Key Java 2 SDK Location Choose Install Folder 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 CA. The extraction key is not case sensitive and spaces are optional. The location where Java 2 SDK is installed on the OneClick server. For example, /opt/jdk-1_5_0_06, as described in Install the Java 2 SDK (Solaris) on page 15. The location where you want to install OneClick. The default directory is /usr/spectrum. This Install Guide will refer to this location as <Install Area> Important: Spaces are not allowed in folder names. OneClick Activation Key SPECTRUM OneClick requires that you enter an activation key as supplied to you by CA. OneClick Port Number SPECTRUM Server Configuration 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>, found in step 1, (you must enter the host name rather than an IP address in this field), the port on the location server to which the OneClick server connects (0xdaff by default), and the Osagent port (14008 by default). Important: It is strongly recommended that you do not set this to the previous default of 14000, as this can lead to interaction with previous versions of SPECTRUM and cause osagent crashes. Troubleshooting SPECTRUM Server Configuration Problems Resolving Unable to Connect to Location Server Error: -Verify connectivity by pinging the <SPECTRUM host> (see step 1) -Verify name resolution -Verify.hostrc access for OneClick server (this install host) on <SPECTRUM host> -Verify main location server is running on <SPECTRUM host> -Verify location server ports OneClick Installation Guide 17

18 Chapter 2: Installing OneClick server on Solaris Table 2-1: Solaris Installation Parameters Installation Window Input Web Administrator User The User Name of the user that you designate as the OneClick administrator. Note: The user name of the OneClick administrator must match exactly (case sensitive) with a valid, SPECTRUM administrator user. Troubleshooting SPECTRUM Web Administrator User Problems Resolving Unable to Configure user <username> in the SpectroSERVER Error: -Verify name resolution (without domain name) to the <SPECTRUM host> (see step 1 of Prepare the SpectroSERVER environment (Solaris) on page 13) -Verify administrator user (ADMIN,0) on <SPECTRUM host>, (case sensitive) -Verify JDK is not installed in a directory with 1 or more spaces in its name -Verify the correct OS patch on SpectroSERVER machine -Verify that osagent is running on <SPECTRUM host> -Verify that OSAGENT_PORT is set to or your customized port. -Verify that the host name entered in SPECTRUM Server Configuration on page 17 matches the host name osagent is advertising. To do this, run <$SPECROOT>/bin/osfind on <SPECTRUM host>. Note that the osfind utility is not installed during OneClick web server-only installations. The osfind utility should return an OBJECT NAME value for CsCModelDomain matching the host portion of the host name entered in the SPECTRUM Server Configuration on page 17. For example, for host name host: HOST: host.domain.com REPOSITORY ID: IDL:CsCModelDomain:1.0 OBJECT NAME: host/servicename OBJECT NAME must match the host portion of the host name entered in SPECTRUM Server Configuration on page 17 for the <SPECTRUM host>. If OBJECT NAME does not match the host name, ensure host name resolution by modifying the hosts file (see step 1). Configuring Alarm and Event Reports 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. 18 OneClick Installation Guide

19 Install OneClick server (Solaris) Table 2-1: Solaris Installation Parameters Installation Window Input Report Manager Servers and Business Objects XI Administrator Password Note: These windows appear only in OneClick with Report Manager installations. Refer to the Report Manager Installation and Administration Guide for details. OneClick URL Install Complete Input is not required. You can launch OneClick or complete the installation without launching OneClick. If you launch OneClick you must return to the OneClick URL window and complete the installation at another time. Input is not required. OneClick Installation Guide 19

20 Chapter 2: Installing OneClick server on Solaris 20 OneClick Installation Guide

21 Chapter 3: Installing OneClick server on Linux This chapter explains how to install the OneClick server on a Red Hat Linux host machine. To install the OneClick server, you must complete the following procedures in the order they appear in this chapter. In this chapter Prepare the SpectroSERVER environment (Linux) on page 21 Install the Java 2 SDK (Linux) on page 24 Install OneClick server (Linux) on page 25 Prepare the SpectroSERVER environment (Linux) Important: When installing OneClick with Report Manager and Business Objects XI: You must first install Business Objects XI from its CD using the license number provided to you by CA. Refer to the Report Manager Installation and Administration Guide (5169) for installation instructions. You must install Business Objects XI and OneClick with Report Manager on the same machine, one that is not also running a SpectroSERVER. Install OneClick with Report Manager from the OneClick CD. See the Report Manager Installation and Administration Guide for more information. Procedure 1. The SpectroSERVER host machine (later referred to in this document as the <SPECTRUM host>) must be running the same SPECTRUM version as the OneClick web server. Note: Certain SpectroSERVER service packs will also require updates to the OneClick web server, while others will not. Check the applicable software release note for details. Verify that the SPECTRUM version installed on the SPECTRUM SpectroSERVER host is the same version as that which you will be installing on the OneClick web server. If not, you must install the correct version of SPECTRUM on the SPECTRUM SpectroSERVER host. 21

22 Chapter 3: Installing OneClick server on Linux To verify this, navigate to <$SPECROOT>/Install-Tools and view the.history file using the more command. You can print out and write in the host name of your <SPECTRUM host> below for future reference: Important: For each SpectroSERVER, there must be an entry in the.hostrc file for the workstations hosting the OneClick server. For more information, see the Security and User Maintenance Guide (2602) and step 3, below. 2. Verify that all associated SpectroSERVERS are running. 3. Verify that the Linux workstation on which you are installing OneClick has host access to all associated SpectroSERVER workstations. On each SpectroSERVER host: a. Launch the SPECTRUM Control Panel. b. Select Configure > Host Security. c. Ensure that the Server List contains either a plus sign (unrestricted access) or the host name of the designated OneClick host (the OneClick web server). See the SPECTRUM Control Panel User Guide (5029) for more information. 4. To ensure that you have connectivity to the designated <SPECTRUM host>, ping it using its host name. 5. Identify an existing or create a new SPECTRUM user to designate as the OneClick administrator user. a. If you install OC using the same user name you installed the SpectroSERVER as, that user is already created in Spectrum with default password of spectrum. b. To create a user on a Linux SpectroSERVER, run the $SPECROOT/bin/addSpecUser utility on the Linux SpectroSERVER. The usage for this utility is: addspecuser <name> <password> -r <role> For example, to add a user with the name specuser with password spectrum who is an Administrator you would type: addspecuser specuser spectrum r Administrator Note: Optionally, the legacy User Editor on a Solaris or Windows SPECTRUM installation can be connected to a Linux SPECTRUM host to perform user maintenance. To do this, follow this procedure: a. Launch the User Editor. 22 OneClick Installation Guide

23 Prepare the SpectroSERVER environment (Linux) b. In the User Editor, select the user model to designate as the OneClick administrator user and verify that its Community String value (listed under User Attributes) is set to ADMIN,0. You can print out and write in the OneClick administrator user below for future reference: Note: In a distributed environment, this administrative user must exist in all landscapes in the distributed environment. For more information see the Distributed SpectroSERVER (2770) guide. 6. Verify that the Linux workstation on which you are installing OneClick server has access to the SpectroSERVER. OneClick Installation Guide 23

24 Chapter 3: Installing OneClick server on Linux 7. You must have host name resolution to the SpectroSERVER from the OneClick server. You can ensure this availability by editing your local hosts file. If you are not using a name service, you must edit your local hosts file (described below). To test host name resolution, from a terminal window, ping the <SPECTRUM host> using just the host portion of its fully qualified domain name. For example, to ping host.company.com: shell> ping host If the ping fails, edit the /etc/hosts file to reflect the IP and name of the <SPECTRUM host>. To add a host name to the Linux hosts file: a. Login as root b. Edit the /etc/hosts file c. Add an entry as below (host in this example): # # Internet host table # localhost host loghost d. Save this file e. Edit the /etc/nsswitch.conf file f. Find the line in nsswitch.conf which begins with hosts: g. Change this line so that files is the first word after hosts: (this tells the name resolution to use the local /etc/hosts file first before using the domain name services). If the word files is already in this line, but is not the first word after hosts: then move it. If the word files is not in this line, then insert it (for example): hosts: files nis h. Save the file Install the Java 2 SDK (Linux) Procedure 1. Log in to your Linux server as root. 2. Uninstall any previously installed 1.3.x or 1.4.x installation of the Java 2 SDK. See java.sun.com/j2se/1.5.0/install.html for more information. 3. Insert the OneClick CD into the CD drive of your Linux server. 4. Copy the jdk-1_5_0_06-linux-i586.bin file from the OneClick/JDK1_5_0 directory on the CD to the /opt directory on your Linux server: cp <cd drive>/oneclick/jdk1_5_0/jdk-1_5_0_06-linux-i586.bin /opt 5. Change the directory to /opt. cd /opt 6. Make the file executable by running the chmod command: chmod +x jdk-1_5_0_06-linux-i586.bin 24 OneClick Installation Guide

25 Install OneClick server (Linux) 7. Run the self-extracting binary. jdk-1_5_0_06-linux-i586.bin 8. Follow the installation wizard instructions. Note: To save disk space on your Linux server, you can delete jdk-1_5_0_06-linux-i586.bin from the /opt directory after you have finished installing it. Install OneClick server (Linux) Procedure 1. Login as root before beginning the OneClick Server installation. 2. Ensure that the root user has display permissions (use xhost to set permissions). 3. Insert the OneClick CD into the CD drive of your Linux 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 OneClick. If autorun does not start, navigate to the <cd drive>/oneclick/ directory and type install.bin and press ENTER to run the installation software. 4. Follow the instructions provided by the OneClick installation software and enter the installation parameters listed in Table 3-1 on page 26 when prompted. OneClick Installation Guide 25

26 Chapter 3: Installing OneClick server on Linux Table 3-1: Linux Installation Parameters Installation Window Introduction License Agreement SPECTRUM Extraction Key Java 2 SDK Location Choose Install Folder 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 CA. The extraction key is not case sensitive and spaces are optional. The location where Java 2 SDK is installed on the OneClick server. For example, /opt/jdk1.5.0_06, as described in Install the Java 2 SDK (Linux) on page 24. The location where you want to install OneClick. The default directory is /usr/spectrum. This Install Guide will refer to this location as <Install Area> Important: Spaces are not allowed in folder names. OneClick Activation Key SPECTRUM OneClick requires that you enter an activation key as supplied to you by CA. OneClick Port Number SPECTRUM Server Configuration 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>, found in step 1, (you must enter the host name rather than an IP address in this field), the port on the location server to which the OneClick server connects (0xdaff by default), and the Osagent port (14008 by default). Important: It is strongly recommended that you do not set this to the previous default of 14000, as this can lead to interaction with previous versions of SPECTRUM and cause osagent crashes. Troubleshooting SPECTRUM Server Configuration Problems Resolving Unable to Connect to Location Server Error: -Verify connectivity by pinging the <SPECTRUM host> (see step 1) -Verify name resolution -Verify.hostrc access for OneClick server (this install host) on <SPECTRUM host> -Verify main location server is running on <SPECTRUM host> -Verify location server ports 26 OneClick Installation Guide

27 Install OneClick server (Linux) Table 3-1: Linux Installation Parameters Installation Window Input Web Administrator User The User Name of the user that you designate as the OneClick administrator. Note: The user name of the OneClick administrator must match exactly (case sensitive) with a valid, SPECTRUM administrator user. Report Manager Servers and Business Objects XI Administrator Password Note: These windows appear only in OneClick with Report Manager installations. Troubleshooting SPECTRUM Web Administrator User Problems Resolving Unable to Configure user <username> in the SpectroSERVER Error: -Verify name resolution (without domain name) to the <SPECTRUM host> (see step 1 of Prepare the SpectroSERVER environment (Linux) on page 21) -Verify administrator user (ADMIN,0) on <SPECTRUM host>, (case sensitive) -Verify JDK is not installed in a directory with 1 or more spaces in its name -Verify the correct OS patch on SpectroSERVER machine -Verify that osagent is running on <SPECTRUM host> -Verify that OSAGENT_PORT is set to or your customized port. -Verify that the host name entered in SPECTRUM Server Configuration on page 26 matches the host name osagent is advertising. To do this, run <$SPECROOT>/bin/osfind on <SPECTRUM host>. Note that the osfind utility is not installed during OneClick web server-only installations. The osfind utility should return an OBJECT NAME value for CsCModelDomain matching the host portion of the host name entered in the SPECTRUM Server Configuration on page 26. For example, for host name host: HOST: host.domain.com REPOSITORY ID: IDL:CsCModelDomain:1.0 OBJECT NAME: host/servicename OBJECT NAME must match the host portion of the host name entered in SPECTRUM Server Configuration on page 26 for the <SPECTRUM host>. If OBJECT NAME does not match the host name, ensure host name resolution by modifying the hosts file (see step 1). Refer to the Report Manager Installation and Administration Guide for details. OneClick URL Input is not required. You can launch OneClick or complete the installation without launching OneClick. If you launch OneClick you must return to the OneClick URL window and complete the installation at another time. OneClick Installation Guide 27

28 Chapter 3: Installing OneClick server on Linux Table 3-1: Linux Installation Parameters Installation Window Install Complete Input Input is not required. 28 OneClick Installation Guide

29 Chapter 4: Installing OneClick server on Windows This chapter explains how to install the OneClick server on a workstation running Windows. To install the OneClick server, you must complete the following procedures in the order they appear in this chapter. In this chapter Prepare the SpectroSERVER environment (Windows) on page 29 Running the installation software on Windows on page 31 Prepare the SpectroSERVER environment (Windows) Procedure 1. The SpectroSERVER host machine must be running the same SPECTRUM version as the OneClick web server. Note: Certain SpectroSERVER service packs will also require updates to the OneClick web server, while others will not. Check the applicable software release note for details. Verify that the SPECTRUM version installed on the SPECTRUM SpectroSERVER host is the same version as that which you will be installing on the OneClick web server. If not, you must install the correct version of SPECTRUM on the SpectroSERVER host. To identify the version of SPECTRUM running on the <SPECTRUM host>, navigate to <$SPECROOT>/Install- Tools and view the.history file using a text editor. You can print out and write in the host name of your <SPECTRUM host> below for future reference: Important: For each SpectroSERVER, there must be an entry in the.hostrc file for the workstation hosting the OneClick server. For more information, see the Security and User Maintenance Guide (2602). 29

30 Chapter 4: Installing OneClick server on Windows 2. Verify that all associated SpectroSERVERS are running. 3. Verify that the Windows workstation on which you are installing OneClick has host access to all associated SpectroSERVER workstations. On each SpectroSERVER host: a. Launch the SPECTRUM Control Panel. b. Select Configure > Host Security. c. Ensure that the Server List contains either a plus sign (unrestricted access) or the host name of the designated OneClick host (the OneClick Web server). See the SPECTRUM Control Panel User Guide (5029) for more information. 4. To ensure that you have connectivity to the designated <SPECTRUM host>, ping it using its host name. 5. Either identify an existing SPECTRUM user or create a new user to designate as the OneClick administrator user. Verify this user is a valid SPECTRUM administrator using SPECTRUM s User Editor: a. Launch the User Editor. b. In the User Editor, select the user model to designate as the OneClick administrator user and verify that its Community String value (listed under User Attributes) is set to ADMIN,0. You can print out and write in the OneClick administrator user below for future reference: Note: In a distributed environment, this administrative user must exist in all landscapes in the distributed environment. For more information see the Distributed SpectroSERVER (2770) guide. 6. Verify that the Windows workstation on which you are installing OneClick server has access to the SpectroSERVER. You must have host name resolution (with just the host portion of the fully qualified domain name) to the SpectroSERVER from the OneClick server. You can ensure this availability by editing your local hosts file. To add a host name to a Windows 2000 host resolution file: a. Navigate to C:\WINNT\system32\drivers\etc b. Open the file hosts with a text editor. c. Add entries per the comments in the hosts file. d. Save the file. 30 OneClick Installation Guide

31 Running the installation software on Windows To add a host name to a Windows XP host resolution file: a. Navigate to C:\WINDOWS\system32\drivers\etc b. Open the file hosts with a text editor. c. Add entries as per the comments in the hosts file. d. Save the file. 7. Remove any prior installations of the JRE and SDK from the OneClick web server host machine. OneClick includes the required JDK and JRE while some older versions can cause conflicts. To do this, navigate to Start > Settings > Control Panel > Add/Remove Programs. Select in turn each instance of the Java Runtime and Java SDK and remove them. Running the installation software on Windows Important: When installing OneClick with Report Manager and Business Objects XI: You must first install Business Objects XI from its CD using the license number provided to you by CA. Refer to the Report Manager Installation and Administration Guide (5169) for installation instructions. You must install Business Objects XI and OneClick with Report Manager on the same machine, one that is not also running a SpectroSERVER. Install OneClick with Report Manager from the OneClick CD. See the Report Manager Installation and Administration Guide for more information. Procedure 1. Log in as Administrator or as a user in the administrators group. Note: You need to have administrator privileges to install OneClick, but you cannot be a Domain Administrator. 2. Insert the OneClick CD into the CD drive of your Windows workstation and do one of the following: If autorun starts and the Install window appears, click the hyperlink to install OneClick. If autorun does not start, navigate to the <cd drive>\oneclick\ directory and double-click install.exe to start the OneClick installation software. 3. Follow the instructions provided by the OneClick installation software and enter the installation parameters listed in Table 4-1 when prompted. OneClick Installation Guide 31

32 Chapter 4: Installing OneClick server on Windows Table 4-1: Windows Installation Parameters Installation Window Introduction License Agreement SPECTRUM Extraction Key Missing Java 2 SDK [Optional, Windows only] 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 CA. The extraction key is not case sensitive and spaces are optional. The Java SDK must be present to continue. The installer automatically checks for the presence of the Java SDK and can install it if it is missing. Click Install JDK and follow the onscreen instructions provided in the install wizard to install Java 2 SDK, Standard Edition, version 1.5.0_06. Choose the path to install the SDK, if necessary. Important: Do not install the Java 2 SDK in the C:\Program Files directory or in any folders named with spaces. Note: The only component of the JDK that must be installed is Program Files. The following are optional components: Native Interface Header Files Demos Java Sources Java 2 Runtime Environment (versions of the JRE earlier than should not be installed) Choose Install Folder The location where you want to install OneClick. The default directory is C:\win32app\SPECTRUM. This Install Guide will refer to this location as <Install Area>. Important: Spaces are not allowed in folder names. OneClick Activation Key OneClick Port Number SPECTRUM OneClick requires that you enter an activation key as supplied to you by CA. 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). 32 OneClick Installation Guide

33 Running the installation software on Windows Table 4-1: Windows Installation Parameters Installation Window SPECTRUM Server Configuration Input The <SPECTRUM host> containing the home user models, the port on the location server to which the OneClick server connects (0xdaff by default), and the Osagent port (14008 by default). Troubleshooting SPECTRUM Server Configuration Problems Resolving Unable to Connect to Location Server Error: -Verify connectivity by pinging <SPECTRUM host> (see step 1). -Verify name resolution. -Verify.hostrc access for OneClick server (this install host) on <SPECTRUM host>. -Verify main location server is running on <SPECTRUM host>. -Verify location server ports. OneClick Installation Guide 33

34 Chapter 4: Installing OneClick server on Windows Table 4-1: Windows Installation Parameters Installation Window Web Administrator User Input The User Name of the user that you designate as the OneClick administrator. Note: The user name of the OneClick administrator must match exactly (case sensitive) with a valid SPECTRUM administrator user. Troubleshooting SPECTRUM Web Administrator User Problems Resolving Unable to Configure user <username> in the SpectroSERVER Error: -Verify name resolution (without domain name) to the <SPECTRUM host> (see step 6 of Prepare the SpectroSERVER environment (Windows) on page 29). -Verify administrator user (ADMIN,0) entered on <SPECTRUM host>, (case sensitive). -Verify JDK is not installed in a directory with 1 or more spaces in its name. -Verify the correct patch on SpectroSERVER machine. -Verify osagent is running on <SPECTRUM host>. -Verify that OSAGENT_PORT is set to or your customized port. -Verify that the host name entered in SPECTRUM Server Configuration on page 33 matches the host name osagent is advertising. To do this, run <$SPECROOT>/bin/osfind on <SPECTRUM host>. Note that the osfind utility is not installed during OneClick web server-only installations. The osfind utility should return an OBJECT NAME value for CsCModelDomain matching the host portion of the host name entered in the SPECTRUM Server Configuration on page 33. For example, for host name host: HOST: host.domain.com REPOSITORY ID: IDL:CsCModelDomain:1.0 OBJECT NAME: host/servicename OBJECT NAME must match the host portion of the host name entered in SPECTRUM Server Configuration on page 33 for the <SPECTRUM host>. If OBJECT NAME does not match the host name, ensure host name resolution by modifying the hosts file (see step 1). -Verify that the JDK installation path contains no white spaces. 34 OneClick Installation Guide

35 Running the installation software on Windows Table 4-1: Windows Installation Parameters Installation Window Schedule Task and Reports Note: This window appears on Web Operator Suite installations only. Input 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 window, click OK. 2. In the Reports dialog box, click the Set Password button under the Task tab. 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. Report Manager Servers and Business Objects XI Administrator Password Note: These windows appear only in OneClick with Report Manager installations. Refer to the Report Manager Installation and Administration Guide for details. OneClick URL Install Complete Input is not required. You can launch OneClick or complete the installation without launching OneClick. If you launch OneClick you must return to the OneClick URL window and complete the installation at another time. Input is not required. OneClick Installation Guide 35

36 Chapter 4: Installing OneClick server on Windows 36 OneClick Installation Guide

37 Chapter 5: Fault tolerant environments and OneClick The following chapter describes procedures and issues applicable to running installations of OneClick in fault tolerant environments. In this chapter Fault tolerant OneClick upgrade in place best practices on page 37 Configuring fault tolerance in sub-netted environments on page 43 Configuring landscape polling interval in fault tolerant environments on page 44 Fault tolerant OneClick upgrade in place best practices The following procedures can be used to update existing version 7.1 fault-tolerant installations of OneClick to the 8.0 version. Upgrade with Historical Event Data Preservation on page 37 Upgrade without historical event data preservation on page 40 Upgrade with Historical Event Data Preservation This upgrade method takes historical data into account and preserves it during the upgrade process. Procedure 1. Run Online Backup to synchronize the primary and secondary SpectroSERVERs and create copies of the most current SpectroSERVER database save files. See the Online Backup section of the Database Management (2601) guide for more information. 2. Isolate the primary and secondary systems by making the following changes to their respective.hostrc files: Note: Make note of these changes; you will need to add these entries back in step 7. 37

38 Chapter 5: Fault tolerant environments and OneClick a. Remove all primary SpectroSERVER entries from the.hostrc file of the secondary SpectroSERVERs. b. Remove all OneClick Web server entries from the.hostrc file of the secondary SpectroSERVERs. c. Remove all secondary SpectroSERVER entries from the.hostrc file of the primary SpectroSERVERs. Note: Once the.hostrc file has been edited to prevent access between fault tolerant SpectroSERVERs, both the primary and secondary SpectroSERVERs will begin polling independently. Important: There will be a loss of fault tolerance until the primary and secondary SpectroSERVERs have been upgraded to Use the MapUpdate tool to remove all stale Landscape map entries on the primary and secondary SpectroSERVERs. See the SPECTRUM Database Tools section of the Database Management (2601) guide for more information. a. SS-Tools directory:./mapupdate -view (to view current map) b. SS-Tools directory of primary SpectroSERVERs:./MapUpdate -remove <Landscape Handle> -precedence 20 c. SS-Tools directory of secondary SpectroSERVERs:./MapUpdate -remove <Landscape Handle> -precedence Upgrade the secondary 7.1 SpectroSERVERs to version 8.0. For detailed information, refer to the SPECTRUM Installation Guide. Do the following prior to the upgrade to 8.0: a. Shut down any SPECTRUM applications running on the secondary SpectroSERVERs before upgrading. b. Designate the system operating as the secondary SpectroSERVER for the current 7.1 main location server as the temporary 8.0 main location server. c. The temporary 8.0 main location server should be specified during the installation of 8.0. Note: It is recommended that the temporary 8.0 main location server is brought back on line before all other SpectroSERVERs or the user may have problems connecting to the local SpectroSERVER. 5. Once the 8.0 SpectroSERVERs are running, upgrade one of the OneClick Web server systems to version 8.0. Perform the following tasks during the upgrade to OneClick 8.0: a. Designate one of the 7.1 OneClick Web servers as the 8.0 OneClick Web server. b. Remove the entry for the 8.0 OneClick Web server from the.hostrc file on each of the 7.1 servers. c. Initiate the installation of 8.0 OneClick. d. When the installation reaches the OneClick License screen, add an entry for the 8.0 OneClick Web server to the.hostrc file on each of the 8.0 SpectroSERVERs. e. When the installation reaches the Server Configuration screen, change the hostname to the temporary 8.0 main location server. 38 OneClick Installation Guide

39 Fault tolerant OneClick upgrade in place best practices 6. When any 8.0 testing you want to do is complete, the remaining 7.1 SpectroSERVERs should be upgraded to 8.0 by doing the following: Note: If you did any modeling during the functional testing of 8.0 and are concerned with preserving historical data during the time period when the primary SpectroSERVERs are upgraded, it is recommended that you restore the.after save file to revert the SpectroSERVER back to its original state after the upgrade to 8.0. a. From SS directory:../ss-tools/ssdbload -il <timestamp>.after.ssdb b. To ensure that historical data will be preserved during the upgrade process, edit the.vnmrc file on the secondary SpectroSERVERs and increase the max_stat_records and max_event_records. c. Restart the SpectroSERVERs in order to update the server with the.vnmrc change. d. Shut down the 7.1 Archive Managers if they are running so that all events and statistics will be stored locally on the secondary SpectroSERVERs. e. Shut down any SPECTRUM applications running on the 7.1 servers before upgrading. f. Specify the current 7.1 main location server as the main location server during the installation of 8.0. Note: It is recommended that the 8.0 main location server be brought back on line before all other SpectroSERVERs so that the user does not have problems connecting to the local SpectroSERVER. 7. Remove the boundaries set in the host security file for the primary and secondary systems by making the following changes to the.hostrc files: a. Add back all primary SpectroSERVER entries from the.hostrc file of the secondary SpectroSERVERs. b. Add back all OneClick Web server entries from the.hostrc file of the secondary SpectroSERVERs. c. Add back all secondary SpectroSERVER entries from the.hostrc file of the primary SpectroSERVERs. 8. Use the Configure > Location Server buttons in the Control Panel of the secondary SpectroSERVERs to change the main LS host entry back to the main location server. 9. Use the MapUpdate tool to verify that both the primary and secondary SpectroSERVERs are listed: SS-Tools directory:./mapupdate -view (to view current map) Note: All locally stored events/statistics on the secondary SpectroSERVER should be flushed over to the primary SpectroSERVER. 10. Edit the.vnmrc file on the secondary SpectroSERVERs and set the max_stat_records and max_event_records back to their original values. 11. Run Online Backup to synchronize the primary and secondary SpectroSERVERs and to update the secondary SpectroSERVERs with the.vnmrc change. OneClick Installation Guide 39

40 Chapter 5: Fault tolerant environments and OneClick 12. Upgrade the remaining OneClick Web server systems to version 8.0. Do the following during the upgrade to 8.0: a. Add the entries for the other 8.0 OneClick Web servers to the.hostrc file of the primary and secondary SpectroSERVERs. b. Initiate the installation of 8.0 OneClick. 13. Update the initial 8.0 OneClick Web server to point to the main location server. a. Edit the WebApps/tomcat/conf/server.xml file. b. Change the "locservername" value to the main location server. c. Change the "orbagentname" value to the main location server. d. Restart the Web server: Solaris As root: 1. shell> /etc/init.d/wotomcat stop 2. shell> /etc/init.d/wotomcat start Windows 1. C:\> net stop spectrumtomcat 2. C:\> net start spectrumtomcat Linux As root: 1. shell> /etc/init.d/wotomcat stop 2. shell> /etc/init.d/wotomcat start 14. Upgrade the SpectroGraph only systems to 8.0. Upgrade without historical event data preservation This upgrade method does not take historical data into account during the upgrade process. Procedure 1. Run Online Backup to synchronize the primary and secondary SpectroSERVERs and create copies of the most current SpectroSERVER database save files. See the Online Backup section of the Database Management (2601) guide for more information. 2. Isolate the primary and secondary systems by making the following changes to their respective.hostrc files: a. Remove all primary SpectroSERVER entries from the.hostrc file of the secondary SpectroSERVERs. b. Remove all OneClick Web server entries from the.hostrc file of the secondary SpectroSERVERs. 40 OneClick Installation Guide

41 Fault tolerant OneClick upgrade in place best practices c. Remove all secondary SpectroSERVER entries from the.hostrc file of the primary SpectroSERVERs. Note: Once the.hostrc has prevented access between fault tolerant SpectroSERVERs, both the primary and secondary SpectroSERVERs will begin polling independently. Important: There will be a loss of fault tolerance until the primary and secondary SpectroSERVERs have been upgraded to Use the MapUpdate tool to remove all stale Landscape map entries on the primary and secondary SpectroSERVERs. a. SS-Tools directory:./mapupdate -view (to view current map) b. SS-Tools directory of primary SpectroSERVERs:./MapUpdate -remove <Landscape Handle> -precedence 20 c. SS-Tools directory of secondary SpectroSERVERs:./MapUpdate -remove <Landscape Handle> -precedence 10 d. When the load is completed, upgrade the secondary 7.1 SpectroSERVERs to version 8.0. Do the following during the upgrade to 8.0: e. Shut down any SPECTRUM applications running on the secondary SpectroSERVERs before upgrading. f. Delegate the system operating as the secondary SpectroSERVER for the current 7.1 main location server as the temporary 8.0 main location server. g. The temporary 8.0 main location server should be specified during the installation of 8.0. Note: It is recommended that the temporary 8.0 main location server is brought back on-line before all other SpectroSERVERs or the user may have problems connecting to the local SpectroSERVER. 4. Once the 8.0 SpectroSERVERs are running, upgrade one of the OneClick Web server systems to version 8.0. Perform the following tasks during the upgrade to 8.0: a. Designate one of the 7.1 OneClick Web servers as the 8.0 OneClick Web server. b. Remove the entry for the 8.0 OneClick Web server from the.hostrc file on each of the 7.1 SpectroSERVERs. c. Initiate the installation of 8.0 OneClick. d. When the installation reaches the OneClick License screen, add an entry for the 8.0 OneClick Web server to the.hostrc file on each of the 8.0 SpectroSERVERs. e. When the installation reaches the Server Configuration screen, change the hostname to the temporary 8.0 main location server. 5. When any 8.0 testing you want to do is complete, the remaining 7.1 SpectroSERVERs should be upgraded to 8.0 by doing the following: a. Shut down any SPECTRUM applications running on the 7.1 SpectroSERVERs before upgrading. OneClick Installation Guide 41

42 Chapter 5: Fault tolerant environments and OneClick b. Specify the current 7.1 main location server as the main location server during the installation of 8.0. Note: It is recommended that the 8.0 main location server be brought back on line before all other SpectroSERVERs so that the user does not have problems connecting to the local SpectroSERVER. 6. Remove the boundaries set in the host security file for the primary and secondary systems by making the following changes to the.hostrc files: a. Add back all primary SpectroSERVER entries from the.hostrc file of the secondary SpectroSERVERs. b. Add back all OneClick Web server entries from the.hostrc file of the secondary SpectroSERVERs. c. Add back all secondary SpectroSERVER entries from the.hostrc file of the primary SpectroSERVERs. 7. Use the Configure > Location Server buttons in the Control Panel of the secondary SpectroSERVERs to change the main LS host entry back to the main location server. 8. Use the MapUpdate tool to verify that both the primary and secondary SpectroSERVERs are listed. SS-Tools directory:./mapupdate -view (to view current map) 9. Run Online Backup to synchronize the primary and secondary SpectroSERVERs. 10. Upgrade the remaining OneClick Web server systems to version 8.0. Do the following during the upgrade to 8.0: a. Add the entries for the other 8.0 OneClick Web servers to the.hostrc file of the primary and secondary SpectroSERVERs. b. Initiate the installation of 8.0 OneClick. 11. Update the initial 8.0 OneClick Web server to point to the main location server: a. Edit the WebApps/tomcat/conf/server.xml file. - Change the "locservername" value to the main location server. - Change the "orbagentname" value to the main location server. b. Restart the Web server: Solaris As root: 1. shell> /etc/init.d/wotomcat stop 2. shell> /etc/init.d/wotomcat start Windows 1. C:\> net stop spectrumtomcat 2. C:\> net start spectrumtomcat 42 OneClick Installation Guide

43 Configuring fault tolerance in sub-netted environments Linux As root: 1. shell> /etc/init.d/wotomcat stop 2. shell> /etc/init.d/wotomcat start 12. Upgrade the SpectroGraph only systems to 8.0. Configuring fault tolerance in sub-netted environments In fault tolerant environments where the OneClick Web server is on a different subnet than the secondary SpectroSERVER, successful fail-overs without contact with the primary SpectroSERVER s osagent require that you configure the provided agentaddr file. The location of the agentaddr file is specified by the ORBagentAddrFile=<Install Area>/WebApps/tomcat/conf/ agentaddr parameter under the orbargs tag in the <Install Area>/WebApps/tomcat/conf/ server.xml file. The agentaddr file is created (if it doesn't already exist) during installation: <Install Area>/WebApps/tomcat/conf/agentaddr To configure the agentaddr file for the case when the OneClick Web server is on a different subnet than the secondary SpectroSERVER: 1. Open the agentaddr file for editing in a text editor. 2. Add the IP address of the secondary server to this file, followed by a carriage return. 3. Save the changes to the agentaddr file. 4. Restart the OneClick Web server. Note: You must restart the OneClick Web server any time the agentaddr file is modified. The supported sub-netted environments for fault tolerance are: Primary SpectroSERVER, Secondary SpectroSERVER, and OneClick Web server are each on different subnets In this environment, fault tolerance requires that all three machines have agentaddr files which contain an entry for each machine in the fault tolerant environment. See the Configuring SPECTRUM CORBA Services section of the SPECTRUM Installation Guide (5136) for more details. Primary and Secondary SpectroSERVERs on the same subnet, OneClick Web server on another subnet Without the primary SpectroSERVER s osagent, the Web server has no way of contacting the secondary SpectroSERVER, since it is on a separate subnet. The agentaddr file tells the CORBA ORBs (Object Request Brokers) where to find osagent on other subnets. The configuration for this scenario is described in detail in Configuring fault tolerance in sub-netted environments on page 43. Primary SpectroSERVER and OneClick Web server on the same subnet, Secondary SpectroSERVER on another subnet In this environment, fault tolerance requires that all three machines have agentaddr files which contain an entry for each machine in the fault tolerant environment. See the Configuring SPECTRUM CORBA Services section of the SPECTRUM Installation Guide (5136) for more details. OneClick Installation Guide 43

44 Chapter 5: Fault tolerant environments and OneClick Primary SpectroSERVER, Secondary SpectroSERVER, and OneClick Web server are all on the same subnet In this scenario, agentaddr files are not necessary. Configuring landscape polling interval in fault tolerant environments In fault tolerant SPECTRUM environments, OneClick checks the status of the SpectroSERVER(s) by polling each landscape at 10 second intervals by default. This is done to shorten the time it takes to failover to the secondary SpectroSERVER when the primary SpectroSERVER goes down and to avoid missing any SpectroSERVER restarts. In some cases, you may want to increase this landscape polling interval for better performance. You can optionally configure the interval by editing the value of domainpollinginterval in the server.xml file on the OneClick web server. The value of domainpollinginterval is the seconds between polls to the SpectroSERVER(s) to determine status. To do this, edit the <$SPECROOT>/WebApps/tomcat/conf/server.xml file to reflect a different value for domainpollinginterval. For example, to change the landscape polling interval to 60 seconds, change the value of domainpollinginterval from 10 to 60: <parameter> <name>domainpollinginterval</name> <value>10</value> </parameter> You must stop and restart the OneClick web server for the changes to take effect. 44 OneClick Installation Guide

45 Chapter 6: Installing OneClick client In this chapter OneClick client special considerations on page 45 Installing Java JRE and Web Start on Solaris and Linux on page 45 Installing Java JRE, including Plug-in and Web Start on Windows on page 47 OneClick client special considerations OneClick client on machines that host Java applications Some older Java applications are not robust, and do not specify the version of the Java Runtime Environment (JRE) they require. Running the OneClick client requires that you install version of the JRE. You may experience problems running these older applications with version of the JRE. Installing Java JRE and Web Start on Solaris and Linux These procedures explain how to install the Java JRE, including plug-in, and Java Web Start on Solaris and Linux. You need the Java JRE to support the OneClick client and Web Start to provide auto-install, auto-update, and to start the application. Installing the Java Runtime environment Installing the Java Runtime environment 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 OneClick. 45

46 Chapter 6: Installing OneClick client 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 OneClick and <portnumber> is the port number specified during the installation. 2. Click the Install JRE link from the main OneClick web page. 3. Follow the detailed instructions in the Installing the Java 2 Runtime Environment window (see Figure 6-1) for updating your system: Figure 6-1: Installing the Java 2 Runtime Environment: Solaris a. Download and install the required operating system patches. b. Download and install the Java 2 Runtime Environment version (You may need to change the permissions on the file in order to run it.) c. Add the Application for starting JNLP (Java Web Start Applications) in Netscape. d. Click OK on both windows to get back to Netscape. 4. You now have all the necessary updates to run the OneClick client on Solaris. You can now click Start Console from the main OneClick web page to launch the OneClick client. 46 OneClick Installation Guide

47 Installing Java JRE, including Plug-in and Web Start on Windows Installing Java JRE, including Plug-in and Web Start on Windows This procedure explains how to install the Java JRE, including plug-in and Java Web Start, on Windows. You need the Java JRE to support the OneClick client and Java Web Start to provide auto-install, auto-update, and to start the application. 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 OneClick. 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 OneClick and <portnumber> is the port number specified during the installation. 2. Click the Install JRE link from the main OneClick web page. 3. In the Installing the Java 2 Runtime Environment window (see Figure 6-2), click Java 2 Runtime Environment to download the JRE. Figure 6-2: Installing the Java 2 Runtime Environment: Windows 4. In the File Download message, click Open. 5. If you accept the license in the Software License Agreement window, select Accept and click Next. OneClick Installation Guide 47

48 Chapter 6: Installing OneClick client 6. In the Setup Type window, choose Typical and click Next. 7. Click Finish when the installation is complete. 8. You can now click Start Console from the main OneClick web page to launch the OneClick client. 48 OneClick Installation Guide

49 Chapter 7: Starting OneClick client This chapter explains how to start OneClick on a client workstation. See the OneClick User Guide (5130) for details on using OneClick. 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 OneClick. 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 OneClick 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. Enter the username and password of either the user identified during the OneClick web server installation (the default password for this initial user is spectrum), or any valid SPECTRUM user with a Web Password set in its user profile and associated with a OneClick Admin or Operator license. Click OK. The OneClick main page appears. Note: Any date and time information shown in OneClick is localized to reflect the time zone where the OneClick client is installed and running. 3. Ensure that you have installed the JRE before clicking on Start Console from the main OneClick web page to launch the OneClick client. If you have not yet installed the JRE, a file download dialog box for the oneclick.jnlp file (Figure 7-1) will open instead of the OneClick client startup. If this happens, click Cancel and install the JRE by clicking on the Install JRE link. 49

50 Chapter 7: Starting OneClick client Figure 7-1: Error: oneclick.jnlp File Download Dialog 4. Click Start Console from the main OneClick web page to launch the OneClick client. 50 OneClick Installation Guide

51 Chapter 8: Uninstalling OneClick In this chapter Uninstalling OneClick on Solaris or Linux on page 51 Uninstalling OneClick on Windows on page 51 Troubleshooting uninstall (Windows Only) on page 52 Uninstalling OneClick on Solaris or Linux Procedure 1. On the workstation running the OneClick server, log in as root. 2. To set the path variable to the location of the Java SDK on the OneClick 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/ j2k1.5.0_06). 3. Navigate to the <Install Area>/UninstallerData directory. 4. Run the OneClick uninstaller../uninstalloneclick Uninstalling OneClick on Windows Procedure 1. On the workstation running OneClick server, log in as administrator or a user in the administrators group. Note: You need to have administrator privileges to uninstall OneClick, but you cannot be a Domain Administrator. 51

52 Chapter 8: Uninstalling OneClick 2. Open the Windows Control Panel. 3. Double-click Add/Remove Programs. 4. In the Add/Remove Programs window, click SPECTRUM OneClick to select it. 5. Click Change/Remove and follow the instructions provided by the uninstall wizard. Troubleshooting uninstall (Windows Only) If you receive the error Windows error 3 occurred while loading the Java VM when attempting to uninstall OneClick, follow this procedure: Procedure 1. Determine the path to the java.exe executable on the OneClick machine by searching for it (Start menu > Search > All Files and Folders... Search for files or folders named: java.exe). This path is needed in step 3 of this procedure. Typically, this is found in the path to the JDK (<PATH_TO_JDK>\jre\bin\java.exe). If, for example, java.exe exists in C:\ jdk1.5.0_06\jre\bin\ then C:\jdk1.5.0_06\jre\bin\ will be the value needed in step Modify the PATH environment variable: a. Right-click My Computer and select Properties. b. Select the Advanced tab, then click the Environment Variables button. c. Under System Variables, select the variable Path and click the Edit button. 3. Append the java.exe path to the end of the current list by adding a semi-colon (;) and then the value from step 1 to the end of the list in the Variable value field as shown in Figure 8-1: Figure 8-1: Edit System Variable 4. Click OK in each of the three dialog boxes to save the changes. 5. Follow the instructions in Uninstalling OneClick on Windows on page 51 to remove OneClick. 52 OneClick Installation Guide

53 Chapter 9: Troubleshooting This chapter identifies problems and error messages that may be generated during OneClick installation and describes corrective action where feasible. Other maintenance and optional configuration issues are also addressed. In this chapter Server configuration problems (Solaris and Linux) on page 53 SPECTRUM web administrator user problems (Solaris and Linux) on page 54 Server configuration problems (Windows) on page 54 SPECTRUM Web administrator user problems (Windows) on page 54 OneClick Web server cannot connect to SpectroSERVER with Dual Network Interface Cards (NICs) on page 55 OneClick client fails to launch (Windows) on page 55 OneClick client login problems on page 55 OneClick client and web proxy issues on page 56 OneClick server error message on page 57 pcanywhere and OneClick on page 57 Java auto-updates and OneClick on page 57 Correcting invalid license error post-installation on page 57 Preserving existing event format and probable cause files on page 58 OneClick users cannot see all landscapes in distributed SpectroSERVER Environment on page 59 Server configuration problems (Solaris and Linux) To resolve an Unable to Connect to Location Server Error: 1. Verify connectivity by pinging the <SPECTRUM host> (see step 1). 2. Verify name resolution. 53

54 Chapter 9: Troubleshooting 3. Verify.hostrc access for OneClick server (this install host) on <SPECTRUM host>. 4. Verify main location server is running on <SPECTRUM host>. 5. Verify location server ports are correct. SPECTRUM web administrator user problems (Solaris and Linux) 1. Verify name resolution (without domain name) to the <SPECTRUM host> (see step 1 of Prepare the SpectroSERVER environment (Solaris) on page 13). 2. Verify administrator user (ADMIN,0) entered on <SPECTRUM host>, (case sensitive). 3. Verify JDK is not installed in a directory with 1 or more spaces in its name. 4. Verify the correct patch on SpectroSERVER machine. 5. Verify that osagent is running on <SPECTRUM host>. 6. Verify that the host name entered in SPECTRUM Server Configuration on page 17 matches the host name osagent is advertising. To do this, run <$SPECROOT>/bin/osfind on <SPECTRUM host>. The osfind utility should return an OBJECT NAME value for CsCModelDomain matching the host portion of the host name entered in the SPECTRUM Server Configuration on page 17. For example, for host name host: HOST: host.domain.com REPOSITORY ID: IDL:CsCModelDomain:1.0 OBJECT NAME: host/servicename The value of OBJECT NAME must match the host portion of the host name entered in SPECTRUM Server Configuration on page 17 for the <SPECTRUM host>. If OBJECT NAME does not match the host name, ensure host name resolution by modifying the hosts file (see step 1). Server configuration problems (Windows) To resolve Unable to Connect to Location Server Error: 1. Verify connectivity by pinging <SPECTRUM host> (see step 1) 2. Verify name resolution 3. Verify.hostrc access for OneClick server (this install host) on <SPECTRUM host> 4. Verify main location server is running on <SPECTRUM host> 5. Verify location server ports SPECTRUM Web administrator user problems (Windows) To resolve an Unable to configure user <user> in the SpectroSERVER. error: 54 OneClick Installation Guide

55 OneClick Web server cannot connect to SpectroSERVER with Dual Network Interface Cards (NICs) 1. Verify name resolution without domain name. 2. Verify administrator user (ADMIN,0) entered on <SPECTRUM host>, (case sensitive). 3. Verify JDK is not installed in a directory with 1 or more spaces in its name. 4. Verify the correct patch on SpectroSERVER machine. 5. Verify osagent is running on <SPECTRUM host>. OneClick Web server cannot connect to SpectroSERVER with Dual Network Interface Cards (NICs) OneClick Web servers may not be able to connect to SpectroSERVER systems with dual NICs. To correct this, create entries that point to the internal LAN IP of the dual NIC machine in the local / etc/hosts file of both the OneClick Web server and the SpectroSERVER, as described in the following procedures by platform: step 7 of Prepare the SpectroSERVER environment (Solaris) on page 13 step 7 of Prepare the SpectroSERVER environment (Linux) on page 21 step 6 of Prepare the SpectroSERVER environment (Windows) on page 29 OneClick client fails to launch (Windows) When installing the JRE, which includes Java WebStart (see Installing Java JRE, including Plug-in and Web Start on Windows on page 47), the default cache directory will be the installing user's home directory. If any part of the full path of the home directory, including the user's name, includes the exclamation character (! ), OneClick will fail to launch properly. In cases where the user's name includes the exclamation character, the following steps will work around this issue: Procedure 1. Start > Programs > Java Web Start 2. File > Preferences 3. Select the Advanced tab 4. Select and change the Applications Folder entry to a path which does not include the exclamation character. OneClick client login problems If a user is unable to login either at the OneClick main web page (at or or when launching the OneClick client, check for these common problems: 1. Does the username entered at login represent a valid SPECTRUM user? OneClick Installation Guide 55

56 Chapter 9: Troubleshooting 2. Does the user exist at the main location server SpectroSERVER which the OneClick Web Server points to? 3. Is that SpectroSERVER, or its secondary, running properly? 4. On that home SpectroSERVER, does the user have either the Administrator or Operator role? Use the SPECTRUM User Editor Set Roles dialog to verify. 5. Is the password correct? Use the SPECTRUM User Editor Set Web Password dialog to verify. 6. Are there no more OneClick licenses available? Note that an error dialog will appear if this is the case. OneClick client and web proxy issues Note: For information on configuring OneClick to work with supported Web proxies, see the OneClick Administration Guide (5166). When first launching the OneClick client, the Connect to Web Server on <host> login dialog box may continue to appear even after three attempts to log in. Attempting to cancel out of this dialog box may result in an HTTP Error Proxy authentication required. This occurs because a proxy is configured that requires authentication and OneClick is attempting to authenticate against that proxy. The solution is to turn off proxies in the Java Web Start Application Manager. To do this, follow this procedure for your operating system for both the OneClick client and Web server: Procedure 1. Disable the use of proxies in Java Web Start on the client machine: Windows: a. Start Java Web Start from the programs group. For example, Start > Programs > Java Web Start > Java Web Start b. Choose File > Preferences, then click the General tab. c. Select None and click OK. Solaris: a. Run <jre install dir>/javaws/javaws b. Select File > Preferences then click the General tab. c. Select None and click OK. 2. Disable the use of proxies for the OneClick Web server machine: Windows: a. Follow step 1 above with this substitution for step c: Select Use Browser and click OK. Change the Web browser proxy setting: b. In Internet Explorer, select Tools > Internet Options. c. In the Connections tab, click the LAN Settings button. 56 OneClick Installation Guide

57 OneClick server error message d. Select the Use a Proxy server checkbox and the Bypass proxy server for local addresses checkbox. If the preceding steps fail to resolve the issue (see Microsoft s Knowledge Base Article for more information), complete step e and step f: e. Click Advanced. f. Under Exceptions, add the IP address for the OneClick Web server machine and click OK. Solaris: a. Configure Java Web Start to not use proxies (see step 1). OneClick server error message If you receive the following error message: The resource at was not found. Could not complete the authorization. You may have another Web services application running on the same port Tomcat is attempting to use. To remedy this, stop (and disable if necessary) the other application and associated services and restart the Tomcat service. pcanywhere and OneClick OneClick server cannot be installed on a machine while that machine is running Symantec pcanywhere. Once the pcanywhere Host Service has been stopped, OneClick server can be installed. Then, the pcanywhere Host Service can be re-enabled. Java auto-updates and OneClick By default, the Java runtime environment automatically checks for Java updates and notifies you if an update is available for download. Before downloading and updating Java using this method, shut down the OneClick web server and any connected OneClick clients. Automatic Java updates can be disabled in the Java Control Panel. Correcting invalid license error post-installation It is possible to install OneClick server with an invalid key. This can be done by entering an invalid key and clicking Continue during installation. It is also possible to enter a valid key after installation. For example, you may have installed OneClick while waiting for your key from CA Support or you may otherwise need to enter a valid OneClick key after installation. When you attempt to launch a OneClick client when the OneClick key is invalid, you will see the following error: Activation key is invalid. Ensure the key entered is for authorization code <your authorization code> and that all entered values match what was given with the key. OneClick Installation Guide 57

58 Chapter 9: Troubleshooting To correct this: 1. Navigate to: <Install Area>/WebApps/tomcat/webapps/spectrum/opc-config.xml 2. Edit and save the opc-config.xml file to reflect your valid key: <activation-key><your valid key></activation-key> 3. If you are following this procedure on a working OneClick installation because you have received a new activation key that increases the number of concurrent OneClick users allowed, you must stop and restart the SPECTRUM Tomcat service for the changes to take effect. Preserving existing event format and probable cause files To make existing SPECTRUM EvFormat files available to OneClick: Procedure 1. Copy or install the SpectroGRAPH SG-Support/CsEvFormat and CsPCause directories to a directory accessible to the OneClick web server. 2. Edit the <Install Area>/WebApps/tomcat/webapps/spectrum/WEB-INF/web.xml file to point to that location by specifying the Probable Cause and Event Format Files parameters. With Web Operator: 1. At the Web Operator server, open the following directory: <$SPECROOT>/WebApps/SG-Support/CsResource/preferences 2. Using a text editor, open the ssroe_alrm.prf file. 3. Replace the current value of the probablecausedir preference with the path to the SPECTRUM probable cause files. By default, SPECTRUM probable cause files are located in: <$SPECROOT>/SG-Support/CsPCause Preference probablecausedir Example probablecausedir=<$specroot>/sg-support/cspcause 4. Using a text editor, open the ssroe_evnt.prf file. 5. Replace the current value of the eventformatdir preference with the path to the SPECTRUM Event Format files. By default, SPECTRUM Event Format files are located in: <$SPECROOT>/SG-Support/CsEvFormat Preference eventformatdir Example eventformatdir=<$specroot>/sg-support/csevformat 6. Save and close the ssroe_evnt.prf file. 58 OneClick Installation Guide

59 OneClick users cannot see all landscapes in distributed SpectroSERVER Environment OneClick users cannot see all landscapes in distributed SpectroSERVER Environment When implementing OneClick within a Distributed SpectroSERVER (DSS) environment, it is possible for OneClick users to only be able to see the main SpectroSERVER that they are configured to point to. Solution For each SpectroSERVER that you would like a given OneClick user to have access to, a duplicate user model must exist on each SpectroSERVER. In the cases of multiple OneClick implementations within a DSS environment, you might have users home models consolidated on different SpectroSERVERs depending on the OneClick Web server they are accessing and the configured main location server. Consider this example. You have three SpectroSERVERs in remote locations that participate in a DSS environment (Figure 9-1). You have installed a OneClick Web server at each of these locations, but would like users in all locations to be able to access all landscapes from within their localized OneClick install. Note: See the Ensuring SpectroSERVER to SpectroSERVER Communication in a DSS Environment section in the Distributed SpectroSERVER (2770) guide for more information. Figure 9-1: Distributed SpectroSERVER/OneClick Environment In this example, U.S. users would have to be consolidated on the U.S. SpectroSERVER with duplicate user models on the London and Singapore SpectroSERVERs. London users would be consolidated on the London SpectroSERVER with duplicate models on the US and Singapore SpectroSERVERs. Singapore users would have to be consolidated on the Singapore SpectroSERVER with duplicate models on the US and London SpectroSERVERs. Note: Consolidating user models is done automatically in SPECTRUM. OneClick Installation Guide 59