Web-Based Enterprise Services
Web-Based Enterprise Services
Web-Based Enterprise Services
To access the latest revision of this document containing updated information, please
visit the WEBES Web site:
http://www.hp.com/services/webes
Rev. 5/5/05
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide i
Copyright Statement
May 2005
Microsoft, Windows, and Windows NT are US registered trademarks of Microsoft Corporation. Intel is a
US registered trademark of Intel Corporation. UNIX is a registered trademark of The Open Group. Java is
a US trademark of Sun Microsystems, Inc.
Confidential computer software. Valid license from Hewlett-Packard required for possession, use or
copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under
vendor’s standard commercial license.
Hewlett-Packard shall not be liable for technical or editorial errors or omissions contained herein. The
information is provided “as is” without warranty of any kind and is subject to change without notice. The
warranties for Hewlett-Packard products are set forth in the express limited warranty statements
accompanying such products. Nothing herein should be construed as constituting an additional warranty.
This service tool software is the property of, and contains confidential technology of Hewlett-Packard
Company or its affiliates. Possession and use of this software is authorized only pursuant to the
Proprietary Service Tool Software License contained in the software or documentation accompanying
this software.
Hewlett-Packard service tool software, including associated documentation, is the property of and
contains confidential technology of Hewlett-Packard Company or its affiliates. Service customer is
hereby licensed to use the software only for activities directly relating to the delivery of, and only during
the term of, the applicable services delivered by Hewlett-Packard or its authorized service provider.
Customer may not modify or reverse engineer, remove or transfer the software or make the software or
any resultant diagnosis or system management data available to other parties without Hewlett-Packard’s
or its authorized service provider’s consent. Upon termination of the services, customer will, at
Hewlett-Packard’s or its service provider’s option, destroy or return the software and associated
documentation in its possession.
Examples used throughout this document are fictitious. Any resemblance to actual companies, persons, or
events is purely coincidental.
Rev. 5/5/05
ii Web-Based Enterprise Services Installation Guide
Change Summary
Change Summary
Revision Description
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide iii
Contents
Title Page i
Copyright Statement ii
List of Figures ix
List of Tables xi
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide v
Contents
Rev. 5/5/05
vi Web-Based Enterprise Services Installation Guide
Contents
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide vii
Contents
Glossary
Rev. 5/5/05
viii Web-Based Enterprise Services Installation Guide
List of Figures
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide ix
List of Tables
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide xi
1
General Information
This chapter provides an overview of the WEBES suite of tools and this document. Detailed
instructions for installing WEBES on each supported operating system are provided in
subsequent chapters.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 1–1
General Information
1.1 What is WEBES?
The WCCProxy contains functions that allow WEBES to interact properly with the operating
system and with HP Instant Support Enterprise Edition (ISEE). The ISEE Client kit also
includes a copy of the WCCProxy. Here are a few additional guidelines regarding the
WCCProxy:
• WEBES and the ISEE Client need the WCCProxy, so avoid uninstalling just the
WCCProxy if you have WEBES or the ISEE Client installed.
• If you install either product, and the other is not installed, it will install its WCCProxy.
• If you install either product, and the other is already installed, it will leave the WCCProxy
alone unless its WCCProxy is newer, in which case it will replace the WCCProxy (which
will still work with the other product).
• Uninstalling WEBES or ISEE will leave the WCCProxy installed if the other product is
still installed.
• Uninstalling WEBES or ISEE will uninstall the WCCProxy if the other product is not
installed.
Rev. 5/5/05
1–2 Web-Based Enterprise Services Installation Guide
General Information
1.2 New in this Release
Refer to the WEBES Release Notes for any current issues regarding the WCCProxy, how it is
shared by WEBES and ISEE, and how WEBES and ISEE should be installed or removed for
proper functioning of WCCProxy.
ISEE for HP-UX PA-RISC and WCCProxy has not been included in these ISEE kits yet
Itanium, and for Windows Itanium
ISEE for OpenVMS Itanium ISEE for this platform does not exist yet
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 1–3
General Information
1.3 Supported Hardware
• 32-bit Intel® based systems manufactured by HP, such as the ProLiant or the HP
OpenView Storage Management Appliance
Note that WEBES usually will operate on any industry standard, 32-bit Intel-based
system. However, because HP does not qualify WEBES on third-party products,
functionality on such systems is provided on an as-is basis only.
• HP AlphaServer systems
• HP 9000 series systems
See the specific operating system chapters for more information about platforms.
Note
You can install and run WEBES on HP-UX and Linux, but currently it does not
analyze native error logs for events occurring on those platforms.
You can, however, copy an error log from another system (Windows, Tru64 UNIX, or
OpenVMS) to an HP-UX or Linux system for manual analysis there.
Rev. 5/5/05
1–4 Web-Based Enterprise Services Installation Guide
General Information
1.5 Installation Kits
http://www.hp.com/services/webes
http://searay-cxo.cxo.cpqcorp.net/service_tools/webes/
1.6 Upgrades
Upgrades can incorporate anything from a major WEBES release down to a minor kit with
only rule updates or small functional improvements. Upgrades install without first uninstalling
WEBES yourself. Be sure to check the websites for the latest upgrades to your WEBES
version.
http://www.hp.com/services/webes
http://searay-cxo.cxo.cpqcorp.net/service_tools/webes/
• General Information
• Installing on Windows
• Installing on Tru64 UNIX
• Installing on HP-UX
• Installing on Linux
• Installing on OpenVMS
• Glossary
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 1–5
1.8 Further Information
For additional information following the formal release of WEBES, see the following:
http://www.hp.com/services/webes
http://searay-cxo.cxo.cpqcorp.net/service_tools/webes/
This chapter describes how to install the WEBES suite of tools on Windows 2000, Windows
2003 and XP. Note that this also includes the HP OpenView Storage Management Appliance.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 2–1
Installing on Windows
2.1 Pre-Installation
2.1 Pre-Installation
Follow these pre-installation guidelines. Depending on which WEBES components you wish
to install, ensure that your system meets the requirements described in the appropriate
sections:
Non-HP Systems: WEBES is a proprietary service tool and is not a fully qualified
off-the-shelf product such as Norton SystemWorks. As such, only platforms
manufactured by HP, such as the ProLiant, are officially supported.
Engineering normally expects that WEBES will operate correctly on any industry
standard, 32-bit Intel-based system. However, because HP does not qualify WEBES on
third-party products, functionality on such systems is provided on an as-is basis only.
Rev. 5/5/05
2–2 Web-Based Enterprise Services Installation Guide
Installing on Windows
2.1 Pre-Installation
A total of 289 MB are used after installation completes, assuming all components are
installed.
• Local kit copy required—Copy the WEBES kit to a local drive. The installation results in
an error when mapping a drive letter to another system where the kit resides, for example:
Internal Error 2755. 3,
F:\path to\WEBESV431BL322KIT2_Jan-28-2004_Windows.MSI
During standard operation, SEA uses far less memory. For example, when the Director is
idle, usage stays generally around 13 MB for systems with all the WEBES tools installed.
The Director only approaches the maximum value when a high volume of events arrive or
an extremely large log file is processed. Even then, the memory usage may remain
significantly below the maximum value. The virtual memory requirement is intended to
set a threshold for the absolute maximum amount of memory that will ever be needed. If
the threshold is exceeded, the Director terminates with out-of-memory error.
Virtual memory for a process is stored in RAM and the pagefile on your disk. The space
allocated must be sufficient to run WEBES and all other applications that you want to run
simultaneously.
If the virtual memory requirement given here is too large or too small for your
environment, you are free to make adjustments. You may want to experiment with
various settings to find the optimal value. Refer to the SEA User Guide for more
information on adjusting the memory settings.
You can check the Windows Installer version by entering msiexec at the command
prompt. (Ignore the message about incorrect command line parameters.) To upgrade,
Windows Installer 2.0 can be downloaded free of charge from the following URL:
http://www.microsoft.com/downloads/release.asp?releaseid=32832
Note that Windows Installer 2.0 is bundled with Windows XP and Windows 2000 SP3.
• Automated Notification—If desired, you can choose a method for sending automatic
problem reports to your service provider:
• SICL—DSNLink V2.2 and a fixed IP address are required for sending System
Initiated Call Logging (SICL) automatic problem reports. You must install
DSNLink before installing WEBES.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 2–3
Installing on Windows
2.1 Pre-Installation
• PRS—For Proactive Remote Service (PRS) automatic reports, you do not need
DSNLink or WorldWire installed on the system that is running WEBES. You
only need to identify the host name and port number of the customer service
gateway (also called the QSAP) during WEBES installation.
• ISEE—For Instant Support Enterprise Edition (ISEE) automatic reports, you
must install ISEE Client A.03.50 or later on the same machine as WEBES.
• You can upgrade to this version without first uninstalling a previous version yourself (any
previous version back to and including version 4.3). This kit recognizes an existing
installation, saves configuration and state data, uninstalls the existing kit, installs this
version, and then restores the configuration and state data.
To install this version on a system that was running a version older than 4.3, first uninstall
the older version using the instructions in the WEBES Installation Guide for that version.
• Supported—fully tested
• As-is—not officially tested but may work reasonably well
• Unsupported—known not to work
Category Browser
Web browsers can use different Java runtime environments, but the SEA web interface
requires certain versions of Java for each web browser.
Rev. 5/5/05
2–4 Web-Based Enterprise Services Installation Guide
Installing on Windows
2.1 Pre-Installation
http://java.sun.com/getjava
Install any desired web browsers before installing the Sun JRE. The JRE installation then
finds and updates installed web browsers so that they use the Sun JRE.
• Error log—After installation, SEA begins analyzing all events currently stored in the
error log, which can result in high CPU usage over an extended period. To control this
operation, you have two options:
• Archive and clean the error log as described in Section 2.1.6 before installing.
This reduces the size of the log and, in turn, the cost of the initial scan.
• Choose to delay the initial scan when prompted during installation. Be aware that
SEA automatic analysis does not run until after (and starting with) the initial
scan, however.
• On Internet Explorer, make sure that HTTP 1.1 settings are enabled. Choose
Tools | Internet Options | Advanced from the pull-down menus. Check both of the
following under HTTP 1.1 Settings:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 2–5
Installing on Windows
2.1 Pre-Installation
• The CADC installation requires a temporary space of up to 530 MB of hard disk space.
This large size is due to the expansion of the symbols required to do crash dump analysis.
The following breakdown shows how the disk space is used:
• RCM component of WEBES—You must uninstall all of the WEBES version that
contained RCM before installing this version, and doing so removes the RCM tool.
You are free to install a standalone RCM kit at any time after removing the old version of
WEBES. This version of WEBES does not contain RCM, but the latest RCM kits and
documentation may be downloaded from the following location:
http://www.software.hp.com/portal/swdepot/displayProductInfo.do?pr
oductNumber=RCMBASE01
2.1.5 Permissions
In order to install, remove, or update WEBES your user ID must be one of the following:
To add Domain Administrators to the local Administrator Group, use the procedure for your
operating system.
Rev. 5/5/05
2–6 Web-Based Enterprise Services Installation Guide
Installing on Windows
2.1 Pre-Installation
Windows 2000: From a login account with administrator privileges, locate the user
management function under My Computer | Manage | Computer Management
(Local) | System Tools | Local Users and Groups | Groups. Double click the
Administrators Group, and press the Add button. Highlight Domain Admins and press
Add.
Windows XP: From a login account with administrator privileges, locate the user
management function under Start | Control Panel | User Accounts. Choose the Advanced
tab, and press the Advanced button. Choose Local Users and Groups | Groups. Double
click the Administrators Group, and press the Add button. Type “Domain Admins” and
press OK (see Figure 2–1).
Follow these steps to archive and clean the error log. If WEBES is installed and running when
you clean the log, stop the Director process before proceeding (see the SEA User Guide for
information on stopping the Director). Also, do not stop and restart any Windows system
processes.
2. For events analyzed by SEA, go to the Application Log. SEA does not process events
from any other Windows event log.
Windows 2000—Click on Application Log in the left pane of the event viewer window.
Windows XP—Click on Application Log in the left pane of the event viewer window.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 2–7
Installing on Windows
2.1 Pre-Installation
3. Clear all events. Note that you are given the option to save the existing events to another
file before clearing. (Saved logs can be analyzed at a later time.)
If WEBES was installed when you cleaned the log and you stopped the Director, you can now
restart it using the procedure described in the SEA User Guide.
• Windows 2000 Server and Advanced Server, when Terminal Services are enabled
• Windows XP when Remote Desktop connections are enabled
From Console—Terminal Server system installations should be performed from the Terminal
Server console by an administrator (either the Administrator account or any account in the
Administrators group).
For the best results, make sure that no clients are logged on to the server during WEBES
installation. You can send clients a message about the time and duration of the installation and
then disable all connections before starting.
Otherwise, the process for installing is the same as any other Windows WEBES installation.
Open Start | Settings | Control Panel | System. Click the Advanced tab. In Environment
Variables, open the PATH entry (under System Variables) for editing.
Do not make any changes; just click OK several times to get out of the System utility.
The PATH is now set for any command prompt windows opened after performing this
workaround.
Rev. 5/5/05
2–8 Web-Based Enterprise Services Installation Guide
Installing on Windows
2.2 Installing WEBES
You can connect to the Windows 2000 desktop on the SMA using two methods:
Every SMA is preconfigured to accept Terminal Services client connections because the
Terminal Services server is preinstalled. Users who do not already have a copy of the Terminal
Services client can download it from the following URL:
http://www.microsoft.com/downloads/details.aspx?FamilyID=33AD53D8-9ABC-4
E15-A78F-EB2AABAD74B5&displaylang=en
Desktop connections also require the account username and password for the SMA. The
factory-set defaults are username administrator and password admin######, where ######
is the last six characters of the serial number in reverse order. The password is case sensitive,
and you are advised to change it (if you have not already done so) for better system security.
After all Pre-Installation requirements are met, follow these steps to install WEBES.
1. If you have not already done so, log on using an account with administrator privileges.
2. Locate and run the WEBES kit executable file, which ends in the .MSI extension.
3. Follow the instructions on screen.
Upgrading—If WEBES 4.3.3 or higher is present, the kit informs you that the other
version was detected and prompts you about upgrading. See Section 2.4 Upgrading
WEBES for details.
Tool Selection—The install kit lets you select the WEBES tools that you want to install
(see Figure 2–2).
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 2–9
Installing on Windows
2.2 Installing WEBES
Rev. 5/5/05
2–10 Web-Based Enterprise Services Installation Guide
Installing on Windows
2.2 Installing WEBES
System name (or IP mgdsys.abc.xyzcompany.com You also must note whether the
address) address is fixed or assigned by
a DHCP server.
Special instructions “Check with customer prior to Add details that will be useful to
dispatching services. Prior your service provider.
notification to security is
necessary for service access to
site.”
Delaying the Initial SEA Scan—Immediately after installation, SEA normally scans all
events currently stored in the error log. For a very full log, this initial scan can result in
high CPU usage over an extended period. You can choose to delay the initial scan when
prompted, but SEA automatic analysis does not run until after (and starting with) the
initial scan. Note that events that happen during the delay are saved in the log for analysis
at initial scan time.
Managed Entity Web Interface—The Managed Entity Web Interface will only appear if
one or more EVAs are detected, and only if those EVAs have already been configured
using the CommandView EVA software. (at least their "EVA Name" must be defined, for
WEBES to recognize them.)
Refer to the SEA User's Guide, chapter 6 "Web Interface", for more information on the
SEA Managed Entity Web interface.
The following screens (see Figure 2–3, Figure 2–4 and Figure 2–5) show the Managed
Entity configuration.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 2–11
Installing on Windows
2.2 Installing WEBES
Rev. 5/5/05
2–12 Web-Based Enterprise Services Installation Guide
Installing on Windows
2.3 Post-Installation
2.3 Post-Installation
Be aware of the following post-installation procedures.
1. If you have not already done so, log on using an account with administrator privileges.
2. Locate and run the WEBES kit file, which ends in the .MSI extension.
3. When prompted, choose the Modify option.
4. Change the selection button next to the tools that you want to add as shown in Figure 2–6.
5. Follow the prompts to proceed with installation. See Table 2–2 if you need help with
installation questions.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 2–13
Installing on Windows
2.3 Post-Installation
HP WEBES 4.4
WCCProxy
WCCProxy is included with and required by WEBES. Never uninstall WCCProxy when
the HP WEBES entry is present.
3. To determine which WEBES tools are installed, highlight the HP WEBES entry.
4. Press the Change/Remove button to run the setup wizard.
5. When prompted, choose the Modify option.
6. Look at the Custom Setup window to see which tools are installed.
7. Click the Cancel button to close the wizard without making any changes.
The default {WEBES install directory} is C:\Program Files\hp\svctools. If this is not where
WEBES was installed, look for the path and file common\webes\release.txt on your system.
The svctools directory containing this path is the {WEBES install directory}.
Rev. 5/5/05
2–14 Web-Based Enterprise Services Installation Guide
Installing on Windows
2.3 Post-Installation
The files list the component versions for the release. Generally, they match the overall
WEBES version number. The files in Table 2–3 also may reveal a “build” number, but those
are not necessarily intended to match across components.
svctools\common\ca\userdata
svctools\common\ccat\userdata
svctools\common\desta\userdata
svctools\common\webes\userdata
svctools\specific\ca\userdata
svctools\specific\ccat\userdata
svctools\specific\desta\userdata
svctools\specific\webes\userdata
When using WEBES, store your own files (such as binary event logs or CCAT crash dump
files) under these subdirectories.
• Storing files under the userdata subdirectories makes them easily accessible in the
WEBES user interfaces. For example, SEA automatically lists any binary event logs from
the ca\userdata subdirectories under Other Logs.
• In WEBES 4.1 or later, files stored under the userdata subdirectories are preserved and
restored during WEBES uninstallations and reinstallations. The files will be restored to
right places the next time you install WEBES, even if you install it to a different location
than before.
SEA version 4.2 or higher can lead to duplicate PRS or OSEM problem reports from the
Enterprise Virtual Array (EVA).
The traditional EVA reporting method uses SNMP traps to the PRS customer service gateway
or OSEM host. Starting with WEBES 4.2, SEA detects the same events by reading the
application event log on the Storage Management Appliance. Because SEA also notifies the
PRS customer service gateway or OSEM host, problem report recipients see duplicate reports
for each event: those originating from the SNMP traps, and those from the event log.
To prevent the duplicate reports, disable the traditional SNMP trap notifications as follows:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 2–15
Installing on Windows
2.3 Post-Installation
The batch file copies a DisabledFilters.txt file to the root of the CRSM directory, which
disables the SNMP trap notifications.
1. Install and Configure the EVA using the CommandView EVA software. Note: The EVA
Name must be assigned so that WEBES can recognize it.
2. Stop and re-Start the Director on each node from which CommandView EVA can
manage the new EVA, either with the Start menu:
• Start...Programs...Hewlett-Packard Service Tools...Web-Based Enterprise
Services...Stop Director
• Start...Programs...Hewlett-Packard Service Tools...Web-Based Enterprise
Services...Start Director
or
3. Enter the new EVA's configuration information into the SEA Managed Entity Web
interface:
• Browse to the SEA Web Interface page http://<nodename>:7902
You will be presented with a new screen that allows you to enter the Managed
Entity information.
Refer to Section 2.2 ‘Installing WEBES’ for more information on Managed Entity Web
Interface.
Refer to the SEA User's Guide, chapter 6 "Web Interface", for more information on the SEA
Managed Entity Web interface.
Managed Entity information must be entered for each EVA managed by CommandView EVA
operating on the same node as WEBES-SEA. This new feature provides entitlement
information that is passed with the notifications sent to ISEE.
Failure to enter this information will cause the notifications generated for the new EVA to be
ignored by the ISEE backend.
Rev. 5/5/05
2–16 Web-Based Enterprise Services Installation Guide
Installing on Windows
2.4 Upgrading WEBES
Email notifications for the events will be sent. All nodes running CommandView EVA
configured to manage the new EVA must have WEBES-SEA Managed Entity information
updated.
If you configure the new EVA using CommandView, but do not configure the same EVA in the
SEA Managed Entity Web interface, you will receive email from SEA within 12 hours after
the CommandView configuration is complete, asking you to configure the new EVA for SEA.
SEA sends an email using the settings entered for email SMTP server and email addresses
during the SEA part of the WEBES installation (see SEA User’s Guide chapter 10,
“Automatic Notifications” for details on where this information is stored and how to change it
after WEBES installation). The email has a link to an URL which takes you to the Web
interface where you can enter the EVA’s information.
Note
This section applies when upgrading to this version of WEBES with 4.3.3 or higher already
installed on the system. The procedure does not apply to versions older than 4.3.3 already
installed.
If you have already installed WEBES version 4.3.2 or earlier, you need to uninstall the
existing version and install the latest version.
If WEBES is already uninstalled or was never installed at all, see Section 2.2, Installing
WEBES.
Upgrading lets you preserve your configuration and state data. Be aware that upgrading
uninstalls the older version of WEBES and installs the newer version—the upgrade does not
simply patch or replace certain files, as was the case with WEBES Service Paks.
Whenever 4.3.3 or higher is already installed, the WEBES kit informs you that the older
version was detected and prompts you about upgrading.
1. Saves configuration and state data to x:\Webes41Backup, where x is the drive where
Windows (not necessarily WEBES) was installed.
2. Uninstalls the existing installation.
3. Installs this version with the same components (SEA or CCAT) that were present before.
4. Restores the saved data.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 2–17
5. Deletes the Webes41Backup directory and all of its contents.
If you answer No, the kit exits. If desired, you can uninstall the existing WEBES copy
yourself, but then not all data will be migrated upon installing the newer version as described
in Section 2.2, Installing WEBES.
1. If you have not already done so, log on using an account with administrator privileges.
2. Completely close the tool if it is running.
3. In the Windows applet for adding and removing programs, highlight HP WEBES.
1. If you have not already done so, log on using an account with administrator privileges.
2. Completely close all tools that are running.
3. In the Windows applet for adding and removing programs, highlight HP WEBES.
• Windows 2000 Server and Advanced Server, when Terminal Services are enabled
• Windows XP when Remote Desktop connections are enabled
For the best results, make sure that no clients are logged on to the server during WEBES
uninstallation. You can send clients a message about the time and duration of the uninstallation
and then disable all connections before starting.
Otherwise, the process for uninstalling is the same as any other Windows WEBES
uninstallation.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 2–19
Installing on Windows
2.5 Uninstalling WEBES
designed to be configured and allowed to run with minimal direct user interaction—without a
physical monitor, keyboard, or mouse attached.
You can connect to the Windows 2000 desktop on the SMA using two methods:
Every SMA is preconfigured to accept Terminal Services client connections because the
Terminal Services server is preinstalled. Users who do not already have a copy of the Terminal
Services client can download it from the following URL:
http://www.microsoft.com/windows2000/downloads/recommended/TSAC/
tsmsi.asp?Lang
Desktop connections also require the account username and password for the SMA. The
factory-set defaults are username administrator and password admin######, where ######
is the last six characters of the serial number in reverse order. The password is case sensitive,
and you are advised to change it (if you have not already done so) for better system security.
Rev. 5/5/05
2–20 Web-Based Enterprise Services Installation Guide
3
Installing on Tru64 UNIX
This chapter describes how to install the WEBES tools on an HP Tru64 UNIX system. The
information in this chapter is organized as follows:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 3–1
Installing on Tru64 UNIX
3.1 Pre-Installation
3.1 Pre-Installation
Follow these pre-installation guidelines. Depending on which WEBES components you wish
to install, ensure that your system meets the requirements described in the appropriate
sections:
Be aware that HP Sustaining Engineering maintains a schedule of support for the Tru64
UNIX operating system. HP does not commit to supporting WEBES when installed on an
operating system version that has exceeded its end-of-support date. See the following
URL:
http://www.hp.com/hps/os/os_pvs_amap.htm
During standard operation, SEA uses far less memory. For example, when the Director is
idle, usage stays generally around 24MB for systems with all the WEBES tools installed.
The Director only approaches the maximum value when a high volume of events arrive or
an extremely large log file is processed. Even then, the memory usage may remain
significantly below the maximum value. The virtual memory requirement is intended to
set a threshold for the absolute maximum amount of memory that will ever be needed. If
the threshold is exceeded, the Director terminates with out-of-memory error.
Rev. 5/5/05
3–2 Web-Based Enterprise Services Installation Guide
Installing on Tru64 UNIX
3.1 Pre-Installation
Virtual memory for a process is stored in RAM and the swap partitions on your disk. The
space allocated must be sufficient to run WEBES and all other applications that you want
to run simultaneously.
If the virtual memory requirement given here is too large or too small for your
environment, you are free to make adjustments. You may want to experiment with
various settings to find the optimal value. Refer to the SEA User Guide for more
information on adjusting the memory settings.
• All DSxx and ES40 systems must have firmware V5.7–4 or higher.
• All other systems (currently ES45, GSxx, and TS202c) ship with a firmware
version that is already compatible with WEBES processing.
In general, users should take advantage of the latest improvements by obtaining the most
recent firmware version available for their platform.
• Automated Notification—If desired, you can choose a method for sending automatic
problem reports to your service provider:
• SICL—DSNLink V2.3E or V3.0 and a fixed IP address are required for sending
System Initiated Call Logging (SICL) automatic problem reports. You must
install DSNLink before installing WEBES.
• PRS—For Proactive Remote Service (PRS) automatic reports, you do not need
DSNLink or WorldWire installed on the system that is running WEBES. You
only need to identify the host name and port number of the customer service
gateway (also called the QSAP) during WEBES installation.
• ISEE—For Instant Support Enterprise Edition (ISEE) automatic reports, you
must install ISEE Client A.03.50 or later on the same machine as WEBES.
• You can upgrade to this version without first uninstalling a previous version yourself (any
previous version back to and including version 4.3). This kit recognizes an existing
installation, saves configuration and state data, uninstalls the existing kit, installs this
version, and then restores the configuration and state data.
To install this version on a system that was running a version older than 4.3, first uninstall
the older version using the instructions in the WEBES Installation Guide for that version.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 3–3
Installing on Tru64 UNIX
3.1 Pre-Installation
• If you want SEA to automatically analyze a system’s native error log, you must install on
a supported HP hardware platform or a machine that includes supported HP I/O devices.
See the WEBES Release Notes for the list of supported products.
• Minimum 32 MB of space in the file system containing the directory to which you install
WEBES (/usr/opt/hp/svctools).
• Web browser—Table 3–1 describes the browser prerequisites for SEA according to the
following categories:
• Supported—fully tested
• As-is—not officially tested but may work reasonably well
• Unsupported—known not to work
Category Browser
Web browsers for Tru64 UNIX can be downloaded from the following web site:
http://h30097.www3.hp.com/internet/download.htm
Not all browsers on the site are supported, so check Table 3–1 first.
Web browsers can use different Java runtime environments, but the SEA web interface
requires certain versions of Java for each web browser.
http://java.sun.com/getjava
Rev. 5/5/05
3–4 Web-Based Enterprise Services Installation Guide
Installing on Tru64 UNIX
3.1 Pre-Installation
Install any desired web browsers before installing the Sun JRE. The JRE installation then
finds and updates installed web browsers so that they use the Sun JRE.
• Error log—After installation, SEA begins analyzing all events currently stored in the
error log, which can result in high CPU usage over an extended period. To control this
operation, you have two options:
• Archive and clean the error log as described in Section 3.1.6 before installing.
This reduces the size of the log and, in turn, the cost of the initial scan.
• Choose to delay the initial scan when prompted during installation. Be aware that
SEA automatic analysis does not run until after (and starting with) the initial
scan, however.
• System serial number—On GS80, GS160, and GS320 systems, verify the serial number
according to Section 3.1.7 before installing.
• RCM component of WEBES—You must uninstall all of the WEBES version that
contained RCM before installing this version, and doing so removes the RCM tool.
You are free to install a standalone RCM kit at any time after removing the old version of
WEBES. This version of WEBES does not contain RCM, but the latest RCM kits and
documentation may be downloaded from the following location:
http://www.software.hp.com/portal/swdepot/displayProductInfo.do?pr
oductNumber=RCMBASE01
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 3–5
Installing on Tru64 UNIX
3.1 Pre-Installation
3.1.5 Permissions
To install, upgrade, or uninstall WEBES, you must be logged on as the root user. The
/usr/opt/hp/svctools directory is owned by root, and has rwx (read, write, and execute)
permissions for root (owner), and no permissions for any other user (group or world).
Follow these steps to archive and clean the error log, depending on your version of Tru64
UNIX. If WEBES is installed and running when you decide to clean the log, stop the Director
process before beginning this procedure (see the SEA User Guide for information on stopping
the Director). Once you have archived and cleared the error log, restart the Director using the
procedure in the SEA User Guide.
4.0F
2. If desired, move the original error log to any appropriate name, for example:
# mv /var/adm/binary.errlog /var/adm/binary.errlog.2002_06_11
4. Restart the system. During restart, the system creates a new binary.errlog file containing a
new configuration event. The system also restarts the binlogd process.
4.0G
2. If desired, move the original error log to any appropriate name, for example:
# mv /var/adm/binary.errlog /var/adm/binary.errlog.2002_06_11
Rev. 5/5/05
3–6 Web-Based Enterprise Services Installation Guide
Installing on Tru64 UNIX
3.1 Pre-Installation
5.1A or Higher
A new feature can send a signal to binlogd to save the current log and create a new one without
stopping the process. Follow the steps in Section 3.1.6.1 Verify the binary.errlog CDSL and
then Section 3.1.6.2 Clear the Log with binlogd Running.
If the CDSL is ever deleted, binlogd recreates it as a regular, cluster-common file, which does
not work correctly. To check your file, issue the command:
# ls -l /var/adm/binary.errlog
1. Stop the binlogd process on all cluster nodes by issuing the following command on each
node:
# /sbin/init.d/binlog stop
2. Saved logs can be analyzed at a later time. If desired, move the original error log to any
appropriate name, for example:
# cd /var/adm
# mv binary.errlog binary.errlog.2002_06_11
3. Issue similar move commands for any node-specific error logs you wish to save, for
example:
# mv /var/cluster/members/{memb}/adm/binary.errlog
/var/cluster/members/{memb}/adm/binary.errlog.2002_06_11
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 3–7
Installing on Tru64 UNIX
3.1 Pre-Installation
# mv /var/cluster/members/{memb}/adm/binlog.saved/binary.errlog.saved
/var/cluster/members/{memb}/adm/binlog.saved/
binary.errlog.saved.2002_06_11
4. Remove existing error logs, ignoring any “No such file or directory” errors:
# rm /var/adm/binary.errlog
# rm /var/cluster/members/{memb}/adm/binary.errlog
# rm /var/cluster/members/{memb}/adm/binlog.saved/binary.errlog.saved
6. Restart the binlogd process on all cluster nodes by issuing the following command on
each node:
# /sbin/init.d/binlog start
For version 5.1A or higher, follow these steps on each cluster node that you want to clear:
The previous command does not kill the binlogd process. Instead, it sends a signal to
binlogd that causes it to copy /var/adm/binary.errlog to
/var/cluster/members/member/adm/binlog.saved. Then, the original
/var/adm/binary.errlog file gets recreated with only a configuration event. Note that
/var/adm/binary.errlog is a CDSL that points to
/var/cluster/members/{memb}/adm/binary.errlog .
For further details, including how to automate this kind of error log management, see the
section on “Managing the Binary Error Log File” in the binlogd man page.
Rev. 5/5/05
3–8 Web-Based Enterprise Services Installation Guide
Installing on Tru64 UNIX
3.1 Pre-Installation
Certain GS80, GS160, and GS320 systems did not have their system serial number set
correctly at the factory, and SEA rules only function when the serial number is set correctly.
Affected serial numbers will begin with the letter “G.”
At the SRM console firmware prompt (the prompt when you first power the system on), check
the serial number with the following command:
The serial number shown should match the actual serial number on the model/serial number
tag located in the power cabinet. If necessary, change the serial number with the following
command:
Enter the six-character serial number provided on the tag in the power cabinet.
Multiple AlphaServers
This issue also can arise when multiple AlphaServers are ordered, because the factory may
assign an identical serial number to each system. In this scenario, SEA rules do not work
correctly because they require that each AlphaServer have a unique number.
If this is the case, uniquely identify each AlphaServer by appending –1, –2, –3, and so on, to
the serial numbers when you use the set sys_serial_num command.
Partitions
Note that multiple partitions on the same AlphaServer always have the same serial number
because they reside on the same machine. There are no SEA conflicts in this case, so do not
attempt to assign unique serial numbers to different partitions on the same machine.
# gunzip WEBES{version}.tar.gz
Then, untar the file. If there is already a “kit” subdirectory when you perform this command,
be sure there are no previous WEBES kit files in this subdirectory before performing the
command.
This command creates a kit directory (if it does not already exist), and extracts the WEBES
installation files. Messages similar to the following appear:
blocksize = 256
x ./kit
x ./kit/instctrl
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 3–9
Installing on Tru64 UNIX
3.2 Installing WEBES
If you have already installed WEBES version 4.3.2 or earlier, you need to uninstall the
existing version and install the latest version.
After all Pre-Installation requirements are met, proceed with the two-step process to install
WEBES.
Note
If installing in a TruCluster environment, make sure all nodes are up and running
before proceeding.
1. First, run the Component Installation as described in Section 3.2.1. This step installs the
files needed for the common components and any selected tools.
2. Then, run the Interactive Configuration Utility as described in Section 3.2.2. Note that
you can return to the utility at any future time, should you wish to modify your WEBES
installation.
# setld -l kit
Do not run setld -D to direct the WEBES installation to a non-default directory. The default
directory is required for proper WEBES operation.
The kit states that you are installing the mandatory subsets, which are the same as the common
components.
Rev. 5/5/05
3–10 Web-Based Enterprise Services Installation Guide
Installing on Tru64 UNIX
3.2 Installing WEBES
Then, you can select which tools to install by typing the option numbers separated by spaces
(or by choosing the “ALL” option). You also can abort the installation at this point.
During installation, the system displays informational messages, but you do not need to
answer configuration questions until you run the Interactive Configuration Utility as described
in Section 3.2.2.
Cluster Installations
Running the setld install on a cluster results in one set of informational messages for each
cluster member. In other words, installing on a cluster places the product on all of the cluster
nodes. If WEBES is not desired on certain nodes (for example, nodes of system types not
supported by WEBES) users can disable WEBES on those nodes. The Start at Boot Time
option described in Table 3–5 disables WEBES on a per-node basis.
# /usr/sbin/webes_install_update
If you need help with a specific field while running the interactive configuration utility, type ?
and press the Enter key.
You must define your system the first time that you run the interactive configuration utility.
The values that you enter persist until you change them or choose to remove the profile when
uninstalling WEBES.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 3–11
Installing on Tru64 UNIX
3.2 Installing WEBES
Company address 123 Main Street You are allowed three lines
Metropolis, VA 22222 when entering the company
USA address.
Automated Notification—The installation includes a small menu for choosing the automated
notification method to your service provider. (This is separate from any email-based
notification that you may set up).
Rev. 5/5/05
3–12 Web-Based Enterprise Services Installation Guide
Installing on Tru64 UNIX
3.2 Installing WEBES
• The CSG option applies to systems that participate in Proactive Remote Service (PRS).
• SICL applies to DSNLink users, and only appears when DSNLink is installed.
• If you do not need to send notifications, choose NONE.
If you have the ISEE Client installed, the menu does not appear. Instead, you see one of the
following:
• With DSNLink already installed—You are asked if you want DSNLink notifications in
addition to ISEE notifications.
• Without DSNLink—WEBES will use the ISEE Client for notifications, and there are no
prompts to answer.
Notification Profile—By default, the installation can automatically create your automated
notification profile based on customer and system entries from Tables 3–2 and 3–3. The
profile gets stored in a text file that you can modify with an editor, if desired:
/usr/opt/hp/svctools/specific/desta/config/profile.txt
Start at Boot Time—You can specify the nodes where you want to start the WEBES Director
by default at system boot time. Note that this option also is available from the main interactive
menu.
After initial configuration, and any time that you rerun the utility thereafter, you are presented
with a menu similar to the following:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 3–13
Installing on Tru64 UNIX
3.2 Installing WEBES
Enter the number for your choice (see Table 3–5). The menu reappears after completing the
selected operation. You can continue making selections or quit.
Selections requiring that the WEBES Director process first be stopped (for example, for tool
installation) automatically stop the Director. You can restart it manually upon completing your
selection, or you are prompted to restart it when you quit the interactive utility.
Selection Description
Install System Event Analyzer (SEA) Installs the SEA tool. If SEA was already
installed, this option would allow you to uninstall
it.
See the SEA Installation Notes for more
information.
Install Computer Crash Analysis Tool (CCAT) Installs the CCAT tool. If CCAT was already
installed, this option would allow you to uninstall
it.
See the CCAT Installation Notes for more
information.
Rev. 5/5/05
3–14 Web-Based Enterprise Services Installation Guide
Installing on Tru64 UNIX
3.3 SEA Installation Notes
Selection Description
SEA also asks you to enter the email address where you want to receive copies of SEA
notifications.
3.5 Post-Installation
Be aware of the following post-installation procedures.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 3–15
Installing on Tru64 UNIX
3.5 Post-Installation
# /usr/sbin/webes_install_update
You are prompted for node-specific information for the new member.
# rehash
WEBES—The WEBES base kit is installed if you see the word “installed” in the output of the
following command. For example:
SEA—SEA is installed if you see the word “installed” in the output of the following
command. For example:
CCAT—CCAT is installed if you see the word “installed” in the output of the following
command. For example:
WCCProxy—WCCProxy is installed if you see the word “installed” in the output of the
following command. For example:
Rev. 5/5/05
3–16 Web-Based Enterprise Services Installation Guide
Installing on Tru64 UNIX
3.5 Post-Installation
WCCProxy /usr/opt/hp/svctools/common/wccproxy/release.txt
SEA /usr/opt/hp/svctools/common/ca/release.txt
CCAT /usr/opt/hp/svctools/common/ccat/release.txt
The files list the component versions for the release. Generally, they match the overall
WEBES version number. The files in Table 3–6 also may reveal a “build” number, but those
are not necessarily intended to match across components.
/usr/opt/hp/svctools/common/ca/userdata
/usr/opt/hp/svctools/common/ccat/userdata
/usr/opt/hp/svctools/common/desta/userdata
/usr/opt/hp/svctools/common/webes/userdata
/usr/opt/hp/svctools/specific/ca/userdata
/usr/opt/hp/svctools/specific/ccat/userdata
/usr/opt/hp/svctools/specific/desta/userdata
/usr/opt/hp/svctools/specific/webes/userdata
When using WEBES, store your own files (such as binary event logs or CCAT crash dump
files) under these subdirectories.
• Storing files under the userdata subdirectories makes them easily accessible in the
WEBES user interfaces. For example, SEA automatically lists any binary event logs from
the ca/userdata subdirectories under Other Logs.
• In WEBES 4.1 or later, files stored under the userdata subdirectories are preserved and
restored during WEBES uninstallations and reinstallations.
On clusters, place files that you want to be accessible by all nodes into the “common” paths,
and files that are only for one node under the “specific” paths.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 3–17
Installing on Tru64 UNIX
3.6 Upgrading WEBES
This occurs because the event and expiration times are based on the timestamp information in
the event log, while the report time is based on the timezone environment variable on the local
host.
To address such discrepancies, correctly set the timezone environment variable as shown in
the following example. You may want to make this verification step part of your regular
post-installation tasks.
# setenv TZ "America/New_York"
If necessary, issue the following command to see a list of acceptable timezone environment
variable values:
# ls /etc/zoneinfo
Issue the following command if you need to see what the current timezone setting is:
# ls -l /etc/zoneinfo/localtime
Note
This section applies when upgrading to this version of WEBES with 4.3.3 or higher already
installed on the system. The procedure does not apply to versions 4.3.2 and older already
installed.
If you have already installed WEBES version 4.3.2 or earlier, you need to uninstall the
existing version and install the latest version.
If WEBES is already uninstalled or was never installed at all, see Section 3.2, Installing
WEBES.
Rev. 5/5/05
3–18 Web-Based Enterprise Services Installation Guide
Installing on Tru64 UNIX
3.7 Uninstalling WEBES
Upgrading lets you preserve your configuration and state data. Be aware that upgrading
uninstalls the other version of WEBES and installs the newer version—the upgrade does not
simply patch or replace certain files, as was the case with WEBES Service Paks.
To upgrade, make sure all cluster members are up, and run the webes_update shell script that
appears in the “kit” subdirectory of the directory containing the WEBES .tar file (after you
untar the file as described in Section 3.1.8, Extracting the Installation Kit).
Caution
Do not run webes_update if any cluster members are down. Doing so may result in
conditions that prevent WEBES from working, uninstalling, or reinstalling properly.
# webes_update
Because the upgrade uninstalls the older version of WEBES, answer Yes when prompted
about upgrading.
Be aware that the upgrade procedure is not mandatory. If desired, you can uninstall the
existing WEBES copy yourself, but then not all data will be migrated upon installing the
newer version with setld as described in Section 3.2, Installing WEBES.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 3–19
Installing on Tru64 UNIX
3.7 Uninstalling WEBES
Run the interactive /usr/sbin/webes_install_update utility, choose the option to remove all of
WEBES, and follow any prompts that appear. In clusters, uninstallation removes WEBES
from all nodes in the cluster.
When you are using the setld utility, be aware that the subsets for SEA and CCAT are
dependent subsets of the WEBES mandatory subset. Therefore, the WEBES subset should not
be removed unless all of those tools are removed as well. Furthermore, WEBES depends on
WCCProxy, so the WCCProxy subset only should be removed after WEBES and all of its
subsets have been removed.
Be aware that the WCCProxy kit is used by both WEBES and the ISEE Client. Do not remove
the WCCProxy kit if the ISEE Client is installed. All other WEBES components may be
removed without affecting any other installed tool.
You may either remove all the components using a single setld command or issue individual
setld commands in the correct order. If you want to issue individual commands for each
subset, make sure that you only remove the WEBESBASE subset after the SEA and CCAT
subsets have been removed. WEBES in turn depends on WCCProxy, so the WCCProxy subset
should be removed after WEBES and all of its subsets have been removed. Do not remove the
WCCProxy component if the ISEE Client is installed.
The following example shows a single command that simultaneously removes WEBES, its
SEA and CCAT subsets, and WCCProxy:
Rev. 5/5/05
3–20 Web-Based Enterprise Services Installation Guide
4
Installing on HP-UX
This chapter describes how to install the WEBES tools on an HP HP-UX system. The
information in this chapter is organized as follows:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 4–1
Installing on HP-UX
4.1 Pre-Installation
4.1 Pre-Installation
Note
You can install and run WEBES on HP-UX, but currently it does not analyze a native
error log for events occurring on that platform.
You can, however, copy an error log from another system (Windows, Tru64 UNIX, or
OpenVMS) to an HP-UX system for manual analysis there.
Follow these pre-installation guidelines. Depending on which WEBES components you wish
to install, ensure that your system meets the requirements described in the appropriate
sections:
• 4.1.4 Permissions
• 4.1.5 Extracting the Installation Kit
During standard operation, SEA uses far less memory. For example, when the Director is
idle, usage stays generally around 24MB for systems with all the WEBES tools installed.
The Director only approaches the maximum value when a high volume of events arrive or
an extremely large log file is processed. Even then, the memory usage may remain
significantly below the maximum value. The virtual memory requirement is intended to
set a threshold for the absolute maximum amount of memory that will ever be needed. If
the threshold is exceeded, the Director terminates with out-of-memory error.
Rev. 5/5/05
4–2 Web-Based Enterprise Services Installation Guide
Installing on HP-UX
4.1 Pre-Installation
Virtual memory for a process is stored in RAM and the swap partitions on your disk. The
space allocated must be sufficient to run WEBES and all other applications that you want
to run simultaneously.
If the virtual memory requirement given here is too large or too small for your
environment, you are free to make adjustments. You may want to experiment with
various settings to find the optimal value. Refer to the SEA User Guide for more
information on adjusting the memory settings.
• Supported—fully tested
• As-is—not officially tested but may work reasonably well
• Unsupported—known not to work
Category Browser
Web browsers can use different Java runtime environments, but the SEA web interface
requires certain versions of Java for each web browser.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 4–3
Installing on HP-UX
4.2 Installing WEBES
http://java.sun.com/getjava
Install any desired web browsers before installing the Sun JRE. The JRE installation then
finds and updates installed web browsers so that they use the Sun JRE.
4.1.4 Permissions
To install, upgrade, or uninstall WEBES, you must be logged on as the root user. The
/opt/hp/svctools directory is owned by root, and has rwx (read, write, and execute) permissions
for root (owner), and no permissions for any other user (group or world).
# gunzip WEBES{version}.tar.gz
1. First, run the Component Installation as described in Section 4.2.1. This step installs the
files needed for the common components and any selected tools.
2. Then, run the Interactive Configuration Utility as described in Section 4.2.2. Note that
you can return to the utility at any future time, should you wish to modify your WEBES
installation.
Rev. 5/5/05
4–4 Web-Based Enterprise Services Installation Guide
Installing on HP-UX
4.2 Installing WEBES
1. Enter the following command to start the install wrapper, which checks for prerequisites,
installs the WCCProxy, and launches an interactive interface (either terminal-based
character/keyboard inputs or a GUI):
# ./WEBESWrapper.sh
WEBES will not install to a non-default directory. The default directory is required for
proper WEBES operation.
This wrapper script will do the necessary prerequisite checks for WEBES
kit installation. Upon successfull installation of the WEBES kit,
dependent subset installation and configuration can be done using the
webes_install_update script.
2. Wait for the list of components to appear. This may take several moments.
3. Highlight each desired component. WEBESBASE is required.
4. Choose Actions | Install from the menus to start tool installation.
The note appears because the WEBES components also require the WCCProxy. You can
safely okay the note, because the kit detects the presence of the WCCProxy during the
Analysis Phase.
5. At the very end of the install, choose File | Exit from the menus to close the interface that
lists the components.
During installation, the system may display other informational messages, but you do not need
to answer configuration questions until you run the Interactive Configuration Utility as
described in Section 4.2.2.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 4–5
Installing on HP-UX
4.2 Installing WEBES
# webes_install_update
If you need help with a specific field while running the interactive configuration utility, type ?
and press the Enter key.
Company address 123 Main Street You are allowed three lines
Metropolis, VA 22222 when entering the company
USA address.
Rev. 5/5/05
4–6 Web-Based Enterprise Services Installation Guide
Installing on HP-UX
4.2 Installing WEBES
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 4–7
Installing on HP-UX
4.2 Installing WEBES
Enter the number for your choice (see Table 4–5). The menu reappears after completing the
selected operation. You can continue making selections or quit.
Selections requiring that the WEBES Director process first be stopped (for example, for tool
installation) automatically stop the Director. You can restart it manually upon completing your
selection, or you are prompted to restart it when you quit the interactive utility.
Selection Description
Install System Event Analyzer (SEA) Installs the SEA tool. If SEA was already
installed, this option would allow you to uninstall
it.
See the SEA Installation Notes for more
information.
Install Computer Crash Analysis Tool (CCAT) Installs the CCAT tool. If CCAT was already
installed, this option would allow you to uninstall
it.
See the CCAT Installation Notes for more
information.
Rev. 5/5/05
4–8 Web-Based Enterprise Services Installation Guide
Installing on HP-UX
4.3 SEA Installation Notes
4.5 Post-Installation
Be aware of the following post-installation procedures.
# rehash
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 4–9
Installing on HP-UX
4.6 Upgrading WEBES
SEA /opt/hp/svctools/common/ca/release.txt
CCAT /opt/hp/svctools/common/ccat/release.txt
The files list the component versions for the release. Generally, they match the overall
WEBES version number. The files in Table 4–6 also may reveal a “build” number, but those
are not necessarily intended to match across components.
/opt/hp/svctools/common/ca/userdata
/opt/hp/svctools/common/ccat/userdata
/opt/hp/svctools/common/desta/userdata
/opt/hp/svctools/common/webes/userdata
/opt/hp/svctools/specific/ca/userdata
/opt/hp/svctools/specific/ccat/userdata
/opt/hp/svctools/specific/desta/userdata
/opt/hp/svctools/specific/webes/userdata
When using WEBES, store your own files (such as binary event logs or CCAT crash dump
files) under these subdirectories.
• Storing files under the userdata subdirectories makes them easily accessible in the
WEBES user interfaces. For example, SEA automatically lists any binary event logs from
the ca/userdata subdirectories under Other Logs.
• In WEBES 4.1 or later, files stored under the userdata subdirectories are preserved and
restored during WEBES uninstallations and reinstallations.
Rev. 5/5/05
4–10 Web-Based Enterprise Services Installation Guide
Installing on HP-UX
4.7 Uninstalling WEBES
Run the interactive webes_install_update utility to remove individual WEBES tools, and
follow any prompts that appear.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 4–11
5
Installing on Linux
This chapter describes how to install the WEBES tools on a Red Hat Linux system. The
information in this chapter is organized as follows:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 5–1
Installing on Linux
5.1 Pre-Installation
5.1 Pre-Installation
Note
You can install and run WEBES on Linux, but currently it does not analyze a native
error log for events occurring on that platform.
You can, however, copy an error log from another system (Windows, Tru64 UNIX, or
OpenVMS) to a Linux system for manual analysis there.
Follow these pre-installation guidelines. Depending on which WEBES components you wish
to install, ensure that your system meets the requirements described in the appropriate
sections:
• 5.1.4 Permissions
• 5.1.5 Extracting the Installation Kit
Non-HP Systems: WEBES is a proprietary service tool and is not a fully qualified
off-the-shelf product such as Norton SystemWorks. As such, only platforms
manufactured by HP, such as the ProLiant, are officially supported.
Engineering normally expects that WEBES will operate correctly on any industry
standard, 32-bit Intel-based system. However, because HP does not qualify WEBES on
third-party products, functionality on such systems is provided on an as-is basis only.
During standard operation, SEA uses far less memory. For example, when the Director is
idle, usage stays generally around 24MB for systems with all the WEBES tools installed.
Rev. 5/5/05
5–2 Web-Based Enterprise Services Installation Guide
Installing on Linux
5.1 Pre-Installation
The Director only approaches the maximum value when a high volume of events arrive or
an extremely large log file is processed. Even then, the memory usage may remain
significantly below the maximum value. The virtual memory requirement is intended to
set a threshold for the absolute maximum amount of memory that will ever be needed. If
the threshold is exceeded, the Director terminates with out-of-memory error.
Virtual memory for a process is stored in RAM and the swap partitions on your disk. The
space allocated must be sufficient to run WEBES and all other applications that you want
to run simultaneously.
If the virtual memory requirement given here is too large or too small for your
environment, you are free to make adjustments. You may want to experiment with
various settings to find the optimal value. Refer to the SEA User Guide for more
information on adjusting the memory settings.
• Minimum 32 MB of space in the file system containing the directory to which you install
WEBES (/usr/opt/hp/svctools).
• Web browser—Table 5–1 describes the browser prerequisites for SEA according to the
following categories:
• Supported—fully tested
• As-is—not officially tested but may work reasonably well
• Unsupported—known not to work
Category Browser
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 5–3
Installing on Linux
5.1 Pre-Installation
Web browsers can use different Java runtime environments, but the SEA web interface
requires certain versions of Java for each web browser.
http://java.sun.com/getjava
Install any desired web browsers before installing the Sun JRE. The JRE installation then
finds and updates installed web browsers so that they use the Sun JRE.
5.1.4 Permissions
To install, upgrade, or uninstall WEBES, you must be logged on as the root user. The
/usr/opt/hp/svctools directory is owned by root, and has rwx (read, write, and execute)
permissions for root (owner), and no permissions for any other user (group or world).
This command creates a kit directory (if it does not already exist), and extracts the
WEBESWrapper.sh file needed for installation:
Rev. 5/5/05
5–4 Web-Based Enterprise Services Installation Guide
Installing on Linux
5.2 Installing WEBES
1. First, run the Common Component Installation as described in Section 5.2.1. This step
installs the files needed for the common components.
2. Then, run the Interactive Configuration Utility as described in Section 5.2.2. The utility
lets you define your customer and system information, and installs the individual
WEBES tools that you want. Note that you can return to the utility at any future time,
should you wish to modify your WEBES installation.
# cd kit
Enter the following command to install the files for the WEBES common components (WCC)
plus any tools you select:
# ./WEBESWrapper.sh
WEBES will not install to a non-default directory. The default directory is required for proper
WEBES operation.
The wrapper checks for prerequisites and then installs the WEBES common components,
including the base kit and WCCProxy:
This wrapper script will do the necessary prerequisite checks for WEBES kit
installation. Upon successfull installation of the WEBES kit, dependent
subset installation and configuration can be done using the
webes_install_update script.
During installation, the system displays informational messages, but you do not need to
answer configuration questions until you run the Interactive Configuration Utility as described
in Section 5.2.2.
# /usr/sbin/webes_install_update
If you need help with a specific field while running the interactive configuration utility, type ?
and press the Enter key.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 5–5
Installing on Linux
5.2 Installing WEBES
You must define your system the first time that you run the interactive configuration utility.
The values that you enter persist until you change them or choose to remove the profile when
uninstalling WEBES.
Path—Enter the path to where you extracted the kit in Section 5.1.5.
Company address 123 Main Street You are allowed three lines
Metropolis, VA 22222 when entering the company
USA address.
Rev. 5/5/05
5–6 Web-Based Enterprise Services Installation Guide
Installing on Linux
5.2 Installing WEBES
Notification Profile—By default, the installation can automatically create your automated
notification profile based on customer and system entries from Tables 5–2 and 5–3. The
profile gets stored in a text file that you can modify with an editor, if desired:
/usr/opt/hp/svctools/specific/desta/config/profile.txt
After initial configuration, and any time that you rerun the utility thereafter, you are presented
with a menu similar to the following:
Enter the number for your choice (see Table 5–5). The menu reappears after completing the
selected operation. You can continue making selections or quit.
Selections requiring that the WEBES Director process first be stopped (for example, for tool
installation) automatically stop the Director. You can restart it manually upon completing your
selection, or you are prompted to restart it when you quit the interactive utility.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 5–7
Installing on Linux
5.3 SEA Installation Notes
Selection Description
Install System Event Analyzer (SEA) Installs the SEA tool. If SEA was already
installed, this option would allow you to uninstall
it.
See the SEA Installation Notes for more
information.
Install Computer Crash Analysis Tool (CCAT) Installs the CCAT tool. If CCAT was already
installed, this option would allow you to uninstall
it.
See the CCAT Installation Notes for more
information.
• The email address where you want to receive copies of SEA notifications
• Whether or not to delay the initial SEA scan
• Whether or not to start WEBES whenever the system boots
Rev. 5/5/05
5–8 Web-Based Enterprise Services Installation Guide
Installing on Linux
5.4 CCAT Installation Notes
5.5 Post-Installation
Be aware of the following post-installation procedures.
Use an editor to add /usr/sbin to the path in /home/username/.bashrc as shown in the following
example:
export PATH="/usr/local/sbin:/usr/sbin:/sbin:${PATH}:${HOME}/bin"
Note that you can establish permission to run WEBES commands by using the sudoers facility
or by being the root user, so you may need to edit .bashrc for individual users or the root user
depending on your situation.
WEBESBASE-4.3-2
WEBESPROXY-1.2-1
WEBESSEA-4.3-2
WEBESCCAT-5.1-1
In the previous example, the WEBES base kit, SEA, CCAT, and the WCCProxy all are
installed. Note that the version numbers may vary.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 5–9
Installing on Linux
5.5 Post-Installation
WCCProxy /usr/opt/hp/svctools/common/wccproxy/release.txt
SEA /usr/opt/hp/svctools/common/ca/release.txt
CCAT /usr/opt/hp/svctools/common/ccat/release.txt
The files list the component versions for the release. Generally, they match the overall
WEBES version number. The files in Table 5–6 also may reveal a “build” number, but those
are not necessarily intended to match across components.
/usr/opt/hp/svctools/common/ca/userdata
/usr/opt/hp/svctools/common/ccat/userdata
/usr/opt/hp/svctools/common/desta/userdata
/usr/opt/hp/svctools/common/webes/userdata
/usr/opt/hp/svctools/specific/ca/userdata
/usr/opt/hp/svctools/specific/ccat/userdata
/usr/opt/hp/svctools/specific/desta/userdata
/usr/opt/hp/svctools/specific/webes/userdata
When using WEBES, store your own files (such as binary event logs or CCAT crash dump
files) under these subdirectories.
• Storing files under the userdata subdirectories makes them easily accessible in the
WEBES user interfaces. For example, SEA automatically lists any binary event logs from
the ca/userdata subdirectories under Other Logs.
• Files stored under the userdata subdirectories are preserved and restored during WEBES
uninstallations and reinstallations.
Rev. 5/5/05
5–10 Web-Based Enterprise Services Installation Guide
Installing on Linux
5.6 Upgrading WEBES
Run the interactive /usr/sbin/webes_install_update utility, choose the option to remove all of
WEBES, and follow any prompts that appear.
Caution
Normally, the built-in dependencies prevent you from accidentally removing a needed
kit. However, you can force a kit removal using the -nodeps switch, so these
guidelines remain important.
When you are using the rpm utility, be aware of these dependencies:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 5–11
Installing on Linux
5.7 Uninstalling WEBES
• SEA and CCAT are dependent on the WEBES base kit, so the WEBES base kit must not
be removed unless those tools are removed as well.
• The WEBES base kit is dependent on WCCProxy, so the WCCProxy must not be
removed unless the WEBES base kit and all of its tools are removed as well.
• Also note that the ISEE Client is dependent on WCCProxy, so the WCCProxy also must
not be removed if you have the ISEE Client installed.
Given these dependencies, you may issue individual rpm commands in the correct order to
uninstall WEBES as shown in the following example. Note that version numbers may vary, so
you might want to first issue the rpm -qa | grep WEBES command as described in
Section 5.5.2.
# rpm -e WEBESCCAT-5.1-1
# rpm -e WEBESSEA-4.3-2
# rpm -e WEBESBASE-4.3-2
# rpm -e WEBESPROXY-1.2-1
Rev. 5/5/05
5–12 Web-Based Enterprise Services Installation Guide
6
Installing on OpenVMS
This chapter describes how to install the WEBES tools on an HP OpenVMS Alpha system. The
information in this chapter is organized as follows:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–1
Installing on OpenVMS
6.1 Pre-Installation
6.1 Pre-Installation
Follow these pre-installation guidelines. Depending on which WEBES components you wish
to install, ensure that your system meets the requirements described in the appropriate
sections:
Note that HP Sustaining Engineering maintains a schedule of support for the OpenVMS
operating system. HP does not commit to supporting WEBES when installed on an
operating system version that has exceeded its end-of-support date. See the following
URL:
http://www.hp.com/hps/os/os_pvs_amap.html
• Patches—Install all the required OpenVMS patches (rated as INSTALL_1) for your
version, plus any other patches that are required for your system (for example, XP1000 or
DS20E). Some patches may have prerequisite patches, so be sure to check the patch
README files before installing patches.
You also need the latest LIBRTL, PTHREADS, ACRTL, TCP/IP, TDF, and MANAGE
patches (if any) that exist for your version of OpenVMS.
Rev. 5/5/05
6–2 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.1 Pre-Installation
The latest UPDATE patch (if one exists for your OpenVMS version) includes a coherent
set of the latest OpenVMS patches as of a certain date. A good strategy is first to install
the latest UPDATE patch, followed by any other required patches listed above that were
released after the latest UPDATE patch.
During standard operation, SEA uses far less memory. For example, when the Director is
idle, usage stays generally around 350MB for systems with all the WEBES tools
installed. Idle usage often may be closer to 73MB, or 9000 8KB pages, even though
350MB of virtual memory is allocated. This discrepancy occurs because of how
OpenVMS calculates and displays its memory usage.
The 600MB of virtual memory gets allocated when the Director starts, but as the Director
subprocesses stop, memory gets released to the system and virtual memory usage
decreases. As subprocesses are spawned during event processing, memory usage
increases and then drops again when those subprocesses finish. The virtual memory
requirement is intended to set a threshold for the absolute maximum amount of memory
that will ever be needed. If the threshold is exceeded, the Director terminates with an
out-of-memory error.
Virtual memory for a process is stored in RAM and the pagefile on your disk. The space
allocated must be sufficient to run WEBES and all other applications that you want to run
simultaneously.
Practically speaking, if there is very little physical memory to support the virtual memory
setting, frequent paging occurs whenever WEBES starts or is running, thus reducing
overall system performance. WEBES engineering recommends having about half (or
more) as much physical RAM as the virtual memory setting. So, to support the 600MB
virtual memory requirement and avoid excessive paging, you would want at least 256MB
of physical RAM.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–3
Installing on OpenVMS
6.1 Pre-Installation
You also can work backwards to determine the highest virtual memory setting to attempt.
For example, if the system only has 128MB of physical RAM, the virtual memory setting
should be reduced to about 250MB. Note that the lower value might cause the combined
director and analyzer subprocesses to run out of memory should a flood of error events
arrive for analysis.
If the virtual memory recommendation given here is too large or too small for your
environment, you are of course free to make adjustments. You may want to experiment
with various settings to find an optimal value. See the SEA User Guide for more
information on adjusting the memory settings.
Even if TCP/IP traffic to other machines has been disabled, the ability to resolve the local
host name into an IP address must be enabled. Otherwise, the Director cannot handle
WEBES message traffic correctly and fails to start.
Other TCP/IP products may work as-is, so the WEBES installation kit always completes
regardless of what, if any, TCP/IP product is installed.
On clusters with multiple system disks, there could be multiple SYSUAF files, on
different system disks. VMS engineering does not support such a configuration. There
should be only one SYSUAF file for the entire cluster, and it should be located on a disk
to which all cluster members have access.
If using multiple system disks and multiple SYSUAF files are used, set the user quotas
for WEBES identically for each SYSUAF. For example, say that you have a cluster
where nodes A and B share a SYSUAF files on system disk 1, and nodes C and D share a
different SYSUAF file on system disk 2. To install WEBES on another disk 3 that all
four nodes share, set the user quotas on node A or B, but also on node DC or CD (because
the user accounts, including quota settings, are stored on both system disks 1 and 2).
Rev. 5/5/05
6–4 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.1 Pre-Installation
New quotas go into effect when you log in again, so you must log out and log in again
before installing WEBES.
• LOCALHOST entry—In order for WEBES to operate correctly, the LOCALHOST entry
must be defined in the OpenVMS TCP/IP HOSTS database. It is defined correctly by
default, but it can be removed, which causes WEBES to fail.
After verifying that LOCALHOST responds to the ping command, you can use Ctrl-C or
Ctrl-Y to stop pinging.
Then, run autogen specifying the beginning/ending phases for autogen, and use feedback
information. Note that the MULTITHREAD sysgen parameter is not dynamic. You must
reboot the system to finish changing the value.
• All DSxx and ES40 systems must have firmware V5.7–4 or higher.
• All other products supported by System Event Analyzer (see the WEBES Release
Notes) ship with a firmware version that is already compatible with
WEBES/SEA processing.
In general, users should take advantage of the latest improvements by obtaining the most
recent firmware version available for their platform.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–5
Installing on OpenVMS
6.1 Pre-Installation
• Automated Notification—If desired, you can choose a method for sending automatic
problem reports to your service provider:
• SICL—DSNLink V2.3E or V3.0 and a fixed IP address are required for sending
System Initiated Call Logging (SICL) automatic problem reports. You must
install DSNLink before installing WEBES.
• PRS—For Proactive Remote Service (PRS) automatic reports, you do not need
DSNLink or WorldWire installed on the system that is running WEBES. You
only need to identify the host name and port number of the customer service
gateway (also called the QSAP) during WEBES installation.
• ISEE—For Instant Support Enterprise Edition (ISEE) automatic reports, you
must install ISEE Client A.03.50 or later on the same machine as WEBES.
• You can upgrade to this version without first uninstalling a previous version yourself
(WEBES 4.3.3 and WEBES 4.3.4 only). This kit recognizes an existing installation, saves
configuration and state data, uninstalls the existing kit, installs this version, and then
restores the configuration and state data.
To install this version on a system that was running a version older than 4.3.3, first
uninstall the older version using the instructions in the WEBES Installation Guide for that
version.
If there is no email received from SEA, then please check your SMTP
configurations.
Rev. 5/5/05
6–6 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.1 Pre-Installation
• If you want SEA to automatically analyze a system’s native error log, you must install on
a supported HP hardware platform or a machine that includes supported HP I/O devices.
See the WEBES Release Notes for the list of supported products.
• Minimum 36,000 blocks free
• Web browser—Table 6–1 describes the browser prerequisites for SEA according to the
following categories:
• Supported—fully tested
• As-is—not officially tested but may work reasonably well
• Unsupported—known not to work
Category VMS
HP now provides a fully supported web browser for OpenVMS, the Secure Web Browser
(SWB) for OpenVMS Alpha, based on Mozilla. The SWB is available for download at:
http://h71000.www7.hp.com/openvms/products/ips/cswb/cswb.html
Be sure to read the install documentation and release notes before using SWB for the
SEA web interface.
http://h71000.www7.hp.com/openvms/products/ips/register_mozilla.ht
ml
Be sure to read the install documentation and release notes before using Mozilla for the
SEA web interface. Also note that these Mozilla kits are later than the baseline for the
SWB and are offered on an as-is basis only. The SWB is the preferred and fully supported
browser for OpenVMS.
All web browsers for OpenVMS require a Java runtime environment to use the SEA web
interface or to access any web site that uses Java. You have two options:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–7
Installing on OpenVMS
6.1 Pre-Installation
Special notes apply depending on which option you choose for accessing the SEA web
interface.
WEBES JRE:
2. Launch the web browser. Java functionality within the web browser should be
identical for either initialization command above, but performance and memory
usage may differ.
• Error log—After installation, SEA begins analyzing all events currently stored in the
error log, which can result in high CPU usage over an extended period. To control this
operation, you have two options:
• Archive and clean the error log as described in Section 6.1.7 before installing.
This reduces the size of the log and, in turn, the cost of the initial scan.
• Choose to delay the initial scan when prompted during installation. Be aware that
SEA automatic analysis does not run until after (and starting with) the initial
scan, however.
• System serial number—On GS80, GS160, and GS320 systems, verify the serial number
according to Section 6.1.8 before installing.
See the SEA documentation for additional background on hardware, firmware, and operating
system interoperability.
Rev. 5/5/05
6–8 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.1 Pre-Installation
• To run the CCAT GUI, DECwindows must be installed and configured and Motif or
X-Window system terminals are required.
• Minimum 8,000 blocks free
• RCM component of WEBES—You must uninstall all of the WEBES version that
contained RCM before installing this version, and doing so removes the RCM tool.
You are free to install a standalone RCM kit at any time after removing the old version of
WEBES. This version of WEBES does not contain RCM, but the latest RCM kits and
documentation may be downloaded from the following location:
http://www.software.hp.com/portal/swdepot/displayProductInfo.do?pr
oductNumber=RCMBASE01
6.1.6 Privileges
To install, upgrade, or uninstall WEBES, the user needs all of the following OpenVMS
privileges:
• When Upgrading WEBES as described in Section 6.4, the user who performs the upgrade
must be the same user who originally installed the previous copy of WEBES.
• When Uninstalling WEBES as described in Section 6.5, the user who performs the
uninstallation must be the same user who originally installed WEBES.
The SET PROCESS command sets privileges for all cluster nodes only when the cluster is
served by a single system disk. However, on a cluster with multiple system disks, you might
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–9
Installing on OpenVMS
6.1 Pre-Installation
choose to install WEBES on nodes served by system disks other than the one serving the node
from which you are installing. In that case, SET PROCESS does not set privileges on those
other nodes (the nodes served by the other system disks), and WEBES does not install
correctly on those other nodes.
To correctly install on clusters with multiple system disks, set up the required privileges as
defaults (the privileges you get when logging in) on all nodes where you wish to install
WEBES, instead of using the SET PROCESS command.
See Section 6.1.10, Shared Non-System Disk Installations, for additional precautions related
to one versus multiple system disks.
Running WEBES
To execute any WEBES commands (DESTA, WSEA, or WCCAT commands), the user needs
all of the following OpenVMS privileges. Note that these are a subset of the privileges
required to install, upgrade, or uninstall WEBES:
Follow these guidelines for cleaning the error log. If WEBES is installed and running when
you clean the log, you do not need to stop and restart the Director process. Also, do not stop
and restart the ERRFMT system event logging process.
Caution
After renaming or deleting the existing log, do not install WEBES until the new
default log is present.
Note that if you rename the log, the saved log can be analyzed at a later time.
Rev. 5/5/05
6–10 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.1 Pre-Installation
Scheduled Maintenance
Aside from starting with a clean log before installing SEA, you may want to perform regular
maintenance on the error log. One method is to rename ERRLOG.SYS on a daily basis. For
example, you might rename ERRLOG.SYS to ERRLOG.OLD every morning at 9:00. To free
space on the system disk, you then can back up the renamed version to a different volume and
delete the file from the system disk.
Certain GS80, GS160, and GS320 systems did not have their system serial number set
correctly at the factory, and SEA rules only function when the serial number is set correctly.
Affected serial numbers will begin with the letter “G.”
At the SRM console firmware prompt (the prompt when you first power the system on), check
the serial number with the following command:
The serial number shown should match the actual serial number on the model/serial number
tag located in the power cabinet. If necessary, change the serial number with the following
command:
Enter the six-character serial number provided on the tag in the power cabinet.
Multiple AlphaServers
This issue also can arise when multiple AlphaServers are ordered, because the factory may
assign an identical serial number to each system. In this scenario, SEA rules do not work
correctly because they require that each AlphaServer have a unique number.
If this is the case, uniquely identify each AlphaServer by appending –1, –2, –3, and so on, to
the serial numbers when you use the set sys_serial_num command.
Partitions
Note that multiple partitions on the same AlphaServer always have the same serial number
because they reside on the same machine. There are no SEA conflicts in this case, so do not
attempt to assign unique serial numbers to different partitions on the same machine.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–11
Installing on OpenVMS
6.1 Pre-Installation
disk containing the target directory. This means that an installation might not always place
WEBES on all cluster nodes, since all nodes might not be able to “see” the place where you
are installing WEBES.
In the previous case, you can install WEBES one more time for the remaining two nodes
by running the install from either node and again choosing the default location of
SYS$COMMON:[HP...]. Consider this a completely separate WEBES installation from
the first install on the majority of the nodes.
• CLUSTER: All but two nodes share system disk A. The other two nodes share system
disk B. All nodes also mount a non-system disk C.
INSTALL NODE: Any node
INSTALL TARGET: A directory on disk C, specified by you during the installation
RESULT: WEBES installs itself for all nodes.
Note that in all cases the kit also lets you choose only a subset of the nodes that can see the
install location.
As explained in Section 6.1.9, WEBES can be installed on a system disk or shared non-system
disk. However, a shared non-system disk might be accessible by multiple nodes that are served
by different system disks as shown in Figure 6–1. This means that WEBES is not limited to
being installed only on nodes served by one given system disk. A PCSI database, however, is
limited to one system disk.
This scenario can generate discrepancies in the PRODUCT SHOW PRODUCT WEBES
command. The command always shows WEBES as installed when run from a node served by
the same system disk as the node from which WEBES was originally installed (the installing
node). This is because the WEBES installer registers WEBES only into the PCSI database for
Rev. 5/5/05
6–12 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.1 Pre-Installation
the system disk serving the installing node, and not into any other PCSI databases. Two types
of misleading information can result as shown in Figure 6–1.
• If a node is served by the same system disk as the installing node, but the user did not add
WEBES to that node, the command shows that WEBES is installed when it is not.
• Conversely, if a node is served by a different system disk from the installing node, and the
user added WEBES to that node, the command does not show that WEBES is installed
when it is.
• There are no other kits in the directory, especially other versions of WEBES kits.
• There are no old WEBES or WCC files in the directory that were left over from previous
operations. (The most reliable course may simply be to use an empty directory.)
$ run WEBES_{version}.EXE
This command extracts the WEBES installation files. Messages similar to the following
appear:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–13
Installing on OpenVMS
6.2 Installing WEBES
********************************************************************
WEBES Kit
********************************************************************
inflating: dec-axpvms-webes-<version>.pcsi
inflating: dec-axpvms-sea-<version>.pcsi
inflating: dec-axpvms-ccat-<version>.pcsi
inflating: webes_install.com
After all Pre-Installation instructions are met, run the following command and follow the
prompts. The command executes the DCL script WEBES_INSTALL.COM in the current
directory. Section 6.1.11 provides information about extracting the script.
Do not run the PRODUCT INSTALL WEBES command used in some older WEBES releases.
This command aborts and prompts you to run the WEBES_INSTALL script instead. As of
version 4.1, the installation uses the WEBES_INSTALL DCL script.
$ @webes_install
* If you continue, recovery data for the patches listed above will be
deleted.
* The deletion of recovery data does not affect the installation status
of
* patches applied to products that are not participating in this
operation.
* However, continuing with this operation prevents you from uninstalling
* these patches at a future time by use of the PRODUCT UNDO PATCH command.
Rev. 5/5/05
6–14 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.2 Installing WEBES
The messages appear because of a new feature that allows OpenVMS patches to be
removed. You only see these messages if you have installed the new OpenVMS PCSI
patch that adds the feature, and you have installed OpenVMS patches that use the feature.
Prior to the addition of this feature, OpenVMS patches could not be removed.
Nevertheless, note that installing WEBES will prevent you from using the new feature to
remove any OpenVMS patches listed. Otherwise, you can safely ignore the messages and
continue with WEBES installation.
• Install Menu—The main install menu lets you choose some or all of the WEBES tools
for installation.
WEBES INSTALL - MAIN MENU
=========================
Optional Components:
1. Mandatory Component Only
2. System Event Analyzer ( SEA )
3. Computer Crash Analysis Tool ( CCAT )
4. All of the Mandatory and Optional Components
5. Exit
=========================
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–15
Installing on OpenVMS
6.2 Installing WEBES
In addition to the customer and system data, WEBES requires you to supply the service
obligation information described in Table 6–3.
In addition, SEA asks what automated notification setup to use (see the explanation of
automated notification in Section 6.1.1):
Rev. 5/5/05
6–16 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.2 Installing WEBES
Option 2 requires you to supply the PRS customer service gateway address and port number
(see Table 6–4).
Table 6–4 PRS Customer Service Gateway Information Required for SEA
If you have the ISEE Client installed, the previous menu does not appear. Instead, you see one
of the following:
• With DSNLink already installed—You are asked if you want DSNLink notifications in
addition to ISEE notifications.
• Without DSNLink—WEBES will use the ISEE Client for notifications, and there are no
prompts to answer.
Delaying the Initial SEA Scan—Immediately after installation, SEA normally scans all
events currently stored in the error log. For a very full log, this initial scan can result in high
CPU usage over an extended period. You can choose to delay the initial scan when prompted,
but SEA automatic analysis does not run until after (and starting with) the initial scan. Note
that events that happen during the delay are saved in the log for analysis at initial scan time.
After the message appears, you are returned to the command prompt.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–17
Installing on OpenVMS
6.3 Post-Installation
6.3 Post-Installation
Be aware of the following post-installation procedures.
This procedure applies whenever you add a new node to a cluster after WEBES was installed,
or when one or more nodes were down during WEBES installation.
To add WEBES to the new cluster node or nodes, enter the following command:
WEBES will be configured on the new nodes in the same way the other nodes were configured
at the time of original WEBES installation.
$ @svctools_home:[common.bin]webes_install
Use the WEBES update menu to enter customized values (such as option 6. System
Information, and option 7. Service Obligation) that apply to the given node.
Rev. 5/5/05
6–18 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.3 Post-Installation
The previous recommendation works only if you install on a cluster where all nodes share the
same system disk. If you install on a cluster-shared disk, but each node has a separate system
disk, then WEBES_INSTALL thinks WEBES is not installed and tries to start an installation.
(It works correctly on the node from which you installed WEBES, but that node already has
the desired configuration data.)
Run these only from the installing node. These options do not involve correcting node
data.
To turn off boot time startup, where {hostname} is the name of the machine:
To turn on boot time startup, where {hostname} is the name of the machine:
• Option 4: Customer Information (This probably does not change per node.)
In the following file, manually edit the fields that do not start with “System ___” :
SVCTOOLS_HOME:[SPECIFIC.DESTA.CONFIG]PROFILE.TXT
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–19
Installing on OpenVMS
6.3 Post-Installation
$ desta start
$ desta stop
• Option 9: Uninstall
Run this option only from the installing node. This option does not involve correcting
node data.
$ @svctools_home:[common.bin]webes_install
When WEBES is already installed, the command launches the update menu:
1.
SEA Menu
2.
CCAT Menu
3.
Start At Boot Time
4.
Customer Information
5.
System Information
6.
Service Obligation
7.
Start DESTA Director
8.
Stop DESTA Director
9.
Uninstall Webes
- Fully uninstalls Webes and all installed dependent components
such as SEA and CCAT
10. Exit
=========================
Selections requiring that the WEBES Director process first be stopped (for example, for tool
installation) automatically stop the Director and then restart it during the interactive routine.
Table 6–5 describes each option:
Rev. 5/5/05
6–20 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.3 Post-Installation
Selection Description
Stop DESTA Director Manually stops the WEBES Director process (in
clusters, selectable for each node)
Note that there are workarounds for WEBES_INSTALL in clusters where you install on a
cluster-shared disk, but each node has a separate system disk. See the Special Case for
Separate System Disks in Section 6.3.2 instead of running WEBES_INSTALL.
WEBES—The WEBES base kit is installed if issuing the following command generates
output similar to the following:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–21
Installing on OpenVMS
6.3 Post-Installation
SEA—SEA is installed if issuing the following command generates output similar to the
following:
CCAT—CCAT is installed if issuing the following command generates output similar to the
following:
In general, you do not need to keep track of any build number that follows the base version
number. Subsequent dot releases may affect the build number.
The previous steps work only if you install on a cluster where all nodes share the same system
disk. If you install on a cluster-shared disk, but each node has a separate system disk, you only
see the correct PRODUCT SHOW output on the node where WEBES was originally installed.
All the other nodes do not show WEBES nor any of its component tools as installed.
You can see what original node WEBES was installed from by looking at the following line in
SVCTOOLS_HOME:[SPECIFIC.DESTA.CONFIG]PROFILE.TXT on any node (unless
someone already edited the file as described in the workarounds in Section 6.3.2):
If someone already edited the PROFILE.TXT file for each node, use the following method to
see where WEBES was installed from:
$ MCR SYSMAN
SYSMAN> set env /cluster
Rev. 5/5/05
6–22 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.3 Post-Installation
This runs the PRODUCT ... command on each node and displays its output. One of the nodes
will show WEBES as installed, which is the original node.
WCCProxy SVCTOOLS_HOME:[COMMON.DESTA]RELEASE.TXT
SEA SVCTOOLS_HOME:[COMMON.SEA]RELEASE.TXT
CCAT SVCTOOLS_HOME:[COMMON.CCAT]RELEASE.TXT
The WEBES readme file lists the component versions for the release. Generally, they match
the overall WEBES version number. The files in Table 6–6 also may reveal a “build” number,
but they are not intended to match across components.
SVCTOOLS_HOME:[COMMON.CA.USERDATA]
SVCTOOLS_HOME:[COMMON.CCAT.USERDATA]
SVCTOOLS_HOME:[COMMON.DESTA.USERDATA]
SVCTOOLS_HOME:[COMMON.WEBES.USERDATA]
SVCTOOLS_HOME:[SPECIFIC.CA.USERDATA]
SVCTOOLS_HOME:[SPECIFIC.CCAT.USERDATA]
SVCTOOLS_HOME:[SPECIFIC.DESTA.USERDATA]
SVCTOOLS_HOME:[SPECIFIC.WEBES.USERDATA]
When using WEBES, store your own files (such as binary event logs or CCAT crash dump
files) under these subdirectories.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–23
Installing on OpenVMS
6.3 Post-Installation
• Storing files under the userdata subdirectories makes them easily accessible in the
WEBES user interfaces. For example, SEA automatically lists any binary event logs from
the CA.USERDATA subdirectories under Other Logs.
• In WEBES 4.1 or later, files stored under the userdata subdirectories are preserved and
restored during WEBES uninstallations and reinstallations.
On clusters, place files that you want to be accessible by all nodes into the “common” paths,
and files that are only for one node under the “specific” paths.
This can occur when, for example, OpenVMS is writing times into the logfile in standard time,
while the Java time zone information utilities are correctly adjusting for daylight savings
based on the date.
To address such discrepancies, look at time settings by checking logicals as shown in the
following example:
(LNM$SYSTEM_TABLE)
"SYS$DST_DELTA_TIME" = "ffffcaccfbc390af"
"SYS$LOCALTIME" = "SYS$SYSROOT:[SYS$ZONEINFO.SYSTEM.US]MOUNTAIN."
"SYS$TIMEZONE_DAYLIGHT_SAVING" = "1"
"SYS$TIMEZONE_DIFFERENTIAL" = "-21600"
"SYS$TIMEZONE_NAME" = "MDT"
"SYS$TIMEZONE_RULE" = "MST7MDT6,M4.1.0/02,M10.4.0/02"
Adjust any settings that are incorrect for your location. You may want to make this verification
step part of your regular post-installation tasks.
Rev. 5/5/05
6–24 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.3 Post-Installation
If you answer YES, WEBES puts the entries below into the MCR SYSMAN STARTUP table,
to do the following:
Would you like the WEBES logicals and DCL commands to be defined during
VMS system reboot? (Adds startup entries to MCR SYSMAN STARTUP, but these
entries do not start any processes)
If you answer YES, WEBES puts the entries below in the MCR SYSMAN STARTUP table, to
do the following:
If you answer NO to the above question, WEBES puts the entries below in the MCR
SYSMAN STARTUP table, to do the following:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–25
Installing on OpenVMS
6.3 Post-Installation
Next, WEBES asks if you wish to start the DESTA Director during installation. If you answer
YES, the Director will be started at the end of the WEBES installation process. If you answer
NO, the Director will not be started by the installation process, and you must start it yourself if
required. The WCCProxy is started however.
If you wish to control the setup of WEBES in the startup sequence yourself, you can instead do
the following:
Option A:—If you want the DESTA Director to start at boot time:
1. Answer “YES” to the “Would you like the WEBES Director to be started during VMS
system boot?” question during the WEBES install.
2. Remove the entries added by the WEBES install:
$ MCR SYSMAN STARTUP REMOVE FILE WCCPROXY$STARTUP.COM
$ MCR SYSMAN STARTUP REMOVE FILE DESTA$STARTUP.COM
$ MCR SYSMAN STARTUP REMOVE FILE CCAT$STARTUP.COM
3. Add these calls to your system startup, anytime after TCP/IP has been started, in any
order:
$ @SYS$STARTUP:WCCPROXY$STARTUP
$ @SYS$STARTUP:DESTA$STARTUP.COM
$ @SYS$STARTUP:CCAT$STARTUP.COM
4. Examine the DESTA line appended to the SYSHUTDWN.COM, and move it if desired.
Option B: If you do not want the DESTA Director to start at boot time, but you want to be
able to run WEBES processes manually, including the DCL commands DESTA, WSEA, and
WCCPROXY (such as “desta start” to start the Director later manually):
1. Answer “NO” to the “Would you like the WEBES Director to be started during VMS
system boot?” and “Would you like the WEBES logicals and DCL commands to be
defined during VMS system reboot” questions during the WEBES install.
2. Remove the entry added by the WEBES install:
$ MCR SYSMAN STARTUP REMOVE FILE WCCPROXY$STARTUP.COM
3. Add these calls to your system startup, anytime after TCP/IP has been started, in any
order:
$ @SYS$STARTUP:WCCPROXY$STARTUP "LOGICALS ONLY"
$ @SYS$STARTUP:DESTA_LOGICALS$STARTUP.COM
Rev. 5/5/05
6–26 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.3 Post-Installation
If you have the ISEE Client installed, it requires the WCCProxy process to be running at
all times. In that case, remove the “LOGICALS ONLY” parameter to allow the
WCCProxy process to start:
$ @SYS$STARTUP:WCCPROXY$STARTUP
$ @SYS$STARTUP:DESTA_LOGICALS$STARTUP.COM
4. The DESTA Director must be stopped before shutting down the VMS system, to ensure a
clean closure of files, sockets, processes and other resources. You can stop it either
manually with the “desta stop” command, or add it to your shutdown sequence as
described below.
Even if you do not start the Director at boot time, it is recommended that you add the line
shown below to your site-specific system shutdown sequence (such as
SYSHUTDWN.COM) to ensure that any DESTA Director started manually is stopped
correctly during system shutdown:
Or simply:
$ @SYS$STARTUP:DESTA$SHUTDOWN.COM
(The simplified line will cause an error message if it remains after WEBES has been
removed or uninstalled.)
Option C: If you do not want the DESTA Director to start at boot time, and you do not want to
be able to run any WEBES processes without manually setting up WEBES first:
The process is the same as in Option B, skipping step 3 (1 and 2 are still required, and 4 is
recommended). No WEBES DCL commands will operate correctly until a user with the
required WEBES runtime privileges (see Section 6.1.6) issues both of the commands listed in
step 3.
If you upgrade WEBES to a newer version after manually removing the entries from
SYSMAN, the upgrade places the WCCPROXY entry in SYSMAN. (This will be corrected in
a future WEBES release.) If you are already handling WEBES setup using one of the above
options (A, B, or C), then you must manually remove the SYSMAN entry inserted by the
upgrade, after the upgrade has completed:
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–27
Installing on OpenVMS
6.4 Upgrading WEBES
Note
This section applies when upgrading to this version of WEBES with 4.3.3 or higher already
installed on the system. The procedure does not apply to versions 4.3.2 or older already
installed.
If you have already installed WEBES version 4.3.2 or earlier, you need to uninstall the
existing version and install the latest version.
If WEBES is already uninstalled or was never installed at all, see Section 6.2, Installing
WEBES.
Upgrading lets you preserve your configuration and state data. Be aware that upgrading
uninstalls the other version of WEBES and installs the newer version—the upgrade does not
simply patch or replace certain files, as was the case with WEBES Service Paks.
#@WEBES_INSTALL (from the directory where the 4.4 kit is present) informs you that the
other version was detected and prompts you about upgrading:
If you answer Yes, the kit saves configuration and state data, uninstalls the other version,
installs this version, and then restores the configuration and state data.
Rev. 5/5/05
6–28 Web-Based Enterprise Services Installation Guide
Installing on OpenVMS
6.5 Uninstalling WEBES
If you answer No, the kit exits. If desired, you can uninstall the existing WEBES copy
yourself, but then not all data will be migrated upon installing the newer version as described
in Section 6.2, Installing WEBES.
$ @svctools_home:[common.bin]webes_install
Choose the menu number for the tool (1 or 2) and follow the prompts to remove it.
1. SEA Menu
2. CCAT Menu
3. Start At Boot Time
4. Customer Information
5. System Information
6. Service Obligation
7. Start DESTA Director
8. Stop DESTA Director
9. Uninstall Webes
- Fully uninstalls Webes and all installed dependent components
such as SEA and CCAT
10. Exit
=========================
$ @svctools_home:[common.bin]webes_install
Choose the “Uninstall WEBES” option from the update menu and follow the prompts that
appear.
1. SEA Menu
2. CCAT Menu
3. Start At Boot Time
4. Customer Information
5. System Information
6. Service Obligation
7. Start DESTA Director
8. Stop DESTA Director
9. Uninstall Webes
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide 6–29
- Fully uninstalls Webes and all installed dependent components
such as SEA and CCAT
10. Exit
=========================
6.5.3 Clusters
Log in to the node where you want to remove WEBES. Then, the uninstall routine asks
whether you also want to uninstall from each of the other nodes in the cluster.
By controlling your answers to the prompts, you can remove WEBES from one node (the one
where you logged on), multiple nodes (which always includes the one where you logged on),
or the entire cluster.
Make sure the other nodes in the cluster can access the WEBES install directory on the node
where you logged on.
Glossary
A|B|C|D|E|F|G|H|I|J|K|L|M|N|O|P|Q|R|S|T|U|V|W|X|Y|Z
A
access ID
An alphanumeric string that identifies a customer. Enterprise customers probably will have more
than one ID. (They may be assigned one per site, for example.) Other systems may refer to this
alphanumeric string as the service ID.
ACHS
Automatic Call Handling System. Within the service provider’s customer service center, ACHS
accepts incoming event analysis messages that were initiated by SICL.
See ACHS.
C
CADC
Crash Analysis Data Collector. On Windows systems, CADC is required before the system can
collect operating system failure information and format it into a footprint that CCAT can then
analyze. The Tru64 UNIX and OpenVMS operating systems come with built-in utilities that create
such footprints.
CCAT
Computer Crash Analysis Tool. CCAT is a remote operating system failure analysis tool and is a
WEBES component.
See CCAT.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide Glossary–1
Glossary
D
See CADC.
The PRS system that connects customer managed systems with the outside world. Events from the
managed systems are accumulated to a single customer service gateway platform on the customer
premises for transmission to the service provider.
D
DESTA
Distributed Enterprise Service Tools Architecture. DESTA is the engineering code name for the
WEBES software suite architecture. Consider any references to DESTA to be roughly synonymous
with WEBES itself.
See DESTA.
DHCP
Dynamic Host Configuration Protocol. DHCP is a protocol for automatic TCP/IP configuration that
provides dynamic and static address allocation and management.
DSNLink
A service tool that allows two-way SICL communications between a customer system and a service
provider system.
See DHCP.
I
Instant Support Enterprise Edition
See ISEE.
ISEE
Instant Support Enterprise Edition. HP ISEE automates remote support over the Internet by using
electronic notifications similar to those from SICL or PRS. ISEE service providers can use remote
diagnostic scripts to analyze supported systems and devices.
Rev. 5/5/05
Glossary–2 Web-Based Enterprise Services Installation Guide
Glossary
J
J
Java Development Kit
See JDK.
See JRE.
See JVM.
JDK
Java Development Kit. The JDK is a set of development tools used for creating Java applications.
such as SEA.
JRE
Java Runtime Environment. JRE is runtime code that enables Java applications to be distributed
freely.
JVM
Java Virtual Machine (or Java VM). The JVM is an abstract computing machine with an instruction
set and various memory areas. The JVM understands the Java class file, which contains its
instructions. The JVM is part of the JDK, and part of better versions of various browsers.
M
mandatory subsets
In Tru64 UNIX WEBES installations, mandatory subsets refers to the required portions of the
WEBES suite such as the WCC, rather than the tools such as SEA or CCAT.
P
PCSI
POLYCENTER Software Installation. PCSI is a software installation and management tool for
OpenVMS systems. PCSI can package, install, remove, and manage software products.
See PCSI.
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide Glossary–3
Glossary
Q
See PRS.
PRS
Proactive Remote Service. PRS lets customer systems self-monitor and securely report problems
and events to a service provider. In addition, service representatives can securely connect back to a
remote customer system for non-disruptive repair and maintenance. PRS uses WorldWire and is the
next evolution from the original SICL service offering.
Q
QSAP
Qualified Service Access Point. QSAP is an older name for the customer service gateway.
See QSAP.
R
RCM
Revision and Configuration Management. In versions prior to 4.2, RCM was a WEBES component
that collected configuration, revision, and patch data from supported systems.
See RCM.
S
SEA
System Event Analyzer. SEA is a remote system event monitoring tool and is a WEBES component.
service ID
An alphanumeric string that identifies a customer. Enterprise customers probably will have more
than one ID. (They may be assigned one per site, for example.) Other systems may refer to this
alphanumeric string as the access ID.
Rev. 5/5/05
Glossary–4 Web-Based Enterprise Services Installation Guide
Glossary
T
SICL
System Initiated Call Logging. SICL uses DSNLink to send fault and failure messages to the service
provider’s customer service center. The messages are then received by ACHS, analyzed, and acted
upon as appropriate. The follow-up service offering to SICL is PRS.
See SMTP.
SMTP
Simple Mail Transfer Protocol. SMTP is a TCP/IP protocol governing email transmission and
reception.
See SEA.
See SICL.
T
TCP/IP
See TCP/IP.
U
UniCensus
Rev. 5/5/05
Web-Based Enterprise Services Installation Guide Glossary–5
Glossary
W
W
WCC
WEBES Common Components. The WCC are required portions of WEBES that allow the tool suite
to function as an integrated installation. The WCC are separate from the individual tools in the
WEBES suite (SEA and CCAT) and are almost always transparent to the user. See also WCCProxy.
WCCProxy
Like the WCC, the WCCProxy is another required part of WEBES. After WEBES installation, the
WCCProxy appears as a separately installed kit and represents WEBES functionality not developed
in the Java environment. The WCCProxy contains functions that allow WEBES to interact properly
with the operating system and with the ISEE Client.
See WEBES.
WEBES
Web-Based Enterprise Services. WEBES is an integrated set of web-enabled service tools that
includes the System Event Analyzer (SEA) and Computer Crash Analysis Tool (CCAT), as well as
the required components WCC and WCCProxy. See also DESTA.
See WCC.
WorldWire
A service tool that allows for secure two-way PRS communication between a customer system and
a service provider system.
Rev. 5/5/05
Glossary–6 Web-Based Enterprise Services Installation Guide