CS121 Series UPS Web/SNMP Manager Manual
CS121 Series UPS Web/SNMP Manager Manual
CS121 Series
The information contained in this manual is non-conditional and may be changed without due
notice. Although Generex has attempted to provide accurate information w ithin this document,
Generex assumes no responsibility for the accuracy of this information.
Generex shall not be liable for any indirect, special, consequential, or accidental damage
including, w ithout limitations, lost profits or revenues, costs of replacement goods, loss or
damage to data arising out of the use of this document
Generex the manufacturer of the BACS products undertakes no obligations with this
information. The products that are described in this brochure are given on the sole basis of
information to its channel partners for them to have a better understanding of the Generex
products.
Generex allows its channel partners to transfer information contained in this document to third
persons, either staff w ithin their own Company or their own customers, either electronically or
mechanically, or by photocopies or similar means. Generex states that the content must not be
altered or adapted in any way without written permission from Generex.
It is agreed that all rights, title and interest in the Generex’s trademarks or trade names
(whether or not regis tered) or goodwill from time to time of Generex or in any intellectual
property right including w ithout limitation any copyright, patents relating to the Products, shall
remain the exclusiv e property of Generex.
Generex w ill undertake to deal promptly w ith any complaints about the content of this
document. Comments or complaints about the document should be addressed to Generex
Systems GmbH.
2
Contents
English Manual 2
1. The CS121 family - Introduction 6
1.1 About your CS121 6
1.1.1 General information 6
1.1.2 Functionalities of your CS121 6
1.2 About the communication w ith the CS121-Adapter 8
1.3 The CS121 Adapter Package 8
1.4 Comparison 10
1.5 CS121 overview 11
1.6 A typical installation - CS121 in a network envir onment 13
1.7 Connect your CS121 ... 13
1.7.1 ... via serial port 13
1.7.2 ... via LAN 14
1.8 Verifying the CS121 connectivity 14
2. Quickstart 15
2.1 Setting up basic netw ork configuration 15
2.1.1 DHCP – Obtain an IP address automatically 16
2.1.2 Establishment of a static CS121 IP address manually (default delivery state)
16
2.1.3 Using HTTP/Webbrowser 16
2.1.4 Using Telnet / MS-HyperTerminal 18
[Link] Building up a connection 18
[Link] Main menu & IP-Settings 19
[Link] UPS Settings 20
[Link] Save configuration 21
2.2 Adapter-restart and boot procedure 21
2.3 Introduction in the event configuration 21
2.3.1 About same basic events 22
2.3.2 Quickguide to install an RCCMD-job 22
3. Configuration of the CS121 24
3.1 CS121 Status-Monitors 24
3.2 Configuration 25
3.2.1 UPS Model & System 25
3.2.2 Netw ork & Security 27
3.2.3 The CS121 w ith DHCP utilization 28
3.2.4 The CS121 w ith ICMP Check 29
3.2.5 Function hide of HTTP links 29
3.2.6 Configuration Static ARP Entries 30
3.2.7 Scheduled Actions 30
3.2.8 Email 32
3.2.9 Email Trap 33
3.2.10 Email Trap Configuration 34
3.2.11 Timeserver 35
3.2.12 Language 38
3.2.13 Events / Alarms 40
[Link] Treshold events 41
[Link] Logfile entries 42
[Link] Email-Job 42
[Link] Email-To-SMS 43
[Link] RCCMD Jobs 44
[Link].1 RCCMD Shutdow n 46
[Link].2 Automatic Reset of the Redundancy Alarm 50
[Link].3 RCCMD Execute/command 51
[Link].4 Example of use 1: CS121-adapter as RCCMD-listener 51
3
[Link].5 Example of use 2: CS121-adapter switches an output 52
[Link].6 RCCMD Trap 54
[Link] UPS shutdow n 54
[Link] AUX-Port 54
[Link] Wake on LAN (WOL) 55
3.2.14 Scheduled Actions 55
3.2.15 SNMP 56
3.2.16 COM2 & AUX 57
[Link] COM2 57
[Link] AUX and SITESWITCH4 Settings 60
3.2.17 SENSORMANAGER 60
3.2.18 RAS Configuration 61
3.2.19 Save Configuration / Reboot 62
3.3 Reading the Logfiles 62
3.4 CS121 for Transfer Switches 65
4. Adapter Software -Updates (Firmware) 66
4.1 Firmw areupdate via Setup-tool 66
4.2 Firmw areupdate via FTP 66
4.3 Firmw are flash renewal and recovery 67
4.4 How to get the “[Link]” from a CS121 to your computer via FTP 68
4.5 Changing the Adapter’s MAC-Address 72
5. Additional Software 74
5.1 RCCMD 74
5.1.1 Installation 74
5.1.2 RCCMD w ith SSL for Windows 76
5.1.3 RCCMD w ith own SSL certif icates 78
5.1.4 RCCMD client as relay station 79
5.1.5 License regulations 79
5.2 gChart 79
5.3 UPS monitor (UPSMON) 81
6. CS121-Enhancements, Field of applications 83
6.1 SiteSw itch4 (SS4) and SiteSwitch4AUX (SS4AUX) 83
6.1.1 SS4 Feature overview 84
6.1.2 SS4 Contents 84
6.1.3 SS4 Installation 84
6.1.4 SS4 - Technical data 85
6.2 Sensor SM_T_COM 85
6.2.1 SM_T_COM configuration 86
6.3 SENSORMANAGER & SENSORMANAGER II 87
6.3.1 General information 87
6.3.2 Installation and Netw ork integration 88
6.3.3 Special features of theSENSORMANANAGER II 91
6.3.4 Configuration 92
6.3.5 Alarm Matrix of the SENSORMANAGER II 93
6.4 RASMANAGER 94
6.5 GSM Modem – Notification via SMS 95
6.6 LED-Matrix Display 97
6.7 MODBUS / PROFIBUS 98
6.8 UNMS ( UPS-Netw ork Management System) 99
7. Troubleshooting – FAQ 101
Appendix 103
A. CS121 - Technical data 103
B. CE- and UL-Certification 103
C. Cable and Circuit board configuration, Pin/AUX-Ports, SensorMan 103
4
D. MODBUS Interface 107
D.1. General information 107
D.2. Available Modbus Function Codes 108
D.3. Exception Codes 108
D.4. MODBUS Modes in the CS121 M (ASCII and RTU) 109
D.5. UPS Parameter 110
D.6. UPSMAN Status Bytes - Standard Device Status Bits 123
D.7. Bus termination 124
D.8. Configuration 124
D.9. TCP/IP - UDP Ports 124
D.10. MODBUS Cables 125
E. Available Variables of the CS121 125
F. Pin layout of Input-sockets of the SENSORMANAGER unit 127
G. Events/Alarms of the CS121 – Description of the alarms 127
H. Description of the alarms for single -phase UPS 131
I. Configuration of Microsoft SCOM 2007 as CS121 Trap Receiver (Monitor)132
J. RARITAN Dom inion PDU Configuration 141
Table of figures 145
5
1. The CS121 family - Introduction
1.1 About your CS121
1.1.1 General inform ation
The CS121-series are a group of products designed especially for critical resource
management w ithin technical facilities. The CS121 can act as a UPS (uninterruptible power
supply) manager for all other computers in the network. All of these products share many of
the same basic CS121 features, and some have special components and functions. Th e
CS121 products are most commonly used for the management of UPS systems, so in this
manual w e specially reflect to the usage of such devices with your CS121. All of the basic
features and most of the product specific features and operation are explained in this manual.
This manual is the basis also for other CS121 based products like CS121, CS121BUDGET,
SENSORMANAGER, SM_T_COM, SITEMANAGER, SITEMONITOR, SITESWITCH4 und
RASMANAGER.
Note: When using the CS121 to act as a UPS (uninterruptible pow er supply)
manager for other computers in a network it is necessary for those
computers that are being managed by the CS121 to have its ow n
RCCMD installation. RCCMD is the only possibility for enabling the
communication between the CS121 acting as a UPS-Manager and other
client computers in a network. While it is possible to add the different
computers as clients in the CS121 settings it is only possible for those
computers to act as an RCCMD client w hen they are running RCCMD.
Each computer running RCCMD must have its ow n RCCMD license.
This is the only possibility for the CS121 to fulfil its function as a network
UPS (uninterruptible pow er supply) manager. Setting up the RCCMD
commands is described in depth in the sections 2.3.2 Quickguide to
install an RCCMD-job and 5 Additional Software.
There are several CS121 SNMP-adapters available for different UPS and although they are
mainly made for UPS, the adapters can easily be modified by simply plugging in other products
like the SITESWITCH SS4-AUX, SENSORMANAGER, and Modems in order to add new
features.
There are tw o basic types of CS121-adapters: external and slot cards. The basic versions for
UPS come w ithout MODBUS-protocol, COM2 for environmental sensors and manageability
and AUX for dry-contacts alarms. For more differences please see section 1.4 Comparison.
There are other external products based on the CS121 such as the RASMANAGER, w hich is a
CS121 w ith a built-in modem. Other external devic es include the SiteSw itch 4 (for the direct
control over power sockets), the SITEMONITOR 64 (for monitoring up to 64 digital alarms) ,
and the SITEMANAGER 2 (a device w ith multiple functions) which are used for handling
facility management purposes that go beyond the UPS systems.
Generally, the SNMP adapter runs an embedded Simple Netw ork Management Protocol
(SNMP) software agent. This agent responds to the SNMP operations “gets” and “sets” and
also forwards “trap-messages” to designated recipients when critical conditions occur to the
UPS - such as low battery status. Additionally, the adapter can send RCCMD signals to client
computers running the Remote Console Command (RCCMD) initiating automatic shutdow ns
or other actions in case of an extended powerfail. (The RCCMD client is an extra system
module requiring its ow n license.)
1.1.2 Functionalities of your CS121
SNMP Adapter CS121/CS121 Slot: The SNMP adapter is a compact unit requiring minimal
workspace (ca. 28x69x126 mm for the external adapter CS121L). The slot card versions of the
adapter (CS111 and CS121SC) get inserted into the extension slots of UPS models supporting
its card type.
Serial Port: Tw o DIP-sw itches change the adapter's serial port (COM2) to a configuration
port for installation or to a communication port for environmental sensors, modem or other
6
functions. The MODBUS-version uses the COM2 as RS485 and is not available for
configuration. The MODBUS version can be configured only via Webbrowser, Telnet and
Default IP address.
SNMP-Traps for remote monitoring and pre -alarming: The main function of the SNMP-
adapter lays in the transmission of alarm conditions of the UPS to the monitoring station
(SNMP traps and RCCMD traps/commands). It also makes UPS data access able for users in
the network upon request. With this function it is possible to retrieve and monitor eg. battery
capacity of an UPS from an SNMP management station. The event settings configuration
menu also allows for SNMP trap testing.
Rem ote Control: With this function it is possible to switch the UPS to Bypass (depending on
the model) or start battery tests. This remote command is executed either via the Network
Management Station or the UPS Management Software or any Webbrowser.
Telnet: Every Adapter maybe reconfigured via the netw ork, using Telnet or http after the
initial configuration of an IP Address for the adapter. Current UPS data can als o be shown
using Telnet. Generally we recommend to use the Webinterface since Telnet (and
terminalconfiguration) does only allow to setup a basic configuration of the CS121.
Works with all m ajor NMS: The SNMP adapter w orks with most, w idely used Netw ork
Management Systems e.g. HP Open View HP UNIX and Microsoft Windows NT, Novell NMS,
Spectrum, Sun NetManager, IBM Net View /600 and others. All SNMP systems which either
allow the compilation of the MIB or already incorporate MIB RFC 1628 for UPS Systems, can
be operated with the Cs121.
Multiserver shut down via RCCMD/RCCMD2 compatibility: The SNMP adapter CS121 is
able to initiate a netw ork shutdown w ith any RCCMD modules from the UPS- Management
Software CD. A TCP/IP based RCCMD signal is sent to all RCCMD clients in the netw ork. This
enables the remote shutdown of practic ally an unlimited number of client computers,
independent of which operating systems the clients are running. RCCMD is an optional part of
the UPS- Management Softw are. Your UPS dealer is able to provide you w ith Licensekeys for
the RCCMD. The UPSMAN servic e of the UPS-Management Software suite is an optional
module and not needed for that basic CS121 operations. We recommend to use the UPSMAN
service only if the UPS is connected via serial or USB cable, if a CS121 is connected only the
UPSMON (optional OEm designed Window s interface) and the Webbrowser are needed.
RS-232 UPS Protocol Router – Pipe- through: The CS121 (not BUDGET versions) is able
to transfer the UPS RS-232 protocol on COM1 directly to COM2. This al low s the use of
additional monitoring softw are on COM2 w hile making extra hardware (RS-232 multiplexer) to
multiply the UPS comport unnecessary.
Logfile: CS121 has an internal logfile synchroniz ed w ith either a set timeserver in your
network or from timeservers in the internet. This logfile can be accessed through the
Webbrowser, UPSMON, JAVAMON or via FTP. Due to the maximum file size of 250 lines
(depends on Hardware, newer HW131 have 2-3 more space), old entries are deleted
automatically.
Network settings: The CS121 Models are adjustable to the network environment. An auto-
sensing function 10 or 100Mbit can be activ ated.
Note: In large fast networks as is normally the case by CISCO or HP- Procurve
with auto-sensing switches problems can occur during the reboot of the
CS121. If this is the case and switches are being used then the auto-
sensing function might very well be the problem. Because the CS121 is
per default set to auto-sensing (ON), this can lead to the netw ork
devices not being able to harmonise communication rates with one
another. This auto-sensing process can take a long time and is
sometimes never attainable. This taxes the CPU capacities of the
switches and can greatly slow down the network or even lead ultimately
to its failure. In this case a default network speed should be determined
7
and set after which, the CS121 can be changed from AUTO to the given
speed, "100half" for example.
Em ail client: The CS121 adapters incorporate a built-in SMTP email-client, w hich is able to
send emails automatically in the event of an alarm.
Web server: The CS121 Models contain a w eb-server, whic h displays all functions and
settings of the adapter. Non-Windows users may use the JAVAMON as graphically display for
UPS data (The JAVAMON module is not implemented in all versions.). Generally the CS121
Webserver is designed for the use with MICROSOFT INTERNET EXPLORER 6 w ith Active X
and is recommended as configuration and management interface.
1.2 About the communication with the CS121-Adapter
MODBUS
Modbus is the de facto standard protocol in industry which is used in the building surveillance
and facility management. All CS121 types include an MODBUS over IP interface and
MODBUS over RS232. The CS121 MODBUS types do not have an RS232 interface at COM2,
here they use an RS485 interface. The CS121 BUDGET series does not support MODBUS.
Please see the appendix where also output and protocol interface are shown.
SNMP
The SNMP (Simple Netw ork Management Protocol) is the Internet-standard protocol for
managing devices on IP netw orks and is defined and standardiz ed in Requests for Comments
(RFCs)-specifications. UPS systems are using in generally as Management Information Base
(MIB) the RFC1628-specif ication which defines UPS-specific devic es.
The CS121 also comes with the standard MIB RFC1628. Because of this MIB is already part
of most SNMP software products, it is not required to compile the MIB (Please search the
MIB2 directory tree for a “UPS-MIB”). If you w ant to include your CS121-adapter to an SNMP-
Management station, w hich does not have the standard MIB RFC1628, you can dow nload the
specif ic MIB from our w ebsite. ([Link]
Copy the MIB file to the appropriate MIB-directory of your SNMP-station and compile this file.
In most cases your SNMP already has implemented this MIB and a compilation is only
necessary if you want to read extra information than just UPS (e.g. for SENSORMANAGER,
etc.)
For additional information about MIB and NMS see also the section “UNMS” later on in this
manual.
For the CS121-SNMP MIB Implementation, please refer to the GENEREX dow nload-page
[Link]
This MIB is specially designed for the CS121 and includes SNMP values for all CS121 optional
products (Temperature, humidity, alarm contacts, etc.) Basicly this [Link] is the
original UPS MIB, extended by extra values supported from your CS121.
TCP
Most common w ay to communicate w ith the CS121-adapter is over TCP. CS121 includes
UPSTCP, w ith gives you a complete interface to integrate the adapter into your network.
1.3 The CS121 Adapter Package
The standard CS121-adapter package contains an SNMP-adapter unit w ith supporting
hardware and software. (Note, that the Budget-models do not have all features.)
Optional is a mounting kit for wall and DIN Rail mounting.
8
CS121SC User manual English. Configuration cable for serial port configuration
(Slot Chinese) via Terminal softw are - and for connection of optional devices for your
CS121.
CS121F User manual English. Configurationcable for serial port configuration
(Slot FUJI) via Terminalsoftware - and for connection of optional devices for your
CS121.
CS121R User manual English. Configurationcable for serial port configuration
(Slot via Terminalsoftware - and for connection of optional devices for your
RIELLO/AROS) CS121.
CS121MOD Pow er supply external. (For USA/CA UL: Supplied by NEC Class 2
(Extern) Pow er supply only) User manual English. Configuration cable for serial
port configuration via Terminal software - and for connection of optional
devices for your CS121. Mini-8 connector for your MODBUS RS-485
connection via COM2.
CS121BL Pow er supply external. (For USA/CA UL: Supplied by NEC Class 2
(Budget Extern) Pow er supply only) User manual English. (Configuration only via
networkcable)
CS121BSC User manual English. (Configuration only via network cable )
(Budget Slot
Chinese)
9
1.4 Comparison
10
1.5 CS121 overview
For CS121L, C and Slot card types
No. Description
11
If the red and green LED shine at your CS121 red AND green during reboot
HW131 during the reboot, huge broadcast traffic into
your netw ork is present „recieve buffer overflow“.
The green LED is signalizing at the reboot, that the
„traffic buffer“ is full. Advice: You should filter
broadcasts via your switch, because it comes to
performance losing of the CS121 HW131
unnecessary.
Normal condition green flashing
UPS communication lost red constantly
(3) DIP-Sw itches: The DIP-Sw itches differentiate between two functions: Configuration- and
normal mode.
Figure 2: DIP-Switches: CS121L (left) in configuration mode (IP [Link]) and CS121SC
(right) in normal mode
Sw itch 1 Sw itch 2 Description
ON OFF Normal operation, device runs on the configured IP-address
OFF OFF Configuration mode w ith default IP Address
[Link] and activ e COM 2 configuration for Terminal
SW
Note: If you are using a different power supply unit from the one in the adapter
package, please consider that the polarity is set correctly. The adapter
might be damaged if the wrong polarity is used. The power supply
voltage should be at least 9V, 12 V is recommended.
For the CS121SC models C and the slot card, there are no power supply
units. These units w ill receive power directly from the UPS device. The
SNMP adapter C and slot card both incorporate a variable 9-36V input.
UPS Interface cable (extern devices only): Please use the manufacturer’s serial port cable that
came w ith your UPS to connect the UPS w ith the SNMP-adapter. Please contact your UPS
manufacturer, if you have questions. Only use the original RS-232 UPS cable for
communication, which w as provided w ith the UPS. If your UPS has a contact closure port,
please use the manufacturer’s special cable. Please consult your UPS dealer on information
regarding special cables.
12
1.6 A typical installation - CS121 in a network environment
A typic al installation on the SNMP-adapter monitoring a UPS in an Ethernet netw ork follows in
the illustration below. The SNMP-adapter communicates w ith the UPS to inform you about
your systems power condition.
13
CS121 MINI/CS121 R_II:
It is required, that the DIP Sw itch 2 remains in position OFF, otherw is e the device will not start
(valid for CS121Minislot/CS125/CS121R_II built 2008- 2010 from serial number 0123M-0001
to 0123M-1135).
Configuration cable (not CS121BL/BSC):
Your package contains a configuration cable, whic h connects to the serial port (COM2) of the
SNMP-adapter and the serial port of a PC w ith terminal software. It is sufficient to use a Dumb-
Terminal or Terminal-Emulationprogram, such as e.g. Microsoft-HyperTerminal. During the
configuration of the SNMP adapter please ensure that the DIP sw itches are in the correct
position. Please also refer to the section 1.5 CS121 overview in this manual.
1.7.2 ... via LAN
Connect the CS121 w ith RJ45 cable (not included) to your LAN.
1.8 Verifying the CS121 connectivity
After the CS121-adapter is connected to the UPS and to the Computer via serial port or via
LAN, please verify the connectivity before you start to configure the CS121. The setup system
can be checked before and after a configuration using the follow ing 3 steps:
UPS-Status displays (LEDs)
During the boot-procedure, the red LED is on, whereas the green LED is off. (Models with
Hardw are Version131 do also indicate uncompressing the firmw are files with flashing red LED
lightening) The boot process can take up to 3 minutes. If there is an error, the red LED does
not go out. For more detailed information about the UPS-Status LEDs, please see section 1.5
CS121 overview .
After five to ten seconds after the boot-process, the green LED flashes rapidly; this indicates
that the SNMP-adapter is trying to start the communication. The adapter will indicate its
communication accessibility w ith random green LED flashes.
Network status LEDs
The LEDs, integrated into the LAN-Connector (RJ45-), w ill signal a connection to the netw ork
with green and with yellow network connectivity.
Ping the SNMP-Adapter
Perform a PING-command from the SNMP-station or from another computer in your netw ork
resp. NMS (Netw ork Management Station).
If you do not get a response, check the SNMP-adapter network connection and IP-address of
the SNMP adapter. The IP-address of the adapter is set to [Link] if DIP-sw itch 1 is in
position OFF (configuration-mode).
Note: The different response rates during the ping process do not correspond
to an error. The adapter does not answer every ping signal at the same
speed, due to different sized UPS protocols. If UPS protocols are of
extensive siz e a timeout can occur briefly . A permanent timeout how ever
is an error.
14
2. Quickstart
The Quickstart manual gives you a short instruction into the main features and how to make
some basic settings and guides you in connecting the SNMP-adapter to the netw ork and UPS.
Note: Before you start to configure the CS121 please ensure that your
connections are valid as described in section 1.8 Verifying the CS121
connectivity (Red network-LED off; green netw ork-LED flashing in
intervals). Please take care that your UPS has been correctly installed
before and is running!
There are three methods available for configuring the SNMP-adapter: Telnet, terminal and
HTTP. These methods differ in the type of user interface and in the type of connection to be
used for the configuration. The telnet method shares similarities w ith both, the terminal and the
HTTP-method. Like the HTTP- method, the telnet method uses a network connection via the
IP-address to establish a communication, but it has the same type of user interface as used in
the terminal-method. The terminal-method requires that the SNMP-adapter be connected via
the serial cable to a host computer. The terminal and telnet methods provide the user with a
text menu indicating per alpha-numeric keys the possibilities for the user to either enter
configuration commands or navigate through the menu levels. The HTTP- method provides the
user with forms in which the system settings are either typed directly into a form or chosen per
drop down menu.
Although, all of the configuration possibilities, Telnet, Terminal and HTTP are generally
available, later in the parts of this manual only the explanation for usage of the HTTP-interface
will be provided. We strongly recommend to use the HTTP interface for configuration and
monitoring.
After you have completed the hardware setup and connected the SNMP-adapter, any of these
three methods can be used to configure the adapter for the network. For this purpose
depending on the configuration method, a communication must be established between the
adapter and user via a serial terminal session or via an established netw ork route in a telnet or
HTTP session. CS121 allows a login only under the username “admin”. Upon entering a
telnet- or terminal-session with the adapter an authorization is required for whic h the default
password is :
“cs121–snmp”
Note: We recommend the follow ing settings for the operation of the CS121 via
cross cable (Ethernet cable for the connection directly). Set the IP address of the PC w ith a
cross cable to an IP address of the same network segment, e.g. [Link] AND set the
gateway to [Link].
A network cross cable is a PC-PC netw ork cable which does not require a switch or a hub
between 2 network computers (2). Most modern computers networkcards have an
autodetection, so any network cable may be used. Only if you do not have such a cable
autodetection its unavoidable to use a Cross-cable or connect a switch or Hub between your
PC and the BACS WEBMANAGER (1).
15
Figure 4: Connection PC-Switch/Hub and CS121 (2) Connection PC-Cross Cable/Network
Cable and CS121
Note: The function DHCP ON/OFF is valid for the follow ing models only: all
CS121 HW 131 and all BACS II Webmanager Budget (not valid for all
CS121 HW 121, SieteManager, SiteMonitor, MiniSlot and Piller I/O
Board)!
2.1.2 Establishment of a static CS121 IP address m anually (default delivery state)
The minimum requirement to operate the SNMP-adapter is to set the IP address, subnet mask
and the UPS model:
The DIP-sw itches of the SNMP-adapter firstly need to be set for the configuration. DIP-
switch 1 is sw itched OFF in the top position as well as DIP sw itch 2 is sw itched OFF. Please
note that the DIP sw itches of the SNMP-slot card adapter are situated on top of the circuit
board and DIP sw itch 2 remains in the OFF position in configuration as well as in the normal
mode.
Note: For slot versions you have to insert and remove the devic e for any
reboot-process. This w ill not have any effect on your UPS but w e
recommend doing such operations only when the UPS is not supplying
any load!
As soon as the network-LED is flashing, add a TCP/IP route on your computer for IP-
address [Link]. This is done via a call from your command line e.g. "route add
[Link] <your computers IP address>“. See als o route -? for more help of route syntax.
Test if you can ping the devic e now: Enter command „ping [Link]“ and check if there is
any response. Now you can connect w ith any Telnet or HTTP-software and continue w ith the
configuration.
2.1.3 Using HTTP/Webbrowser
The entire configuration can be done via Webbrowser. Please use the default IP-address
[Link] and the TELNET password (default: “cs121-snmp”). The username is alw ays
“admin”.
For the configuration using the webbrowser please observe the following:
16
We recommend the use of Microsoft Internet Explorer 6.x (or higher) or Mozilla 1.3x. Please
note, that Java scripting has to be activated. Using Internet Explor er, the corresponding
settings have to be made under “Internet options” - “security”.
We also recommend never to use the his tory function of the browser, as this may lead to
multiple transfer of commands (e.g. delete event jobs) to the adapter.
Upon entering a HTTP-configuration session, the user is required to enter a username,
”admin”, in addition to the password ”cs121-snmp”.
17
Figure 7: HTTP - Network & Security Settings
Apply your settings with the button at the right side.
Change to menu “Save Configuration” and click “Save Configuration”.
2.1.4 Using Telnet / MS-HyperTerm inal
[Link] Building up a connection
Use of Telnet, enter the command: „telnet <IP-Address>“, whereas <IP-Address> is in the
configuration mode set to [Link].
Start a Terminalprogram (e.g. MS-HyperTerminal) and ensure that the serial communication
cable for COM2 is connected. To build up the connection, mind the follow ing communication
settings:
Adapter
Baud rate 9600
Data bits 8
Parity None
Stop Bits 1
Flow Control None
Xon/Xoff
Handshaking None
CR/LF OFF
Local Echo OFF
Terminal Type ANSI (VT100)
18
[Link] Main menu & IP-Settings
19
Enter Command => 6 USV 1
To assign the UPS location SysLocation, type 6 and enter the location name:
Enter Command => 7 Building 12
[Link] UPS Settings
Choose option 4 from the main menu and you enter the menu “UPS Settings”. Within this
menu the user needs to select the UPS model the CS121-adapter is connected to (usually at
COM1).
Note: Please do not change parameters except of UPS-model unless you want
to choose specif ied configuration according your UPS- model!
Please note option “D”: “System shutdown (minutes before battery end – downtime)“: This
value determines how many minutes before a complete battery unload the event “System
shutdown” from event menu is executed.
The shutdown time interval needs to be set large enough, so that adequate time for a system
shutdown is allocated before the UPS runs out of power. Please calculate this value
generously e.g. if the battery time of the UPS is 10 minutes and the event procedure takes 2,5
20
minutes, ensure you start (configure) the shutdown (or other event action) 3 minutes before the
UPS is sw itched off, so that more than enough time is available to complete the corresponding
event action.
[Link] Save configuration
Call “Save, Exit and Reboot”-command from the main menu. (The communication to the
adapter will be lost).
ATTENTION: Keep the Telnet, Ter minal, Webbrowser w indow open until the device has been
lost or you see a message that reboot is under progress. If you close the configuration w indow
too early it may corrupt the [Link] configuration file. (see also section 4 Adapter
Software-Updates (Firmw are))
Note: Various options and settings for UPS-configuration can be done under
Telnet or HyperTerminal, e.g. setting access controls of the SNMP-
communities, set traps, set display settings, etc. However, the
configuration via Webbrowser offers a much more convenient way to
configure the CS121. If you have any possibility w e recommend you to
use this way.
2.2 Adapter-restart and boot procedure
After you have finished the basic IP- and netw ork-settings you should set DIP-sw itch 1 in
position ON and restart the adapter w ith your configurations.
You can perform an adapter restart by unplugging the power supply of the CS121 and w ait
until the adapter has restarted w ith your configurations.
Alternativ ely you can restart the Adapter w ith the “Reboot”-Option in the “Save Configuration”-
menu of the Webbrowser. The follow ing message will displayed:
21
to several client stations. In addition, it is possible to specify when and how often an action is
to be released.
2.3.1 About same basic events
Please call the menu “ Events / Alarms” in the Web-browser to open the main configuration-
site, whereon all configurable events are listed. In the following, we introduce same basic and
important events which should be in general handled from every CS121-Adapter. For a
complete description in-deep please see section 3 Configuration of the CS121.
Powerfail
The event “Pow erfail” will be released when the UPS has lost the power supply . This event is
usually used to proceed operations like backup-strategies, batch-files to be executed on client
stations etc. pp. You can configure such jobs w ith the “Remaining time” -parameter to ensure
the actions w ill be executed completely.
System shutdown
The event “system shutdown” will be released, if the configurated “System Shutdow n Time” (in
the menu “ UPS model and system”) is reached. This means, there are yet the configurated
minutes left until the battery’s capacity is expected to be finished (as calculated by the
adapter).
This event should only be used to proceed all operations concerning your forced shutdown
szenarios. Further operations are usually configurated on the event “Pow erfail”.
Note: This EV ENT is the final task a CS121 can initiate before the UPS
switches off! DO NOT use this EVENT for triggering shutdowns via
RCCMD etc. because the remaining time in this status is not secure. We
strongly recommend to use the event “Pow erfail” and configure the
RCCMD shutdown calls w ith a UPS “remaining time”, this is the best
way to send RCCMD shutdowns to several IP-addresses in a certain
logic or sequence!
Battery low
The event “Battery low” will be released from the UPS w hen the battery charge has reached a
critical state.
UPSMAN started
The event “UPSMAN started” is periodically released in normal operating mode. You can use
this event to configure jobs, which should be executed as long as the adapter is working in
normal mode.
Note: Same UPS models allows you to configure the thresholds for releasing
UPS specific events individual. CS121 also supports these features if the
UPS includes this possibility. See also section Error! Reference source
not found. Error! Reference source not found. in this manual.
2.3.2 Quickguide to install an RCCMD-job
Condition for setting-up an RCCMD job in the CS121 configuration (like Shutdown for
example) is the installation of RCCMD at the client workstation.
Note: Each RCCMD- Installation requires a licence key! Usually, the CS121
Adapter Package includes already one licence key. This license key can
only be used once per installation. If more computers need to be added
to the shutdown process, additional licenses are requir ed.
Please follow the description in section 5.1 RCCMD to install RCCMD at the client-workstation.
After you finished the client-side installation of RCCMD you can configure an RCCMD-job at
the CS121-adapter:
22
For example to configure a job, whic h initiates a shutdown-signal to a client-workstation,
please enter the event “System shutdown” in the menu “Events / Alarms”. The following “Event
Editor” then lets you add a new job.
23
3. Configuration of the CS121
Note: After you have finished the basic network configuration you should have
set DIP-sw itch 1 in position ON and rebooted the adapter. At the SC slot
cards you have to remove the card from its slot and change the DIP
Sw itch 1 to position ON. After this, re-insert the card. Info: There is no
risk to remove/insert the slot card, there w ill be no effect on the UPS
output.
3.1 CS121 Status-Monitors
The Menu “System & Netw ork Status” shows basic information about general configuration
settings:
24
Figure 16: HTTP - UPS Functions
AUX & SensorMan Status:
The AUX & TEMPMAN status shows the actual measurements of the connected
environmental sensor devices SM_T_COM, SENSORMANAGER or TEMPMAN.
25
Figure 18: HTTP - UPS Model & System
With the parameters UPS ID, system-name, -location, -contact you can describe the UPS and
CS121. This is useful e.g. to locate the UPS physic ally and can be used among others for
event settings.
Note: Do not change the default UPS- Parameters for Baud Rate and Hold time
unless you have special instructions from the UPS maker.
Please note the field “System Shutdown Time “: This value determines how many minutes
before a complete battery unload the event “System shutdown” from the event menu (please
cp. according section Error! Reference source not found. Error! Reference source not
found.) is executed. Attention: This EVENT is the final task a CS121 can initiate before the
UPS sw itches off ! DO NOT use this Event for triggering shutdowns via RCCMD etc. because
the remaining time in this status is not secure. We strongly recommend to use the Event
Pow erfail and configure the RCCMD shutdow n calls with a UPS “remaining time”, this is the
best way to send RCCMD shutdowns to several IP addresses in a certain logic or sequence!
Note: Please apply your changes before leaving the menu to send the values
to the CS121-adapter - do not forget to press “SAVE & EXIT &
REBOOT” after you have finished your configuration work!
The section „Custom Values“ contains 6 fields with can be used to save custom specif ic
comments concerning your UPS.
26
3.2.2 Network & Security
Note: We recommend to set the Network Card Speed NOT to “Auto”, but
rather to the accordant speed of your sw itch. In addition we
recommend to open the TCP/IP and UDP ports only, that the CS121
is using. Please take a look into the chapter Appendix D. D.9 for
further information. To fend foreign reboots out of the network, we
recommend to disable the port 4000 at your switch. Please note,
that you are not able to update the CS121 firmware anymore.
Enable the port 4000 again, if you want to update the firmware.
The CS121 firmw are version 4.30.x provides the definition of the TCP MSS value. The
Maximum Segment Size defines the amount of bytes, whic h will be send as reference data into
a TCP segment. The default is 1460. If you got problems w ith a VPN connection, change the
TCP MSS value to 1100. The TCP MSS value is valid for HTTP only!
Enable RCCMD Listener: Among others, here you can allow the CS121 to act as an RCCMD
listener client. This makes it possible for another UPSMAN-Manager, CS121, SITEMANAGER
or other RCCMD compatible sender to send the adapter an RCCMD command like sending
one of the AUX output ports a high or low signal – or to start other actions.
You can also set the MODBUS configurations in this menu. The configuration requires only the
follow ing entries:
Enable Modbus over IP: Every CS121 model w ith Firmw are Version 2.0 (or higher) can
also transfer UPS data via the MODBUS-protocol on IP (port 502). You may use any
MODBUS client to read the UPS value from CS121. For using the RS-485 interface, you must
27
use a CS121MODBUS (special hardware) in other cases you have to use MODBUS-over IP.
This is enabled by default, you may disable this feature via Telnet or HTML-configuration.
Modbus Slave Address: Enter the corresponding number, meaning which number in the
chain (bus) the adapter is .
Modbus Mode: RTU (Binary mode) or ASCII mode text output. Please select the type w ith
the scroll down menu.
Note:
ASCII Mode w orks at CS131 & CS121 platforms with communcation parameters 7/E/2, or
7/E/1 or w ith 7/N/2 from baudrate 1200 to 38400. We recommend for ASCII the use of 7/N/2
and the highest baudrate supported by your devic e.
RTU Mode w orks at CS131 & CS121 platforms w ith communcation parameters 8/E/1 or
8/N/2 or 8/N/1 or 8/E/2 or 8/O/2 or with 8/O/1 from baudrate 1200 to 38400. We recommend
for RTU the use of 8/E/1 and the highest baudrate supported by your devic e.
Enable Hardware Watchdog: (from firmware 3.87) This is a function that should avoid
hang-ups of the CS121 HW131 (via netw ork problems or other, external devices). This
function is only available at the new er hardware 131, not at the 16bit model CS121 HW121.
The hardw are watchdog w ill be triggered every 20 seconds from one of the CS121 services. If
they get no response, the CS121 w ill restart by itself . Thereby the broadcasts like denial of
service attacks will be sw itched off reliable. The hardw are watchdog should be used only, if
you cannot determine the cause of a hang-up. If reboots occur often, please contact the
support for an analysis. To sw itch off the hardware watchdog, uncheck the box “Enable
Hardw are Watchdog” and click the “Apply” button. Click the Save Configuration menu and use
the function “Save, Exit and Reboot” and restart the adapter completely. Now achieve a cold
start!
Change Administrator Password: The password protects against unauthorized usage and
manipulation. The default password is "cs121-snmp". In case you have "forgotten" your
password a master password can be generated using your adapter serial number. Please
contact your manufacturer for more information.
Change UPSMON & SS4 Password: This is a separate password (default: “cs121-snmp)
and allows to open UPS FUNCTIONS and SS4 FUNCTIONS only to specif ic users. With this
password, which is valid for the TCP/IP connection to the UPSMON too, the user may switch
on/off the UPS, start battery tests, switch SITESWITCH 4 outputs, but can not change any
other setting on the CS121 configuration. Exception: If the administrator password (default
identic) was not changed. The UPSMON is a Windows client, which is able to connect via
network to the CS121. The UPSMON and SS4 password is used as protection. Advic e: For the
activation of the new password (apply button), it is required to reboot the CS121 via the „Save,
Exit & Reboot“ function.
The UPSMON password blocks entry to the UPSMON tools battery test and emergency shut
dow n. Know ledge of this password enable users to gain access to these security relevant
functions.
28
Figure 20: HTTP - Network & Security DHCP Settings
Click the “Apply” button and reboot the CS121 w ith the “Save, Exit & Reboot” function.
Fallback address: If the DHCP server w ill not be available, just reboot the CS121 to use the
fallback address. This address is equiv alent to the settings of the local address in the menu
„Netw ork & Security Settings“. When DHCP w ill be available again, just reboot the CS121 to
use the DHCP address.
3.2.4 The CS121 with ICMP Check
From the firmw are version 4.26.x the CS121 is able to answer and send ICMP polls, to c heck
the quality of the network and, in need, can reboot itself.
29
Figure 22: HTTP – Network & Security Hide HTTP Links
You can determine into the ARP Settings, which IP address to whic h MAC address will be
assigned. Therefore the ARP entry w ill not expire for this IP address. The ARP table w ill be
determined firmly and w ill never expire! Case of application: HP Teaming or an ARP entry is
desired, but the ARP table cannot be restored automatically.
In the “Scheduled Actions” menu you can schedule the following actions:
Self test: A self test is a short hardware test, which switches the device to a short discharging.
Battery test: A battery test is a short battery test, whic h switches the battery to a short
discharging.
30
Custom test: A custom test checks, if the batteries are able to hold the downtime at least.
Full test: A full test is used to calibrate the UPS and w ill discharge the batteries till the „battery
low “ limit. This test should be done once a year at most, because to avoid a damage of the
batteries.
Online (inverter mode): This is a function to switch into “Normal Mode” (power supply of the
battery). This status is the normal UPS mode and it is actual not necessary to schedule any
kind of commands.
Offline (bypass mode): This is a function to sw itch into “Bypass Mode”. Thereby the inverter
of the UPS is not in usage and the current would not be buffered, if a failure would occur. This
mode displays a failure of the UPS, please call the UPS service to solv e the problem.
Shutdown UPS: This action causes the sw itch off of the UPS. This could be arranged, if a low
charging of the battery occurs, in case of a fire alarm or a power failure happens.
Sw itch UPS Outlet: This is a function to switch of the UPS outlets (not provided of every
UPS).
Sw itch AUX port: In general the AUX port is used for additional contacts, which can be
configured as in- or output (e. g.: as input for alarm contacts of an air conditioner or as an
output to sw itch a connector). If the contacts will be configured as inputs, they are able to be
used as event in the “Event Settings”. Additionally you can establish jobs, if they are
configured as outputs. The menu “Sw itch AUX port” is for outputs only . You cannot switch
inputs!
RCCMD Shutdown: Here, IP-addresses from computers w ith RCCMD connection (receivers)
in the network can be entered. The CS121-adapter can then initiate a multi-server shutdown.
The timing for such a shutdown procedure depends on the configured down time of the
adapter (default: time of the remaining capacity of battery in min., during a long power fail.) or
on a countdown timer. Extended CS121-adapters can also use more events (e.g. battery low,
battery defect, communication lost etc.) as RCCMD signals. Please contact your UPS dealer
for more information.
RCCMD Message: With this job the user can combine and configure a text message with
RCCMD event. Text messages can be sent to RCCMD receivers. This makes it possible to
send text messages via RCCMD (version 2 or higher) to a Window s 2000 server or a Unix
computer, using the “NET SEND” or the respective “WALL” method. The problem w ith notifying
network users on different operating systems is therefore solved.
RCCMD Command: This RCCMD signal w ill cause any RCCMD receiver (e.g. another
CS121, RCCMD client or SITEMANAGER, SITESWITCH4) to execute a command or
program, e. g.: to start a program at a remote work station.
Native UPS Command: (for very experienced users only ) This is a function to execute UPS
ow n commands. Assumption: The user knows the “Command IDs” and the proper parameter.
These commands require additional parameter. If you want to use these kind of commands,
just contact your UPS dealer.
Send WOL: WOL stands for “Wake on LAN”. This function uses data packages to prompt
other computers in a local netw ork to start-up. Please use this function in the event “UPSMAN
started” to wake up computers which have been shut downed previously after an extended
pow er outage, which cause the CS121 or UPS to sw itch off completely. Additional you may
add this WOL signal to the EVENT “ Pow er restored”. Advice: Not every netw ork cards are
31
providing this function or are password protected. Activate this function into the BIOS settings
of the motherboard.
Send Periodic Em ail: This is a function to send the log files via email periodically (from
firmware [Link] and higher).
3.2.8 Em ail
If you wish to define actions to send Emails depending on specified events you need to
configure the Email settings.
32
Note: Please ensure that you have specif ied a DNS-server in menu “Network
& Security” if the mail-server could not be reached. You can transfer up
to 511 signs.
The „UNMS Email Trap Settings“ got the configuration linked, described into the chapter
3.2.10.
If Email-Trap is arranged and the UNMS II got the TeleService module extension, every devic e
can be monitored via emails. The UNMS II displays every device in an own grafical screen with
all measuring values and timestamp of the latest update. If a status will change, the values will
be updated immediately. If no status changes, the measuring values will be updated into the
defined period of time for the „Heartbeat“.
33
Figure 27: UNMS II screen with timestamp of the latest measuring values update
Advice: The Email Trap configuration is in accordance w ith the common email text
configuration from the previous page, but we recommend to create an own email account for
the UNMS II Email Traps, because this emails are non-readable for the user and the email
account w ill be stressed unnecessary. This Email Trap account should be used from the
UNMS II w ith TeleService only. You should change the parameter after using the import
settings feature accordingly.
The „Heartbeat“ via email is an additional feature for the UNMS II w ith TeleServic e. A new
„Heartbeat Timeout“ is at present, in the case, the „Heartbeat Email“ was not receiv ed.
Thereby a disconnect of the CS121/BACS connection will be monitored. If the „ Heartbeat
Email“ w as not receiv ed for 12 hours, an alarm w ill be triggered.
You can define the interval for the „Heartbeat“ at the CS121 and w e recommend to use an
interval of 12 hours.
34
Figure 28: UNMS Email Trap Settings
You can trigger an Email Trap via « Test » button. The CS121 AlarmLog will log the sending
and the UNMS II w ith TeleService should display new measuring values within 2 to 3 minutes.
The default selection of the Email Trap events shows, which events are critical and should be
sent. If you want to send further events, you can enable them here by clicking the « Apply »
button. Please note, that it is required to execute the « Save, Exit & Reboot » function, after
you have finished your configuration.
3.2.11 Timeserver
The CS121 uses a timeserver to supply the correct date and time of any event in its local
logfile. If no Timeserver is set, the CS121 will not use date and time in the logfile, but a date
stamp of 1970. For the normal operation of the CS121 a timeserver is not required, but we
strongly recommend to set access to a timeserver.
35
Figure 29: HTTP - Timeserver Settings
The timeserver is important to synchroniz e the UPS logfile to the actual time. The adapter
supports up to three different timeserver IP-addresses. Both, RFC868- and SNTP- protocols
are available. Enter the IP-address of any timeserver in your LAN or in the internet. In the
internet you will find many timeservers supporting RFC 868 TCP requests, e.g. the IP-address
of the timeserver of the National Institute of Standards and Technology is [Link]; the
timeserver of the Physikalisch-Technische Bundesanstalt is [Link].
Note: The timeserver w ill synchronize immediately follow ing the reboot
(featured with Firmw are 3.03 and newer). If the synchronisation fails, the
CS121 w ill attempt another timeserver synchronisation. Follow ing that,
the CS121 w ill attempt a synchronisation w ith the timeserver every 24
hours. It is required to unlock UDP port 123. From Firmw are 4.17 the
timeserver w ill synchronize in a 10 minute interval for at most 24 hours,
after it the synchroniz ation interval will be reduced to 24 hours.
The CS121 firmw are version 4.28.x provides the option to set the system time manually.
Please note, that after the next reboot the synchroniz ation w ill be lost.
Attention: The NEWAVE UPS got a special feature: Time synchronization via MODBUS
command 99. With this signal, the internal clock of the CS121 w ill be reset to 01:00 every
night, because of the optimization of a correct time. To avoid that the CS121 internet
synchronization process w ill correct this time again (regularly process at every restart and
every 24 hours), it is required to disable the SNTP timeserver into the CS121.
Every Windows computer offers the by “Windows Time” a timeserver whic h synchroniz es the
time of the PC w ith an internet clock. How to setup the MS-Timeservic e is described below.
If you do not have any internet access in your network, you may setup a timeserver which use
the PC clock. For this you may choose any freeware from the internet or dow nload from here:
[Link]
Test Timeserver connection: This option is testing the Timeserver connection with a time and
date stamp. Please note that the connection to the timeserver only works, when the adapter is
not in the configuration mode (IP [Link]). The CS121 should have a timeserver to
synchronize the UPS alar ms w ith your local time. Without a timeserver the CS121 would use a
default time from 1970.
36
Microsoft Windows SNTP Timeserver: As timeserver you can use any e.g. Windows PC in
your network which has access to a timeserver in the internet or a local PC clock. To use the
Microsoft Windows timeserver you have to configure and start the “Windows Time Server”
service – see screenshot in the service list:
After having configured and started your Microsoft Windows Timeserver you have to reboot
your computer and check the Event Logfile of Windows to ensure, the service was started
correctly . In this case, you can configure your CS121 Timeserver using the IP-address of this
Windows computer.
Note: Please check if your computer is reachable through the network. You
may have to change the Windows Firewall settings to allow
inbound/Outbound UDP port 123.
At Windows Server 2003 and 2008 it is required to enable the NTP server into the registry
manually. Open the follow ing folder:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W32Time\TimeProviders\Ntp
Server
Click w ith the right mouse button onto “Enabled” and change the “Value Data” from 0 to 1.
After this change stop/start the W32 Time service.
37
Figure 31: Registry NTP Server
3.2.12 Language
The CS121 firmw are version 5.x or higher is supporting the following languages :
- English
- German
- Chinese
- French
- Spanish
- Polish
- Portugese
38
Figure 32: Language Configuration
To be able to use this feature, it might be required, to configure the follow ing into your web-
browser (example Internet Explorer 8) :
39
3.2.13 Events / Alarms
The Event/Alarm-pages are the main feature of the CS121-configuration and are based on a
combination of events and actions (resp. Jobs). At CS121 there are various events defined,
such as e.g. “Pow erfail”, “UPS Battery bad”, “Battery low” etc. Each event the CS121-adapter
allow s you to release one or more actions. An action can be e.g. to write a logfile-entry in the
alarm-logfile (as default all events do perform an logfile-event), to send an eMail or to perform
an RCCMD- Command (e.g. shutdown signals to several RCCMD Clients). For a short
introduction into the handling of Events and Actions see als o the section “Quickstart”.
In this menu the relationships between system events such as alarms and the actions to be
taken those events are defined.
To configure your events and actions open the menu “Events / Alarms”. The menu “Event
Configuration” shows you an overview about the events and the number of configured actions.
40
The Event Editor offers you 3 commands on each Job: Edit, Delete and Test. (See figure
above) Please note: the Test will perform the execution actually, which means for exeample,
that testing a RCCMD-Shutdow n Job w ill actually relealse the Shutdown-Signal at the Client-
side! You should perform a Shutdow n-test not until you have switched off the Shutdown-
procedure at the Client. (RCCMD Configuration, Button Configure shutdown)
All Jobs are saved not until you executed the Save, Exit and Reboot- Procedure, not until the
device is restarted and running in normal mode (DIP-Sw itch 1 is ON).
The number of jobs per event ist limited. CS121 Series 2001-2006 allow up to 25 jobs,
running under Firmw are 3.5x even up to 35 jobs (approximatley, depends on the jobs). If more
jobs should be executed, you have to configure RCCMD as relay -station, as described in
section 5.1.2.
[Link] Treshold events
Some UPS models allow you to configure thresholds for releasing UPS specific threshold
events individually. CS121 also supports these features if the UPS includes this option. In this
case, you see at the main Event menu “Event configuration” at the bottom an additional link
“Configure threshold events”. Click here to add a new individual threshold event and you enter
the configuration page “Threshold Events”, w ithin you get the possibilities to configure
individual events.
The CS121 firmw are version 4.27.x or higher provides the option to configure pre-threshold
events for the analog sensor inputs (temperature, humidity etc .) additionally. In this example a
pre-threshold alarm for a SM_T_COM temperature sensor for the value temperature low of
13°C and temperature high of 37°C w ere defined. The analogue values for external sensors
are configurable through the variable SM_analogue 1-8. The proper threshold events for
temperature low of 10°C and temperature high of 40°C were defined into the menu “COM2 &
AUX” for the SM_T_COM.
41
[Link] Logfile entries
For a numerous of events logfile-entries are already pre-configured as default. To configure a
new logfile-entry, type in the field “Text” the desired message you w is h to enter in the logfile
and choose the option on the right side, when/how often the message should appear in the
logfile.
Note: Do not forget to apply your changes before leaving the menu to send the
values to the CS121-adapter!
The CS121-logfile is located in the adapter root directory “../flash” The user can read the
Alarmlog-file using a FTP connection with the default IP address [Link] or the configured
IP-address and the username/password combination “admin/cs121-snmp”. Alternativ ely the
logfiles can also be watched with the GENEREX monitor-tools UPSMON or JAVAMON resp.
via the Webbrowser. About the logfiles-contents please see also section 3.3 Reading the
Logfile.
[Link] Em ail-Job
Note: Please ensure that your Email settings in the menu “Email” are valid.
(See also section “Email” above)
Besides text entries (up to 511 signs), variables can also be integrated into the email from the
CS121-adapter. This may personalize your emails. A list of available variables are
documentated in the appendix (Section E Available Variables of the CS121). Please mind, that
42
the variables are only getting filled if the event actually occures, not by testing the action. (So
simulation is not possible, you have to create a real alarm to see the full message)
For example please see the figure above: There, the variables #MODEL and
#AUTONOMTIME w ill be substituted with their current values when the action w ill be released.
Please notice the syntax, that each variable name must be started with the character # and
must be ended w ith a <space> character.
Apply your settings and test the Email-job in the “Event Editor” to ensure Email w ill be
sent.
Continuous, periodic events:
To define an event job w hich will be executed continuous, e.g. daily, create a job on the event
„UPSMAN started“, as in the follow ing figure:
[Link] Em ail-To-SMS
In order to send a SMS message in case of an alarm, you have to use the “Email to SMS
Service” of your GSM provider. This is a service where the UPSMAN sends an email to the
service center of your GSM provider, who converts the email into an S MS. This service is
standard in most GSM netw orks and very reliable compared to modem solutions. For receiv ing
emails as SMS you have to contact your GSM provider to open this service. In the following we
describe how this works with some GSM providers in Europe, since these providers change
this very often, please refer to the website of your GSM provider to find out how “Email to
SMS” can be activated for your cell phone.
Example:
GSM Provider T-Systems D1
Your D1 email address w ill be D1Nr.@[Link] (e.g.:01711234567@[Link]) Please
note that you enable receiving emails on your cell phone. This is done by sending a SMS w ith
the message “OPEN”, to the number 8000.
Only the subject or the text field of the email w ill be transferred as a SMS, 160 characters from
the subject and text field.
Important: If you want to stop receiving emails, please send a SMS to the number 8000, w ith
the text “CLOSE”.
(If you want to enable the email transfer again, just send a message to the number 8000,
containing the text “OPEN”, as described before.)
43
(If you want to enable the email transfer again, just send a message to the number 3400,
containing the text “OPEN”, as described before.)
Other providers
Please ask your cell phone network provider for informations about the email to SMS settings.
Note: RCCMD clients are optional and not freeware. Most CS121 are
equipped today w ith a single RCCMD standard license, some UPS
makers add more licenses, other do not deliver any license at all w ith a
CS121. Contact your UPS maker and ask for the license regulations for
RCCMD in conjunction w ith your CS121.
Certain pre-settings are imperative for all RCCMD actions.
- First of all in general regards to the CS121-adapter as an UPSMON Server, the „Enable
UpsMon Server“ and the „Use RCCMD2 Traps“ controls boxes must be checked in menu
“Netw ork & Security Settings”. (default is ON) This enables the CS121 to execute its RCCMD
actions.
- Secondly , the CS121 adapter and the RCCMD client must both be appropriately configured
in order to reach one another using RCCMD commands over the network.
If you want to define RCCMD Traps by yourself , you can use the follow ing variables :
#OUTPOWER – Output pow er in %
#BATTCAP – Battery capacity in %
#INVOLT – Input voltage in V
#TEMPDEG – Temperature in °Celsius
#AUTONOMTIME – Autonomy time in minutes
#LASTTSTBUPT – Last test battery autonomy time in minutes
#STATUS – Status
#ISTEST – In test mode
#LASTERR – Last error
#TIMEUNTILSHTDWN – Time until shutdow n in minutes
#RUNTIME – Runtime in minutes
#INCURR – Input current in A
#BATTVOLT – Battery voltage in V
#INFREQ - Input frequency in %
#OUTFREQ – Output frequency in %
#CNT_PF – Counter pow er failures
#CNT_BL – Counter battery low events
#CNT_SD – Counter shutdowns
#CNT_SA – Counter shutdowns active
#CNT_TF – Counter test failures
44
#INPHASES – Amount input phases
#OUTPHASES – Amount output phases
Example of the configuration of a RCCMD Trap job for the event “Power restored”:
Figure 42: HTTP - Job Editor: RCCMD Trap, Event « Power restored »
You can add any kind of text/measurement units. It is required to add a blank ahead and
behind the variable (#MODEL). If you want to receive more variables, please seperate them
with a blank and a « . ».
45
The CS121-adapter uses the parameter-based RCCMD Version 2, which can execute
different actions on the same TCP channel. RCCMD Version 1 clients can only execute one
action (shutdown file execution as default, so any RCCMD signal w hich is transmitted to an
RCCMD client V1 w ill cause a shutdown of this server ) RCCMD Version 3 is capable to
handle also redundant UPS installations (eg. PC w ith 2 power supplies and 2 UPS).
Note: For all 3 RCCMD event functions a list of the user configured RCCMD
receiv ers appear in every RCCMD event.
3.2.14 The amount of RCCMD clients is limited and dependent of the size of the
clients per CS121 are guaranteed. If you need more than 50 clients to reach,
to use RCCMD relays (see chapter 5.1.4). However it is only possible to
the same time, meaning that the first 50 RCCMD clients are executed
etc. We recommend to change the timing parmeters of the RCCMD-jobs that
50 commands are transm itted at the same time. We also recommend to use
as Relaystation if you want to shutdown more than 50 computers from a
section 5.1.2 RCCMD w ith SSL for Windows
The Secure Sockets Layer (SSL) protocol is a cryptographic protocol that provides security
and data integrity for communications over TCP/IP netw orks.
Use your Web-browser to navigate to the address of your UPS Web-Manager. Click the
“Netw ork & Security” configuration button and enable the SSL network feature.
46
Figure 45: Timeserver Settings
Click the „Save Configuration“ button and the „Save, Exit & Reboot“ button to confirm your
settings.
47
Figure 48: Advanced Network Settings
48
RCCMD client as relay station)
Note: The RCCMD timeout is 60 seconds, meaning that after this time the
communication to the RCCMD client w ill be stopped and a logfile entry
will be made. When an OK response from the client is receiv ed, the
system assumes a successful RCCMD Shutdow n and proceeds with a
shutdown of the next 50 RCCMD clients. Every minute one batch of up
to 50 RCCMD clients can be executed without SSL.
License regulations:
Please note that in order to use these functions legally, the corresponding RCCMD client
program is installed and started from the UPS-Management Software CD. The RCCMD
license code can only be used once per installation. If more computers need to be added to
the shutdown process, additional RCCMD client licenses are required.
Note: All netw ork components, such as routers, hubs etc. need to be fully
UPS-supported, as it is otherwise not possible to reach all clients during
the network shutdown.
[Link].1 RCCMD Shutdown
49
Note: For security reasons we recommend to make the same RCCMD
shutdown entries for the Event “Battery low” - but in this Event w ithout
any delays to avoid that the server crashes because of low battery
alarm.
In case a connection is established using telnet or http, the RCCMD-
command can be tested w ithout using disrupting power to the UPS. At
the Web-browser you simply have to press “test” to transmit the
shutdown signal immediately. (see figure HTTP - Event Editor above)
Due to netw ork settings it is possible that this test is answered with
"failed". The signal is often sent and received although the receiver may
not respond correctly . In such cases, only use the receiver side to check
if the signal has actually been receiv ed. For checking the communication
between RCCMDs you have to check the RCCMD log file on both sides.
In the CS121 the logs are inside the Alarm log, at the RCCMD client side
the logs are found inside the RCCMD folder e. g. [Link].
Click on the CS121 Web-interface in the menu „Configuration“ the Events/Alarms button.
Select the event Powerfail.
Select the function “Send RCCMD Shutdow n to remote client” in the Job Editor:
50
Figure 52: HTTP - Job Editor
Enter the ip-address of the client, that should receiv e the shutdown.
The timer settings in the blue framed scheduler box w ill be executed only, if the EVENT is still
true after the delays/countdowns have run out.
E.g. if any action has been configured at "do after 10 seconds" than this action will NOT be
started, if after 9 seconds the EVENT is no longer true. Only if 10 seconds this EVENT w as
present, the action w ill be triggered.
See below the explanation of all timer event configuration options for this type :
"Alw ays”: Action/Job w ill be executed in case that this EVENT is true immediately and
repeated alw ays as long as the EVENT is true (every 5 seconds according to poll cycle
default of a CS121).
"Every x seconds”: Action/Job will be executed in case that this EVENT is true w ith a delay
of x seconds and repeated every x seconds again.
"After x seconds”: Action/Job w ill be executed in case that this EVENT is true after a delay
of x seconds. Action w ill be cancelled, if EVENT is false before time has run out.
"After x seconds and repeat”: Action/Job w ill be executed in case that this EVENT is true
after a delay of x seconds and will be repeated after x seconds again. Action will be cancelled,
if EVENT is false before time has run out.
"After x seconds on battery”: Action/Job will be executed in case that the EVENT UPS ON
BATTERY or POWERFA IL is true and after a delay of x seconds. Action will be cancelled, if
EVENT is false before time has run out. This Job is identical to the EVENT POWERFAIL and
the configuration "After x seconds".
"At seconds remaining time”: Action/Job will be executed in case that the UPS runs on
battery/Powerfail and the remaining time, read by the UPS or calculated by the
internal CS121 routine has reached a certain remaining time. Only useful if the
"Autonomytime" of your UPS can be regarded as reliable.
"REMAINING TIME " is defined as Autonomytime in seconds of this UPS at the actual
discharging level minus the DOWNTIME (configured in menu UPS MODEL & SYSTEM,
default is 3/6 minutes).
51
Figure 53: HTTP - Job Editor / Function
In this example a RCCMD Shutdow n is configured for the event Powerfail. The shutdown
signal should be send after 5 minutes (300 seconds). Click the „Apply “ button after you have
finished the configuration. Save your settings via the menu „Save Configuration“ and execute
the „Save, Exit & Reboot“ function.
We recommend to test the configuration prior of the implementation of the shutdown function
into a live-system. Click into the Event Editor of Powerfail the “Test” button (Job Type: RCCMD
SD).
After you have clicked the “Test” button (Attention! The shutdown will be executed immediately
without consideration of the defined delay), the following message will be displayed:
You can see the successful sending of the signal into the “AlarmLog”:
52
Figure 57: HTTP – AlarmLog
[Link].2 Autom atic Reset of the Redundancy Alarm
You can use the function „Send RCCMD cancel shutdown“, to discard a previously sent
shutdown automatically. If a shutdown was suppressed, because of the existing redundancy at
this point of time, but the problem w as solved at the UPS inter mediate, you can reset the
shutdown with the function „Send RCCMD cancel shutdown“. The client, w hic h received the
shutdown, w ill be encouraged to reset it.
This command can be set individually into your CS121, UPSMAN or BACS WEBMANAGER
Events/Alarms configuration, but makes sense only, if the event, which w ill send the command,
is true, if the UPS is back in normal condition. For this the events „POWER RESTORED“,
„BATTERY LOW OFF“, „UPSMAN STARTED“ and „GENERAL ALARM OFF“ are suitable, if
they are provided from your UPS into the CS121. The job „Send RCCMD cancel shutdown“
would be set into these all-clear events, so that e. g. at restart of the UPS, the event „UPSMAN
STARTED“ w ould reset the accordant RCCMD client automatically.
Alternativ e: Should the job „Send RCCMD cancel shutdown“ not be present into your CS121,
UPSMAN or BACS WEBMANAGER, you can use the job „Send RCCMD shutdown to remote
client“ or rather „Send RCCMD execute to remote client“ alternatively.
The parameter „WAKEUP“ got the same function like the „Send RCCMD cancel shutdown“
and resets the redundancy alarm of a RCCMD Client into initial state. For this the events
„POWER RESTORED“, „BATTERY LOW OFF“, „UPSMAN STARTED“ and „GENERAL
ALARM OFF“ are suitable too, to configure the function „Send RCCMD command to remote
client“ w ith the „WAKEUP“ command.
53
Click into the CS121 menu “Events/Alarms” onto “Pow er restored” and add a new job. Select
the function “Send RCCMD command to remote client”, set the accordant IP address of the
RCCMD client and click the “Cancel RCCMD Shutdow n” button.
RCCMD Message
With this job the user can combine and configure a text message with RCCMD event. Text
messages can be sent to RCCMD receivers. This makes it possible to send text messages via
RCCMD (version 2 or higher) to a Windows 2000 server or a Unix computer, us ing the “NET
SEND” or the respectiv e “WALL” method. The problem w ith notifying network users on
different operating systems is therefore solv ed.
54
Enable RCCMD Listener and set RCCMD Listener Port in menu “Netw ork & Security”.
Add IP of UPSMAN sender in the SNMP community of the CS121-RCCMD client (see also
section “SNMP”)
Target AUX port must be set to "use as Output" (menu AUX, see according section)
The send RCCMD Command must match the settings of the CS121 RCCMD listener client.
See the UPSMAN User Manual for setting up this job on a computer running UPS
Management Softw are.
[Link].5 Exam ple of use 2: CS121-adapter sw itches an output
CS121 receives an external RCCMD signal to switch an output at the SS4 (Pow er Switch)
whic h is connected to the AUX of a CS121.
If you w ant to send from a CS121, UPSMAN, SITEMANAGER II, SITEMONITOR II,
SITESWITCH 4 or any other RCCMD sender a signal to any other RCCMD client e.g. to sw itch
at its AUX port an output, please follow the example below .
Note: To let the receiver act as RCCMD listener, same basic settings in menu
“Netw ork & Security” are necessary: Please ensure that the option
“RCCMD Listener” is enabled and the RCCMD Listener port is specif ied.
(Usually the listener port is 6002)
55
Figure 62: HTTP - Job Editor: RCCMD-Command
If you want to send a signal from a RCCMD client, e.g. UPSMAN or RCCMD Software, to
switch an AUX port of a CS121, do the following:
C:\RCCMD\
56
[Link].6 RCCMD Trap
RCCMD Trap is the automatic messaging system of CS121, w orking w ith RCCMD clients. If
jobs have been configured in this category, the actions that are set here will be executed only
when an RCCMD client has established a connection to the UPSMON server of the CS121.
57
connecting an SS4/AUX pow er outlet manager, in which case all AUX ports function as
Outputs. For the AUX w e provide several “add-ons” like the SS4AUX, SM_IO Relay box,
SM_BUZZ Alarm beeper, etc. For a complete overview of “add-ons” for the AUX please see
the according datasheet, downloadable from [Link].
The CS121 L (external box) allotted from serial number 0121-10417 (delivered from
31.07.2008) about a COM3 port. The CS121 SC (slot card) allotted from serial number 0123-
09428 (delivered from 03.09.2008) about a COM3 port too. The AUX port assignment is
depending to the hardwaretype different, see figure 71 and 76.
[Link] Wake on LAN (WOL)
Note: Not all netw ork cards support this function, and for those network cards
that do, some of them are password protected. Please enable this
function on your computers BIOS settings on the motherboard.
Attention: If you want to send WOL signals into different subnets, it is requir ed, that
the switch, the PC and the CS121 are configured to “Autosensing”!
3.2.16 Scheduled Actions
This menu is for programming schedules actions on your CS121 or facility manager
SITEMANAGER. When combined w ith the other facility managing functions of the CS121
adapter, the Scheduled actions tool can be used to operate and run many different tasks, e.g.
Sw itch on/off UPS, do battery tests, switch to “green mode” or bypass, etc.
58
a different type of Action and see how the configuration w indow changes. This makes it very
easy for the user to configure the individual jobs. In addition, the w indow makes the scheduling
of reoccurring events very easy by offering the selection of ONCE, DAILY, WEEKLY, and
MONTHLY for each new entry.
Note: Please ensure that timeserver settings are valid when you configure
scheduled actions. An unreachable timeservice will be indicated at the
top of the menu “Scheduled Actions”.
3.2.17 SNMP
Within this menu you can define access controls for SNMP-communities. This concern e.g.
SNMP-Management tools, Trap receivers etc.. The CS121 firmw are version 4.44.x provides
SNMP V3. SNMP V3 requires the definition of at least a SNMP V3 user on both sides (CS121,
SNMP-Management tool). The follow ing SNMP V3 security level are at present:
o No auth, no priv: No authentication, no priv acy, but an SNMP V3 user
o Auth, no priv: Authentic ation (SNMP V3 user, SNMP V3 password), no
privacy
o Auth, priv: Authentication (SNMP V3 user, SNMP V3 password), SNMP
privacy password
The submenu displays a column of 10 manager IP-addresses with the corresponding access
permissions, the commands and an example. Use this screen to specify whic h managers have
access to the SNMP adapter agent, the community names (password) and also what type of
access the IP managers have - read only or read and write.
Configuring Trap-receivers
Use this to determine w hic h IP managers receive traps (messages) from your SNMP-adapter.
The screen permits you to send traps about your UPS to IP-addresses (managers).
59
Also, the menu for switching authentication and cold boot traps are located here. If activ ated
these traps are send to the configured SNMP trap receiv ers in the trap receiver list.
SNMP Trap Test
In this menu the user may test the SNMP traps, whereas the defined traps are only used for
test purposes and do not represent real traps. The receiv er must also be configured in order to
make this test work. Additionally, save the settings and reboot your CS121 before testing the
communication w ith the configured IP-address. (does not work in configuration mode). If you
use SNMP Test trap, you will receive SNMP Traps of a “Pow erfail” and “Pow er restored “
scenario – the simulation of a power outage of some seconds.
See also Netw ork & Security-Settings.
3.2.18 COM2 & AUX
[Link] COM2
This menu takes the user into the submenus for the general settings of the COM2 and AUX
connection ports of the CS121-adapter.
Note: Unless DIP-sw itch 1 is OFF the COM2 port is alw ays running in
configuration mode.
Pipe-Through Mode 1:
Enable or disable the “pipe-through” of the adapter. If enabled, the RS-232 protocol of the UPS
will be transmitted to the COM2 of the adapter, so now you can connect any other RS-232
software to the adapter to make use of the RS-232 UPS protocol – parallel to the adapter. This
makes the use of multiplexer hardware is no longer necessary. 2 serial interfaces on your UPS
whic h are working parallel are utilized now. Reminder: If you have enabled this function, you
can no longer configure the adapter via the serial cable, you must changed the settings via
HTTP. As communication cable betw een CS121 and your application you have to use the
original CS121 configuration cable.
Note: Please note, that it is required to define the same baud rate of the UPS
baud rate in “COM2 Baud Rate”. This is valid for Pipe-Through Mode 1 +
2!
60
Pipe-Through Mode 2:
Analog to Pipe-through mode 1, the UPS data is piped through to COM2 but not directly. In
order to accelerate the internal processes of the adapter, the UPS data is accumulated into
memory before being made available to COM2. Consequently, Pipe-through mode 2 also does
not provide for the relaying of signals to the UPS through COM2 either. (See also section
“Netw ork & Security Settings”)
MODBUS/SPI3
The selection of MODBUS/SPI3 in the drop down menu of the COM2 settings enables the
CS121 MODBUS/SPI3-Profibus function. The default CS121 device types communicating
MODBUS via RS232. The special CS121 device types LM and SCM communicating RS485
via the COM2. You can detect by means of the CS121 serial number 0124-..., if you got a
CS121 w ith RS485 interface. The CS121_SPI3 Profibus and LONBUS converters w ill be
connected to the COM2 w ith RS232 port and as configuration use MODBUS/[Link] take
a look into chapter 6.7 for further information.
61
Figure 71: HTTP - COM2 & AUX with TEMPMAN
RAS-Mode
The selection of the “RAS”-entry in the drop down menu of the COM2 settings enables the
CS121-RASManager function. This function is only operational if a RASMANAGER ist used
(CS121 w ith inbuilt modem) and a RASMANAGER license key is provided (optional, part of
RASMANAGER). While it is also possible to select this entry in the Telnet menu, it is only
possible to configure the RASMANAGER settings using the HTTP interface of the CS121. See
menu “RAS Configuration” for further settings.
GSM Modem
A GSM modem provides the notif ication or rather forwarding of the UPS events/alarms via
SMS. Please take a look into chapter 6.5 for further information.
SiteManager 2, SiteManager 2/v3
The selection of SiteManager 2, SiteManager 2/v3 enables the communication betw een the
CS121 and the SiteManager. The SiteManager is a professional facility management device,
whic h provides 8 configurable analog inputs, 8 digital inputs and 8 switchable relay contacts.
Please take a look into the SiteManager II user manual for further information.
SiteMonitor 2
The COM2 selection SiteMonitor 2 enables the communication betw een the CS121 and the
SiteMonitor 2. The SiteMonitor 2 is a professional facility management device, whic h provides
64 digital inputs for several contact detectors.
SM_T_COM
The SM_T_COM is a temperature sensor for the CS121 and is used for the monitoring and
controlling of UPS rooms, server rooms etc.. Please take a look into chapter 6.2 for further
information.
62
SM_T_H_COM
The SM_T_H_COM is a temperature and humidity sensor for the CS121 and is used for t he
monitoring and controlling of UPS rooms, server rooms etc.. Please take a look into the
SM_T_H_COM datasheet for further information.
[Link] AUX and SITESWITCH4 Settings
The AUX connection is an input/output port for connecting external contact devic es such as
alarms or for connecting to an SS4AUX SiteSw itch power socket manager. The SS4
SiteSw itch is a standalone device with a built in CS121. The SiteSw itch SS4 AUX is an
inexpensiv e and practical extension to the CS121 adapters enabling the individual power
switching of up to four power sockets – using the inbuilt AUX port (4 pins) of the CS121. By
entering the corresponding list number, the AUX ports are switched to output or input.
The AUX port can only read signals, if the port is switched to input. If sw itched to output the
AUX port can send signals to an optocoupler for example. (Refer to the circuit diagrams in the
appendix.) After a reboot, the state of the sw itches remains in the status previous to the
reboot.
The follow ing describes the configuration of the AUX ports using the HTML interface. All of the
AUX ports 1 – 4 can be manually set to „Output“ so that in the event of an alarm, the CS121
can be preconfigured in the “Events” menu to switch the ports individually. When all ports are
set to “Output”, this is equiv alent to activating the „SS4 Mode“. The SS4 mode is to be
activated when connecting a SITESWITCH4 to the AUX port of the CS121.
When the Output options are deactivated, the AUX ports act as inputs used for monitoring
signals such as input from alarm contacts. For example, w hile configuring port 2 as an input to
monitor an alarm, the CS121 can also be preconfigured to respond to the alarm signal from
port 2 to shut on or off a device connected to one of the other ports that has been set to
Output.
For example see also the settings in figure “HTTP - COM2 & AUX” above.
The OUTPUT setting is to be configured with a power-up sequence so that, for example the
fileserver on port 1 w ill be switched on upon Pow er up. In the Pow er up delay-fields the
number of seconds after a Pow er up in whic h a connected port device is to be switched on can
be entered. E.g. the setting 10 in the Power delay column w ill cause the switching on of the
fileserver on Port 1 to be delayed by 10 seconds after the Pow er up. Note that executing the
Save, Exit & Reboot does not cause a Pow er up, in order to cause a Power up the power
supply to the adapter must be interrupted. The differences between a Reboot and a Pow er up
become more noticeable w hen considering the AUX port contac ts. During a Reboot the current
status of the ports remain unchanged unless the settings of the ports have been changed from
input to output or vic e versa. A Power up will set the ports to the preconfigured Pow er up
settings.
Note: From CS121 HW131 it is required, if the AUX ports will be defined from
“Unused” to In- or rather Output, that a cable w ith Pull-Dow n resistance
or a CON-AUX or a CON-R-AUX is connected. Otherwis e the status
display of the AUX ports is undefined and can be changed by itself
anytime !
3.2.19 SENSORMANAGER
The SENSORMANAGER is a data measurement and collecting unit w hic h allows the
individual measurement and monitoring of 8 analog measurement devic es (0-10V) and 4
digital alarm inputs or 4 outputs (open collectors). SENSORMANAGER has its ow n chapter in
the manual, w herein the features and field of applications etc. pp. are described as well as in
depth the various specific configurations.
In generally, the SENSORMANAGER unit is connected w ith its COM 1 port to CS121’s COM 2
port, which has to be configurated as SensorManager mode (see also section COM 2 settings
above).
63
Within the configuration page “Sensor Manager Settings” of the CS121 you can - among
others - define limit values w hen events (to be configurated in “Events / Alarms”) will be
released.
64
3.2.21 Save Configuration / Reboot
If you are satisfied with your configuration select “Save, Exit & Reboot” and w ait until the
adapter informs you about the reboot-process. Do NOT close your web-browser !
Please notice that a reboot of the CS121 may take up to 3 minutes. During the boot phase the
CS121 is compiling the user settings and waits for timeserver response. As soon as the start-
up process is through and all requested data are present or „timed-out“, the UPS
communication starts and the green LED is flashing to signalize the UPS RS-232 traffic . Now
the devic e is ready for use and you may check the UPS values with any Web browser
(http:://<IP address>) or SNMP software - or you may connect with Dataw atch Pro-tools, such
as UPSMON, UNMS, USW or JAVAMON. When connecting w ith UPSMON or UNMS, TCP/IP
can be selected instead of SNMP. This is faster and contains more UPS values than an SNMP
communication.
3.3 Reading the Logfiles
The CS121-Alarmlog contains the alarm protocol of events that were designated as alarms in
the Event/Settings-section and include the user defined alarm settings of the CS121
configuration as well as the events that are designated as alarms in the UPS native protocol.
These entries include such things as CS121 Admin defined email notifications which lead to a
much higher alarm entry log level than w ould otherw is e be the case if only UPS protocol
defined alarms w ere being recorded. For explanation, the follow ing illustrates typical log file
entries made by the UPS:
The CS121 logs the time after a new start up:
01/17/2007,[Link], Synchronized with timeserver [Link]. OK
This indicates a successful synchronization with the timeserv er.
65
01/17/2007,[Link],MAIL: subject "CS121 Event 44" successfully sent
01/17/2007,[Link],MAIL: subject "CS121 Event 45" successfully sent
These are 8 Emails sending information about analogue sensors (temperature, humidity and
the like) that are connected to a SENSORMANAGER, indicating that all controlled values are
within tolerance levels - or that no sensor is connected to the devic e or connection port.
01/17/2007,[Link],MAIL: subject "CS121 Event 54" successfully sent
01/17/2007,[Link],MAIL: subject "CS121 Event 55" successfully sent
01/17/2007,[Link],MAIL: subject "CS121 Event 56" successfully sent
01/17/2007,[Link],MAIL: subject "CS121 Event 57" successfully sent
These 4 Emails indicate that the digital sensors (for airconditioning, fire alarms and the like) of
the SENSORMANAGER, are either in the normal state or that no sensor is connected.
01/17/2007,[Link],MAIL: subject "CS121 Event 62" successfully sent
01/17/2007,[Link],MAIL: subject "CS121 Event 63" successfully sent
01/17/2007,[Link],MAIL: subject "CS121 Event 64" successfully sent
01/17/2007,[Link],MAIL: subject "CS121 Event 65" successfully sent
These 4 Emails indicate the status of the digital alar m contacts of the sensors (for Emergency
OFF, fire extinguisher and the like) connected w ith the SENSORMANAGER, show ing either
the status is NORMAL or that nothing is connected.
01/17/2007,[Link],MAIL: subject "CS121 Event 70" successfully sent
This Email show s that no SENSORMANAGER is connected although the CS121 is configured
as having a connection to a Sensormanager. This informs the ADMIN that the CS121 is
incorrectly configured. In this case, the user should correct the settings.
The UPS data w ill be logged w ith timestamp into the CS121 DataLog.
The data of the connected devices (e. g. temperature sensor) w ill be logged into the CS121
ExternalDeviceLog.
66
Figure 75: HTTP – CS121 ExternalDeviceLog
In figure 62 the logging of a SM_T_H_COM is displayed, sensor 1 for the temperature, sensor
2 for the humidity.
At unif y UPS their events w ill be imported out of the UPS directly and are displayed into the
CS121 menu LogFiles, “UPS Events”.
67
3.4 CS121 for Transfer Sw itches
The CS121 is used from time to time for automatic transfer switches (ATS) too. The graphical
display depends on the manufacturer.
68
All ASYS, AEG and PILLER transfer sw itches are using the extended RFC1628 SNMP MIB
(Dow nload). The models SOCOMEC STS and LTM got their ow n MIB (STS LTM MIB), w hich
is available as download from our website:
[Link]
Note: We strongly recommend to update any firmw are lower than 2.69 to the
actual version!
All actual Firmw are-updates are provided at [Link] download page.
Note: Any interruption of a fir mw are upload may damage your adapter. If this is
the case, you have to reformat the adapter with special software See
section “Firmw are Recovery”. or contact your UPS software support for
more information.
The boot procedure of the CS121-adapter performs several steps:
First, the firmw are is going to be uncompressed.
Starting firmware
Control process called UPSMAN is going to be started and USV connection is trying to
established
Services e.g. Webserver etc. started
There are two ways to update your firmw are-version, by using the Setup-tool or via FTP.
4.1 Firmwareupdate via Setup-tool
Firmw are updates are available for free at [Link]. Dow nload the specif ied version
(mind your OEM ID) and follow up the setup-procedure. If necessary, consult your UPS dealer
for further information.
4.2 Firmwareupdate via FTP
A firmware update can be made via FTP during normal operation of the CS121-Adapter
(username: “admin”, password: “cs121-snmp”). Simply overwrite the older firmware files,
[Link], [Link] and [Link] in the FILES folder w ith the newer files
69
and reboot the adapter. Afterwards, reconfigure the devic e via Telnet. For more details read
the [Link] of the firmw are update package.
Note: The configuration of the CS121 can be saved for archiving purposes
using an ftp-connection. Simply dow nload the „[Link]“ to the
directory of your choice. Later on, after the CS121 has been updated,
the configuration can be saved back into the „flash“ directory of the
CS121 per ftp.
Caution: This upgrade process requires some technic al know ledge. This process
can seriously damage your CS121 if not performed correctly . Please
follow the instructions carefully to avoid damaging your system! We
strongly recommend to use the CS121 update tool to avoid conflicts and
to safely update your CS121.
General information regarding the upgrading process of the CS121 - Known Problems
and Prelim inary Precautions :
Any update w ill cause a deletion of all former settings. The adapter must be reconfigured
after the update. The current settings information can be saved by using an FTP connection to
your adapter to save the [Link] file in the flash dir ectory to a local directory. This file
contains all of the information about the current CS121 settings in a formatted text. Do not
copy this file back onto the adapter after the update as a replacement for the new [Link].
The information must be entered back into the settings using the adapters configuration
interface. Note that the http interface often contains newer settings options that are not yet
implemented in the telnet and terminal interfaces.
Any recovery should be made on the default IP Address [Link]. Put DIP Sw itch 1 and
2 in the OFF position before starting.
Please avoid the use of routers and sw itches between your computer and the CS121, if
available use Hub (recommended) or a direct line (Ethernet-cross-cable).
Instructions for recovery procedure :
In case the CS121 is not running, has any defect or other problem, please put dip switch 1 to
OFF ( Dip 2 should be alw ays OFF) and follow the procedure below:
70
1. Before starting the update, unplug the adapter from the pow er supply (slot cards have to be
removed from the slot).
2. Set a route to default IP-Address. Command syntax on your windows computer: "route add
[Link] <your IP address>". Als o note that the flash tool can also be used to set the route
for you by checking the set route check box in the update interface.
3. Check if your route is correctly set w ith the console command "route print". You should see
that [Link] is in the list.
4. Make sure that no other device is answering on "ping [Link]". If you get any answer
then you have to disable this device first before you can continue.
5. As an extra notice, the update interface dis plays an stereo button with the text "Format &
Rew rite" to show that all settings will be lost.
6. Press the "Start Update" button and re-power the CS121 in THE EXACT SAME MOMENT!
If the start w as successful, you w ill see that the f irmw are is loading. DO NOT INTERRUPT
THIS PROCESS! Pay attention to the process. If during the loading the following text
reappears in the dialogue:
"Connecting to target [Link] on port 4000....."
then shortly disrupt the power supply to the adapter in order to initiate the communication call
between the updating computer and the adapter once again. The process should then flow
through all the way to the follow ing text: "update successful".
Attention: It is important to start the update and the adapter at the same time
because even with a defect firmware installation, there is a window of 1
second during the start of a cold boot in w hich the CS121 w ill answer IP
calls to [Link]. When the firmware update tool gets a connection
during this time, the recovery process can start. If you get a timeout,
retry this procedure.
7. After the firmware has been loaded, you can reboot the adapter and configure the system
with HTTP (resp. TELNET), still using IP address [Link].
4.4 How to get the “[Link]” from a CS121 to your computer via FTP
Click on the w eb-interface of your CS121 into the configuration menu bar the „Save
Configuration“ button. Click the „Backup Configuration“ icon with the right mouse button, select
„Save Target As“ and choose the path of your hard dis k, where you want to store the
„[Link]“ data.
71
Figure 81: CS121-Configuration Manager
Via FTP: Enter the follow ing into the address field of a web-browser: [Link] of your
CS121>. Enter the username admin and the password cs121-snmp. You will find the
„[Link]“ into the „flash“ folder.
72
Figure 83: CS121-FTP Context Menu
73
Figure 85: CS121-FTP [Link]
After you have updated your CS121, please open the „new“ and the stored „[Link]“ in an
editor. Now check, if the parameter of the new data are present into the stored data. If not, you
need to copy the missing parameter of the new data into the stored „[Link]“.
Now you can overwrite the „[Link]“ into the „flash“ folder via ftp.
Just reboot (do not select „Save, Exit & Reboot“) the CS121 via web-browser.
74
Figure 87: CS121-Reboot
At the reboot, the stored „[Link]“ will be load and the CS121 w ill obtain the configuration
prior of the update.
75
BACS, SiteMonitor, SiteManager:
00-03-05-0A-xx-xx
where XX-XX represents the HEX code of the GENEREX CS121 Board’s serialnumber
(decimal).
How to find the CS121 board serialnumber:
Note: This is not the serial number of the CS121 itself, its the serial number of
the CS121. Motherboard. At a CS121 Slot this number is found as a
white lable on the board, the text of this lable maybe like this: "SN:B (or
C)-xxxxx QC:Passed". The number after SN:B (or C) is the
motherboards serialnumber. (If you can not find the label on the
motherboard, please contact your USV manufacturer.)
At CS121 external units you have to open the chassis to see this label.
Example 1 : If youre lable is : "SN:B-40985", than the correct command to set the MAC adress
for your CS121 is: "set MAC 00-03-05-02-A0-19".
[Alternativ ly you may use the CS121 Product serial number (e.g. 0123-11328) instead:
Example 2 : If youre Product serial number is : "0123-11328", than the correct command to set
the MAC adress for your CS121 is: "set MAC 00-03-05-02-2C-40"]
76
5. Additional Software
5.1 RCCMD
RCCMD is the client module for integrating an unlimited number of computers of any operating
system into an UPSMAN managed UPS facility. The main purpose is to transmit shutdown
signal or messages to RCCMD clients in other networks or on other OS.
77
Figure 89: RCCMD Client Installation – IP-Address
The follow ing window gives you the possibility to enable a periodical connection check and to
attach a batch-file to be executed in the case of a failure.
78
5.1.2 RCCMD w ith SSL for Windows
The Secure Sockets Layer (SSL) protocol is a cryptographic protocol that provides security
and data integrity for communications over TCP/IP netw orks.
Use your Web-browser to navigate to the address of your UPS Web-Manager. Click the
“Netw ork & Security” configuration button and enable the SSL network feature.
79
Figure 94: Settings Confirmation
Start the RCCMD Wizard installation again and enable the SSL netw ork feature.
80
5.1.3 RCCMD w ith own SSL certificates
In this chapter we will describe, how to use an own SSL certif icate with RCCMD, e. g.
OpenSSL ( [Link] ):
Be your own CA
Using OpenSSL it is quite simple to become your own CA. Just run:
[Link] –newca
Done! Just ensure, that you select a useful CN (common name) !
Create your RCCMD certificate
You need to create your certif icate for RCCMD now . As it will use it for verific ation, it should
contain the same useful common name (CN), that you selected for the CA. The private key
must not be encrypted to let the RCCMD Client (service) start without trouble. Therefore we
use the “–nodes” option and the “-newreq” command:
[Link] –newreq -nodes
Sign w ith your CA:
[Link] –sign
Now create an empty file named “[Link]“ and copy the cert information of [Link]
(rccmd certif icate), [Link] (private key) and [Link] (CA) into it. Please note, that the
exact copying is required to use it without trouble!
Use your own RCCMD certificate
Do the follow ing steps at the RCCMD Client and every sender (e. g. UPS Web Manager):
Backup the exis ting “[Link]”
Replace the existing “[Link]” w ith your own
Restart the RCCMD Client
Restart the RCCMD Sender
81
5.1.4 RCCMD client as relay station
In order to reach a bigger number of RCCMD receivers, the adapter needs to be operated as
relay station. The receiver w ill be configured so that it will receive a RCCMD signal and this
signal is then used to start a batch file, which then starts even more RCCMD sender signals.
This computer is then sender and receiver at the same time and is therefore an important link
in the UPS monitoring chain. Generally the use of an RCCMD client as relay stations makes
the management of several 100 RCCMD clients far easier than configuring this via the
Webbrowser interface of the CS121. Additionally, all Webrowser Event configurations have a
certain limitation so that you have to use the relay function if the number of jobs exceed e.g. 50
per event at the CS121 HW 131, at older CS121s even earlier.
See the following script, which lets the RCCMD-client act as relay station:
Figure 97: Example: Batch file to let the RCCMD act as relay station
5.1.5 License regulations
Please note that in order to use these functions legally, the corresponding RCCMD program is
installed and started from the UPS- Management Software CD resp. see [Link]-
dow nload page for the latest version. (see above) The license code can only be used once
per installation. If more computers need to be added to the shutdown process, additional
licenses are required. The CS121-adapter package does usually contain a single licenses for
RCCMD to shutdow n 1 computer. For more computers to shutdown you have to order
separate RCCMD client licenses. Generally the CS121 has an unlimited capacity to shutdown
RCCMD clients, but if you have to enter more than 30-50 RCCMD clients via the Webbrow ser
interface it may make sense to use RCCMD relays (see above).
5.2 gChart
(only older firmware before 4.26) gChart is a GENEREX plug-in for the MS Internet Explorer
available as a free download from the GENEREX w eb site. Quickly and easily visualise all of
the CS121-adapter logfiles using Generex's ActiveX graphic al log controller GChart when
using the Internet Explorer. Discover UPS problems more easily and optimise system tuning
more rapidly. Navigate through the data w ith the mouse using functions like zoom and pan with
continuous motion in real time and query interpolated data values by clicking in the areas of
interest. Customize the view by moving or toggling off the legend, toggle off and on the data
grid and also switch individual log values on and off.
82
Figure 98: gchart plug-in for the internet explorer
Get the gChart experience now by visiting our online CS121 at: [Link] and be
sure to follow the GChart logfile links.
In order to activate this function, the follow ing adjustments in the Internet Explorer Options are
required:
Click via the menu „Tools“ into the Internet Options.
Select the tab „Security“.
Click the „Trusted Sites“ icon, than the „Sites“ button and add the desired IP address.
83
Close the opened w indows via „Close“ and „Ok“.
Click into the Internet Options and Security again. Click via „Custom level...“ into the Security
Settings of the Trusted Sites Zone.
Initialize and script ActiveX controls not marked as save for scripting
Close the opened w indows via „Ok“ and restart your Internet Explorer with the desired site.
84
block diagrams. Other devices, such as diesel generators or extra measuring units can be
integrated w ith this management software via the network. A separate password protected
screen can be created, if the devices also support remote controlling commands. The values
and status information, w hic h are stored in the UPSMAN log file, can be requested from every
computer w ith an installed UPS monitor module.
Features:
Monitoring of all UPS systems that are connected in the netw ork via UPSMAN and
respective SNMP adapter
gCHART dynamic visual log file graphic tool
Remote controlling of all UPS systems via the netw ork
Graphic display of the UPS input data (voltage, power)
Read out and display of the UPSMAN event-log files
Programming of the UPSMAN scheduler
Graphic screens containing all UPS information also under UNIX, MAC (JAVAMON)
85
6. CS121-Enhancements, Field of applications
6.1 SiteSwitch4 (SS4) and SiteSwitch4AUX (SS4AUX)
Note: (only SS4, not SS4AUX) If you wis h to use a UPS w ith your SS4 then
you must install the appropriate CS121 Firmw are on your SS4. The
default Firmw are on SS4 (OEMID 27) is for the usage without UPS, as
standalone remote powerswitch. For UPS usage at the SS4 you must
also be sure to set the Exchange COM Ports checkbox and then use the
configuration cable to connect the SS4 w ith your UPS.
86
Figure 103: Exchange COM Ports 1 & 2 for SS4
6.1.1 SS4 Feature overview
4 configurable powers sockets w ith a breaking capacity of 230V/8A
Pow er socket status indicator via HTML, UPSMON, UNMS or SNMP
Control via the internal CS121 or via remote CS121 or RCCMD compatible devices
Remote control of the powers sockets via HTML Brow ser (Password protected)
LED-Status of the power sockets
Small metal casing w ith 1.5RU, designed for 19"-Rack Mountings (mounting frame included)
High breaking capacity (8A), input with IEC 16A.
Programmable power switching via the HTML and UPSMON Scheduler
Delay of alarm (e.g. UPS alar ms) triggered power switching on COM1 of the CS121
6.1.2 SS4 Contents
SITESWITCH 4
16A IEC 230V power cable
2 mounting irons for 19“-Rack installation
manual for SS4
The manuals are being constantly updated and therefore the reader is encouraged to check
our website for a newer download version of the adapter manual. Check
[Link] for manual updates.
6.1.3 SS4 Installation
The pow er consuming devices are connected to the SS4 using IEC 250 VAC/6A plug cables.
The SS4 has 4 IEC 250VAC/6A chassis sockets that can be sw itched on and off separately.
Special notice is to be giv en to the 8A threshold breaking capacity; exceeding this limit w ill
cause the SS4 fuse to break leaving all connected devices without electric ity.
Note: Due to errors that may cause the switched off power outlet to remain on
it is necessary to conduct the follow ing: Before connecting any power
consuming devices with the SITESWITCH 4 or working on any power
consuming devices already connected to the SITESWTICH 4, make sure
that the SITESWITCH 4 is not connected to the power supply by pulling
its power cable out of the power socket.
Use the provided mounting irons to fix the SS4 into a 19“ rack. Place the SS4 so that the front
panel of the SS4 can be securely screwed onto the 19“ rack housing while insuring also that
the power cables can be connected from behind as well.
As soon as all of the power consuming devic es are connected to the SS4, the IEC 16 pow er
supply cable can be connected. Upon establishing power to the SS4, the green „POWER„ LED
will light up, and the 4 „ Pow er Socket Status LED“ one for each of the sockets should be unlit.
This means that none of the sockets are being provided with power thus cutting the connected
devices from the power supply.
87
The CS121 establishes a user interface f or the SS4 for whic h the user has the option of using
either UPSMON, Webbrow ser, UNMS or an SNMP- Program. All communications take place
either through a modem or network connection. Detailed information is covered in section 7.7.9
AUX and SS4 Settings.
6.1.4 SS4 - Technical data
Inputvoltage: 230V AC +/- 5%
Max. Pow er Input: 16A
Max. Pow er Output per socket: 8A (Load at cos phi 1)
Dimensions 260x180x60mm (BxTxH), w ith 19” : 1,5U
Operating temperature: 0-40°C/rel.Humidity0-95% non condensating
6.2 Sensor SM_T_COM
The SM_T_COM is a temperature sensor for the use w ith a GENEREX CS121. It has a range
from -25° - 100° Celsisus (-13° –212° Fahrenheit) and comes w ith a 1.8 meter cable for
connecting to the CS121 COM2 port. The SM_T_COM is designed for monitoring and
management of 19"- racks, UPS rooms, server and data center rooms and for industrial
applications. Simple Plug' n Play connections insure that the sensor can be easily and safely
installed.
88
6.2.1 SM_T_COM configuration
In this example, a below threshold of 13 was defined for SM_analogue 1, in this case for the
temperature in °C, w hich will appear into the Event Configuration, after you executed the
“Save, Exit & Reboot” function.
89
Figure 109: CS121-Configuration Threshold Event for SM_analogue 1
90
the RJ11 socket. Convenient splitting plug available for attaching two sensors to one RJ11
socket.
Purpose:
Monitoring of temperatures, humidity and other analog data in computer rooms w ith
automated response to system alarms.
Alarms can be individually configured and defined for trip contacts such as fire, smoke and
intrusion, and minimum/maximum thresholds values can be set for analog devices such as
humidity, temperature and pressure, fluid level, etc. – any sensor whic h transmits its values
between 0- 10 V may be connected to a SENSORMANAGER.
Data logging, logging of alarms, automatic shutdowns of network computers, and other
actions can be set as reactions to critical alarms.
All system operating and configuring can be done remotely via Web browser. The EVENT
driven alarm management system of the CS121 informs the administrator of problems and
may automatically sw itch off computers and other devices (Optional extensions: SITESWITCH
4 or SITEMANGER).
The SENSORMANAGER is an extension to the CS121 Webmanager. If you want to connect
any other computing device, please download the RS-232 protocol for the SENSOR
MANAGER from our website and adjust your software to this communication type.
Important:
New firmw are for your CS121 is available for download at: [Link]
91
all 8 analog inputs, you have to use a splitting plug (optional) or connect the sensors directly to
the Channel Inputs as described above.
If you use the sensor type SM, you may connect a second SM sensor to the input of the first
SM. You can not connect more than 2 SM sensors in line.
For connecting an alarm contact to the SM sensor, you may use the first or the second SM
contact input/output, but not both. Only one digital input/output is available per socket.
OTHER SENSORS: If you use other sensors than SM, EE or TM, you must use a splitting plug
in order to connect more than one sensor to a single INPUT of the SENSORMANAGER.
For setting up the sensors in the SENSORMANAGER make sure your configuration matches
your sensor type, e. g. see example:
92
Figure 113: SENSORMANAGER II LEDs
Note: You have to configure the CS121 COM2 port to “SensorMan” (for SENSORMANAGER II
“SensorMan 2”) – otherw is e the CS121 w ill not start making requests to the SENSOR
MANAGER.
See the CS121 user manual for instructions on how to configure the CS121 for operation w ith
the TEMPMAN/SENSOR MANAGER and how to manage and set the alarms.
The latest version of CS121 user manual is available for download at:
[Link]
When the SENSOR MANAGER is running, you w ill see the values in the AUX section of the
CS121 Web browser.
Detection of the analog temperature values via variables:
#TEMP1
#TEMP2
#TEMP3
#TEMP4
#TEMP5
#TEMP6
#TEMP7
#TEMP8
Pin layout of INPUT Socket the SENSORMANAGER Box:
INPUT 1:
Pin 1 Voltage 9-24Volt +
Pin 2 Analog Channel 1 (0-10V+)
Pin 3 Analog Channel 5 (0-10V+)
Pin 4 Ground
Pin 5 OUTPUT: Open collector OUT 9-24 V, max. 30mA
Pin 6 INPUT: Digital Input 9-24V
INPUT 2:
Pin 1 Voltage 9-24Volt +
Pin 2 Analog Channel 2 (0-10V+)
Pin 3 Analog Channel 6 (0-10V+)
Pin 4 Ground
Pin 5 OUTPUT: Open collector OUT 9-24 V, max. 30mA
Pin 6 INPUT: Digital Input 9-24V
93
INPUT 3:
Pin 1 Voltage 9-24Volt +
Pin 2 Analog Channel 3 (0-10V+)
Pin 3 Analog Channel 7 (0-10V+)
Pin 4 Ground
Pin 5 OUTPUT: Open collector OUT 9-24 V, max. 30mA
Pin 6 INPUT: Digital Input 9-24V
INPUT 4:
Pin 1 Voltage 9-24 Volt +
Pin 2 Analog Channel 4 (0-10V+)
Pin 3 Analog Channel 8 (0-10V+)
Pin 4 Ground
Pin 5 OUTPUT: Open collector OUT 9-24 V, max. 30mA
Pin 6 INPUT: Digital Input 9-24 V
Example:
Alarm INPUT contact
If the alarm contact INPUT is used, you may connect your alarm contact e.g. to INPUT 1 Pin 6
and Pow er supply Pin 1. In the CS121 you can configure that as a HIGH signal to the alarm is
set – or the other way round.
OUTPUT contact
If you want to sw itch any relays or send high signals to the OUTPUT, you may connect your
OUTPUT contact e.g. to INPUT 1 Pin 5 to your relays and configure the CS121 as “OUTPUT”
for this signal. Now you may configure your Events in the CS121 to set the OUPUT to HIGH or
LOW.
Sensor connection
The sensor has to work within 0-10Volts, this may be connected directly to Channels 1-8, and
the CS121 w ill now show the values in its Web browser. Alarm thresholds and actions may be
configured via the EVENT manager of the CS121.
6.3.3 Special features of the SENSORMANANAGER II
Unlike the CS121 and the older SENSORMANAGER type, the new SENSORMANAGER II
configuration data w ill be stored in the device itself on a non-volatile chip. This result in a
different behaviour of the SENSORMANAGER II compared to the older SENSORMANAGER:
Acknow ledged alarms are displayed in yellow in the status bar of the SENSORMANAGER II.
Not confirmed alarms are dis played in red (at older SENSORMANAGER alw ays in yellow).
After clicking the “Apply” button no rebooting is required, because the SENSORMANAGER II
saves it configuration data in its internal ROM.
The 3 status diodes will be displayed in blue, if the communication betw een the CS121 and the
SENSORMANAGER II is lost.
The status site of the SENSORMANAGER II w as changed. The analog measurement values
will be displayed vertical.
94
Figure 114: SENSORMANAGER II Status Site
6.3.4 Configuration
The SENSORMANAGER II provides the opportunity of the definition of pre-alarm-thresholds.
Beside the name of the input you also define here as shown above the alarm thresholds, the
sensor range and the measurement unit. Note, that the alarm values (low and high) are only
active if the fields beside the alarm values are enabled. In the drop dow n menu “Sensor Type”
some basic sensor models are already listed, which you can choose to set predefined values
for these types (select “Custom” to make divergent or individual settings).
You can calibrate every sensor with the Sensor Range, that means if you want to rise a
measured value for 5°C, just modify the default range from 0-100 to 5-100. Therefore you are
able to adjust the measurement values like a gauged thermometer.
With the field “Hysteresis” you define the scope within the defined value can oscillate without
releasing an alarm. This is important e.g. for temperature measurements, which are not
increasing/decreasing continuously.
At “Lograte” you can set the loop time (in sec) in whic h the measured values w ill be written into
the logfile.
95
Figure 116: SENSORMANAGER II Configuration Outlets
Furthermore it is possible to attach a timer value to each Outlet. This determinates how long
an outlet w ill be sw itched (in seconds). Set the timer value to “0” if the outlet is to be sw itched
without any time limit.
Note: If you do not want to use a name for the Analog-, Digital Inputs or rather the
Outlets, please set the follow ing into the single name area:
96
in chapter 3.2.5 Events / Alarms. This is possible because each marker has its own event
“Alarm Marker x”, which can be configured through the event configuration.
The second possibility is to switch a relay output in dependency of the statue of one or several
markers. Therefore you have the output matrix, figured as below . In this example is configured
that Output 4 is to be switched on when Marker 1 or Marker 2 is set (or the opposite way
around in case “Output Inverted” is enabled). Using the “Alarm Matrix” offers you numerous
possibilities to sw itch Outputs in dependency of input alarms.
6.4 RASMANAGER
The RAS-Manager relays alarm signals coming from monitoring devices such as UPS,
SiteManagers, contact alarms and the like to monitoring stations or email receivers. Any
computer with RAS capabilities (Windows, Linux) can be used as a monitoring station. The
only requirement is the setup of an PPPServer on the monitoring station. After the
establishment of communications betw een the RAS-Manager and the monitoring station, a
RCCMD signal is sent that depending on configuration can either make log entries, send
emails and SMSs or execute programs.
97
Figure 120: RASMANAGER network integration
Alternativ e, you can make a Mini8-DSUB9 cable for the Siemens GSM TMA T35i Modem by
yourself , as follows:
98
Figure 122: Mini8-DSUB9 Cable Cross-Section
Add an accordant function via the “Events / Alarms” menu. Select the function “Send SMS w ith
GSM modem” for the notific ation via SMS and set the telephone number of the receiver and
the message.
99
LED Status Display
Into the menu “System & Netw ork Status” you can see the signal level of the modem, to adjust
your antenna optimal. Green means a good signal is present.
100
Figure 127: LED-Matrix display network integration
Any device operating as an RCCMD Sender like a computer running UPSMAN software,
RCCMD clients, CS121 Web managers and other RCCMD 2 compatible products can send
text messages or environmental data values to the LED-Matrix and can add sounding alarms
for warnings that require immediate attention. Users can also use the built in Web server
interface of the LED- Matrix to relay alarms and messages w ithout the use of an RCCMD
Sender. The user simply enters the message into the Web browser that is to be relayed
through the LED-Matrix.
For further information and description please take a look into the LED-Matrix User Manual.
6.7 MODBUS / PROFIBUS
MODBUS
Modbus is a serial communications protocol for use w ith its programmable logic controllers
(PLCs). It has become a de facto standard communications protocol in industry, and is now the
most commonly available means of connecting industrial electronic devices. Modbus allows for
communication betw een many devices connected to the same netw ork, for example a system
that measures temperature and humidity and communicates the results to a computer.
Modbus is often used to connect a supervisory computer with a remote terminal unit (RTU) in
supervisory control and data acquisition (SCADA) systems.
The CS121-series (exclude BUDGET models) support MODBUS over IP and MODBUS over
RS232 generally. Additionally, the CS121MODBUS-series also includes an RS485 interface at
COM2, w hich can be connected to a 485Bus-system.
Note: MODBUS response changed: Now MODBUS w ill respond with "-9999"
or with "-1", if values are requested, which are not available at this UPS
or other device. This shall clearly identify that this value is "not
available".
101
Figure 128: CS121MODBUS Installation
102
Figure 130: UNMS-Installation
103
Please note that the CS121 uses the standard MIB, w hich is included in most SNMP software
already. This MIB is called UPSMIB and corresponds with the Standard RFC1628. In most
cases compiling of the MIB is not required as it can be found under:
[Link]
Please check your MIB directory before compiling the RFC1628!
Configure the NMS
Set/compile the device MIB, if there is no standard UPS MIB RFC 1628 (CS121 only!)
Add the SNMP adapter object to the management map and configuration of the events (e.g.
message to the operator)
Ping the SNMP adapter
Due to the different compilation procedures of the SNMP softw are products, it is not possible
to explain the general procedures in greater detail. The compilation of a MIB file is explained in
the general SNMP software manuals. Please contact the support, if you cannot resolve errors
using this manual.
After the compilation the UPS software can be polled via a MIB browser and data can be read.
Please choose the corresponding MIB variable or string of MIB variable and set the destination
address TCP/IP of the adapter. The adapter w ill answer w ith the UPS data.
Alternativ ely the Windows UPSMON, JAVAMON or the UPS SNMP WATCH of the DataWatch
Pro Software can be used. The UPS data w ill then be dis played graphic ally and internal UPS
information, which are only useful to the technic al support, will be hidden. In addition to this,
the UPS SNMP WATCH is able to manage groups of UPS devices, in order to manage parallel
redundant UPS systems.
As an optional add-on for the HP OpenView softw are, a snap-in may be ordered for
UPSMAN/CS121.
Note: SNMP response changed: Now only those SNMP requests are
answered, which are present at this UPS or other device. Missing data
does no longer cause a return value "0" or "-1". An SNMP Walk w ill now
no longer return any OIDs, w hich are not supported by this UPS.
7. Troubleshooting – FAQ
Problem : Inform Pyramid DSP Series Communication w ith UPS Slotcard inside does not start
the UPS communication or if the external RS232 communication does not work.
Solution: It is required to put the DIP sw itches onto the UPS mainboard into the position “ON”,
if you are using a CS121 SNMP slot card! Put the DIP sw itches into the position “OFF”, if you
are using an external CS121 via RS232 interface!
104
Figure 131: Mainboard Inform Pyramid DSP
Problem : CS121 reboots again and again after a few time into company´s netw ork
environment.
Solution: The netw ork monitoring software “WhatsUp Gold” is started. We do not support this
software, stop the service, problem solved.
Problem : Sending of RCCMD signals, the following error is logged into the CS121 AlarmLog:
105
Appendix
A. CS121 - Technical data
Operating
Product Pow er Size Weight temperature
CS121L 12VDC 12,5 x 7 x 2,8 cm 210 gr. < 40° C
(Extern) 300 mA.
CS121SC 13,5 x 6 x 1,5 cm 66 gr. < 40° C
(Slot chinese)
CS121F 7,5 x 8 x 1,5 cm 64 gr. < 40° C
(Slot FUJI)
CS121R 14,5 x 7,5 x 1,5 cm 80 gr. < 40° C
(Slot RIELLO)
CS121MOD 12,5 x 7 x 2,8 cm 210 gr. < 40° C
(MODBUS Extern)
CS121BL 12VDC 12,5 x 7 x 2,8 cm 202 gr. < 40° C
(Budget Extern) 300mA.
CS121BSC 12,5 x 7 x 2,8 cm 59 gr. < 40° C
(Budget Slot Chinese)
106
Figure 134: Cable configuration HW121 COM2
107
Figure 137: Slot version: Circuit board connection
Pin1: -> GND
Pin2: -> VDD
Pin3: -> Tx D
Pin4: -> RxD
Pin9: -> GND
Pin8 connected w ith Pin 10
Figure 139: AUX-Port (Hardware Revision 1.1 = from Serial numbers 0121-1203, 0122-00198,
0123-00564 onwards) RJ11 6-pol
108
Pin1: -> +3,3V
Pin2: -> Input/Output 1
Pin3: -> Input/Output 2
Pin4: -> Input/Output 3
Pin5: -> Input/Output 4
Pin6: -> GND
The maximum input voltage is 3,3V. The input signals may be fed from external power sources
or feed directly from Pin 1. If the external power supply delivers more than 3,3V a pre-resistor
has to be fitted. The input resistance of the input is 1,5 k
When using a opto coupler switch, a Pull up resistor of 1,5kOhm has to be used.
Output-voltage: If configured as OUTPUT, every Pin delivers 3.3 Volt/10mA.
Figure 140: Example (Inputs): Opener or closer contact (only on hardware model CS121)
109
Figure 143: Examples: AUX Input on hardware model CS131 only, left side “pull-down”, right
side “pull-up” configuration
AUX port assignment for CS121 HW131 L from serial number 0121-10417 and CS121 HW131
SC from serial number 0123-09428:
PIN 1: 3,3V
PIN 2: AUX port 0: disposable
PIN 3: AUX port 1: disposable
PIN 4: AUX port 2: RX from COM3 (input)
PIN 5: AUX port 3: TX from COM3 (output)
PIN 6: GND
D. MODBUS Interface
D.1. General inform ation
For remote control and monitoring of devices the MODBUS interface in each CS121 M can
read out measurement values, events, status and other information in a master-slave protocol.
Note: Please note that not all UPS models support all or specif ic measurement
values (e.g. battery low).
Communication Parameters:
ASCII Mode works at CS131 & CS121 platforms with communcation
parameters 7/E/2, or 7/E/1 or with 7/N/2 from baudrate 1200 to 38400. We
110
recommend for ASCII the use of 7/N/2 and the highest baudrate supported by
your device.
MODBUS Parameter
If you receive faulty answers (Timeout Errors, Transaction ID Errors, Write Errors etc.) , it may
be, that the polling cycle was defined to fast. This causes the non answered polling requests or
even a reboot of the CS121 through the integrated Watchdog, because the system is
overloaded. Further on it can come to delayed answers during the MODBUS over IP or rather
RS485 polling due to traffic into the bus or netw ork, because the CS121 is a multi device,
whic h has to handle several tasks at the same time.
NOT E: Please define a response timeout of at least 2000ms (at a fast MODBUS over IP or
RS485 netw ork/bus or rather higher accordingly, e.g. 4000ms at slow connections). The
timeout has to be increased until the errors stay out.
Note: Please note that the MODBUS adapter client allows a timeout of 40ms at
9600 baud for one value.
D.3. Exception Codes
Except for broadcast messages, when a master devic e sends a query to a slave device it
expects a normal response. One of four possible events can occur from the master's query:
111
If the slave device receives the query w ithout a communication error, and can handle the query
normally, it returns a normal response.
If the slave does not receive the query due to a communication error, no response is returned.
The master program w ill eventually process a timeout condition for the query.
If the slave receives the query, but detects a communication error parity, LRC, or CRC, no
response is returned. The master program w ill eventually process a timeout condition for the
query.
If the slave receives the query without a communication error, but cannot handle it (for
example, if the request is to read a non existent register the slave w ill return an exception
response informing the master of the nature of the error.
Available Exception codes:
Code Meaning
01H Illegal Function:
The command received in the query is not defined.
02H Illegal Address:
The address received in the query is not defined for the slave.
04H Slave Device Failure:
Internal slave devic e error.
D.4. MODBUS Modes in the CS121 M (ASCII and RTU)
MODBUS Command
The follow ing tables contain the general command descriptions and examples with ASCII and
RTU framing.
Read Words (Functions 03h and 04h)
For the CS121 there is normally no difference between these tw o functions.
Query:
slave no function code address of first word word count Checksum
to read LRC or CRC
1 byte 1 byte High byte Low byte High byte Low byte 1 or 2 byte(s)
Answer:
slave no function code Byte count high byte low byte of bytes with Checksum
of first first word contents of n LRC or CRC
word words
1 byte 1 byte 1 byte 1 byte 1 byte n * 2 bytes 1 or 2 byte(s)
Example: Read Words, Function 04h, ASCII Mode
Read one w ord at address 63h (= 99 decimal):
Query:
Byte 1 2, 3 4, 5 6, 7 8, 9 10, 11 12, 13 14, 15 16 17
Mea- Lead- Slave Func- address of first word count to LRC Carria line
ning ing num- tion word to read read ge feed
colon ber code high low high low return LF
byte byte byte byte
ASCII : 0 1 0 4 0 0 6 3 0 0 0 1 9 7 <CR> <LF>
HEX [3A] [30][31] [30][34] [30][30] [36][33] [30][30] [30][31] [39][37] [0D] [0A]
Answer:
Byte 1 2, 3 4, 5 6, 7 8, 9 10, 11 12, 13 14 15
Mea- leadin Slave function byte content LRC carriag line
112
ning g number code count s of the e return feed
colon word LF
high low
byte byte
ASCII : 0 1 0 4 0 2 1 2 3 4 B 3 <CR> <LF>
HEX [3A] [30][31] [30][34] [30][32] [31][32] [33][34] [42][33] [0D] [0A]
ASCII: Data, w hich w ill send over the link as ASCII characters.
HEX: Hexadecimal values of the data
The word at address contains the value 1234h = 4660 decimal.
Example: Read Words, Function 04h, RTU Mode
Read one w ord at address 63h (= 99 decimal):
Query:
Byte 1 2 3 4 5 6 7 8
Meani silent Slave function address of first word count to CRC silent
ng interval number code word to read read interval
>= 3.5 high low high low low High >= 3.5
charact byte byte byte byte byte byte charact
ers ers
RTU [01] [04] [00] [63] [00] [01] [C1] [D4]
HEX
Answer:
Byte 1 2 3 4 5 6 7
Meani silent Slave function byte Content CRC Silent
ng interval number code count s of interval
>= 3.5 the >= 3.5
charact word charact
ers ers
RTU high low low high
HEX byte byte byte byte
[01] [04] [02] [12] [34] [B4] [47]
The word at address contains the value 1234h = 4660 decimal.
Some clients (e. g. MODBUS Poll) use “MODBUS addresses” w ith a valid range of 0-
65535, but some other clients use the “MODBUS register” w ith a valid range of 1-65536. In this
case it is required to add a “1” to the MODBUS address you want to poll.
If you are using a PILLER UPS w ith a CS121 firmw are version 4.29.3 or higher,
please take a look into the UPS user manual for the accordant MODBUS values. If you are
using a BACS system at the same time, no BACS values w ill be available via MODBUS.
113
AddressType FunctionName Description Length
100 U 3/4 OUTP0WER0 Outpow er Phase 1 1
101 U 3/4 OUTP0WER1 Outpow er Phase 2 % 1
102 U 3/4 OUTP0WER2 Outpow er Phase 3 % 1
103 U 3/4 BATTCAP Battery Capacity % 1
104 S 3/4 INVOLT0 Input Voltage Phase 1 V 1
105 S 3/4 INVOLT1 Input Voltage Phase 2 V 1
106 S 3/4 INVOLT2 Input Voltage Phase 3 V 1
107 S 3/4 TEMPDEG Temperature C° 1
108 S 3/4 AUTONOMTIME Autonomy Time minutes 1
109 U 3/4 STATUS (e. g. UPS nor mal = “4”, UPS Status (ASCII HEX) 1
Pow erfail = “12”, Battery test Please note UPSMAN
running = “68”, Bypass = “5” ) status bytes table below
110 S 3/4 BATTVOLT Battery Voltage V 1
111 U 3/4 INFREQ0 Input Frequency Hz Phase 1
1
112 U 3/4 INFREQ1 Input Frequency Hz Phase 1
2
113 U 3/4 INFREQ2 Input Frequency Hz Phase 1
3
114 U 3/4 CNT_PF Pow erfail Counter 1
115 U 3/4 Alarm Battery Bad 1 = active; 0 = not active 1
116 U 3/4 Alarm: On Battery 1 = active; 0 = not active 1
117 U 3/4 Alarm: Battery Low 1 = active; 0 = not active 1
118 U 3/4 Alarm: Battery Depleted 1 = active; 0 = not active 1
119 U 3/4 Alarm: Over temperature 1 = active; 0 = not active 1
120 U 3/4 Alarm: Input Bad 1 = active; 0 = not active 1
121 U 3/4 Alarm: Output Bad 1 = active; 0 = not active 1
122 U 3/4 Alarm: Output Overload 1 = active; 0 = not active 1
123 U 3/4 Alarm: On Bypass 1 = active; 0 = not active 1
124 U 3/4 Alarm: Bypass Bad 1 = active; 0 = not active 1
125 U 3/4 Alarm: Output Off as requested. 1 = active; 0 = not active 1
126 U 3/4 Alarm: UPS Off as requested. 1 = active; 0 = not active 1
127 U 3/4 Alarm: Charger Failed 1 = active; 0 = not active 1
128 U 3/4 Alarm: UPS Output Off 1 = active; 0 = not active 1
129 U 3/4 Alarm: UPS System Off 1 = active; 0 = not active 1
130 U 3/4 Alarm: Fan Failure 1 = active; 0 = not active 1
131 U 3/4 Alarm: fuse failure 1 = active; 0 = not active 1
132 U 3/4 Alarm: general fault 1 = active; 0 = not active 1
133 U 3/4 Alarm: diagnose test failed 1 = active; 0 = not active 1
134 U 3/4 Alarm: communication lost 1 = active; 0 = not active 1
135 U 3/4 Alarm: awaiting power 1 = active; 0 = not active 1
136 U 3/4 Alarm: shutdown pending 1 = active; 0 = not active 1
137 U 3/4 Alarm: shutdown imminent 1 = active; 0 = not active 1
138 U 3/4 Alarm: test in progress 1 = active; 0 = not active 1
139 U 3/4 AUX Port 1 1 = active (high) 1
0 = not active (low)
140 U 3/4 AUX Port 2 1 = active (high) 1
0 = not active (low)
141 U 3/4 AUX Port 3 1 = active (high) 1
0 = not active (low)
114
142 U 3/4 AUX Port 4 1 = active (high) 1
0 = not active (low)
143 U 3/4 Sensormanager/SMTCOM sensor Analog value 1
1
144 U 3/4 Sensormanager/SMTHCOM Analog value 1
sensor 2
145 U 3/4 Sensormanager sensor 3 Analog value 1
146 U 3/4 Sensormanager sensor 4 Analog value 1
147 U 3/4 Sensormanager sensor 5 Analog value 1
148 U 3/4 Sensormanager sensor 6 Analog value 1
149 U 3/4 Sensormanager sensor 7 Analog value 1
150 U 3/4 Sensormanager sensor 8 Analog value 1
115
160 U 3/4 TrueOutputPow er Phase A in KW True Output Pow er Current 1
Phase 1 in Kilow att
161 U 3/4 TrueOutputPow er Phase A in KW True Output Pow er Current 1
Phase 1 in Kilow att
162 U 3/4 TrueOutputPow er Phase A in KW True Output Pow er Current 1
Phase 1 in Kilow att
163 U 3/4 AUX Port 1 1 = active (high) 1
0 = not active (low)
164 U 3/4 AUX Port 2 1 = active (high) 1
0 = not active (low)
165 U 3/4 AUX Port 3 1 = active (high) 1
0 = not active (low)
166 U 3/4 AUX Port 4 1 = active (high) 1
0 = not active (low)
116
10 bit 2 0 Status 0: Floating charge 1
Status 1: Instant charging
11~30 bit 2 For future expansion 1
After 31 bit 2 Venders own definition 1
117
26 word 4 Temp 5 0.1degC
UPS shelf temperature
Digital output (DO)
Function 1 to read data; 5 to control the function
0 bit 1/5 UPS Turn On
118
162 U 3/4 TrueOutputPow er Phase A in KW True Output Pow er Current 1
Phase 1 in Kilow att
163 U 3/4 AUX Port 1 1 = active (high) 1
0 = not active (low)
164 U 3/4 AUX Port 2 1 = active (high) 1
0 = not active (low)
165 U 3/4 AUX Port 3 1 = active (high) 1
0 = not active (low)
166 U 3/4 AUX Port 4 1 = active (high) 1
0 = not active (low)
119
121 U 3/4 Alarm: Charger Failed 1 = active; 0 = not active 1
122 U 3/4 Alarm: UPS Output Off 1 = active; 0 = not active 1
123 U 3/4 Alarm: UPS System Off 1 = active; 0 = not active 1
124 U 3/4 Alarm: Fan Failure 1 = active; 0 = not active 1
125 U 3/4 Alarm: Fuse Failure 1 = active; 0 = not active 1
126 U 3/4 Alarm: General Fault 1 = active; 0 = not active 1
SensorManager/SMTH_COM,
137 U 3/4 Sensor 1 Analog Value 1
SensorManager/SMTH_COM,
138 U 3/4 Sensor 2 Analog Value 1
139 U 3/4 SensorManager/Sensor 3 Analog Value 1
140 U 3/4 SensorManager/Sensor 4 Analog Value 1
141 U 3/4 SensorManager/Sensor 5 Analog Value 1
142 U 3/4 SensorManager/Sensor 6 Analog Value 1
143 U 3/4 SensorManager/Sensor 7 Analog Value 1
144 U 3/4 SensorManager/Sensor 8 Analog Value 1
120
Section OEM Netminder for all other types
121
131 U 3/4 Alarm: On Bypass 1 = active; 0 = not active 1
132 U 3/4 Alarm: Bypass Bad 1 = active; 0 = not active 1
SensorManager/SMTH_COM,
151 U 3/4 Sensor 1 Analog Value 1
SensorManager/SMTH_COM,
152 U 3/4 Sensor 2 Analog Value 1
122
153 U 3/4 SensorManager/Sensor 3 Analog Value 1
154 U 3/4 SensorManager/Sensor 4 Analog Value 1
155 U 3/4 SensorManager/Sensor 5 Analog Value 1
156 U 3/4 SensorManager/Sensor 6 Analog Value 1
157 U 3/4 SensorManager/Sensor 7 Analog Value 1
158 U 3/4 SensorManager/Sensor 8 Analog Value 1
Secti
on
OEM POWERTRONIX
MIZAR
Adres
se Name ALCOR QUASAR SUPERNOVAE
123
121 Alarm: Output Bad not supported x not supported
122 Alarm: Output Overload x x x
123 Alarm: On Bypass x x x
124 Alarm: Bypass Bad x x x
Alarm: Output Off As
125 Requested x x x
126 Alarm: UPS Off As Requested x x x
127 Alarm: Charger Failed x x
128 Alarm: UPS Output Off x x x
129 Alarm: UPS Sytem Off not supported x not supported
not
130 Alarm: Fan Failure x supported x
not
131 Alarm: Fuse Failure not supported supported not supported
132 Alarm: General Fault x x x
not
133 Alarm: Diagnose Test Failed not supported supported not supported
134 Alarm: Communication Lost x x x
not
135 Alarm: Awaiting Pow er not supported supported not supported
not
136 Alarm: Shutdown Pending not supported supported not supported
not
137 Alarm: Shutdown Imminent not supported supported not supported
not
138 Alarm: Test In Progress x supported not supported
139 AUX Port 1 x x x
140 AUX Port 2 x x x
141 AUX Port 3 x x x
142 AUX Port 4 x x x
124
Section Transfer Switches All transfer sw itch vendors, except PILLER
1 U 3 / 4Sources Asynchronous Warning, input current difference, switching might 1
not be possible
2 U 3 / 4Static Sw itch A Failure Alarm, switching failure 1
3 U 3 / 4Static Sw itch B Failure Alarm, switching failure 1
4 U 3 / 4On Static Sw itch A Supplied from input A 1
5 U 3 / 4On Static Sw itch B Supplied from input B 1
6 U 3 / 4On Manual Bypass A Supplied via bypass from input A 1
7 U 3 / 4On Manual Bypass A Supplied via bypass from input B 1
8 U 3 / 4Source A Failure Alarm, input A failure, problem w ith voltage 1
9 U 3 / 4Source B Failure Alarm, input B failure, problem w ith voltage 1
10 U 3 / 4General Fault General alarm 1
125
108 U 3 / 4EX_NOM_CURR Nominal Current 1
109 U 3 / 4STATUS GENEREX UPS Status (see below) 1
126
UPS Status Hex-Value Dec-Value Description
127
D.8. Configuration
Please use Telnet (network connection) for the configuration with the default IP address
[Link]. Put DIP sw itch 1 into the “OFF” position. If you have a RS-232/ RS-485 converter
available you can also use a HyperTerminal via COM2 w ith both DIP sw itches in the “OFF”
position.
D.9. TCP/IP - UDP Ports
The follow ing are ports of the CS121 SNMP Adapter. These are the ports that have to be
made available in the Firew all in order to use all of the CS121 functions:
Echo 7/tcp
echo 7/udp
WOL 9/udp
ftp-data 20/tcp
ftp 21/tcp
telnet 23/tcp
smtp 25/tcp
http 80/tcp
snmp 161/udp
snmptrap 162/udp
time (rfc868) 37/tcp
time (sntp) 123/tcp
rccmd 6003
Upsmon 5769
Modbus over IP 502/tcp
Update flash 4000/udp
The UPSMON port 5769 is required for the follow ing:
UPSMON Windows
RCCMD and UNMS II alive check
Port forwarding (unblocking of several CS121 into the network via own ports into
other networks)
Support of all other commands and functions via UPSTCP
D.10. MODBUS Cables
The follow ing cable (Cable 112) is used for connecting the Schneider Electrics TSX SCY
CM6030 MODBUS device and the CS121 MODBUS adapter.
128
Note: Not all variables are supported from all UPS- models. Please try the use
of the variable to see, whether your UPS supports the variable or not.
Variable Meaning
OUTPUT_VOLT Output voltage - only supported from specif ied USV manufactures
OUTPUT_CURRENT Output currency
SECSONBATT Seconds, since the event power outage has been released
STATUS Actual UPS state
INVOLT0 Input voltage, phase 1
INVOLT1 Input voltage, phase 2
INVOLT2 Input voltage, phase 3
INCURR Input currency
BATTVOLT Battery voltage
TEMPDEG Ambient or operating temperature – depends on the UPS-Model
AUTONOMTIME Pow er-on time left over under actual charge
BATTCAP Capacity of the battery in percent
OUTPOWER0 Load in percent, phase 1
OUTPOWER1 Load in percent, phase 2
OUTPOWER2 Load in percent, phase 3
INFREQ0 Input frequency, phase 1
INFREQ1 Input frequency, phase 2
INFREQ2 Input frequency, phase 3
OUTFREQ0 Output frequency, phase 1
OUTFREQ1 Output frequency, phase 2
OUTFREQ2 Output frequency, phase 3
CONNECT ID of the used UPS protocol
CABLE ID of the used cable type
POWER Configurated UPS Pow er
LOAD Configurated Load
HOLDTIME Configurated hold time
RECHARGETIME Configurated time for a complete battery charging
MODEL UPS model name
TIMEREMAIN Resttime (AUTONOMTIME-POWERREMAIN)
LOCALTIME Local timestamp
OUTPHASES Output phase
INPHASES Input phase
LOCATION UPS-Adapter location
DATE Date
129
TIME Time
ATTACHED_DEVICES Attached devices
BATTINSTDATE Battery installation date
AGENTSOFTREV Firmw are version
MANUFACTURER Manufacturer
TEMP1, Actual measurement for sensors 1-8, used for SensorMan settings
…, only
TEMP8
TEMP1LOCATION, Configurated sensor 1-8 location
…,
TEMP8LOCATION
TEMP1UNIT, Configurated sensor 1-8 unit
…,
TEMP8UNIT
CUSTOM1TEXT, Configurated Custom Text 1-6
…,
CUSTOM6TEXT
130
G. Events/Alarms of the CS121 – Description of the alarms
The Events/Alarms are different from UPS to UPS, depending on the UPS manufacturer. We
are describing in the following example the Events/Alarms of a NEWAVE UPS, w hich are
similar to most of the UPS. Anyway all alarms, whic h are not POWERFAIL, BATTERY LOW,
SYSTEM SHUTDOWN, UPSMAN STARTED and AUX, you should advice your UPS
manufacturer, because an UPS hardware failure might be present! The mentioned alarms are
universal. The POWERFAIL and BATTERY LOW alarm require a reaction, e. g. the
configuration of shutdowns of clients via RCCMD.
Event Description
Maintenance breaker open (inactive). Load will be supplied via the UPS.
Maintenance Breaker Open Regular UPS protected operation.
Inverter Breaker Open Inverter breaker open. Load is not UPS protected!
Inverter breaker closed. Load will be supplied via the inverter. Normal
Inverter Breaker Closed condition.
131
Battery Breaker Closed Battery breaker closed. OK, normal condition.
UPS Off UPS off
UPS On UPS on
New Alarm New alarm, buzzer was activated.
Buzzer Off Buzzer off
General Alarm An alarm has occured. Alarm LED at the UPS is flashing.
General Alarm Off No more alarm is active. Alarm LED at the UPS is off.
Overtemperature Overtemperature of the UPS
Temperature Ok Temperature of the UPS is back in normal range.
Output Bad UPS output failure (e. g. voltage, frequency)
Output Okay UPS output OK
Overload UPS overload, reduce load otherwise the UPS shutdown is pending
No More Overload No more overload
Bypass Bad Bypass failure at input (e. g. voltage, frequency)
Bypass Ok Bypass Ok
UPS Shutdown Canceled UPS shutdown canceled
UPS Shutdown UPS shutdown initiated
Charger Fault Charger fault
Charger Ok Charger Ok
System Off UPS output will be switched off or rather is off
System Off Canceled UPS output switching off canceled
Bypass On Bypass on
Bypass Off Bypass off
Battery Depleted Battery depleted
Input Bad Input bad, alarm will be triggered with the powerfail event
Mains Input Okay Power restored at the input
Fan Failure UPS fan failure
Fan Ok UPS fan OK
Awaiting Power Awaiting power prior of automatic start of UPS
Shutdown Pending UPS shutdown/switching off is pending
Shutdown Imminent UPS shutdown/switching off is imminent
Unit Powerfail Powerfail at an UPS module
Unit Power Restored Power restored at an UPS module
132
Redundancy Lost UPS redundancy lost, load to high or UPS modules are not at hand
Inverter Failure Inverter failure
Emergency Power Off Emergency power off, UPS was switched off
133
Schematic drawing of an UPS, e. g. NEWAVE
Yellow = Fuse
Blue = Automatic breaker
Green = Manual Breaker
Event Description
UPS is on battery and the autonomy time decreases. ADVICE: The RCCMD
shutdowns will be set into this alarm, to send shutdown signals to the
Powerfail clients, if the powerfail will last longer!
Power restored Power supply restored
UPS connection lost UPS RS232 communication lost, CS121 tries to restore the connection.
UPS connection restored UPS RS232 communication restored
UPS Battery Old UPS batteries too old, call UPS service
Overload UPS overload, reduce load otherwise the UPS shutdown is pending
Load Normal No more overload
Overtemperature Overtemperature of the UPS
134
Temperature Normal Temperature of the UPS is back in normal range
Bypass on Bypass on
Bypass off Bypass off
The autonomy of the battery has reached the defined threshold "Battery
Low". The UPS shutdown is pending. ADVICE: The RCCMD shutdowns will
be set into this event too, but without delay! (Emergency shutdown, if
Battery low batteries are to weak)
UPS battery bad Battery in bad condition
This event got no relevance and will be removed in the future CS121
Scheduler Shutdown firmware
Input bad Input bad, alarm will be triggered with the powerfail event
Load >80% Load is over 80%
Load >90% Load is over 90%
General Alarm An alarm has occured. Alarm LED at the UPS is flashing
General Alarm canceled No more alarm is active. Alarm LED at the UPS is off
Manual Bypass on Manual Bypass on
Manual Bypass off Manual Bypass off
Charger fault Charger fault
AUX Port 1 High AUX port 1 opened
AUX Port 2 High AUX port 2 opened
AUX Port 3 High AUX port 3 opened
AUX Port 4 High AUX port 4 opened
AUX Port 1 Low AUX port 1 closed
AUX Port 2 Low AUX port 2 closed
AUX Port 3 Low AUX port 3 closed
AUX Port 4 Low AUX port 4 closed
135
Configuration of the SNMP service (on Windows Server 2003)
Close Add or Remove Programs.
Click Start, Run, type [Link], and then click Enter.
Scroll down and select SNMP Service. Right click the servic e and select Properties.
136
Figure 148: SNMP Trap Service
In the Operations console (Authoring space), start the Create a Monitor Wizard.
On the Select a Monitor Type page, do the follow ing:
Expand SNMP Trap Based Detection Simple Trap Detection Event Monitor
– Single Event and Single Event.
Select your unsealed management pack from the list. Click Next.
137
Figure 150: Select a Monitor Type
138
Figure 151: General Properties
On the Configure the trap OIDs to collect page for the First SNMP TrapProvider,
leave Use discovery community string selected.
Click to place the cursor in the Object Identifier Properties section and type the first
object identifier (OID) that you want to monitor: [Link].[Link].3
(upsTrapAlarmEntryAdded). Then click Next.
139
Figure 152: Configure the trap OIDs to collect
On the Build Event Expression page, click to place the cursor in the Parameter
Name section and type the trap parameter variable that you want to use here:
/DataItem/SnmpVarBinds/SnmpVarBind[2]/Value
Why did we use SnmpVarBind[2] in our expression? Because the traps second
contains the OID of the traps UPS alarm (Object upsAlarmDescr of the trap).
Click to place the cursor in the Operator section and select Equals.
Click to place the cursor in the Value section and type the value to match here:
[Link].[Link].6.3.2 (The [Link].[Link].6.3.2 is the well known alarm OID for
upsAlarmOnBattery).
140
Then click Next.
On the Configure the trap OIDs to collect page for the Second SNMP TrapProvider,
leave Use discovery community string selected.
Click to place the cursor in the Object Identifier Properties section and type the first
object identifier (OID) that you want to monitor: [Link].[Link].4
(upsTrapAlarmEntryRemoved). Then click Next.
On the Build Event Expression page, click to place the cursor in the Parameter
Name section and type the trap parameter variable that you want to use here:
/DataItem/SnmpVarBinds/SnmpVarBind[2]/Value
Why did we use SnmpVarBind[2] in our expression? Because the traps second
contains the OID of the traps UPS alarm (Object upsAlarmDescr of the trap).
Click to place the cursor in the Operator section and select Equals.
Click to place the cursor in the Value section and type the value to match here:
[Link].[Link].6.3.2 (The [Link].[Link].6.3.2 is the well known alarm OID for
upsAlarmOnBattery).
141
Figure 155: Build Event Expression
On the Configure Alerts page, set the properties of the alert, for example:
Type the Name for the alert, such as UPS OnBattery Alert.
Optionally, type the Alert description. You can also click the (…) button and select
Target and Data variables to include in the description, such as Devic e Name.
Select a Priority from the list, such as High.
Select a Severity from the list, such as Critical.
Click Create
142
Figure 157: Configure Alerts
143
Figure 158: Discovery Method
Discovery for even a single device will run for a couple of minutes by default. If you specify an
IP range, it w ill take a little longer.
On the Select Objects to Manage page, select the devic es desired for management.
On the Summary page, click Finish. The objects w ill display in the Network
Devices node of the Operations Console Administration space.
At this point, SNMP-enabled device availability monitoring w ill start automatically. Any traps (of
kind upsAlarmOnBattery) received from the cs121 target devices w ill be rais ed as alerts in the
Operations console.
1. Install a RCCMD client on a Windows OS and copy/create a file, like the follow ing, into the
RCCMD directory (default C:\Program Files\RCCMD) and use a SNMPw alk tool from an open
source with the mandatory dis tribution txt-file « [Link] ». This file is included for legal
reasons (Open Source).
144
Figure 159: „[Link]“
The command is called « [Link] » and expect 4 parameters :
2. The batch file “[Link]” accepts now several parameters from incoming RCCMD executes
and translates these into SNMP set commands for the Raritan.
If this w orks manually from your Windows RCCMD computer, than you can go ahead with step
3.
3. Now you have to select the desired CS121 event and add a RCCMD command, w hich will
be send to the Windows computer, where RCCMD is running and the “[Link]” file is
located.
145
Figure 160: CS121 Configuration for such a relay command
The target of the RCCMD command is the Window s computer with RCCMD and the
„[Link]“ w ith the IP address [Link]. If the event „UPS Major Alarm Added“ will
occur, this Job w ill execute the command „[Link] [Link] public2 1 0“ to switch off
the socket number 1 at the Raritan w ith the IP address [Link] immediately.
Tip: You should stop RCCMD running in the background on this Windows computer, so you
will better see, whats going on. Stop the RCCMD service, than open a command line into the
RCCMD folder and start „[Link] –debug“. Now the software w ill run in the foreground and
you can watch the communication.
4. The Raritan w ith firmw are 1.4.1 is unfortunetaley buggy. Here the workaround:
The default community strings for the Raritan are identically set for „read“ and „write“ to
„public“, but this configuration is invalid! It must be different!
Solution: Stop the SNMP Agent at the Raritan, change the community for „write“ to any other
than „public“ and restart it!
146
The default Raritan user is „admin“, password is „nimda“.
Attention! This does not work with MS Internet Explorer! Use any other web-browser,
e. g. Mozilla Firefox.
Click on „Stop“, change the configuration on „Write Community“, e. g. to „public2“ and restart.
147
Table of figures
148
Figure 52: HTTP – AlarmLog .............................................................................................. 50
Figure 53: HTTP – Job Editor RCCMD WAKEUP .............................................................. 50
Figure 54: HTTP – Job Editor RCCMD WAKEUP .............................................................. 51
Figure 55: HTTP - Job Editor: RCCMD execute/command................................................. 51
Figure 56: HTTP – Enable RCCMD Listener ...................................................................... 52
Figure 57: HTTP - Job Editor: RCCMD-Command ............................................................. 53
Figure 58: HTTP - Job Editor: RCCMD-Trap ...................................................................... 54
Figure 59: HTTP - Job Editor: Shutdow n UPS-Job ............................................................. 54
Figure 60: HTTP - Job Editor: Sw itch AUX-Port ................................................................. 54
Figure 61: HTTP - Job Editor: Wake on LAN...................................................................... 55
Figure 62: HTTP - Scheduled Actions w ith warning............................................................ 55
Figure 63: HTTP - SNMP.................................................................................................... 56
Figure 64: HTTP - COM2 Mode overview........................................................................... 57
Figure 65: Pipe Thru Installation ......................................................................................... 58
Figure 66: HTTP - COM2 & AUX w ith TEMPMAN .............................................................. 59
Figure 67: HTTP – Sensor Manager Settings ..................................................................... 61
Figure 68: HTTP - RAS Manager Settings.......................................................................... 61
Figure 69: HTTP – CS121 DataLog.................................................................................... 63
Figure 70: HTTP – CS121 ExternalDeviceLog ................................................................... 64
Figure 71: HTTP – CS121 UPS Events .............................................................................. 64
Figure 72: HTTP – Status Page Socomec Transfer Switch ................................................ 65
Figure 73: HTTP – Status Page Eaton Transfer Sw itch...................................................... 65
Figure 74: HTTP - Fir mw are Update Page ......................................................................... 66
Figure 75: CS121-configuration settings via ftp. ................................................................. 67
Figure 76: CS121-Configuration Manager .......................................................................... 69
Figure 77: CS121-FTP Access ........................................................................................... 69
Figure 78: CS121-FTP Context Menu ................................................................................ 70
Figure 79: CS121-FTP Folders........................................................................................... 70
Figure 80: CS121-FTP [Link].................................................................................... 71
Figure 81: CS121-FTP File Replacement ........................................................................... 71
Figure 82: CS121-Reboot................................................................................................... 72
Figure 83: RCCMD - Overview ........................................................................................... 74
Figure 84: RCCMD Client Installation – IP-Address ........................................................... 75
Figure 85: RCCMD Client Installation – Connection check................................................. 75
Figure 86: RCCMD Client Installation – Batch-files ............................................................ 75
Figure 87: RCCMD SSL Settings........................................................................................ 76
Figure 88: Timeserver Settings........................................................................................... 76
Figure 89: Settings Confirmation ........................................................................................ 77
Figure 90: SSL Configuration ............................................................................................. 77
Figure 91: Advanced Netw ork Settings............................................................................... 77
Figure 92: Example: Batch file to let the RCCMD act as relay station ................................ 79
Figure 93: gchart plug-in for the internet explorer ............................................................... 80
Figure 94: Internet Options of the internet explorer ............................................................ 80
Figure 95: Security Settings................................................................................................ 81
Figure 96: SideSw itch4 and SS4 AUX................................................................................ 83
Figure 97: CS121-Installation w ith SideSw itch4 ................................................................. 83
Figure 98: Exchange COM Ports 1 & 2 for SS4.................................................................. 84
Figure 99: The Sensor SM_T_COM ................................................................................... 85
Figure 100: CS121-Installation w ith temperature SM_T_COM ............................................. 85
Figure 101: CS121- SM_T_COM Settings............................................................................ 86
Figure 102: CS121- SM_T_COM Functions ......................................................................... 86
Figure 103: CS121-Configuration Threshold Events of analogue Inputs .............................. 86
Figure 104: CS121-Configuration Threshold Event for SM_analogue 1 ............................... 87
Figure 105: Sensor Manager (SensorMan) .......................................................................... 87
Figure 106: CS121-Installation w ith SENSORMANAGER .................................................... 88
Figure 107: SENSORMANAGER II Settings......................................................................... 89
Figure 108: SENSORMANAGER II LEDs............................................................................. 90
Figure 109: SENSORMANAGER II Status Site .................................................................... 92
149
Figure 110: SENSORMANAGER II Configuration Analog Inputs ......................................... 92
Figure 111: SENSORMANAGER II Configuration Outlets.................................................... 93
Figure 112: Alarm matrix – Marker configuration.................................................................. 93
Figure 113: Alarm Matrix – Sw itching of relay outputs.......................................................... 94
Figure 114: Alarm Matrix – Sw itching of relay outputs.......................................................... 94
Figure 115: RASMANAGER netw ork integration.................................................................. 95
Figure 116: PIN Adjustment Adapter-Connector GSM_A..................................................... 95
Figure 117: Mini8-DSUB9 Cable Cross-Section................................................................... 96
Figure 118: COM2 Mode: GSM Modem ............................................................................... 96
Figure 119: Configuration of the Function ............................................................................ 96
Figure 120: Siemens GSM TMA T35i Modem...................................................................... 97
Figure 121: GSM Signal Quality Display .............................................................................. 97
Figure 122: LED-Matrix display network integration ............................................................. 98
Figure 123: CS121MODBUS Installation.............................................................................. 99
Figure 124: CS121 PROFIBUS Installation .......................................................................... 99
Figure 125: UNMS- Installation ........................................................................................... 100
Figure 126: Mainboard Inform Pyramid DSP...................................................................... 102
Figure 127: CS121 AlarmLog, ProtMan Connection........................................................... 102
Figure 128: CS121 Netw ork Card Speed Configuration..................................................... 102
Figure 129: Cable configuration HW121 COM2 ................................................................. 104
Figure 130: Cable configuration HW121/HW131 COM2 .................................................... 104
Figure 131: External D-SUB 9-polig male........................................................................... 104
Figure 132: Slot version: Circuit board connection............................................................. 105
Figure 133: Pin COM2 Mini-DIN 8 pol female .................................................................... 105
Figure 134: AUX-Port (Hardw are Revis ion 1.1 = from Serial numbers 0121-1203, 0122-
00198, 0123-00564 onwards) RJ11 6-pol ....................................................... 105
Figure 135: Example (Inputs): Opener or closer contact (only on hardware model CS121) 106
Figure 136: Opto coupler logic ........................................................................................... 106
Figure 137: Example (Outputs) .......................................................................................... 106
Figure 138: Examples: AUX Input on hardware model CS131 only, left side “pull-down”, right
side “pull-up” configuration.............................................................................. 107
Figure 139: AUX Port Assignment...................................................................................... 107
Figure 140: MODBUS - Jumper ......................................................................................... 124
Figure 141: MODBUS - Cable 112 ..................................................................................... 125
Figure 142: SNMP Service Properties................................................................................ 133
Figure 143: SNMP Trap Service......................................................................................... 134
Figure 144: General Properties .......................................................................................... 134
Figure 145: Select a Monitor Type ..................................................................................... 135
Figure 146: General Properties .......................................................................................... 136
Figure 147: Configure the trap OIDs to collect ................................................................... 137
Figure 148: Build Event Expression ................................................................................... 137
Figure 149: Configure the trap OIDs to collect ................................................................... 138
Figure 150: Build Event Expression ................................................................................... 139
Figure 151: Configure Health ............................................................................................. 139
Figure 152: Configure Alerts .............................................................................................. 140
Figure 153: Discovery Method............................................................................................ 141
Figure 154: „[Link]“ ....................................................................................................... 142
Figure 155: CS121 Configuration for such a relay command ............................................. 143
Figure 156: Raritan Device Settings................................................................................... 143
Figure 157: Raritan SNMP Settings ................................................................................... 144
150