Transcript Configuration the PCBE Agent

PowerChute Business Edition
-----PCBE
Agent ; Server ; Console
© 2007 APC-MGE corporation.
使用 “ IE + PCBE Agent ”监
控UPS
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
© 2007 APC-MGE corporation.
PowerChute Business Edition 7.0 for Unix
• General for PCBE
• Prepare installation environment
• Installation Routine
• The Configuration of PCBE
• Un-Installation
• Troubleshooting
Xiaoping Guo
Team Leader, TS UNIX, JPAA
Beijing , China, Apr., 2004
© 2007 APC-MGE corporation.
General for PCBE 7.0 for Unix Product
Overview
PowerChute Business Edition enables you to simultaneously monitor up to
25 UPSs protecting servers or workstations.
In the event of an extended power outage graceful unattended shutdown
ensures no information is lost and time to recovery is minimized.
Advanced notification and analysis features help you to identify the causes
of potential UPS and power related problems before they occur ensuring
the health of your system.
© 2007 APC-MGE corporation.
General for PCBE 7.0 for Unix
PowerChute Business Edition Agent
Provides UPS status monitoring and, in the event of an extended power outage,
system shutdown capabilities for your UPS-protected computers.
This software must be installed on each computer that is directly attached to one
of the UPS systems described in Supported UPS Models.
PowerChute Business Edition Server
Used to configure and monitor the PowerChute Business Edition Agents.
The PowerChute Server gathers information from the PowerChute Agents and
provides centralized event tracking, event notification and a single point of
contact for the PowerChute Console.
This software must be installed on one of your networked Windows computers.
PowerChute Business Edition Console
Connects to the PowerChute Business Edition Server to provide the user interface
for managing and configuring your UPS-protected systems.
Install the PowerChute Console on any Windows workstation, desktop, or laptop.
In Unix, the agent for it only.
© 2007 APC-MGE corporation.
General for PCBE 7.0 for Unix
Specific Feature
 Optimized for managing1-25 PCBE Agents over a network
 Designed for easy operation
Auto-discovery
-- Automatically discovers Agents on the network
Centralized view
-- See status information of up to 25 Agents at a glance
Inventory reporting
-- Detailed report on UPSs, battery age, etc.
Mass Configuration
-- Configure Settings, Shutdown, and Email parameters for all UPSs at once
© 2007 APC-MGE corporation.
General for PCBE 7.0 for Unix
Specific Feature
 Innovative features
Power Analysis Graph (Deluxe only)
-- Automatically generates a report summarizing power event history
Recommended actions
-- When power events occur, administrator is presented
with a recommended course of action
Optional web-based interface
-- Included with all OS versions, for remote management
In addition, the Windows console can manage all Operating System
Versions of PCBE over the network.
Silent Install (Deluxe only)
-- it’s only for Linux with RPM format.
Note : The above-mentioned features are provided by the combination of
PCBE Agent / Server / Console.
© 2007 APC-MGE corporation.
General for PCBE 7.0 for Unix
Specific Feature
 PCBE for UNIX is provided Agent only
-- It is managed by PCBE Server / Console like PCBE Agent for Windows OS.
PCBE Server /Console is provided for Windows OS only.
PCBE Agent: Provides UPS status monitoring and, in the event of an
extended power outage, system shutdown capabilities for
UPS-protected computers.
 Running Command File in response to power events
 Event Notification ( E-Mail or SMS,Wall Broad-Cast Message )
© 2007 APC-MGE corporation.
General for PCBE 7.0 for Unix
Specific Feature
Supported Environmental Monitors
The PowerChute Business Edition Agent can manage and report on the status of the Environmental Monitoring Card
(AP9612TH).
The monitor must be firmware revision S or later.
Higher Level Power Events
Feature will indicate when power problems are occurring for a particular agent in a graphical manner.
Old Power Event Analysis will now be called Power Event Summary.
Graph types will include a weekly view, daily view, and specific day of the week (Sundays, Mondays, Tuesdays, etc.).
Will have the ability to chart all events, or individual ones.
Risk assessment summary
Feature will provide a server-level report of power problems to assess a customer's current risk level.
Agents out of range will be displayed when list is expanded, and double-clicking on the agent will take you to the properties
panel.
© 2007 APC-MGE corporation.
Prepare installation environment
Supported OS
Currently:
- Turbo Linux 7.0/8.0
- SuSE Linux 8.0/8.1/8.2
- Red Flag Linux 4.0
- Red Hat Linux 7.1/7.2/7.3/8.0/9.0
- Solaris 8.0/9.0 for Sparc
© 2007 APC-MGE corporation.
Prepare installation environment
Requirement of Environment
The Operating System must have:
- X-Windows with resolution of 800x600 or above
- RS-232 Serial Port
© 2007 APC-MGE corporation.
Prepare installation
environment
Supported UPS
Back-UPS
Back-UPS Pro
Smart-UPS
Matrix-UPS
2-Port Interface Expander Card
Share UPS 8-Port Interface Expander
© 2007 APC-MGE corporation.
Prepare installation
environment
UPS connection cable
type
Smart-Signaling
: 940-0024C
Simple-Signaling : 940-0020B
Note : 940-0023A Cable is not used on PCBE for UNIX
© 2007 APC-MGE corporation.
Installation Routine
 Before the installation
