Multilink User Manual
Multilink User Manual
TABLE OF CONTENTS
1.0
1.1
2.0
2.1 2.2 2.3 2.4
3.0
3.1
3.2 3.3
4.0
4.1 4.2 4.3
5.0
5.1
5.2
Reviewing Settings and Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Checking Permissions for Multiple Users, if Needed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Starting the MultiLink Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
6.0
6.1 6.2 6.3 6.4 6.5
7.0
7.1 7.2
8.0
8.1
8.2 8.3
8.4
ConfiguringConfigure Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
8.4.1 8.4.2 8.4.3 8.4.4 8.4.5 8.4.6 8.4.7 8.4.8 8.4.9 8.4.10 8.4.11 8.4.12 8.4.13 8.4.14 8.4.15
8.5
ii
9.0
9.1 9.2
9.3
LIEBERT MULTILINK RESPONSE TO UPS EVENTSTYPICAL SEQUENCE . . . . . . . . . . . . . . 81 UNINSTALLING LIEBERT MULTILINK FROM YOUR SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . 84 LIEBERT SOFTWARE PROGRAM LICENSE AGREEMENT. . . . . . . . . . . . . . . . . . . . . . . . . . . .85
Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
A.1.1 A.1.2 A.1.3 A.1.4 Platform-Specific Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notes on Running Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 88 89 90
A.2 A.3
VMware Server ShutdownLiebert MultiLink Advanced for Windows Only . . . . . . . . . 91 Oracle Solaris. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
A.3.1 A.3.2 A.3.3 A.3.4 Platform-Specific Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notes on Running Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Platform-Specific Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notes on Running Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 95 95 96 97 97 97 98
A.4
OpenSolaris x86 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
A.4.1 A.4.2 A.4.3 A.4.4
A.5
Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
A.5.1 A.5.2 A.5.3 A.5.4 Platform-Specific Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Notes on Running Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Uninstalling Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Platform-Specific Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notes on Running Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Platform-Specific Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notes on Running Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling Liebert MultiLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 101 102 102 103 103 104 104
A.6
A.7
APPENDIX C - TECHNICAL INFORMATION & FREQUENTLY ASKED QUESTIONS . . . . . . . . . . . . . . . 107 APPENDIX D - LIST OF EVENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
D.1 D.2 Events for Local Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Events for UPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
FIGURES
Figure 1 Figure 2 Figure 3 Figure 4 Direct cable connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 UPS connected by cable to one computer on network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 UPS with SNMP card on network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Serial Port Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
TABLES
Table 1 Table 2 Table 3 Table 4 Table 5 Table 6 Table 7 Table 8 Table 9 Table 10 Table 11 Table 12 Table 13 Table 14 Table 15 Table 16 Table 17 Table 18 Communications Method by UPS Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Setting up a connection - during or after installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Features Available by Connection Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Viewer Tabs - Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Viewer Menu Options - Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Status icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Viewer Tabs - Checking the UPS Status and Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Viewer Menu and Tab Options - Configuring the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Sample data log file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Actions Available for Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Serial Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Contact Closure Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Events from Event Configuration tab with My Event Actions selected . . . . . . . . . . . . . . . . . . . 108 Events from Event Configuration tab with UPS selected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Cables to Connect UPS and Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Liebert MultiLink Software on CD-ROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Liebert MultiLink Network Shutdown Licenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Liebert MultiLink Network Administration License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
iv
LIEBERT MULTILINK
How Do You Contact Emerson for Technical Support?
For help on deciding how to set up Liebert MultiLink or any other monitoring product, contact Emersons Software Technical Applications Support Center at:
UNITED STATES FRANCE GERMANY ITALY NETHERLANDS UNITED KINGDOM EUROPE ASIA WORLDWIDE 1 800 222 5877 +33 (0) 1 46 87 51 52 +49 (0) 89 99 19 220 +39 (0) 2 98250 324 +31 (0) 475 503333 +44 1628403200 +800 11554499 +800 11554499 1 614 841 6755 FAX: 1 614 841 5471 All Products: http://www.liebert.com Liebert MultiLink: http://multilink.liebert.com E-mail: [email protected]
Liebert MutiLink
1.0
1.1
Typical sequence
Liebert MultiLinks responses to a power loss depend on the version of the software, its configuration by the user, installation of any upgrade licenses and the type of connection between the host computer and the UPS. Following is a simplified version of how Liebert MultiLink Advanced might respond to a utility power failure. Utility power fails, and the UPS begins powering the computer network. The UPS senses the power loss, triggering Liebert MultiLink to activate timers and issue notifications that utility power has been interrupted. If the timers expire before utility power is returned, Liebert MultiLink can prompt an operating system shutdown, preventing the loss of valuable data as well as damage to computers from a precipitous loss of power. Depending on configuration by the user, Liebert MultiLink will respond automatically to this UPS event by sending pop-up notifications, e-mails and pager messages, running command-line options, performing an orderly shutdown and keeping a log of all events. When utility power is restored, the UPS prompts Liebert MultiLink to cancel the timers and notify targeted computers of the return to normal status.
Liebert MutiLink
2.0
2.1
Configurations
The application can monitor virtually any configuration (see examples in Figures 1 through 3): Any individual computer with a single Liebert UPS Any single network with multiple computers and one or more Liebert UPS units Interconnected networks with computers powered by one or more Liebert UPS units
2.2
Connections
Liebert MultiLink works with any of these connections to a Liebert UPS: Serial port on your computer (using contact closure or serial communications) USB port on your computer SNMP card on a network or interconnected networks A single computer connected by any of those methods can be networked to other computers and, with license upgrades, configured to monitor UPSs connected to those computers. Liebert MultiLink can monitor UPS units over a network that includes any combination of LANs, WANs and any other type of network. Liebert MultiLink can notify targeted client computers of On Battery and Low Battery events for coordinated shutdown of the operating system.
2.3
Platforms
Liebert MultiLink functions on multiple platforms. Visit the Liebert MultiLink Web site at http://multilink.liebert.com for a list of currently supported platforms.
2.4
Multiple Languages
Users may choose a language for the text displayed in all dialog boxes associated with the Liebert MultiLink service and Viewer, including Liebert MultiLinks notifications. Supported languages include: English (U.S.) French (Canada) Spanish Chinese (Simplified) Japanese
Liebert MutiLink
3.0
3.1
3.1.1
3.1.2
Contact Closure
Contact Closure communications provide basic functions only, supporting these UPS-related events: UPS Operating On Battery Low Battery UPS Returned From Battery (Normal) For these events, these actions are available: sending pop-up notifications, performing orderly shutdowns and keeping a log of all events. (With Liebert MultiLink Advanced, all actions are available, including e-mail and pager messages and running command-line options.)
Liebert MutiLink
3.1.3 3.1.4
Contact Closure No No
USB No No No No No No No
* Available when UPS is equipped with SNMP card, such as Intellislot SNMP/Web card
Liebert MutiLink
3.2
Visit the Web site or contact your local Emerson representative, value-added reseller, or distributor for information. This manualdownloadable from the Liebert MultiLink Web site:
http://multilink.liebert.com
A Liebert UPS linked to a computer. For requirements specific to various operating systems, see the Liebert MultiLink Web site, http://multilink.liebert.com, or Appendix A - Operating System Details. A communications link between the UPS and the computer, depending on the type of connection:
Connection Type Link Between UPS and Computer (Same as Serial Communications) A special serial cableavailable from Liebert or built with instructions in Appendix B - Making Your Own Liebert MultiLink UPS Cable of this manual An available serial port on the computer protected by the UPS (see Appendix C - Technical Information & Frequently Asked Questions) A USB cable with a Type A connector on one end (to connect to the computer) and a Type B connector on the other (to connect to the UPS) An available USB portor an adapter from the computers serial port to the Type A connector end of the USB cableon the computer protected by the UPS (Same as Contact Closure) A special serial cableavailable from Liebert or built with instructions in Appendix B - Making Your Own Liebert MultiLink UPS Cable of this manual An available serial port on the computer protected by the UPS (see Appendix C - Technical Information & Frequently Asked Questions) Ethernet, Internet or Intranet, utilizing SNMP protocol and IP addresses
Contact Closure
With an SNMP card in the UPS, an available IP porteither 161 and 162 or Liebert-reserved ports 3027 and 3029depending on your operating system and configuration (see Appendix C - Technical Information & Frequently Asked Questions). TCP/IP connectivity throughout the network, if the UPS is equipped with an SNMP card or if Liebert MultiLink will monitor or communicate with more than one UPS or computer.
Liebert MutiLink
3.3
Advanced Features
Liebert MultiLink comes in two versions: Fundamental (shipped with your UPS) and Advanced (upgrade). Liebert MultiLink Fundamental allows you to monitor equipment and configure automated shutdown. Liebert MultiLink Advanced expands your control and monitoring capabilities by adding E-mail, Virtual Server Shutdown and Paging notification of events, Command Execution prior to shutdown and Data Logging for trending. To obtain this upgrade on CD-ROM (part number MLADV), contact your local Emerson representative or distributor. Advanced features are covered in this manual and identified as such. To determine your version of Liebert MultiLink: Start the Viewer. Click on Help in the menu at the top of the window, then on About.
Liebert MultiLink Fundamental Liebert MultiLink Advanced
Liebert MutiLink
4.0
4.1
Cable Connection
Figure 1 shows the simplest possible Liebert MultiLink installation. The software can be configured to monitor the UPS, and, if utility power fails or another problem arises, can notify the computer (MultiLink Agent) and personnel about the problem. In the event of a serious power problem, Liebert MultiLink can be configured to prompt the shutdown of the MultiLink Agents operating system.
Figure 1
Connection to computers serial port (for Contact Closure or Serial UPS) or USB port (USB Device)
MultiLink Agent
UPS
Figure 2 shows the same type of direct cable connection to a computer (MultiLink Agent) on a network. With a contact closure, USB or serial connection, Liebert MultiLink can send notifications to all computers (MultiLink Clients) on a network. (These computers must be running Liebert MultiLink.) With a Liebert MultiLink Network Shutdown License installed on the MultiLink Agent computer, the software can send notifications to the MultiLink Client computers when needed. Figure 2 UPS connected by cable to one computer on network
The MultiLink Agent computer is monitoring the UPS through a serial or USB port connection. Liebert MultiLink can send notifications to any computer on this network. This configuration requires a MultiLink Network Shutdown License. Any computer configured as a targeted client must be running Liebert MultiLink.
MultiLink Agent
UPS
MultiLink Client
MultiLink Client
MultiLink Client
MultiLink Client
Connection to computers serial port (for Contact Closure or Serial UPS) or USB port (USB Device)
Ethernet
Liebert MutiLink
4.2
SNMP Connection
Figure 3 shows examples of two Liebert MultiLink configuration options for a UPS with an SNMP connection. The SNMP card installed in the UPS can be monitored by up to 20 MultiLink Agent computers, or it can notify up to 20 MultiLink Client computers for automated shutdown. (These computers must be running Liebert MultiLink.) With the proper Liebert MultiLink Network Shutdown License installed, MultiLink Agent computers can forward On Battery and Low Battery traps received from the SNMP card to MultiLink Clients being powered by the UPS.
Figure 3
MultiLink Client
Ethernet
MultiLink Client
The UPS is connected to computers over an Ethernet network via an SNMP card.
MultiLink Client
MultiLink Agent
Ethernet
This configuration requires a MultiLink Network Shutdown License. Any computer configured as a targeted shutdown client must be running Liebert MultiLink.
Liebert MutiLink
4.3
Virtual Servers
Liebert MultiLink Advanced can be configured to initiate a graceful shutdown of VMware ESXi Hypervisor servers. Such systems consist of a computer and guest operating systems, known as a virtual server. See below.
Virtual Server
A UPS should be powering the virtual servers and a Windows system. Liebert MultiLink Advanced will be installed on the Windows system monitoring the UPS for events. If an event occurs, then Liebert MultiLink Advanced can execute an action to shut down the virtual servers. See below for a typical system layout. For details, refer to A.2 VMware Server ShutdownLiebert MultiLink Advanced for Windows Only.
10
Liebert MutiLink
5.0
5.1
5.1.1
5.1.2
Multiple Installations
For identical installation on multiple computers, the System Administrator may install Liebert MultiLink on one computer, configure that computer and use those settings for subsequent installation on other computers. Identical installations require that the computers use the same operating system as the original installation and the same version of Liebert MultiLink. 1. Install Liebert MultiLink on one computer as described in 5.2 - Beginning the Installation, then follow these steps before subsequent installations: a. Make a copy of the Liebert MultiLink distribution in a common location that is accessible to System Administrators who intend to install Liebert MultiLink on similar computers. b. In that common location, create a subdirectory where you will place the configuration files from the initial installation. This new subdirectory can have any name, but using the name site_cfg simplifies subsequent installations by allowing automatic detection of the configuration files. c. Copy the configuration files (in the cfg subdirectory) from the initial installation into the subdirectory created in Step b. 2. Proceed with the second and subsequent installations as described in 5.2 - Beginning the Installation, starting each installation from the common location described in Step a above.
11
Liebert MutiLink
5.1.3
Table 2
Step (Section) Connection type (Section 5.2.2) Source type (Section 5.2.3) Connection type (Section 5.2.2) Source type (Section 5.2.4) Connection type (Section 5.2.2) Source type (Section 5.2.3) Connection type (Section 5.2.2) Source type (Section 5.2.5)
CONTACT CLOSURE - Monitor a UPS connected to this computer by a contact closure cable
USB CABLE - Monitor a UPS connected to this computer by a USB cable Choose USB port on computer [computer name]. (No choice required) Choose USB Device in Device Type box. (No choice required)
SERIAL UPS - Monitor a UPS connected to this computer by a serial cable Choose Serial port on computer [computer name]. Specify name of serial port. Choose Serial UPS in Device Type box. Specify port in Serial Port box.
UPS WITH SNMP CARD - Monitor an SNMP-equipped UPS connected to the same network Choose Network to an SNMP UPS or MultiLink on another computer Host & client computers must use same ports. Choose SNMP source if host computer uses standard ports (161/162) OR Choose Custom if host computer does NOT use standard ports (161/162) Choose Network to an SNMP UPS or MultiLink on another computer Host & client computers must use same ports. Choose MultiLink source if host computer uses standard ports (3027/3029) OR Choose Custom if host computer does NOT use standard ports (3027/3029) Choose SNMPv1 Device in Device Type box. Host & client computers must use same ports. Choose 161 in Request Send Port box; choose 162 in Trap Listen Port box. OR Specify ports in Request Send Port and Trap Listen Port boxes. Choose MultiLink Basic Notification Source in Device Type box. Host & client computers must use same ports. Choose 3027 in Request Send Port box; choose 3029 in Trap Listen Port box. OR Specify ports in Request Send Port and Trap Listen Port boxes.
MULTILINK BASIC NOTIFICATION SOURCE* - Set up a client computer to receive notifications over a network Connection type (Section 5.2.2) Source type (Section 5.2.5)
* Note: After designating a client computer as a MultiLink Basic Notification Source, add the client computer to the host computers list of targets (8.3.6 - Properties - Clients Tab)
12
Liebert MutiLink
5.2
Subsequent Installations
For subsequent installations, choose Use the site-specific configuration files at (subdirectory created in Step b in 5.1.2 - Multiple Installations), as shown below. The text box must display the full path where the configuration files were placedcfg or another directory as specified by the System Administrator. The subdirectory can be entered manually or it can be found by using the Browse button.
13
Liebert MutiLink
5.2.1
Upgrade or Reinstallation
If you are upgrading or reinstalling Liebert MultiLink, the existing version is detected and Liebert MultiLink will incorporate your existing configuration files into the new installation, bypassing some steps required for an initial installation. Click the Next button and go to 5.2.6 - Restrict or Allow Access to Configuration Settings.
14
Liebert MutiLink
5.2.2
15
Liebert MutiLink
5.2.3
For further information, see serial port information for your operating system in Appendix A - Operating System Details. NOTE Make sure that the specified port is a serial port on the computer, not on a terminal expander. For a Contact Closure UPS, this port must support the modem control lines shown in Table 12 in Appendix B - Making Your Own Liebert MultiLink UPS Cable. For a serial connection UPS, see Table 11. If the UPS and computer are not yet linked by a cable or if the UPS uses Contact Closure connection, a message window prompts you for the type of connection to be used. Refer to 3.1 - Connecting host computer, UPS and targeted clients before making a selection. The two types of connections are: Contact-closure communicationsfor UPS models, see Table 1 Serial communicationsfor UPS models, see Table 1 Each type requires a custom cable. These cables can be made or purchased. To make a cable, see Appendix B - Making Your Own Liebert MultiLink UPS Cable. To buy a cable, see Appendix E - Ordering Parts.
16
Liebert MutiLink
5.2.4
If the UPS and computer are not yet linked by a cable, a message window presents two options: Click Back to return to the previous window. There you may select a different method of connection or connect the USB cable so the device will be detected. Click Next to continue installing the software without the device being detected. If you choose this option, you may add the device in the Viewer (see 8.3.3 - Properties - Setup Tab).
17
Liebert MutiLink
5.2.5
Choose: To do this: SNMP source Specify that this computer uses a network to monitor a UPS equipped with an SNMP card. Choose this option if the host computer uses standard SNMP ports 161 and 162; if other ports are used, choose Custom instead.
MultiLink Designate a client computer as a MultiLink Basic Notification Source. source The client computer uses a network to receive notifications from Liebert MultiLink on a host computer configured to monitor the UPS that is powering the network. Choose this option if the host computer uses standard ports 3027 and 3029; if other ports are used, choose Custom instead. Custom Specify this computer as an SNMP source or a MultiLink source but with customized options. To choose options that are not standard, such as choosing different ports: Click on the Setup button after choosing Custom. This opens the Device Setup window, shown at right. For details on these setup options, see 8.3.3 - Properties - Setup Tab.
Notes For network connections, the host computer and client computers must use the same portseither 161 and 162 or Emerson-reserved ports 3027 and 3029. For details on how to change the ports after installation, see 8.3.3 - Properties - Setup Tab. After designating a client computer as a MultiLink Basic Notification Source, it must be added to the host computers list of targets, as described in 8.3.6 Properties - Clients Tab.
18
Liebert MutiLink
5.2.6
5.3
5.4
5.5
19
Liebert MutiLink
6.0
20
Liebert MutiLink
6.1
Table 3
USB No No No No No No
Bypass Group Input Group Hardware Info Group Other Group Alarm Group DiagnosticsTest Battery Output ControlTurn UPS Output Off/On UPS Audible AlarmSilence UPS Operating On Battery Low Battery UPS Output Returned From Battery Other Events Notify E-mail (Advanced**) Page (Advanced**) Shutdown Command (Advanced**) Log Virtual Server (Advanced**) Silence Alarm (Advanced**)
Monitoring Device Events (Event Configuration tab with My Event Actions [or monitoring device] selected)
System Shutdown Commencing UPS Monitor Software Started UPS Monitor Software Stopped
* Some but not all Liebert UPS units support Turn UPS Output Off with Contact Closure connection. ** Available only in Liebert MultiLink Advanced. For purchase information, see Appendix E - Ordering Parts.
21
Liebert MutiLink
6.2
Viewer Tabs
The Viewer window has two parts. The left side displays the MultiLink Network as a navigation tree, and the right side shows information about any selected item in the tree. The Viewers three tabsOverview, Event Configuration and Event Logprovide different views of the tree at left. The information at right varies according to the item in the tree that is selected.
Tabs Information for selected item
The Overview tab has two functions: to view the UPS status and to configure the UPS. The Event Configuration tab allows you to set up responses to individual events and test configuration by simulating an event. The Event Log tab displays a list of the most recent UPS events. Table 4 shows where to find detailed information about each of the Viewers tabs. Table 4
Tab Overview
You may also use a Web browser to view the status of any UPS equipped with a Web-enabled SNMP card. For these devices, the Web browser permits some configuration and testing.
22
Liebert MutiLink
6.3
Viewer Menus
The Viewer also has functions available from three menus: MultiLink, Configure and Help. Each menu has a drop-down list of options that apply to all device components and events.
Menus Menu options
Table 5 summarizes the options available in the Viewer menus and shows where to learn more about each. Table 5 Viewer Menu Options - Summary
Menu Option Save Event Configuration MultiLink Service Exit Edit My Device List Edit Network Device List Address Book Paging Services E-Mail Services Virtual Servers Modem Specify Web Browser Function Save changes to Event Actions Start & stop Liebert MultiLink service Quit the Viewer Add, delete or alter the configuration of a UPS Add, delete or alter another Liebert MultiLink installation Set up addresses for e-mails and paging Set up paging service providers Set up e-mail service providers Set up virtual servers operating within a computer running Liebert MultiLink Set up the modem
For more information, see: 8.1.1 - MultiLink Menu - Save Event Configuration 8.1.2 - MultiLink Menu - Service and 9.1 - Starting or Stopping Liebert MultiLink Service 8.1.3 - MultiLink Menu - Exit 8.4.3 - Configure Menu - Edit My Device List 8.4.4 - Configure Menu - Edit Network Device List 8.4.6 - Configure Menu - Address Book (Liebert MultiLink Advanced Only) 8.4.7 - Configure Menu - Paging Services (Liebert MultiLink Advanced Only) 8.4.8 - Configure Menu - E-Mail Services (Liebert MultiLink Advanced Only) 8.4.9 - Configure Menu - Virtual Servers (Liebert MultiLink Advanced Only) 8.4.10 - Configure Menu - Modem (Liebert MultiLink Advanced Only) 8.4.11 - Configure Menu - Specify Web Browser 8.4.12 - Configure Menu - Options 8.4.13 - Configure Menu - Set Language 8.4.14 - Configure Menu - Local Password 8.4.15 - Configure Menu - Upgrade License
Configure
Help
Choose a Web browser for viewing UPS data Specify some notification and Options shutdown options Select a language for the Viewer Set Language and Liebert MultiLink Service Local Set password for access from Password another Liebert MultiLink installation Upgrade License Install an upgrade license About Check Liebert MultiLink version
6.4
Notifications
When Liebert MultiLink is running, various types of notifications may appear as pop-up or console messages. With Liebert MultiLink Advanced, notifications may also be sent as e-mail or pager messages to selected users. The timing, content and recipients of these notifications are specified for each UPS-related event during configuration (see 8.5 - ConfiguringEvent Configuration tab).
6.5
Status Icons
Liebert MultiLink employs graphics to illustrate the status of configured devices, including whether they are operating normally or experiencing any alarms. The icons shown in Table 6 appear in popup notifications and in the MultiLink Viewer: Table 6 Status icons
Icon Description No problems Informational Impaired Critical Liebert MutiLink
23
7.0
24
Liebert MutiLink
7.1
In the example above, the left side of the window shows the MultiLink Network tree with either an SNMP or serial connection. Limited group information is available with a Contact Closure connection. To expand or collapse a folder, click on the symbol to the left of the folder icon. The lower right corner of the Viewer displays the icon representing the most serious condition existing in the tree. Except when conditions are normal for all monitored devices, the top of the tree also displays the icon denoting the most serious condition. When the navigation tree is expanded, Liebert MultiLink displays the icon at each level (see 6.5 - Status Icons for a legend to interpret the icons).
25
Liebert MutiLink
To view graphs and parametric data, click on an item in the left side of the window; the associated data appears on the right. It may take a few moments for Liebert MultiLink to collect the data. These views do not apply to Contact Closure connections.
View data for selected item
Graphs
This example shows information for the Battery group, the item selected in the tree at left. Each portion of the MultiLink Network tree displays similar data. To close the Viewer, click on MultiLink, then on Exit.
7.1.1
26
Liebert MutiLink
7.2
Event Log tab MultiLink menu (to exit) Refresh button updates view of log file
Clicking on My Event Actions displays a log of events from the device designated as your event source. Logs of events pertaining to other Liebert MultiLink installations are available under the Network Event Actions portion of the tree. To display a list of configured actions that occurred as the result of an event, select the event in the list and click on the Show Actions button. (The button is grayed-out if no actions occurred.) Click on the Close button to return to the Viewer.
27
Liebert MutiLink
8.0
The Viewer offers powerful options for configuring how Liebert MultiLink responds to UPS-related events and notifies computer users of events and pending actions, such as an operating system shutdown. This section details the following functions available through the Viewer to customize Liebert MultiLinks features for your system. Table 8 Viewer Menu and Tab Options - Configuring the Software
Function Save changes to event actions Start or stop Liebert MultiLink service Exit the Viewer Rename a UPS Test battery; turn UPS output on or off; temporarily silence an alarm Enable alerts; change UPS connection type or communication ports; change status polling rate Set up Web access for a UPS Change UPS settings: enable audible alarm, battery testing and auto restart Add MultiLink Network Shutdown Clients Configure data logging features Add a local UPS Add a network MultiLink installation Enter pager and e-mail recipients in address book (Liebert MultiLink Advanced) Add pager service providers (Liebert MultiLink Advanced) Add e-mail service providers (Liebert MultiLink Advanced) Virtual Servers (Liebert MultiLink Advanced) Enable and configure modem (Liebert MultiLink Advanced) Specify a Web browser to view UPS status Change notification and shutdown options Select a language for the MultiLink Service and Viewer Change password or permission for remote configuration Install an upgrade license Set up responses to UPS-related events Simulate a UPS-related event to test configuration Temporarily disable a UPS-related event Temporarily disable an event Action MultiLink menu Access Method For information, see: 8.1.1 - MultiLink Menu - Save Event Configuration 8.1.2 - MultiLink Menu - Service 8.1.3 - MultiLink Menu - Exit
Right-click on UPS for 8.2 - Renaming a UPS Properties (Overview tab) Right-click on UPS for UPS 8.3.2 - Review the UPS Control Options Control (Overview tab) 8.3.3 - Properties - Setup Tab Right-click on UPS for Properties (Overview tab) 8.3.4 - Properties - Web Tab 8.3.5 - Properties - UPS Settings Tab 8.3.6 - Properties - Clients Tab 8.3.7 - Properties - Data Logging Tab (Liebert MultiLink Advanced Only) 8.4.3 - Configure Menu - Edit My Device List 8.4.4 - Configure Menu - Edit Network Device List 8.4.6 - Configure Menu - Address Book (Liebert MultiLink Advanced Only) 8.4.7 - Configure Menu - Paging Services (Liebert MultiLink Advanced Only) 8.4.8 - Configure Menu - E-Mail Services (Liebert MultiLink Advanced Only) 8.4.9 - Configure Menu - Virtual Servers (Liebert MultiLink Advanced Only) 8.4.10 - Configure Menu - Modem (Liebert MultiLink Advanced Only) 8.4.11 - Configure Menu - Specify Web Browser 8.4.12 - Configure Menu - Options 8.4.13 - Configure Menu - Set Language 8.4.14 - Configure Menu - Local Password Event Configuration tab Right-click on event for Test Event (Event Configuration tab) Right-click on event for Disable (Event Configuration tab) Right-click on Action for Disable (Event Configuration tab) 8.4.15 - Configure Menu - Upgrade License 8.5 - ConfiguringEvent Configuration tab 8.6 - Testing Responses to Events 8.7 - Disabling and Re-Enabling an Event 8.8 - Disabling and Re-Enabling an Action
Configure menu
(Each section of this chapter begins with opening the MultiLink Viewer. For help on opening the Viewer, see the information for your platform in Appendix A - Operating System Details.)
28 Liebert MutiLink
8.1
8.1.1
8.1.2
8.1.3
29
Liebert MutiLink
8.2
Renaming a UPS
A UPS can be renamed, assisting in troubleshooting when there is more than one UPS on the network. Click on the Overview tab. On the left side of the window, right-click on the UPS to be renamed and choose Properties from the pop-up menu. In the Properties window, click on the Setup tab and enter a descriptive name in the Device Name box. In the Description field, enter any notes about the UPS, such as its location, model and similar information.
Right-click to display pop-up menu . . . . . . then click on Properties . . .
. . . and description.
For more information on the Setup tab in the Properties window, see 8.3.3 - Properties - Setup Tab.
30
Liebert MutiLink
8.3
8.3.1
Start Browser
For UPS devices with Web-enabled SNMP cards, Liebert MultiLink permits viewing UPS data with a Web browser. The Web browser also offers access to some other features, such as UPS control options, battery testing and configuring some UPS functions. Before you can use the Web browser function, you must specify the Web browser to use (see 8.4.11 Configure Menu - Specify Web Browser) and you must enable Web access for this UPS (see 8.3.4 - Properties - Web Tab). To start the Web browser: Click on the Overview tab. Right-click on the UPS device name to open a pop-up menu, then click on Start Browser. This opens the Web browser chosen in dialog box, as shown below.
31
Liebert MutiLink
8.3.2
To view the UPS Control options: Click on the Overview tab. Right-click on the UPS device name to open a pop-up menu, then click on UPS Control. This opens the UPS Control dialog box, as shown below.
For details on using the UPS Control options, see 9.2 - Using the UPS Control OptionsSerial Connection and SNMP. UPS models requiring Contact Closure connections offer only one option: Turn UPS Output Off. For further information, see 9.3 - Using the UPS ControlContact Closure.
32
Liebert MutiLink
8.3.3
Overview tab Right-click to display pop-up menu . . . . . . then click on Properties . . . Serial UPS Connection . . . then click on the Setup tab. USB Connection SNMP Connection
Use the check box to designate this device as your event source.
The Device Type box displays the type of connection between the computer and the UPS: Contact Closurefor example, MultiLink Agent computer in Figures 1 and 2 USB DeviceMultiLink Agent computer in Figures 1 and 2 Serial UPSMultiLink Agent computer in Figures 1 and 2 SNMPv1 DeviceMultiLink Agent computer in Figure 3 MultiLink Basic Notification SourceMultiLink Client computer in Figure 3 See 3.1 - Connecting host computer, UPS and targeted clients. The software detects the type of connection by sensing the type of UPS and cable connected to the computer. The Device Name box displays a name for the UPS. This name can be changed by entering a new name in the box. The Enable Actions check box allows you to designate which UPS in the My Device List subfolder is to act as the source of events for the host computer. There can be only one event source for each Liebert MultiLink installation. For details, see 8.4.2 - Liebert MultiLink Event Source.
33
Liebert MutiLink
The Type-specific properties options relate to communications between the UPS and the host computer. These properties vary by connection type; values are automatically detected by Liebert MultiLink. The defaults are correct for most installations, but some may be altered if necessary.
USB Device
The Type-specific properties box does not provide choices for USB connections.
SNMP connections
For SNMP connections (for example, MultiLink Agent computer in Figure 3), you will see these Type-specific properties: Hostname or IP addressidentifies the UPS SNMP Community Stringthe default is LiebertEM (case-sensitive) Trap Listen Portusually port 162 (Standard SNMP trap port) for communicating events (traps) because of SNMP card requirements Request Send Portusually port 161 (Standard SNMP request port) for communicating status (gets) because of SNMP card requirements Status RateDetermines how often Liebert MultiLink checks the condition of the UPS.
34
Liebert MutiLink
8.3.4
Place a check mark () in the Enable Web access box to allow users to use the Web browser for this UPS. Enter the IP address of the UPS in the URL box, if needed.
35
Liebert MutiLink
8.3.5
SNMP Connection
In the Contact box (SNMP connection), enter the name of the person who should be contacted about issues involving this UPS. In the Location box, enter the physical location of the UPS, for example, Georges cubicle. This optional field is helpful if the user has more than one UPS. (Certain UPS models only) To allow activation of an alarm when a UPS-related event occurs, click in the Enable UPS Audible Alarm box. To deactivate the alarm, clear the check box. This operation prevents the UPS from sounding an audible alarm for any condition. To silence the alarm while an event is occurring, see 9.2.3 - UPS Audible AlarmSilencing Alarm. (Certain UPS models only) To perform periodic battery tests (Serial UPS), click in the Enable Automatic Battery Test box. To disable automatic testing, clear the check box. (Certain UPS models only) To automatically restart the UPS after utility power is restored following a loss of input power, place a check mark () in the Enable Autorestart check box, then specify the desired time delay in the Autorestart Delay box. To disable automatic restarting, clear the check box.
36 Liebert MutiLink
8.3.6
The values in the MultiLink Request Status Port box relate to communications between the host computer and targeted client computers. The default port, 3027, is correct for most applications. Contact Emerson Network Power Technical Support for assistance. Ensure that all MultiLink Network Shutdown Clients are configured to request status from the host computer on the port specified in the MultiLink Request Status Port box. The host computer must be running Liebert MultiLink 4.x or 3.x, and all clients must be running Liebert MultiLink 4.x, 3.x or 1.x. Check to make sure the entry in the SNMP Community String box matches that in your other systems. The default is LiebertEM (case-sensitive).
37
Liebert MutiLink
The targeted clients Hostname or IP address must be correctly entered in the Client Hostname or IP Address box. Each client must have Liebert MultiLink 4.x, 3.x or 1.x installed and must be configured to listen for traps on the port that is configured in the Event Trap Port box. Both the host and client computers must use the same pair of ports for traps and requestsfor example, both must use ports 162 and 161 or both must use ports 3029 and 3027. Check to make sure the entry in the SNMP Community String box matches that in your other systems. The default is LiebertEM (case-sensitive). To remove a client from the list, click on the client, then on Delete. Liebert MultiLink will not ask for confirmation before deleting the selected client. Click on Cancel to close the window without saving the changes.
38
Liebert MutiLink
Error message
If any messages are not sent, an error message will appear on the host computer. The error message, above right, indicates that the entry in Client Hostname or IP Address is an invalid IP address or is a hostname that cannot be resolved. The selected computer probably is not configured in the Domain Name Service. If it is configured with its associated reverse lookup entry, there might be a problem accessing the name service. Try to ping the name server and correct any problems there. If no problems are found at the server, check the configuration at the client end. b. Check all targeted client computers to verify that each received a test message similar to the one shown below.
This message should appear within five seconds of being sent. If it does not, compare the time it is displayed with the time on the message. If the lapse is more than 10 seconds, there is a local name service problem. If the message is received within five seconds, the local name service configuration is correct. If test messages are received in a timely fashion and the entry was a hostname, DNS or other name services are correctly configured.
39
Liebert MutiLink
8.3.7
To select UPS parameters that will be checked and recorded in the data log file, click on an item in the Available window, then click on the arrow to move that item to the Selected window. More than one item can be moved at one time by using standard methods common to your operating system. Liebert MultiLink will record data about any parameter selected for logging. The Interval box displays the number of minutes between Liebert MultiLinks checks of the UPS. The Records box displays the number of records that will be stored in the data log file. The Historical files box displays the number of data log files that will be retained. Liebert MultiLink creates a file in the location specified in the File Logging portion of the Data Logging tab. The data log is a comma-delimited file that will open with a word-processing or spreadsheet program. Table 9 below shows an example of data collected. Table 9
Time 10/6/2012 13:45 10/6/2012 14:00 10/6/2012 14:15 10/6/2012 14:30 10/6/2012 14:45 10/6/2012 15:00
40
Liebert MutiLink
8.4
ConfiguringConfigure Menu
The Configure menu is integral to setting up Liebert MultiLinks response to various UPS-related events. The Configure menu allows you to add and delete UPSs for monitoring, set up the modem, edit your password and install an upgrade license.
8.4.1
8.4.2
41
Liebert MutiLink
8.4.3
Click on Configure, then on Edit My Device List. . . . . . to view any UPS in your local device list . . .
Add a UPS
In the Edit My Device List window, choose Add if you wish to include another UPS as a locally known device. This window contains the same options as the Setup tab in the Properties window. Enter the UPS information according to the instructions in 8.3.3 - Properties - Setup Tab.
Delete a UPS
In the Edit My Device List window, select the UPS from the list, then click on Delete if you wish to remove a UPS from the My Device List subfolder. Liebert MultiLink will ask you to confirm that you wish to delete the UPS. Click on Yes to confirm the deletion.
42
Liebert MutiLink
8.4.4
The Edit Network Device List menu option allows you to add, change or remove a Liebert MultiLink installation. To do this: Click on Configure, then on Edit Network Device List.
Add, edit or delete a Liebert MultiLink installation as described in the following sections.
43
Liebert MutiLink
In the Hostname or IP address box, enter the host computers name or IP address. In the Password box, enter the Liebert MultiLink password for the computer that is being added to the Network Device List. This permits the System Administrator to access the network Liebert MultiLink installation. Checking the Save password box prevents a user from having to enter the password on each use.
If the computer hostname or IP address has changed, enter the new name or address in the Hostname or IP address box. If the Liebert MultiLink password has changed, enter the new password in the Password boxes. Checking the Save password box prevents a user from having to enter the password on each use.
8.4.5
44
Liebert MutiLink
8.4.6
In the Address Book window, click on Add. In the New Address window, choose Email Address from the drop-down list and click OK. This opens the Edit Address window, as shown below.
Enter the persons name in the Name box. If the Address Book already contains an entry for this person, you will be prompted to alter the entry. For ease in setting up e-mails, you could use the following designation or a variantSmith, Adam (e-mail) Enter the e-mail address in the Address box. Choose from the Service Provider drop-down list, or click on the New Provider button to enter a new service provider. Click OK.
45
Liebert MutiLink
In the Address Book window, click on Add. In the New Address window, choose Page Target from the drop-down list and click OK. This opens the Edit Address window, as shown below.
Enter the persons name and pager ID in the appropriate boxes. Select the type of pager (alphanumeric or numeric) from the Pager Type drop-down list. Choose from the Service Provider drop-down list, or click on the New Provider button to enter a new service provider. Click OK to save the changes or click Cancel to close the window without saving.
8.4.7
In the Paging Service Providers window, click on Add. In the New Service Provider window, choose the type of paging service from the Type drop-down menu, either Telocator Alphanumeric Protocol (TAP) for alphanumeric pagers or Numeric
46
Liebert MutiLink
Touch-Tone Connection for numeric pagers. An alphanumeric pager displays messages containing text and numerals; a numeric pager displays only numerals. Click OK. This opens the Edit Service Provider window, which varies by type of service.
For a numeric pager: Enter the service providers name in the Name box. The Connection Type box displays the choice of Type made in the preceding step. Enter the service providers phone number immediately followed by any touch-tone sequence such as a comma for a pauseto be delivered in the Provider Phone Number (if needed) box. Use this format for the phone number: 1 800-555-1212,,, (note commas for pauses). Do not use parentheses around the area code. Enter any commands required to initiate or complete the page in the appropriate boxes: Commands after Provider Phone Number (if needed), Commands after Pager Id (if needed) and Commands after Numeric Message (if needed). Check with the pager service provider to determine whether any commands are required. Click OK to save the changes or click Cancel to close the window without saving.
47
Liebert MutiLink
For an alphanumeric pager: Enter the service providers name in the Name box. The Connection Type box displays the choice of Type made in the preceding step. Enter the service providers phone number in the Phone Number box in this format: 1 800-555-1212. Do not use parentheses around the area code. Choose the appropriate parity/data bits setting from the Serial Port Settings drop-down menu. Enabling message truncation shortens messages through a particular provider to a specified length. In the Page Message Length box, place a check mark () in the Enable Message Truncation box and specify the maximum message length in the Characters box. Click OK to save the changes or click Cancel to close the window without saving.
8.4.8
In the Email Service Providers window, click on Add. In the Edit Service Provider window, enter the name of the service provider in the Name box. In the SMTP Server box, enter the name of the service providers mail server, for example: mail.domain.com The Return Address box must have an e-mail address for messages to be sent, for example, the e-mail address where the message originated. If identifying information is included in the Return Address, the e-mail address must be enclosed in angle brackets, for example: [email protected] OR Joe Smith<[email protected]> Click OK to save the changes or click Cancel to close the window without saving.
48 Liebert MutiLink
8.4.9
In the Virtual Servers window click on Add. In the Edit Virtual Servers Window that opens, enter the name of the virtual server in the Name box. In the Hostname or IP Address box, enter the hostname or the IP address of the virtual server being added. The Login Name box must have a user login for the virtual server that has root privilege. The Server Password and Confirm Password boxes should have the password of the user login in the Login Name box. The Guest Shutodwn Wait Time box defines the maximum amount of time the shutdown action will wait for all applications toclose before the shutdown will beinitiated. Individual system requirements may require extending this timer. Click OK to save the changes or click Cancel to close the window without saving.
49
Liebert MutiLink
To view a list of configured virtual servers or to change any of the configuration information, click on Configure, then on Virtual Servers. Select the virtual server to be updated and click Edit. Edit the information and click OK to save the changes or click Cancel to close the window without saving.
50
Liebert MutiLink
In the Modem Configuration window that opens, place a check mark () in the Modem Connected and Enabled boxthis is required to use the modem. Select the proper Modem Serial Port from the drop-down list. Enter the required information. a. If your telephone system requires dialing a particular digit, such as 9, to get an outside line, choose from the drop-down list in the External Line box or enter the number followed by a comma. b. If the line used by the modem has the call-waiting feature, choose from the drop-down list in the Disable Call Waiting box or enter the required code followed by a comma. c. Before Liebert MultiLink can find and utilize the modem, data must be entered in the Modem Control boxes. You may change the default values as needed. d. At any time, click on the Reset to Defaults button to revert to the factory defaults for this feature. e. Click OK to save the changes or click Cancel to close the window without saving.
51
Liebert MutiLink
By default, Liebert MultiLink will use the computers default browser, indicated by a check mark () in the Use Windows default browser box. To accept this, click OK. To use a different browser: Remove the check mark () from the Use Windows default browser box. Use the Browse button to locate the Web browser or enter the full path in the Web Browser text box. Enter any required information in the Command-line options (if needed) box. Click OK. To use the Web browser, you must also enable Web access for each UPS to be monitored. See 8.3.4 Properties - Web Tab for details.
52
Liebert MutiLink
Notification Options
By default, Liebert MultiLink pop-up messages are enabled, with no check mark () in the Disable all MultiLink pop-up windows box. To change this, place a check mark () in the box. The Countdown To Shutdown options are available only when Liebert MultiLink pop-up windows are enabled (the default). Place or remove check marks () to set the following options: Display countdown window - When this box is checked (the default), it permits display of the MultiLink Countdown to Shutdown window to alert users of an impending shutdown of the operating system. Enable Pause button - When this box is checked (the default), it activates the Pause Shutdown button on the MultiLink Countdown to Shutdown window. (The Pause Shutdown button permits the user to interrupt the countdown, freezing the timer with whatever unelapsed time remains. The shutdown can be resumed at the point the countdown was paused or it can be canceled.) Enable Cancel button - When this box is checked (the default), it activates the Cancel Shutdown button on the MultiLink Countdown to Shutdown window. (The Cancel Shutdown button permits the user to halt the countdown and prevent Liebert MultiLink from shutting down the operating system.)
Shutdown Options
By default, Liebert MultiLink is configured to power down the computer after an operating system shutdown. To change this setting, remove the check mark () from the Power down computer after shutdown box. This option is enabled only on platforms that support a choice of whether to power down the computer after an operating system shutdown.
53
Liebert MutiLink
Select an option from the Language Selection drop-down list, then click OK. The next time the Liebert MultiLink service and Viewer are restarted, all text in the MultiLink Viewer and in Liebert MultiLink notifications will appear in the selected language. A confirmation dialog box asks whether you wish to restart the Liebert MultiLink service and Viewer now. Click Yes to do so. (Or click No to return to the Viewer; the language will be changed the next time the Liebert MultiLink service and Viewer are started.)
54
Liebert MutiLink
Click on Configure, then on Local Password. In the Modify MultiLink Password window, enter the current password in the Old Password box. This enables the remaining options in the window. To prevent remote configuration changes, place a check mark () in the check box. Leaving the check box blank will permit configuration and monitoring from a remote location. To change the password, enter up to 32 alphanumeric characters in the New Password box. Enter the same password in the Confirm Password box.
55
Liebert MutiLink
Click on Configure, then on Upgrade License . . . . . . to view the Upgrade License options.
Click on the Install button to begin. A message box appears after successful installation.
After installing the license, configure the targeted MultiLink Clients as described in 8.3.6 Properties - Clients Tab. (Targeted clients must have Liebert MultiLink version 1.x or 3.x installed. If the targeted client is running version 3.x of the software, the Device Type for the event source must be MultiLink Basic Notification Source. Also, in the Hostname or IP address box of the targeted MultiLink Client computer, the hostname of the computer on which the MultiLink Network Shutdown License is installed must be specified. See 3.1 - Connecting host computer, UPS and targeted clients and 8.3.3 - Properties - Setup Tab).
56
Liebert MutiLink
8.5
8.5.1
A Contact Closure connection between the UPS and the computer supports only three events: UPS Operating On Battery, Low Battery, UPS Output Returned From Battery (Normal). See Appendix D - List of Events for a complete list of events for the Local Host (Table 13) and for the UPS (Table 14).
57
Liebert MutiLink
Types of Actions
The following Actions may be configured for any Event: Table 10 Actions Available for Configuration
Action Notify E-mail (Liebert MultiLink Advanced Only) Page (Liebert MultiLink Advanced Only) Shutdown Command (Liebert MultiLink Advanced Only) Log Virtual Server (Liebert MultiLink Advanced Only) Silence Alarm* (Liebert MultiLink Advanced Only) Description Broadcast messages (pop-up or console) about UPS-related events Send e-mail messages Send messages to targeted clients telephone pagers Shut down this computer Run commands Make records of UPS-related events and actions Shut down virtual servers Turn off a UPS warning alarm (such as for maintenance or repair) For details, see: 8.5.2 - Event Actions - Notify 8.5.3 - Event Actions - E-Mail (Liebert MultiLink Advanced Only) 8.5.4 - Event Actions - Page (Liebert MultiLink Advanced Only) 8.5.5 - Event Actions - Shutdown 8.5.6 - Event Actions - Command (Liebert MultiLink Advanced Only) 8.5.7 - Event Actions - Log 8.5.8 - Event Actions - Virtual Server (Liebert MultiLink Advanced Only) 8.5.9 - Event Actions - Silence Alarm (Liebert MultiLink Advanced Only)
58
Liebert MutiLink
Enable box
The example above shows how to enable a Notify Action for UPS Operating On Battery.
Configuration Steps
The following sections detail the options available for each Action. The Actions and Events available depend on the connection method and device type, but the steps are the same for all types.
59
Liebert MutiLink
8.5.2
Enable box
Check () the Enable Notify Action box. This is required for the action to operate. The Initial Delay displays the time lapse between an events occurrence and when the notification message is sent. The Repeat Count box shows how many times Liebert MultiLink will send a message at intervals specified in the Repeat Interval box. For example, to start sending a notification 15 seconds after the Event occurs and then every 30 seconds for a total of 5 times: Initial Delay = 15 sec Repeat Count = 5 Repeat Interval = 30 sec Default messages have been set up for all events. These messages state the type of event, the time it occurred, the device involved and a description of the event. To view a message as it will appear on users screens, click on the Preview button.
To alter a message, click on the Edit button and enter the desired text in the Message window, as shown below.
60
Liebert MutiLink
Buttons at the top of the Message window insert linked text that prompts Liebert MultiLink to describe the event. Text also may be typed into the Message window. To restore the default message at any time, click on Default. Checking the Include Advice box inserts text into the message that will advise computer users to begin taking certain actions. For example: Save your work and log out now as system shutdown will begin shortly. The UPS is running out of battery capacity and minimal battery backup runtime remains. The Local Notification option may send messages by pop-up or to the operating system console. These options vary by operating system. For information, see Appendix A - Operating System Details. The Broadcast Notification box allows you to specify message recipients as All Users or Specific Users. (This feature is not available on all operating systems; see Appendix A - Operating System Details.) To choose specific users to receive the message, click on Specific Users, then on Select to open the Broadcast Notification window.
In the Broadcast Notification window, click on the Add button to enter the Hostname or IP address of recipients. Once entered, a recipients Hostname or IP address can be changed by using the Edit button or removed by using the Delete button on the Broadcast Notification window. The Canceling Event will abort all actions initiated by Liebert MultiLink in response to the event being configured. See Table 14 for a list of Events with default canceling events. At any time, click on the Reset to Defaults button to revert to the factory defaults for this feature. To save settings, click on the MultiLink menu at the top of the window, then click on Save Event Configuration.
61
Liebert MutiLink
8.5.3
Enable box
To configure the E-mail action: Check () the Enable E-mail Action box. This is required for the action to operate. The Initial Delay displays the time lapse between an events occurrence and when the e-mail is sent. The Repeat Count box shows how many times Liebert MultiLink will send a particular e-mail at intervals specified in the Repeat Interval box. Check to make sure a subject is specified in the E-mail Subject box. By default, the subject is MultiLink Notification. This can be changed by entering a new subject. Default messages have been set up for all events. These e-mails state the type of event, the time it occurred, the device where it occurred and a description of the event. To view the text as it will appear in a recipients e-mail message, click on the Preview button. To alter a message, click on the Edit button and enter the desired text. Buttons at the top of the Message window insert linked text that prompts Liebert MultiLink to describe the event. Text also may be typed into the Message window. To restore the default message at any time, click on Default. Checking the Include Advice box inserts text into the message that will advise computer users to begin taking certain actions. For example: Save your work and log out now as system shutdown will begin shortly. The UPS is running out of battery capacity and minimal battery backup runtime remains.
62
Liebert MutiLink
The message will be sent to all e-mail addresses in the Recipients box. Addresses may be added, altered or deleted by using the Add, Edit and Delete buttons as appropriate. a. To Add an e-mail address to the recipients list: 1. Click on the Add buttonthis opens the Edit Address List window.
Click on arrow (<) to remove an address from the E-mail Recipients list for this Event
2. Select an address on the left side of the window by clicking on itthis highlights the address. 3. Use the arrow (>) between the windows to move the name to the E-mail Recipients window at right. 4. Click on Closethe new address appears in the Recipients box. (New e-mail addresses can be added to the Address Book from this window by clicking on Add and entering the information as described above.) b. To Edit a recipients e-mail address: 1. Highlight the address in the Recipients box in the main window (Event Configuration tab with the E-mail action highlighted). 2. Click on the Edit buttonthis opens the Edit E-mail Address window, shown below.
3. Update the persons name and e-mail address as needed. 4. To update the persons service provider, choose from the Service Provider drop-down menu or click on the New Provider button to enter a new provider. 5. Click on OK. c. To Delete a recipient from the list: 1. Highlight the address in the Recipients box in the main window (Event Configuration tab with the E-mail action highlighted). 2. Click on the Delete button. The address is deleted from the e-mail recipients list. An alternate method of removing a recipient is to open the Edit Address List window, highlight the address to be removed from the recipients listing and click on the < arrow. The Edit E-mail Parameters button gives you access to an address book with e-mail addresses and service providers. For details, see: 8.4.6 - Configure Menu - Address Book (Liebert MultiLink Advanced Only) and 8.4.8 - Configure Menu - E-Mail Services (Liebert MultiLink Advanced Only). The Canceling Event will abort all actions initiated by Liebert MultiLink in response to the event being configured. See Table 14 for a list of Events with default canceling events. At any time, click on the Reset to Defaults button to revert to the factory defaults for this feature. To save settings, click on the MultiLink menu at the top of the window, then click on Save Event Configuration.
Liebert MutiLink
63
8.5.4
Enable box
To configure the Page action: Ensure the modem is configured. (See 8.4.10 - Configure Menu - Modem (Liebert MultiLink Advanced Only).) Check () the Enable Page Action box. This is required for the action to operate. The Initial Delay displays the time lapse in minutes and seconds between an events occurrence and when the paging function is activated. The Repeat Count box shows how many times Liebert MultiLink will send the page at intervals specified in minutes and seconds in the Repeat Interval box. The Message box allows you to specify the content of both types of messages: alphanumeric and numeric. The type of pager is set up for each pager address as alphanumeric or numeric paging see 8.4.7 - Configure Menu - Paging Services (Liebert MultiLink Advanced Only). To specify the content of messages in the Message box: a. Alphanumeric default messages have been set up for all events. The message displayed in the Alphanumeric box will be sent to all recipients set up for alphanumeric pagers. Note that some paging services limit the length of messages that can be sent. These messages state the type of event, the time it occurred, the device where it occurred and a description of the event. To view an alphanumeric message as it will appear on users pagers, click on the Preview button. To alter an alphanumeric message, click on the Edit button and enter the desired text. Buttons at the top of the Message window insert linked text that prompts Liebert MultiLink to describe the event. Text also may be typed into the Message window. To restore the default message at any time, click on Default. Checking the Include Advice box inserts text into the message that will advise computer users to begin taking certain actions. For example: Save your work and log out now as system shutdown will begin shortly. The UPS is running out of battery capacity and minimal battery backup runtime remains.
Liebert MutiLink
64
b. To enter a numeric message, enter the appropriate digits in the Numeric box. This message will be sent to all recipients set up for numeric pagers. The message will be sent to all pager addresses in the Recipients box. Addresses may be added, altered or deleted by using the Add, Edit and Delete buttons as appropriate. a. To Add a pager address to the recipients list for this Event: 1. Click on the Add buttonthis opens the Edit Address List window.
Click on arrow (<) to remove an address from the Pager Recipients list for this Event
2. Select an address from the Pager Addresses box on the left side of the window by clicking on itthis highlights the address. 3. Use the arrow (>) between the windows to move the name to the Pager Recipients box. 4. Click on Closethe new address appears in the Recipients box. b. To Edit a recipients pager address: 1. Highlight the address in the Recipients box in the main window (Event Configuration tab with the Page action highlighted). 2. Click on the Edit buttonthis opens the Edit Pager Address window, as shown at right. 3. Update the persons name and Pager ID as needed. The Pager ID is the unique method paging service providers use to connect to a pager. Some paging service providers use a unique phone number as the Pager ID; others use a common phone number and an identifying number. For services using a unique phone number, enter the pager-specific phone number in the Pager ID box and leave the Service Provider phone number blank. For services using a common phone number, enter the specific ID in the Pager ID box and the common phone number in the Service Provider configuration. 4. Choose the paging methodnumeric or alphanumericfrom the Pager Type drop-down menu. 5. To update the persons service provider, choose from the Service Provider drop-down menu or click on the New Provider button to enter a new provider. 6. Click on OK. c. To Delete a recipient from the list: 1. Highlight the address in the Recipients box in the main window (Event Configuration tab with the Page action highlighted). 2. Click on the Delete button. The address is deleted from the page Recipients box. An alternate method of removing a recipient is to open the Edit Address List window, highlight the address to be deleted from the recipients listing and click on the < arrow. The Edit Paging Parameters button gives you access to an address book with pager addresses and service providers. For details, see: 8.4.6 - Configure Menu - Address Book (Liebert MultiLink Advanced Only) and 8.4.8 - Configure Menu - E-Mail Services (Liebert MultiLink Advanced Only). The Canceling Event will abort all actions initiated by Liebert MultiLink in response to the event being configured. See Table 14 for a list of Events with default canceling events. At any time, click on the Reset to Defaults button to revert to the factory defaults for this feature. To save settings, click on the MultiLink menu at the top of the window, then click on Save Event Configuration.
65 Liebert MutiLink
8.5.5
Enable box
To configure the Shutdown action: Check () the Enable Shutdown Action box. This is required for the action to operate. In the Operating System Shutdown area, check the Enable box to permit Liebert MultiLink to perform an orderly shutdown of the operating system. Use the arrows in the Delay boxes to specify the time lapse between an events occurrence and when the shutdown begins. The System Administrator can use the UPS Output Off feature to set up Liebert MultiLink to shut down the UPS after shutting down the host computers operating system. This feature is available only on certain UPS models. (A special cable may be required to support this feature on Contact Closure connections.) To set up the UPS Output Off feature, click on the Enable box, Use the related Delay boxes to specify an additional delay (above and beyond the Operating System Shutdown delay) prior to turning off the UPS output. NOTE Because the Canceling Event does not halt the UPS Output Off portion of the Shutdown action, Emerson strongly advises against enabling the UPS Output Off action if the Operating System Shutdown action is not enabled. Enabling Auto reboot UPS output causes the UPS to restore power to the load (after a brief delay) after the output power has been turned off as a result of selecting the Enable check box. These features induce a controlled cycling of power to the critical load, eliminating the need to reset the UPS manually. This option is not available with Contact Closure. Note: Input power to the UPS must be present before UPS output power can be restored. If the output has been turned off during a utility outage, the UPS output power will not be turned on until the input utility is restored. The Canceling Event will abort all actions initiated by Liebert MultiLink in response to the event being configured, except UPS Output Off (see NOTE above). See Table 14 for a list of Events with default canceling events. At any time, click on the Reset to Defaults button to revert to the factory defaults for this feature. To save settings, click on the MultiLink menu at the top of the window, then click on Save Event Configuration.
66
Liebert MutiLink
8.5.6
Enable box
To configure the Command action: Check () the Enable Command Action box. This is required for the action to operate. Use the arrows in the Initial Delay boxes to specify the time lapse between an events occurrence and when the command is executed. In the Properties line, specify a command by either typing it in the Command box or by clicking on the Browse button and locating the appropriate file. In the Arguments box, enter any arguments required for the command to function properly. Once entered, arguments will remain in the Arguments box until deleted. If inappropriate arguments are displayed, be sure to delete them. The Canceling Event will abort all actions initiated by Liebert MultiLink in response to the event being configured. See Table 14 for a list of Events with default canceling events. At any time, click on the Reset to Defaults button to revert to the factory defaults for this feature. To save settings, click on the MultiLink menu at the top of the window, then click on Save Event Configuration.
67
Liebert MutiLink
8.5.7
Enable box
Send duplicate message to operating system log (not available on all platforms)
To configure the Log action: Check () the Enable Log Action box. This is required for the action to operate. Use the arrows in the Initial Delay boxes to specify the time lapse between an events occurrence and when the event log is created. The event logs file name with its full path appears in the Log File portion of the Properties section. The logs default file size is 1 MB and will hold thousands of records. On some platforms, Liebert MultiLink offers the option of sending duplicate log entries to the operating system log. (This feature is not available on all operating systems; see Appendix A - Operating System Details.) There is no canceling event for the Log action. At any time, click on the Reset to Defaults button to revert to the factory defaults for this feature. To save settings, click on the MultiLink menu at the top of the window, then click on Save Event Configuration. The log file, user.log, is a comma-delimited file (values are separated by commas). The files contents can be imported into an external application, such as a spreadsheet, database, text editor, or word processing program.
68
Liebert MutiLink
8.5.8
Enable box Delay to initiate shutdown of virtual servers (becomes active when action is enabled) List of virtual servers
To configure the Virtual Server action: Check the Enable Virtual Server Action box. This is required for the action to operate. In the Virtual Servers for Shutdown area, use the arrows in the Delay boxes to specify the interval between an events occurrence and the beginning of the shutdown. All configured virtual servers are listed. To edit this list, refer to 8.4.9 - Configure Menu Virtual Servers (Liebert MultiLink Advanced Only). At any time, click on the Reset to Defaults button to revert to the factory defaults for this feature. To save settings, click on the MultiLink menu at the top of the window, then click on Save Event Configuration.
69
Liebert MutiLink
8.5.9
Enable box
Check () the Enable Silence Alarm Action box. This is required for the action to operate. Use the arrows in the Initial Delay boxes to specify the time lapse between an events occurrence and when the Silence Alarm action occurs. There is no canceling event for the Silence Alarm action. At any time, click on the Reset to Defaults button to revert to the factory defaults for this feature. To save settings, click on the MultiLink menu at the top of the window, then click on Save Event Configuration.
70
Liebert MutiLink
8.6
For example, if you are testing the UPS Operating On Battery event, the following occurs: If the Notify action is enabled, the configured notification occurs on the host computer. If the Shutdown action is enabled, a shutdown timer begins. If this timer expires before you cancel the test, the operating system is shut down.
71
Liebert MutiLink
72
Liebert MutiLink
8.7
8.7.1
Disable an Event
To disable an event: Click on the Event Configuration tab. Right-click on the name of the event you want to disable. In the pop-up menu that appears, click on Disable. The event and all its actions are grayed-out.
Disable
73
Liebert MutiLink
8.7.2
Re-Enable an Event
To re-enable an event: Click on the Event Configuration tab. Right-click on the name of the event. In the pop-up menu that appears, click on Enable.
Enable
74
Liebert MutiLink
8.8
8.8.1
Disable an Action
To disable an action: Click on the Event Configuration tab. Right-click on the name of the action you want to disable. You must right-click at the top of the column. In the pop-up menu that appears, click on Disable. The action is grayed-out.
Disable
75
Liebert MutiLink
8.8.2
Re-Enable an Action
To re-enable an action: Click on the Event Configuration tab. Right-click on the name of the action. In the pop-up menu that appears, click on Enable.
Enable
NOTE For an action to be enabled, it must be available in your version of Liebert MultiLink. Liebert MultiLink Fundamental does NOT support these actions: Email, Page, Command, Virtual Server and Silence Alarm. The actions can be enabled only in Liebert MultiLink Advanced.
76
Liebert MutiLink
8.8.3
SCREEN SHOWS LIEBERT MULTILINK FUNDAMENTAL This message appears on mouse-over if an event is not available in your version of Liebert MultiLink
This message appears if you attempt to disable an event that is not available in your version of Liebert MultiLink
77
Liebert MutiLink
9.0
9.1
78
Liebert MutiLink
9.2
To use these options in the UPS Control dialog box: Click on the Overview tab. Right-click on the UPS device name to open a pop-up menu, then click on UPS Control.
9.2.1
9.2.2
! WARNING Turning the UPS output off is not recommended. All loads plugged into the UPS will
lose power within two (2) minutes. This may require a manual shutdown of your computer network. Before turning off the UPS output, Liebert MultiLink will ask for confirmation that you wish to do so.
To cycle the UPS output (i.e., turn UPS output power off, then return output power following a brief delay), click on the Turn UPS Output Off/On button in the UPS Control window. (To automatically restart the UPS after utility power is restored, use the Auto Restart boxsee 8.3.5 - Properties - UPS Settings Tab).
9.2.3
79
Liebert MutiLink
9.3
! WARNING Turning the UPS output off is not recommended. All loads plugged into the UPS will lose
power within two (2) minutes. This may require a manual shutdown of your computer network. To open the UPS Control dialog box and turn off the UPS output: Click on the Overview tab. Right-click on the UPS device name to open a pop-up menu, then click on UPS Control.
To turn off power to the critical load, click on the Turn UPS Output Off button.
80
Liebert MutiLink
81
Liebert MutiLink
2. If the Command action (available in Liebert MultiLink Advanced only) is enabled: A timer starts that may lead to executing a command that the user or System Administrator has written to perform site-specific operations for applications that have command-line options. If this timer expiresthe duration specified during configurationthe script is executed. To cancel the Command action manually, open the MultiLink Viewer, select the Event Configuration tab and remove the check mark () from the Enable Command Action box. Click on MultiLink, then on Save. 3. If the Shutdown action is enabled: A shutdown timer begins when UPS Operating On Battery occurs. The timers duration is specified during configuration. If this timer expires before the canceling event UPS Output Returned From Battery occurs, the operating system is shut down. Liebert MultiLink notifies the user that a shutdown is impending. When two minutes remain on the shutdown timer, the MultiLink Countdown to Shutdown box opens.
Timer . . .
. . . shows seconds remaining until operating system is shut down. Cancel Shutdown Pause Shutdown
Clicking on Cancel Shutdown overrides the configuration settings and prevents the operating system from being shut down. A dialog box asks for confirmation before the shutdown is canceled. Clicking on the Pause Shutdown button suspends the shutdown process, including the timer. A dialog box confirms that the shutdown is paused and offers the options of canceling the shutdown or resuming the countdown toward an orderly shutdown of the operating system.
82
Liebert MutiLink
Low Battery
The Low Battery event functions as a safety net, prompting an orderly shutdown of the operating system before power is lost. The Low Battery event will override a longer on-battery timer. Timers for this event typically are set for much shorter times than for other UPS-related events. When Liebert MultiLink detects a Low Battery event: 1. It displays a UPS Alert.
2. If the Command action (available in Liebert MultiLink Advanced only) is enabled: A timer starts that may lead to executing a command that the user or System Administrator has written to perform site-specific operations for applications that have command-line options. If this timer expiresthe duration specified during configurationthe script is executed. To cancel the Command action manually, open the MultiLink Viewer, select the Event Configuration tab and remove the check mark () from the Enable Command Action box. Click on MultiLink, then on Save. 3. If the Shutdown action is enabled: A shutdown timer begins when Low Battery occurs. The timers duration is specified during configuration. If this timer expires before the canceling event UPS Output Returned From Battery occurs, the operating system is shut down. Liebert MultiLink notifies the user that a shutdown is impending. When two minutes remain on the shutdown timer, the MultiLink Countdown to Shutdown box opens.
Timer . . .
. . . shows seconds remaining until operating system is shut down. Cancel Shutdown Pause Shutdown
Clicking on Cancel Shutdown overrides the configuration settings and prevents the operating system from being shut down. A dialog box asks for confirmation before the shutdown is canceled. Clicking on the Pause Shutdown button suspends the shutdown process, including the timer. A dialog box confirms that the shutdown is paused and offers the options of canceling the shutdown or resuming the countdown toward an orderly shutdown of the operating system.
83
Liebert MutiLink
84
Liebert MutiLink
THIS SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR INTENDED PURPOSE. LIEBERT DOES NOT WARRANT THAT THE SOFTWARE FUNCTIONS WILL MEET YOUR REQUIREMENTS OR THAT THE SOFTWARE WILL OPERATE UNINTERRUPTED OR ERROR FREE. LIMITATION OF REMEDIES/DAMAGES: (A) Liebert's entire liability and your exclusive remedy arising from use or inability to use the Software is: (1) The replacement of any distribution media not meeting Liebert's warranty, or (2) If Liebert is unable to provide you a replacement that conforms to Liebert's warranty, to refund the purchase price. (B) IN NO EVENT WILL LIEBERT BE LIABLE FOR ANY DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS, LOST REVENUE, LOSS OF USE, OR LOSS OF DATA OR OTHER INCIDENTAL OR CONSEQUENTIAL OR OTHER ECONOMIC DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF THESE DAMAGES. YOU ACKNOWLEDGE THAT THIS LICENSE REFLECTS THIS ALLOCATION OF RISK. U.S. GOVERNMENT RESTRICTED RIGHTS. This Software is developed at private expense and is provided with Restricted Rights. Use, duplication, or disclosure by the United States Government is subject to restrictions set forth in the Federal Acquisition Regulations and its Supplements. The manufacturer is Liebert Corporation, 1050 Dearborn Drive, Columbus, Ohio 43085. ASSIGNMENT: You may not sublicense, assign, or otherwise transfer this license of the Software without the prior written consent of Liebert. Any such transfer of rights, duties, or obligations is void. EXPORT RESTRICTIONS: You may not export the Software in violation of applicable export laws and regulations of the applicable countries. You agree to comply with all laws, regulations, decrees and orders of the United States of America that restrict the exportation (or re-exportation) of the Software to other countries, including, without limitation, the U.S. Export Administration Regulations. UPDATE POLICY: Liebert may create, from time to time, updated versions of the Software. Liebert reserves the right to make changes to or improvements in any aspect of the Software at any time without prior notice to you and without an obligation to supply such changed and/or improved Software to you. COMPLETE AGREEMENT/GOVERNING LAW/VENUE: This Software license agreement comprises the final and complete agreement between the parties. No person is authorized to change or modify this Agreement except an executive officer of Liebert Corporation and then only in writing. The laws of the United States and the State of Ohio shall apply to this Agreement and its interpretation without reference to choice or conflict of laws principles. Liebert and you hereby irrevocably submit to the personal and subject matter jurisdiction of any State of Ohio or federal court sitting in Columbus, Ohio, in any action or proceeding arising from or relating to this MultiLink Software License Agreement. MultiLink Software License revision January 10, 2003
86
Liebert MutiLink
Refer to: A.1 - Windows A.3 - Oracle Solaris A.4 - OpenSolaris x86 A.5 - Linux A.6 - Hewlett Packard HP-UX A.7 - IBM AIX
NOTE These requirements should be adequate for the simplest Liebert MultiLink installationa single workstation connected to a UPS by serial port connection (see Figure 1). More complex configurations may require additional processor speed, disk space or RAMespecially if you plan to use Liebert MultiLink on a network with multiple copies of Liebert MultiLink communicating with one another.
87
Liebert MultiLink
A.1
WINDOWS
In addition to the general requirements listed in 3.0 - What is Required to Use Liebert MultiLink?, prospective Liebert MultiLink users must also have these minimal requirements: Windows 7, XP, Vista, Server 2003 or Server 2008 x86/x86-64 processor Memory requirements 1 GB of RAMWindows 7, Windows Vista, Server 2008 512 MB of RAMServer 2003, XP Professional A display adapter configured for at least 256 colors A mouse or other pointing device TCP/IP network protocol
88
Liebert MultiLink
Appearance in window with status of Started shows Liebert MultiLink service is running
3. Execute the command by pressing the Enter key. 4. The screen will display the IP address. If the computer has more than one network adapter, the IP address will be the numbers associated with the active Network Interface Card.
89
Liebert MultiLink
Click the Uninstall button. A message asks you to confirm that you want to uninstall the software. Click Yes to begin removing the software. A message box appears when the process is completed. The uninstall process stops the Liebert MultiLink service and removes all Liebert MultiLink files from the hard drive.
90
Liebert MultiLink
A.2
Virtual Server
A UPS should be powering the virtual servers and a Windows system. Liebert MultiLink Advanced will be installed on the Windows system monitoring the UPS for events. If an event occurs, then Liebert MultiLink Advanced can execute an action to shut down the virtual servers. See below for a typical system layout.
System Requirements
MultiLink System Windows operating system supported by MultiLink Advanced version 4.2 or greater MultiLink Advanced 4.2 or greater installed on a separate physical machine other than a guest OS on a VMware server Microsoft Windows PowerShell v2.0 or later VMware vSphere PowerCLI v5.0 or later MultiLink communicating with the UPS PowerShell script must be set to as a trusted certificate Virtual Server VMware ESXi v4.1 or v5.0 Hypervisor server vSphere license (system) installed VMware tools installed on each guest OS Login to vSphere with root privilege
91
Liebert MultiLink
Install Liebert MultiLink Advanced 4.2 or greater on a computer - not on a guest operating system
2. Verify that Liebert MultiLink is communicating with the UPS. 3. On the Liebert MultiLink System, install Microsoft Windows PowerShell v2.0. This is a standard component in the Windows 7, Windows Server 2008 R2, and later operating systems although it is an optional feature that may need to be added to your machine. Computers running Windows XP and Vista may be upgraded by downloading and installing the Windows Management Framework. For more information on this, see http://support.microsoft.com/kb/968929. 4. Install VMware vSphere PowerCLI on the MultiLink computer. The PowerCLI distributions may be downloaded from the VMware Download Center. 5. On the Liebert MultiLink System, start a Windows PowerShell command window. A shortcut for this may be found at Start>Programs>Accessories>Windows PowerShell. a. Change the PowerShell script execution policy to RemoteSigned to permit running scripts on this machine. For security, Liebert has provided a signed script for this purpose so the execution policy may be set to something other than Restricted (the default). b. Run the following command in the Windows PowerShell command window: Set-ExecutionPolicy RemoteSigned c. For more information about this policy, use the Get-Help about_Signing command. 6. On each virtual server, configure a user who is a member of the root group for Liebert MultiLink to use for shutting down that server. You will later need to configure the same user name and password within Liebert MultiLink. 7. Each guest operating system that Liebert MultiLink should shut down should have the appropriate VMware Tools installed. If these are present, Liebert MultiLink will perform a normal shutdown of the guest OS on that VMware Server. If VMware Tools is not installed in a particular guest OS, Liebert MultiLink will perform a forced shutdown of that guest operating system.
92
Liebert MultiLink
8. In the MultiLink Viewer, under the Configure menu option, select Virtual Servers and then click Add to add virtual servers.
9.
Enter the following information for each virtual server that Liebert MultiLink will shut down: NameA descriptive name of the server TypeType of virtual server, for example, VMware Hostname or IP Address Login Namevirtual server user, must be a member of the root group in the VMware Server Server Password Guest Shutdown Wait TimeThis box sets the maximum amount of time the shutdown action will wait for all applications to close before the shutdown will be initiated. Individual system requirements may require extending this timer.
10. Repeat the Virtual Server configuration for each virtual server that Liebert MultiLink will shutdown (maximum of 10 servers).
93
Liebert MultiLink
12. Put a checkmark ()in Enable Virtual Server Action for each Event that a shutdown should be performed for.
Put a checkmark () in the Enable Virtual Server Action box for events that should cause a shutdown
Select the time for Liebert MultiLink to delay between an events occurrence and starting the shutdown of the virtual servers
13. Use the Virtual Servers for Shutdown Delay to set the time between an events occurence and when Liebert MultiLink begins shutting down the virtual servers. 14. Make sure the operating system shutdown delay for the shutdown event is set with enough of a delay to allow the shutdown of the guest operating systems of the virtual servers. 15. Save settings, click on the MultiLink menu at the top of the window, then click on Save Event Configuration. Finish any additional configurations in Liebert MultiLink. Schedule a time to place the UPS on battery and test the entire Liebert MultiLink system to verify the shutdown of the VMware servers.
94
Liebert MultiLink
A.3
ORACLE SOLARIS
In addition to the general requirements listed in 3.0 - What is Required to Use Liebert MultiLink?, prospective Liebert MultiLink users must also have these minimal requirements: Oracle Solaris version 9, 10 or 11 on an UltraSPARC processor Appropriate patches applied to operating system. For patches required to run Java 1.6, see: http://www.oracle.com/technetwork/server-storage/solaris11/downloads/index.html 100 MB of free disk space (during installation, the /tmp partition must have 150 MB free) 512 MB of RAM Common Desktop Environment or Oracle OpenWindows (X Window System) A mouse or other pointing device TCP/IP network protocol
This command lists the PMTAG and SVCTAG for each port. You will substitute the values of these tags in the following command:
pmadm -d -p {PMTAG} -s {SVCTAG}
3. If you are using an SNMP card, check for SNMP daemons. Execute the command ps -ef | grep -i snmp. If the processes snmpdx or snmpdm are running, they must be disabled before you can install Liebert MultiLink. If you are not using an SNMP hardware card with your UPS, then Liebert MultiLink can use its default port settings of 3029/3027, and there is no need to disable the SNMP daemons. 4. Make sure the Liebert MultiLink distribution file has execute permission (chmod +x <file>), then execute it. Alternate to /tmp during installation If you do not have enough disk space in the /tmp partition to meet the requirement specified in A.3.1 - Platform-Specific Requirements, you may specify an alternate location when starting the installation. For example, to use /home/tmp, start the install with the following command:
./ML_40_001_Solaris.bin /home/tmp
Post-Installation Notes
The Liebert MultiLink installation program places the script LiebertM in the /etc/init.d directory. It also creates K30LiebertM and S90LiebertM links in the /etc/rc1.d and /etc/rc2.d directories.
Note: The characters surrounding hostname are the grave accent (`) that is usually found on the same keyboard key as the tilde (~).
95 Liebert MultiLink
The result of this command will show your machine name. In this example, the machine name is frodo. Then run the following command:
more /etc/hosts
The result of this command will list one or more entries of IP address and name pairs. In this example: The IP address for machine name frodo is 10.0.0.10 The IP address for machine name bilbo is 10.0.0.11
96
Liebert MultiLink
A.4
OPENSOLARIS X86
In addition to the general requirements listed in 3.0 - What is Required to Use Liebert MultiLink?, prospective Liebert MultiLink users must also meet these minimal requirements: OpenSolaris version 10 on x86 processor Appropriate patches applied to operating system. Appropriate patches required to run Java 1.6.0_16. SUNWscp: http://pkg.opensolaris.org/release/en/search.shtml?token=whoami&action=Search To install it, execute the following command in command prompt: pfexec pkg install SUNWscp 100 MB of free disk space (during installation, the /tmp partition must have 150 MB free) 512 MB of RAM X Window System with Gnome desktop environment A mouse or other pointing device TCP/IP network protocol
Post-Installation Notes
The Liebert MultiLink installation program places the script LiebertM in the /etc/init.d directory. It also creates K30LiebertM and S90LiebertM links in the /etc/rc1.d and /etc/rc2.d directories.
97
Liebert MultiLink
98
Liebert MultiLink
A.5
LINUX
In addition to the general requirements listed in 3.0 - What is Required to Use Liebert MultiLink?, prospective Liebert MultiLink users must also have these minimal requirements: A Linux distribution with a version 2.6.27 or later kernel running on a x86 / x86_64 processor. Use uname r to determine the version of your kernel and note that, in most cases, this will be different from the version of your Linux distribution. The following packages of shared libraries, in 32-bit form, must be installed for Liebert MultiLink to run properly. glibc (usually /lib/libc.so.6), version 2.9 or later libstdc++ (usually /usr/lib/libstdc++.so.6), version 3.4 or later libXext (usually /usr/lib/libXext.so.6) libXi (usually /usr/lib/libXi.so.6) libXtst (usually /usr/lib/libXtst.so.6) A Linux distribution that manages services (daemons) using the System V method. This uses an init.d directory and several rc?.d directories located either in /etc/rc.d or just /etc (e.g., /etc/rc.d/init.d). 100 MB of free disk space (during installation, the /tmp partition must have 150 MB free) 512 MB of RAM for a 32-bit Linux, 1 GB of RAM for a 64-bit Linux X Window System with either the KDE or Gnome desktop environment A mouse or other pointing device TCP/IP network protocol Most recent popular Linux distributions meet these requirements. Liebert MultiLink has been tested on: Red Hat Enterprise Linux 6.3 SuSE Linux Enterprise 11 Liebert MultiLink has been tested with both KDE and Gnome desktop environments.
99
Liebert MultiLink
Post-Installation Notes
The Liebert MultiLink installation program places the script LiebertM in the /etc/rc.d/init.d (or /etc/init.d) directory. It also creates K30LiebertM and S90LiebertM links in several of the /etc/rc.d/rc?.d (or /etc/rc?.d) directories.
Note: the characters surrounding hostname are the grave accent (`) that is usually found on the same keyboard key as the tilde (~).
In the output from this command, you can see the machines IPv4 address following inet addr: within the section associated with you network interface (e.g., eth1).
Name Resolution
Liebert MultiLink must be able to resolve the computer's hostname to its IP address in order to function properly. This means that the computer must be properly configured for a DNS server or the file /etc/hosts contains an appropriate record for the hostname. If this is not done, the installation will fail with an Initialization Error.
100
Liebert MultiLink
A.6
3. If you are using an SNMP card, check for SNMP daemons. Execute the command ps -ef | grep -i snmp. If the processes snmpd or snmpdm are running, they must be disabled before you can install Liebert MultiLink. If you are not using an SNMP hardware card with your UPS, Liebert MultiLink can use its default port settings of 3029/3027, and there is no need to disable the SNMP daemons. 4. Make sure the Liebert MultiLink distribution file has execute permission (chmod +x <file>), then execute it. Alternate to /tmp during installation If you do not have enough disk space in the /tmp partition to meet the requirement specified in A.6.1 - Platform-Specific Requirements, you may specify an alternate location when starting the installation. For example, to use /home/tmp, start the install with the following command:
./ML_36_003_HP-UX.bin /home/tmp
Post-Installation Notes
The Liebert MultiLink installation program places the script LiebertM in the /sbin/init.d directory. It also creates K300LiebertM and S900LiebertM links in the /sbin/rc1.d and /sbin/rc2.d directories.
101
Liebert MultiLink
Note: The characters surrounding hostname are the grave accent (`) that is usually found on the same keyboard key as the tilde (~).
The result of this command will show your machine name. In this example, the machine name is frodo. Then run the following command:
more /etc/hosts
The result of this command will list one or more entries of IP address and name pairs. In this example: The IP address for machine name frodo is 10.0.0.10 The IP address for machine name bilbo is 10.0.0.11
102
Liebert MultiLink
A.7
IBM AIX
In addition to the general requirements listed in 3.0 - What is Required to Use Liebert MultiLink?, prospective Liebert MultiLink users must also have these minimal requirements: AIX 5.1 for RISC System/6000 Appropriate fixes applied to operating system For specific fixes that need to be installed to run Java 1.4.1 applications on AIX, see the Java 1.4.1 for AIX download area at: http://www-106.ibm.com/developerworks/java/jdk/index.html Common Desktop Environment (X Window System) TCP/IP network protocol 100 MB of free disk space on the partition where Liebert MultiLink will be installed (during installation, the /tmp directory must have 150 MB free) A mouse or other pointing device 512 MB of RAM
Post-Installation Notes
The Liebert MultiLink installation program places the script LiebertM in the /usr/sbin directory and modifies the /etc/rc.tcpip file to execute this script.
103
Liebert MultiLink
Note: The characters surrounding hostname are the grave accent (`) that is usually found on the same keyboard key as the tilde (~).
The result of this command will show your machine name. In this example, the machine name is frodo. Then run the following command:
more /etc/hosts
The result of this command will list one or more entries of IP address and name pairs. In this example: The IP address for machine name frodo is 10.0.0.10 The IP address for machine name bilbo is 10.0.0.11
104
Liebert MultiLink
B.1
B.2
INSTRUCTIONS
Follow these directions to build the cable: 1. Determine the connector your UPS needs Examine your UPS. Does it have a 9-socket or 25-socket connector? This connector should be a socket or pin connector and look similar to one of the diagrams below. You will need to obtain a corresponding pin or socket connector. The diagrams in Figure 4 - Serial Port Connectors will help determine the type of connector you have. The circles denote pins and the dots denote sockets.
Figure 4
14
25
DB9, pins
5 1 13
DB25, pins
1
25
14
DB9, sockets
DB25, sockets
2. Determine the connector your computer needs Examine your computer. Does it have a 9-pin or 25-pin connector? Is the connector a pin or socket type? (A pin connector has protruding pins; a socket connector has holes.) If the UPS has a socket connector, the cable connector must have pins and vice versa. The diagrams in Figure 4 - Serial Port Connectors will help determine the type of connector you have. The circles denote pins and the dots denote sockets. 3. Determine the length of the cable you need Measure the distance between the UPS and the computer. The cable must be long enough to reach each machines connector and to go around obstructions. Keep the cable as short as possible, preferably less than 25 feet. Do not lay the cable near electromagnetic interference sources such as AC power lines, fluorescent lights and induction motors.
105 Liebert MultiLink
4. Buy the parts The parts are available at most electronics stores or large computer stores as well as through mail-order companies. The following illustration shows some of the parts you may need.
5. Assemble the UPS and computer connectors Assemble the UPS and computer connectors according to the appropriate table belowa serial communication cable is connected according to Table 11; a contact closure communication cable is connected according to Table 12. The face of the connector has a number assigned to each hole or pin. Table 11 Serial Communication
UPS Interface Port DB9 SOCKETS Liebert NX Only 3 2 5 Hood Shield DB9 PINS All Other UPS Models 2 3 5 Hood Shield USE CABLE SHIELD Shield connected on one side only Comments DB9 SOCKET 2 3 5 Not connected Computer Interface Port
Table 12
DB25 16 17 11 9 7 19
NOTE Unlisted pins and sockets are not connected. The following picture shows a possible pin-wire insertion for a connector.
6. Assemble the connector housing and connect the cable to it 7. Connect the cable to the computer and UPS
106 Liebert MultiLink
107
Liebert MultiLink
List of Events
Critical
Informational
Impaired
108
Liebert MultiLink
List of Events
D.2
Table 14
Event
Events supported by all device types UPS Operating On Battery The UPS is discharging the battery to supply power to the load. The UPS has reached a Low Battery level. Time available to remain on battery is very short. The UPS has returned from an abnormal utility input condition. Impaired
Low Battery UPS Output Returned From Battery Weak Battery Condition (certain UPS models only)
Critical
Informational
The UPS has reported that the battery is in a weak condition (with utility present). This is a contact closure event only.
Impaired
Events not supported by contact closure The Liebert MultiLink software has established communications via the serial port. This could be from the starting of the service, or a reestablishment of communication after an interruption. An unexpected loss of communications with the UPS via the serial port. The Liebert MultiLink software has established communication with the UPS and is now monitoring status. This could be from the starting of the service, or a reestablishment of communication after an interruption. Please verify that Liebert MultiLink is correctly configured and that the physical connection between the computer (or server) and UPS is properly installed. If you need further assistance, please call Emerson Technical Support. The UPS is on bypass and will be unable to power your load in the event of a power failure. When a UPS experiences an internal failure, the load is switched to bypass as a protective measure. The UPS may have been manually switched to bypass by a user. If a nonuser initiated bypass condition occurred, you should investigate the condition of the UPS. The UPS battery is fully charged. You now have the maximum amount of battery runtime available for any future power outages. The battery capacity has fallen below a user-defined level. Depending on where this level is, you will want to take appropriate action such as saving your work and logging off. The Battery Capacity level notification is user configurable and can be modified in the Event Configuration tab in Liebert MultiLink. 109
Informational
Critical
Impaired
The UPS has reported that the battery is fully charged. User defined event. The battery capacity is equal to or fallen below the defined level. This event is enabled only when operating on battery.
Informational
Impaired
Liebert MultiLink
List of Events
Table 14
Event
Impaired
The temperature of the UPS internal components is operating above the normal temperature range.
Critical
The UPS has reported it is in boost mode. Boost mode is the correction of output voltage during low input utility conditions. The input voltage is higher than the nominal range of the UPS. The output voltage is higher than the nominal range of the UPS. The output voltage is lower than the nominal range of the UPS. The battery charger in the UPS has failed.
Informational
Input Voltage High Output Voltage High Output Voltage Low Battery Charger Failed
Informational
Impaired
Impaired
Critical
Output Overload
Critical
The bypass input power is out of the usable range in terms of frequency or voltage.
Impaired
The load has returned to within the output limits of the UPS.
Informational
The bypass input voltage has returned to a usable range in terms of frequency or voltage. The UPS has initiated a test of the battery system.
Informational
Informational
110
Liebert MultiLink
List of Events
Table 14
Event
Critical
The UPS has failed an internal diagnostic test. The UPS has performed a test of the connected battery and reported the result as passed. The UPS has performed an internal test and reported the result as passed. The UPS has determined that the battery needs to be replaced. The input frequency is out of the nominal range of the UPS. The output load has returned to the UPS from bypass and is now protected. The UPS output has returned from boost mode. Boost mode is the correction of output voltage during low input utility conditions. The UPS has reported it is in buck mode. Buck mode is the correction of output voltage during high input utility conditions. The UPS output has returned from buck mode. Buck mode is the correction of output voltage during high input utility conditions. The temperature of the UPS internal components has returned to a normal operating range. The input voltage has returned from high to the nominal operating range. The output voltage has returned from high to the nominal operating range of the UPS. The input frequency has returned to the nominal range of the UPS. UPS diagnostic test initiated.
Critical
Informational
UPS Diagnostic Test Passed Replace Battery Input Frequency Is Out Of Range UPS Output Returned From Bypass UPS Output Returned From Boost Mode
Informational
Critical
Informational
Informational
The utility voltage is within a normal range and the UPS is no longer operating on the boost circuit. To conserve battery power your UPS corrects an over voltage condition by using a buck circuit. If this over voltage condition is persistent and the UPS continually operates in buck mode, it may be indicative of a utility problem. The utility voltage is within a normal range and the UPS is no longer operating on the buck circuit.
Informational
Informational
UPS Output Returned From Buck Mode UPS Temperature Has Returned To A Normal Range Input Voltage Returned From High To Normal Range Output Voltage Returned From High To Normal Range Input Frequency Returned To Normal Range UPS Diagnostic Test Initiated
Informational
Informational
The utility voltage is now within a normal range and is supplying the UPS with adequate power. The output voltage has returned to the nominal operating range of the UPS and is supplying voltage that will properly support the load. The utility frequency is now within a normal range and can be utilized by the UPS. The UPS is performing a self-test of its electronics. The result will be issued shortly.
Informational
Informational
Informational Informational
111
Liebert MultiLink
List of Events
Table 14
Event
Ambient Overtemperature
Critical
Informational
Critical
Battery Module Failed Internal UPS Communication Loss Internal UPS Communication Restored
A battery module in the UPS is in a failed state and needs to be replaced. Communication between UPS internal components has failed. Communication between UPS internal components has been restored and is operating properly.
Critical
Critical
Informational
The UPS main control has failed and the unit is operating on redundant control.
Impaired
Impaired
The UPS load has receded below the maximum load setting. The UPS redundant control has failed and the unit is operating on main control.
Informational
Impaired
112
Liebert MultiLink
List of Events
Table 14
Event
The UPS in not operating in a redundant power module configuration based on the user-selectable redundancy setting.
Impaired
The UPS is now operating in a redundant power module configuration based on the user-selectable redundancy setting.
Informational
The temperature of the UPS internal transformer is operating above the normal temperature range.
Critical
The temperature of the UPS internal transformer has returned to operating in the normal temperature range.
Informational
Impaired
Battery Test Cannot Be Performed UPS Diagnostic Test Cannot Be Performed Output Voltage Returned From Low To Normal Range UPS Output is off
The battery diagnostic test cannot be performed either because it is inhibited or there is a system problem. The UPS diagnostic test cannot be performed either because it is inhibited or there is a system problem. The output voltage has returned from low to the nominal operating range of the UPS. The UPS output is off, the load is not supplied with power.
Informational
Informational
Informational
Critical
UPS Output is on
The UPS output has been turned on, the load is now supplied with power.
Informational
113
Liebert MultiLink
Ordering Parts
Table 16
Table 17
MLLKB MLLKC MLLKD
Part Number
MLLKG MLLKU
Table 18
MLLNA
Part Number
114
Liebert MultiLink
Locations
United States 1050 Dearborn Drive P.O. Box 29186 Columbus, OH 43229 Europe Via Leonardo Da Vinci 8 Zona Industriale Tognana 35028 Piove Di Sacco (PD) Italy +39 049 9719 111 Fax: +39 049 5841 257 Asia 29/F, The Orient Square Building F. Ortigas Jr. Road, Ortigas Center Pasig City 1605 Philippines +63 2 687 6615 Fax: +63 2 730 9572
While every precaution has been taken to ensure the accuracy and completeness of this literature, Liebert Corporation assumes no responsibility and disclaims all liability for damages resulting from use of this information or for any errors or omissions. 2014 Liebert Corporation All rights reserved throughout the world. Specifications subject to change without notice. Liebert is a registered trademark of Liebert Corporation. All names referred to are trademarks or registered trademarks of their respective owners.
SL-53625_REV4_01-14
www.EmersonNetworkPower.com