-- Connect the correct cable to Serial Port and UPS
-- Installation of PCBE Agent need X-Windows.
This installer is GUI based only.
-- Check the below parameter.
PCBE User Name / Password
UPS Model
Serial Port Name for PCBE Agent
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
 Step1
-- Login as “root” user
Otherwise, Change to root user using “su” command.
# su
Password: xxxxxxxxxx [ Enter root user Password ]
-- Mount CD-ROM ( CD-ROM User only )
Solaris : Auto Mount CD-ROM
Otherwise, Execute “volcheck” command manually.
# volcheck
Linux
: Execute “mount” command manually
# mount –r /dev/cdrom /mnt/cdrom
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
 Step2
-- Change the current directory to the installation file directory you
mounted in Step1.
In the case of Download File, Change the current directory to the place
you copied the installation file.
# cd /mnt/cdrom/Redhat Linux
# pwd
/mnt/cdrom/Redhat Linux
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
 Step4
-- Start GUI Installer.
Solaris : # ./pbe_agent_solaris_jvm.bin
Linux
: # ./pbe_agent_linux_jvm.bin
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
 Step5
-- After this, execute the installation according to directions of an installer.
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
-- Agree Software License.
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
-- Display Read me file.
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
-- Enter the installation directory.
Default : /opt/APC/PowerChuteBusinessEdition/Agent
Note : In the case of RPM installation, this screen is not displayed.
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
-- Execute UPS automatic detection
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
-- Complete UPS automatic detection
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
-- Enter the User information ( User Name / Password )
Note : PCBE Server and Agent must use the same Username / Password.
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
-- Confirm the setting of PCBE Agent
Note : In the case of RPM installation, this screen is not displayed.
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
-- Start files copy and setting process
Note : In the case of RPM installation, this screen is not displayed.
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
-- The installation completed
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
 Step6
-- Check PCBE Agent Daemon.
© 2007 APC-MGE corporation.
Install the PCBE Agent in Unix
 Step7
-- Check the files of PCBE Agent directory
© 2007 APC-MGE corporation.
Install PCBE 7.0 Agent for Linux with RPM format
Step 1: Execute the RPM command
#rpm -ivh /mnt/cdrom/Linux/pbeagent-xxx.i386.rpm
...where xxx is the version of the product.
Notes:This installs PowerChute Business Edition to the default directory,
/opt/APC/PowerchuteBusinessEdition/Agent.
This rpm also supports the --prefix option to allow you to specify the destination directory.
For example,
# rpm -ivh /mnt/cdrom/Linux/pbeagent-xxx.i386.rpm --prefix /PCBE_Agent
...would install the PowerChute Business Edition Agent to the /PCBE_Agent directory.
© 2007 APC-MGE corporation.
Install PCBE 7.0 Agent for Linux with RPM package
Step 2: Config the log information and UPS type
# <pcbe_agent_directory>/config.sh
Or,
#./config.sh user=<user name> pass=<password> signal=<smart|simple|share> port=<serial port filename> [start]
For example,
#./config.sh user=apc pass=apc signal=smart port=/dev/ttyS1 start
© 2007 APC-MGE corporation.
Configuration List
American Power Conversion
PowerChute Business Edition Agent Configuration Utility
New Username
>apc
New Password
>apc
Confirm New Password
>apc
Select the Signal Type
[1]:Smart
[2]:Simple
>1
Select the Serial Port
[1]:/dev/ttyS0
[2]:/dev/ttyS1
[3]:Other
>2
Signal Type:Smart
Share Ups:No
Serial Port:/dev/ttyS1
Are the UPS settings correct?(Yes or No)
>Yes
Start PowerChute Business Edition Agent?(Yes or No)
>Yes
Starting PowerChute Business Edition Agent ......
PowerChute Business Edition Agent started.
© 2007 APC-MGE corporation.
Un-install PCBE 7.0 Agent for Linux with RPM format
Execute the below command:
#rpm -e pbeagent
© 2007 APC-MGE corporation.
Start or stop the PCBE Agent Daemon
• Starting the PowerChute Business Edition Agent
Linux: #/etc/init.d/PBEAgent start
Solaris: #<pcbe_agent_directory>/bin/startup start
• Stopping the PowerChute Business Edition Agent
Linux: #/etc/init.d/PBEAgent stop
Solaris: #<pcbe_agent_directory>/bin/startup stop
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 If PCBE Agent for UNIX is managed by PCBE Server,
the configuration is executed by PCBE Console like PCBE Agent
for Windows OS.
 The configuration item on PCBE Console, it is same to
PCBE Agent for Windows OS.
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 PCBE Agent for UNIX on PCBE Console
This means OS
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 The setting item of PCBE Agent for UNIX on PCBE Console
It is same to PCBE Agent
for Windows OS.
Mass Configuration function
can be used.
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 If PCBE Agent for UNIX is not managed by PCBE Server,
the configuration is executed by Web Interface.
-- Input the address : http://pcbe-agent-ipaddress:3052
 By using Web Interface, you can access to PCBE Agent without
the network.
Note : Java plug-in needs to be installed in Web Browser.
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Access to Web Interface
Input the address :
http://pcbe-agent-ipaddress:3052.
Input User Name / Password
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Top Page
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Web Interface Menu Item : Device Model Menu
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Web Interface Menu Item : Device Model Menu
-- System Status Summary
This screen summarizes the current device status and the environmental status,
as well as showing the contact information.
-- System Status
The System Status screen displays UPS System Parameters, Power Status and
Battery Status.
-- Configure
The UPS Configuration screen allows you to configure line settings and general settings
for your UPS.
-- Diagnostics
The Diagnostic Settings screen allows you to view the last diagnostic results, and
schedule and initiate diagnostics.
-- About UPS
The About UPS screen displays UPS Information / Contact Information
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Web Interface Menu Item : Event Menu
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Web Interface Menu Item : Event Menu
-- Logs
This screen lists the most recent UPS events and the date and time each event occurred
beginning with the most recent.
-- Actions
The Event Actions screen lists the events that can occur and separates them into three
categories - critical, warning, and informational. You can not change an event's configured
category. The listing also shows the actions configured for each event.
Actions
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Web Interface Menu Item : Event Menu
-- Recipients
The Event Recipients screen lists the addresses of the users configured to be notified
when an event occurs. You can configure users to receive either e-mail or broadcast
messages, or both.
-- Configure Log
The Event Log Configuration screen allows you to set a limit of how long data should be
maintained.
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Web Interface Menu Item : Data Log Menu
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Web Interface Menu Item : Data Log Menu
-- View Log
The View Log screen reports the most recent UPS data and the date and time the data was
sampled. The data reports are sorted by date, then time, with the most recent data appearing
at the top of the screen.
-- Configure Log
The Data Log Configuration screen allows you to configure the data log recording parameters
or create a custom view of the data log using the Filter Data Log View tool.
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Web Interface Menu Item : Protected System Menu
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Web Interface Menu Item : Protected System Menu
-- Shutdown Settings
This screen summarizes the parameters configured for shutdown and describes the steps of the
shutdown sequence. From this screen you can choose "Configure" to configure your shutdown
parameters.
Go to parameters configuration page.
© 2007 APC-MGE corporation.
Configuration the PCBE Agent
 Web Interface Menu Item : Protected System Menu
-- System Setting
Use the System Settings screen to configure the following:
Device Communication Port, SMTP E-mail Settings, Contact Information
-- Shutdown now
Use the Shutdown System Now screen to initiate the shutdown sequence,
resulting in a system shutdown, and control a system reboot.
-- About
Select About from the Protected System menu to display the name or IP address of the server
being monitored, and the operating system used by that server
© 2007 APC-MGE corporation.
Un-Installation Routine
 Before the un-installation
-- In the case of Solaris, Un-Installation of PCBE Agent need X-Windows.
This un-installer is GUI based only.
-- In the case of Linux ( bin file Format ), Use the same command for
the un-installation.
© 2007 APC-MGE corporation.
Un-Install the PCBE Agent in
Unix
 Step1
-- Login as “root” user
Otherwise, Change to root user using “su” command.
# su
Password: xxxxxxxxxx [ Enter root user Password ]
© 2007 APC-MGE corporation.
Un-Install the PCBE Agent in
Unix
 Step2
-- Start Un-Install in GUI
# cd /opt/APC/PowerChuteBusinessEdition/Agent
# pwd
/opt/APC/PowerChuteBusinessEdition/Agent
# ./uninstallPowerChuteBusinessEditionAgent
© 2007 APC-MGE corporation.
Un-Install the PCBE Agent in
Unix
 Step3
-- Click “Yes” button on the dialog box.
© 2007 APC-MGE corporation.
Un-Install the PCBE Agent in
Unix
 Step4
-- Start Un-Install Process.
© 2007 APC-MGE corporation.
Un-Install the PCBE Agent in
Unix
 Step5
-- The un-installation completed.
© 2007 APC-MGE corporation.
Troubleshooting for PCBE
Agent
 No Communication with UPS/"No Server"
-- Step1 : Check the cable type.
Make sure that the serial cable that came with the UPS is attached between the UPS
and the system serial port. It is NOT a standard RS-232 cable.
The required cable depends on the UPS model - please refer to the table below.
After the proper cable is attached stop and restart the PCBE Agent Daemon.
If the system is still unable to communicate proceed to the next step.
© 2007 APC-MGE corporation.
Troubleshooting for PCBE
Agent
 No Communication with UPS/"No Server“
-- Step2 : Stop and start the Agent in Linux.
The agent process may not be running... you can start and stop it with the following.
Stop Operation :
# /etc/init.d/PBEAgent stop
Start Operation :
# /etc/init.d/PBEAgent start
© 2007 APC-MGE corporation.
Troubleshooting for PCBE Agent
 No Communication with UPS/"No Server“
-- Step2 : Stop and start the Agent in Solaris.
The agent process may not be running... you can start and stop it with the following.
Stop Operation :
# cd <pcbe_agent_directory>
# ./bin/startup stop
Start Operation :
# cd <pcbe_agent_directory>
# ./bin/startup start
© 2007 APC-MGE corporation.
Troubleshooting for PCBE
Agent
 No Communication with UPS/"No Server"
-- Step3 : Check port setting.
In the case of Solaris ( SPARC BOX ), the following setup may be necessities.
This setting is executed using admintool.
# admintool &
For Smart-Signaling : Template
Terminal Hardwired
Baud Rate
2400
Port Service
Disabled
For Simple-Signaling : Template
Modem Dial-Out Only
Baud Rate
2400
Port Service
Disabled
© 2007 APC-MGE corporation.
Troubleshooting for PCBE
Agent
 No Communication with UPS/"No Server"
-- Step4 : Use the different port.
Change the system to a different port on the server.
You will need to check the setting of Communication Port, and system port setup.
Web Interface --- [ Protected System ] – System Setting
© 2007 APC-MGE corporation.
Troubleshooting for PCBE
Agent
 TCP Port number for PCBE
If the PCBE is used in the network with Firewall, it is necessary to let
the following TCP Port pass.
-- From PCBE Server To PCBE Agent
: TCP#2161
-- From PCBE Agent To PCBE Server
: UDP#2161
-- From Web Browser To PCBE Agent
: TCP#3052
From PCBE Console To PCBE Agent
( Only when referring to Event / Data Log )
-- From PCBE Console To PCBE Server
© 2007 APC-MGE corporation.
: TCP#2260
Troubleshooting for PCBE
Agent
 Installation to the server without X-Windows
If the computer with X-Windows is in somewhere on the same network,
you may be able to install the server without X-Windows.
< Example Operation >
-- Step1 : Login to the server with X-Windows, and start Terminal.
-- Step2 : Permit using this X-Windows from other servers.
# xhost +
-- Step3 : Using Telnet, access to the server without X-Windows.
# Telnet without_x_server_ipaddress
-- Step4 : Set up the environment on the server without X-Windows.
# DISPLAY=with_x_server_ipaddress:0.0
# export DISPLAY
-- Step5 : Execute the installer
# cd /tmp/pcbefile
# ./pbe_agent_solaris_jvm.bin
-- Step6 : Display the GUI installer for the server without X-Windows
on the server with X-Windows.
© 2007 APC-MGE corporation.
Troubleshooting for PCBE Agent
Password of 3-16 characters is required for
PowerChute Business Edition
During the installation of PCBE, when prompted to select user name and password, the
error message "Password of 3-16 characters is required".
This issue occurs when the screen resolution is less than 800 x600 and the confirm
password box is not visible. This error can occur on all Operating Systems with this screen
resolution.
There are two ways to resolve.
The customer may use the TAB key once to insert the cursor into the confirm password text
box that remains offscreen. The customer should then hit the 'next' button to continue with
the installation.
The second option would be to change the screen resolution and try installing the software
again.
© 2007 APC-MGE corporation.