Manual CS121 en PDF
Manual CS121 en PDF
Manual CS121 en PDF
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 within 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, without 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 within 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.
(whether or not registered) or goodwill from time to time of Generex or in any intellectual
property right including without limitation any copyright, patents relating to the Products, shall
remain the exclusive property of Generex.
Generex will undertake to deal promptly with 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.2 CS121 Device Type Overview 6
1.3 Scope of Delivery 8
1.4 Functional Overview of the CS121 8
1.4.1 Functionalities of your CS121 10
1.5 The Communication with the CS121-Adapter 11
1.6 CS121 Overview of the Connections and LEDs 12
2. Quickstart 14
3. Initial Operation of the CS121 14
3.1 Connect your CS121 ... 14
3.1.1 ... via LAN 14
3.1.2 ... via serial port 15
3.2 Verifying the CS121 Connectivity 15
3.3 Setup of the Basic Network Configuration 15
3.3.1 DHCP Obtain an IP address automatically 16
3.3.2 Establishment of a static CS121 IP address manually (default delivery state)
16
3.3.3 Using HTTP/Webbrowser 17
3.3.4 Configuration using Telnet / MS-HyperTerminal 18
3.3.4.1 Main Menu & IP-Settings 18
3.3.4.2 UPS Settings 19
3.3.4.3 Saving Configuration 20
3.4 CS121 Restart and Boot Procedure 21
4. Configuration of the CS121 21
4.1 CS121 Menu System & Network Status 21
4.2 23
4.2.1 Saving Data 23
4.2.2 UPS Model & System 23
4.2.3 Network & Security 24
4.2.4 The CS121 with DHCP utilization 26
4.2.5 The CS121 with ICMP Check 26
4.2.6 Function hide of HTTP links 27
4.2.7 Configuration Static ARP Entries 27
4.2.8 Email 27
4.2.9 Email Trap 29
4.2.10 Email Trap Configuration 30
4.2.11 Timeserver 31
4.2.12 Language 33
4.2.13 Events / Alarms 34
4.2.13.1 Threshold Events 35
4.2.13.2 Logfile Entries 36
4.2.13.3 Email-Job 37
4.2.13.4 Email-To-SMS 37
4.2.13.5 AUX-Port 38
4.2.14 SNMP 39
4.2.15 COM2 & AUX 40
4.2.15.1 COM2 40
4.2.15.2 AUX and SITESWITCH4 Settings 43
4.2.16 SENSORMANAGER 43
4.2.17 RAS Configuration 44
3
4.2.18 Scheduled Actions 45
4.2.19 Save Configuration / Reboot 46
4.3 Reading the Logfiles 46
4.4 RCCMD 49
4.4.1 RCCMD Jobs 49
4.4.2 RCCMD Traps 50
4.4.3 RCCMD Shutdown 52
4.4.4 Automatic Reset of the Redundancy Alarm 56
4.4.5 RCCMD Message 57
4.4.6 RCCMD Execute/Command 57
Example of use 1: CS121-adapter as RCCMD-listener 57
Example of use 2: CS121-adapter switches an output 57
4.4.7 UPS shutdown 59
4.4.8 Wake On LAN (WOL) 59
4.4.9 Scheduled Actions 60
4.4.10 CS121 for Transfer Switches 60
5. Adapter Software Updates (Firmware) 62
5.1 Firmwareupdate via Setup-tool 62
5.2 Firmwareupdate via FTP 62
5.3 Firmware flash renewal and recovery 63
5.4 a FTP 63
6. Additional Software 66
6.1 RCCMD 66
6.1.1 RCCMD with SSL for Windows 66
6.1.2 RCCMD with own SSL certificates 68
6.1.3 RCCMD client as relay station 68
6.1.4 License regulations 69
6.2 jChart 69
6.3 gChart 71
6.4 UPS monitor (UPSMON) 73
7. CS121-Enhancements, Field of applications 74
7.1 SiteSwitch4 (SS4) and SiteSwitch4AUX (SS4AUX) 74
7.1.1 SS4 Feature overview 75
7.1.2 SS4 Contents 75
7.1.3 SS4 Installation 75
7.1.4 SS4 - Technical data 76
7.2 Sensor SM_T_COM 76
7.2.1 SM_T_COM configuration 77
7.3 SENSORMANAGER & SENSORMANAGER II 79
7.3.1 General information 79
7.3.2 Installation and Network integration 80
7.3.3 Special features of theSENSORMANANAGER II 83
7.3.4 Configuration 83
7.3.5 Alarm Matrix of the SENSORMANAGER II 84
7.4 RASMANAGER 86
7.5 GSM Modem Notification via SMS 86
7.6 LED-Matrix Display 89
7.7 MODBUS/PROFIBUS/LONBUS 89
7.8 UNMS (UPS-Network Management System) 90
7.9 SNMP 91
8. Troubleshooting FAQ 92
8.1 Common Problems 92
Appendix 100
4
A. CS121 - Technical data 100
B. CE- and UL-Certification 100
C. Cable and Circuit board configuration, Pin/AUX-Ports, SensorMan 100
D. CS121 WDP Watchdog & Powermanager 104
E. MODBUS Interface 105
E.1. General information 105
E.2. Available Modbus Function Codes 106
E.3. Exception Codes 107
E.4. MODBUS Modes in the CS121 M (ASCII and RTU) 107
E.5. UPS Parameter 108
E.6. UPSMAN Status Bytes - Standard Device Status Bits 127
E.7. Bus termination 128
E.8. Configuration 129
E.9. TCP/IP - UDP Ports 129
E.10. MODBUS Cables 129
F. Available Variables of the CS121 130
G. Pin layout of Input-sockets of the SENSORMANAGER unit 131
H. Events/Alarms of the CS121 Description of the alarms 132
I. Description of the alarms for single-phase UPS 135
J. Configuration of Microsoft SCOM 2007 as CS121 Trap Receiver (Monitor)137
K. DHCP Configuration via Telnet 145
L. RARITAN Dominion PDU Configuration 146
Table of figures 150
5
1. The CS121 Family - Introduction
1.1 About your CS121
1.1.1 General Information
The CS121-series are a group of products designed especially for critical resource
management within technical facilities. All of these products share many of the same basic
CS121 features, and some have special components and functions.
The CS121 products are most commonly used for the management of UPS systems, get UPS
data via SNMP and display all available data and failures. These information will be forwarded
to desired clients. In addition a shutdown of these clients could be executed via our RCCMD
Multi-Server Shutdown Software.
This user manual describes the main function of the CS121 and the function of additional
components.
The construction and the configuration of the CS121 devices are universal. The adaption has
to be fit in different UPS devices from worldwide located manufacturers. This user manual
cannot show all alternatives. Different screenshots and described details have to be
interpreted correspondingly.
And the following external devices, which are CS121 based, but got additional features.
6
Properties of the CS121 device types:
7
1.3 Scope of Delivery
The standard CS121-adapter package contains an SNMP-adapter unit with 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 available.
forwards Trap Messages to desired receivers. This Trap Messages inform the user about
critical situations of the UPS, e. g. a power failure. In addition the CS121 can trigger RCCMD
(Remote Console Command) signals, messages, shutdowns.
8
Functional Overview of the CS121 Professional
9
Functional Overview of the CS121_R_II
10
the UPS is connected via serial or USB cable, if a CS121 is connected, you just need a web-
browser for the monitoring.
RS232 UPS Protocol Router Pipe- through: The CS121 (not BUDGET versions) is able
to transfer the UPS RS232 protocol on COM1 directly to COM2. This allows the use of
additional monitoring software on COM2, while making extra hardware (RS232 Multiplexer) to
multiply the UPS comport unnecessary.
Log File: The CS121 got an internal log file synchronized with either a timeserver in your
network or from Internet timeservers. This log file can be accessed by web-browser,
UPSMON, JAVAMON or via FTP. The size of the log file is 250 lines, older entries will be
overwritten automatically.
Network Settings: The CS121 models are adjustable to the network environment. An auto-
sensing function, 10Mbit or 100Mbit can be selected.
Email Client: The CS121 adapters incorporate a built-in SMTP email client, which is able to
send emails automatically, if an error occurs.
Web-Server: The CS121 models possess a web-server, which displays all functions and
settings of the adapter. Non-Windows users may use the UPSView as graphically display for
UPS data.
Network Connection: The below figure displays a CS121 into a network environment. The
CS121 is communicating with the UPS and displays all available data.
11
- nt to include your CS121 to a SNMP-Management
station, which does not have the standard MIB RFC1628, you can download the specific MIB
from our website http://www.generex.de/e/download/cs12x/download_p.html. 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.).
UPSTCP
The most common way to communicate with the CS121 is over TCP. The CS121 contains
UPSTCP, which gives you a complete interface to integrate the adapter into your network. If
you are a software manufacturer, please contact us directly for the specification of this
interface, if you want to implement it by your own. All others use TCP for the access via web -
interface (UPSView, UNMS II) or SNMP or MODBUS.
1.6 CS121 Overview of the Connections and LEDs
For CS121 L, LM, SC, SCM and other slot cards:
1) LED state of the network connection: The LEDs of the RJ45 socket flashing
green, if a network connection is established and yellow, if network communication
is at present. The yellow LED displays the network traffic. If the yellow LED is
glowing steady, the network traffic is too high.
2) COM2 port as Mini 8 connector for the configuration or connection of external
devices.
3) LED state of the CS121 HW131: The following tables are valid for the CS121
HW131!
12
Green LED Red LED Adapter
OFF ON Adapter is looking for UPS/initializing. The start phase can
last up to 3 minutes
Flashing OFF Data flow/normal mode of the UPS
ON ON Communication to UPS interrupted
Figure 3: CS121L (left) in configuration mode (IP 10.10.10.10) and CS121SC (right) in normal
mode
Note: Into configuration mode the full functionality of the CS121 is not
available! Please change to a valid network address and put DIP-switch
1 to position ON as soon as you made your basic network settings! After
this, please continue configuring your CS121 in your network. Please
follow up the procedure in chapter Error! Reference source not found.
Error! Reference source not found. in this manual.
Please note, that the CS121 Budget versions got no COM2 port!
13
6) Serial interface (COM1): For the connection to the UPS
7) Power supply, the external CS121 got an external power supply (9 12VDC)
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 will receive power directly from the UPS device. The
SNMP adapter C and slot card both incorporate a variable 9-36V input.
2. Quickstart
This quickstart describes the basic functions and settings of the CS121. The CS121 can be
configured via Telnet, Terminal and HTTP. The Telnet configuration uses the same network
interface as the HTTP configuration. The Terminal configuration requires a serial connection to
a workstation.
We recommend the configuration via HTTP, because it is the most comfortable one and that is
why we describe the HTTP configuration in this user manual.
After you finished the CS121 hardware setup, all 3 configuration modes are at present. If you
want to use the Telnet or HTTP configuration, it is required to add a temporary network route
to the CS121 configuration mode IP address 10.10.10.10.
Please use the following access data:
User: admin
Password: cs121-snmp
14
3.1.2 ... via serial port
The CS121 contains two serial ports (not BL and BSC-versions), COM1 provides the connection to the
UPS and COM2 is used for the configuration of the SNMP adapter.
Note: The different response rates during the ping process do not correspond
to an error. The CS121 does not answer every ping signal at the same
time, due to different sized UPS protocols. If UPS protocols are of
extensive size a temporary timeout can occur. A permanent timeout
however is an error.
Note: We recommend the following settings for the operation of the CS121 via
cross cable (Ethernet cable for the connection directly). Set the IP address of the workstation
with a cross cable to an IP address of the same network segment, e.g. 10.10.10.11 AND set
the gateway to 10.10.10.10.
15
A network cross cable is a PC-PC network cable, which does not require a switch or a hub
between 2 network workstations (2). Most modern workstation network cards have an auto
detection, so any network cable may be used. Only if you do not have such a cable, connect a
switch or Hub between your workstation and the CS121 (1).
Note: The function DHCP ON/OFF is valid for the following 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)!
3.3.2 Establishment of a static CS121 IP address manually (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-switches of the SNMP-adapter firstly need to be set for the configuration. DIP-
switch 1 is switched OFF in the top position as well as DIP switch 2 is switched OFF.
Note: For slot versions you have to insert and remove the device for any
reboot-process. This will not have any effect on your UPS but we
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 10.10.10.10. This is done via a call from your command line e.g. "route add
-? for more help of route syntax.
any response. Now you can connect with any Telnet or HTTP-software and continue with the
configuration.
16
3.3.3 Using HTTP/Webbrowser
Attention!
finished your whole confgu
The entire configuration can be done via Webbrowser. Please use the default IP-address
10.10.10.10 and the TELNET password (defau - . The username is always
Please do never close the web-browser or telnet window during saving process! If you close
down list. Further configurations like Power, baud rate, cable type etc. were made
automatically (ensure your Browser has enabled JavaScript) and do not need to be set. We
strongly recommend to keep the default settings for this UPS unless you have instructions
from the UPS maker.
17
Figure 6: HTTP - UPS Model & System Settings
Apply your settings with the button at the right side.
Network & Security IP-address, Gateway and Subnet Mask
to the CS121-adapter.
18
Figure 8: Telnet - Main Menu
To select any option in the main menu enter the number of the option at the Enter command
=> prompt. The program displays the desired screen.
menu the user needs to select the UPS model the CS121-adapter is connected to (usually at
COM1).
19
Figure 10: Telnet - UPS Settings
The CS121-adapter distinguishes here generally between Cable- and Serial-models. With
Cable, the adapter and the contact interface of the UPS are connected with a special cable.
Using Serial, UPS models connect to the adapter via the serial UPS-cable. (Part of the UPS
package). Serial is default, when the user selects a UPS model name from the drop-down list.
When Cable is used, please search the list for the corresponding UPS model and cable type.
The CS-121 supports serial models with its own RS-232 protocol as well as contact UPS
models with the cable types O,C,1-10. Those contact cables are UPS or alarm system specific
and should be provided by the corresponding manufacturer. Our Cable documentation shows
examples of those cables if they are individually made cables.
Please choose the corresponding serial UPS model or cable model communication
parameters. Parameters like baud rate etc. are present for the corresponding UPS model.
Note: Please do not change parameters except of UPS-model unless you want
to choose specified configuration according your UPS-model!
This
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
minutes, ensure you start (configure) the shutdown (or other event action) 3 minutes before the
UPS is switched off, so that more than enough time is available to complete the corresponding
event action.
3.3.4.3 Saving Configuration
Call -command from the main menu. (The communication to the
adapter will be lost).
20
ATTENTION: Keep the Telnet, Terminal, web-browser window open until the device has been
lost or you see a message that reboot is under progress. If you close the configuration window
too early it may corrupt the upsman.cfg configuration file.
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 web-browser offers a much more convenient way to
configure the CS121. If you have any possibility we recommend you to
use this way.
3.4 CS121 Restart and Boot Procedure
After you have finished the basic IP- and network-settings you should set DIP-switch 1 in
position ON and restart the adapter with your configurations.
You can perform a CS121 restart by unplugging the power supply of the CS121 and wait, until
the CS121 has restarted with your configurations.
Alternatively you can restart the CS121 - -
menu of the web-browser. The following message will displayed:
Note: After you have finished the basic network configuration you should have
set DIP-switch 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
Switch 1 to position ON. After this, re-insert the card. Info: There is no
risk to remove/insert the slot card, there will be no effect on the UPS
output.
settings.
21
Figure 12: HTTP System & Network Status
-data, above all the state of
charge and battery load:
The AUX & SensorMan status shows the actual measurements of the connected
environmental sensor devices SM_T_COM, SM_T_H_COM, SENSORMANAGER, CON_AUX
or CON_R_AUX.
22
Figure 15: HTTP - AUX & SensorMan Status
In the above figure, a button menu is presented in which the ports 1 and 2 can be clicked on
and off. A yellow light bulb indicates that output to the corresponding port is being provided,
while the gray unlit light bulb indicates the status of being switched off in which case the
connected device is not being provided wi
are password protected. This is the same password that has been set in the CS121-
configuration. The ports 3 & 4 are configured as input sensors, here the OFF symbol shows an
open contact, and alarm would show a closed contact. The AUX port of CS121 can be
configured as output or input or a mixture of both.
4.2 onfiguration
4.2.1 Saving Data
ATTENTION! The following is essential for all entries of configuration data:
Close all web-browser menus via th
If you have finished your configuration completely, get into the CS121 menu Save
IMPORTANT! Do not close the Telnet or web-browser window, until the connection to the host
is lost or you got a message, that the CS121 is rebooting. If you close this window to early, it
Please note, that the reboot process of the CS121 could last at least 3 minutes.
23
Figure 16: HTTP - UPS Model & System
With the parameters UPS ID, system name, system location, system contact you can describe
the UPS and CS121.
Note: Do not change the default UPS-Parameters for Baud Rate and Hold time
unless you have special instructions from the UPS maker.
em Shutdown Time This value determines, how many minutes
nt menu will be
executed. Attention: This EVENT 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 Powerfail
and configure the RCCMD shutdown signals
to send RCCMD shutdowns to several IP addresses in a certain logic or sequence!
be used to save custom specific
comments concerning your UPS.
4.2.3 Network & Security
24
This menu configures the CS121 network card settings, passwords and enable/disables
several adapter and network services.
The CS121 firmware version 4.30.x provides the definition of the TCP MSS value. The
Maximum Segment Size defines the amount of bytes, which will be send as reference data into
a TCP segment. The default is 1460. If you got problems with 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
following entries:
Enable Modbus over IP: Every CS121 model 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 RS485 interface, you must 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 with
the scroll down menu.
Note: 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 recommend for
ASCII the use of 7/N/2 and the highest baudrate supported by your device.
RTU Mode works at CS131 & CS121 platforms with 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 device.
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 -snmp)
and allows to open UPS FUNCTIONS and SS4 FUNCTIONS only to specific 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. Advice: For the
activation of the new password (apply button), it is required to reboot the CS121 via the ,
25
The CS121 firmware version 4.52.x provides the entry of a Hostname, if you want to use
DHCP.
Force configured Gateway disabled by default. At disabled all
requests will be responded to the requesting IP address and its MAC address directly. If
enabled, all incoming requests will be routed through the defined Gateway exclusively.
box.
Fallback address: If the DHCP server will not be available, just reboot the CS121 to use the
fallback address. This address is equivalent to the settings of the local address in the menu
121 to
use the DHCP address.
4.2.5 The CS121 with ICMP Check
From the firmware version 4.26.x the CS121 is able to answer and send ICMP polls, to check
the quality of the network and, in need, can reboot itself.
26
Note: The CS121 supports 3 functions of ICMP via RFC 792:
0 Echo reply
3 Destination unreachable
8 Echorequest
4.2.6 Function hide of HTTP links
The CS121 firmware version 4.23 or higher provides the function to disable the following
You can determine into the ARP Settings, which IP address to which MAC address will be
assigned. Therefore the ARP entry will not expire for this IP address. The ARP table will be
determined firmly and will never expire! Case of application: HP Teaming or an ARP entry is
desired, but the ARP table cannot be restored automatically.
4.2.8 Email
If you wish to define actions to send Emails depending on specified events you need to
configure the Email settings.
27
Figure 22: HTTP - Email Settings
In this menu the internet name of your SMTP mail client is required. If DNS is not configured,
t address has to be entered. Please also note that the sender
account name (e.g. [email protected]) should not be a random name, since some mail
servers do not allow this. We recommend to use an existing account e. g. [email protected].
Most servers require matching account names and mail server names. E. g.
If the server name and account name do not match, the following error message will be
mail server:
The user can check the logfile if the email transfer works. The logfile (text.log under the CS121
root directory ../Flash/text.log) can be viewed using FTP, via the UPSMON tool or via the web-
Note: Do not use email authorization if this is not required by your mailserver !
only this function) needs to be supported (e. g. freemail.de). This changes the protocol from
SMTP to ESMTP and a password is required.
The length of the password should be a minimum 3 and a maximum of 63 characters.
Send a test-mail to validate your settings after you have applied the mail-settings. A short
message on the menu indicates whether the test-mail could be sent or not.
28
Note: Please ensure that you have specified a DNS-
ail-server could not be reached. You can transfer up
to 511 signs.
TeleService available
Unlike to the other connection types, this one can assimilate incoming email traffic only and is
therefore the optimal fitting for relevant to security customers and remote monitoring.
If Email-Trap is arranged and the UNMS II got the TeleService module extension, every device
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
29
Figure 24: UNMS II screen with timestamp of the latest measuring values update
Advice: The Email Trap configuration is in accordance with 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 will be stressed unnecessary. This Email Trap account should be used
from the UNMS II with TeleService only. You should change the parameter after using the
import settings feature accordingly.
s not received.
n
interval of 12 hours.
30
Figure 25: UNMS Email Trap Settings
You can trigger an Email Trap via « Test » button. The CS121 AlarmLog will log the sending
and the UNMS II with 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.
4.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.
31
Figure 26: HTTP - Timeserver Settings
The timeserver is important to synchronize 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 129.6.15.29; the
timeserver of the Physikalisch-Technische Bundesanstalt is 192.53.103.103.
Note: The timeserver will synchronize immediately following the reboot. If the
synchronisation fails, the CS121 will attempt another timeserver
synchronisation. Following that, the CS121 will attempt a
synchronisation with the timeserver every 24 hours. It is required to
unlock UDP port 123. From Firmware 4.17 the timeserver will
synchronize in a 10 minute interval for at most 24 hours, after it the
synchronization interval will be reduced to 24 hours.
The CS121 firmware version 4.28.x provides the option to set the system time manually.
Please note, that after the next reboot the synchronization will 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 will be reset to 01:00 every
night, because of the optimization of a correct time. To avoid that the CS121 internet
synchronization process will correct this time again (regularly process at every restart and
every 24 hours), it is required to disable the SNTP timeserver into the CS121.
time of the PC with an internet clock. How to setup the MS-Timeservice 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 download from here:
http://www.generex.de/wwwfiles/timeserver/atcs22.zip
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 10.10.10.10).
Please take a look into the FAQ of this user manual for further information how to use a
workstation as timeserver.
32
4.2.12 Language
The CS121 firmware version 5.x or higher is supporting the following languages :
- English
- German
- Chinese
- French
- Spanish
- Polish
- Portugese
To be able to use this feature, it might be required, to configure the following into your web-
browser (example Internet Explorer 8) :
33
Figure 28: IE8 Internet Options Languages
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,
UPS Battery bad tc. Each event the CS121 allows
you to release one or more actions. An action can be e. g. write a log file entry in the alarm log
(as default all events do perform a log file 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 also the sectio
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 Events / Alarms
an overview about the events and the number of configured actions.
34
Figure 30: HTTP - Event Editor
The Event Editor allows you to edit, delete and test existing events, as well as to add a new
event job. Please click on the desired action to enter the Job Editor, who lets you make the
configuration.
Here in the following a short example how to configure an RCCMD shutdown signal.
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 shutdown job will actually trigger the shutdown signal at the client side!
You should perform a shutdown test not until you have switched off the shutdown procedure at
the client (RCCMD Configuration, Button Configure shutdown).
All jobs are not saved until you executed the Save, Exit and Reboot function, not until the
device is restarted and running in normal mode (DIP-Switch 1 is ON).
The number of jobs per event ist limited. CS121 Series 2001-2006 allow up to 25 jobs,
running under Firmware 3.5x even up to 35 jobs (approx., depends on the jobs). If more jobs
should be executed, you have to configure RCCMD as relay station, as described in section
6.1.1.
4.2.13.1 Threshold Events
Some UPS models allow you to configure thresholds for releasing UPS specific threshold
events individually. The CS121 also supports these features, if the UPS includes this option. In
this case, you see at the main e
Configure threshold events o add a new individual threshold event and you
individual events.
35
Figure 32: HTTP Threshold event
The CS121 firmware 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 were defined. The analog values for external sensors are
configurable through the variable SM_analogue 1-8. The proper threshold events for
36
as the event is present. Other actions on events such as Email, RCCMD shutdown, UPS-
Dialer, TempMan etc. can be configured in the same way. Each event may have an unlimited
number of actions (executed now, delayed etc.).
4.2.13.3 Email-Job
Note: Please as
Beside text entries (up to 511 signs), variables can also be integrated into the email from the
CS121. This may personalize your emails. A list of available variables are documentated in the
appendix. Please note, that the variables are only getting filled, if the event actually occurs, not
by testing the action (so a 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 will be substituted with their current values, when the action will be
released.
Please notice the syntax, that each variable name must be started with the character # and
must be ended with a <space> character.
Apply your settings and test the Email-
sent.
Continuous, periodic events:
To define an event job, which will be executed continuous, e. g. daily, create a job for the event
in the following figure:
4.2.13.4 Email-To-SMS
37
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
phone.
Example:
GSM Provider T-Systems D1
Your D1 email address will be [email protected] (e.g.:[email protected]) Please
note that you enable receiving emails on your cell phone. This is done by sending a SMS with
Only the subject or the text field of the email will 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, with
(If you want to enable the email transfer again, just send a message to the number 8000,
(If you want to enable the email transfer again, just send a message to the number 3400,
Other providers
Please ask your cell phone network provider for informations about the email to SMS settings.
4.2.13.5 AUX-Port
38
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 hardware type different.
4.2.14 SNMP
Within this menu you can define access controls for SNMP-communities. This concern e.g.
SNMP-Management tools, Trap receivers etc.. The CS121 firmware 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 following SNMP V3 security level are at present:
o No auth, no priv: No authentication, no privacy, but an SNMP V3 user
o Auth, no priv: Authentication (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 which 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 which IP managers receive traps (messages) from your SNMP-adapter.
The screen permits you to send traps about your UPS to IP-addresses (managers).
Also, the menu for switching authentication and cold boot traps are located here. If activated
these traps are send to the configured SNMP trap receivers 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 receiver must also be configured in order to
39
make this test work. Additionally, save the settings and reboot your CS121 before testing the
communication with the configured IP-address. (does not work in configuration mode). If you
Note: The Pipe Through Modes are not supported from every UPS model.
Please contact GENEREX via [email protected], if your UPS model
is supporting these modes.
Pipe-Through Mode 1:
- -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
which 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 between CS121 and your application you have to use the
original CS121 configuration cable (not included).
Note: Please note, that it is required to define the same baud rate of the UPS
-Through Mode 1 +
2!
40
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
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 with RS485 interface. The CS121_SPI3 Profibus and LONBUS converters will be
connected to the COM2 with RS232 port and as configuration use MODBUS/SPI3.Please take
a look into chapter 6.7 for further information.
41
Figure 41: HTTP - COM2 & AUX with TEMPMAN
GSM Modem
A GSM modem provides the notification 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 between the
CS121 and the SiteManager. The SiteManager is a professional facility management device,
which 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 between the CS121 and the
SiteMonitor 2. The SiteMonitor 2 is a professional facility management device, which 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.
42
SM_T_H_COM
The SM_T_H_COM is a temperature and humidity sensor for the CS121 and is used for the
monitoring and controlling of UPS rooms, server rooms etc.. Please take a look into the
SM_T_H_COM datasheet for further information.
4.2.15.2 AUX and SITESWITCH4 Settings
The AUX connection is an input/output port for connecting external contact devices such as
alarms or for connecting to an SS4AUX SiteSwitch power socket manager. The SS4
SiteSwitch is a standalone device with a built in CS121. The SiteSwitch SS4 AUX is an
inexpensive 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 switched 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 switches remains in the status previous to the
reboot.
The following describes the configuration of the AUX ports using the HTML interface. All of the
AUX ports 1 4 can be m
Note: From CS121 HW131 it is required, if the AUX ports will be defined from
- or rather Output, that a cable with Pull-Down resistance
or a CON-AUX or a CON-R-AUX is connected. Otherwise the status
display of the AUX ports is undefined and can be changed by itself
anytime !
4.2.16 SENSORMANAGER
The SENSORMANAGER is a data measurement and collecting unit which allows the
individual measurement and monitoring of 8 analog measurement devices (0-10V) and 4
digital alarm inputs or 4 outputs (open collectors). SENSORMANAGER has its own chapter in
the manual, wherein the features and field of applications etc. pp. are described as well as in
depth the various specific configurations.
43
- among
others -
released.
44
4.2.18 Scheduled 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, which switches the battery to a short
discharging.
Custom test: A custom test checks, if the batteries are able to hold the downtime at least.
Full test:
This test should be done once a year at most, because to avoid a damage of the
batteries.
Shutdown UPS: This action causes the switch 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.
Switch UPS Outlet: This is a function to switch of the UPS outlets (not provided of every
UPS).
Switch 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 switch a connector). If the contacts will be configured as inputs, they are able to be
RCCMD Shutdown: Here, IP-addresses from computers with 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 Windows 2000 server or a Unix
45
RCCMD Command: This RCCMD signal will 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
These commands require additional parameter. If you want to use these kind of commands,
just contact your UPS dealer.
Send WOL:
other computers in a local network to start-
puters which have been shut downed previously after an extended
power outage, which cause the CS121 or UPS to switch off completely. Additional you may
providing this function or are password protected. Activate this function into the BIOS settings
of the motherboard.
Send Periodic Email: This is a function to send the log files via email periodically (from
firmware 4.xx and higher).
4.2.19 Save Configuration / Reboot
If you ar Save, Exit & Reboot
adapter informs you about the reboot-process. Do NOT close your web-browser!
4.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 would otherwise be the case if only UPS protocol
defined alarms were being recorded. For explanation, the following illustrates typical log file
entries made by the UPS:
The CS121 logs the time after a new start up:
01/17/2007,16:21:45, Synchronized with timeserver 192.53.103.103. OK
This indicates a successful synchronization with the timeserver.
for this particular UPS is the EVENT "UPSMAN started" This means that an Email was sent
with the text "UPSMAN started" which acts to confirm the log entry of 08:06:50 as Email.
01/17/2007,16:28:47, MAIL: subject "CS121 Event 16" successfully sent
In this case, the Scheduler has been activated and is ready for operations. In this case, the
scheduler is set to conduct a "Selftest" which it in turn relays per email to the designated
CS121 ADMIN.
01/17/2007,16:28:47,MAIL: subject "CS121 Event 26" successfully sent
01/17/2007,16:29:03,MAIL: subject "CS121 Event 27" successfully sent
46
01/17/2007,16:29:28,MAIL: subject "CS121 Event 28" successfully sent
01/17/2007,16:30:46,MAIL: subject "CS121 Event 29" successfully sent
These are 4 Emails indicating the status of the AUX Ports (Auxiliary connection for external
alarms), which are set to give notification of the status signal LOW. Since the AUX Status can
only be set to High or Low and given that the CS121 in itself cannot distinguish the device, an
alarm email will be sent by the CS121 to the designated ADMIN at startup per default with the
startup status of each connected alarm. In this case, it is up to the administrator to determine if
the emails indicate an actual alarm or not.
01/17/2007,16:34:48,MAIL: subject "CS121 Event 38" successfully sent
01/17/2007,16:35:12,MAIL: subject "CS121 Event 39" successfully sent
01/17/2007,16:35:16,MAIL: subject "CS121 Event 40" successfully sent
01/17/2007,16:35:28,MAIL: subject "CS121 Event 41" successfully sent
01/17/2007,16:35:33,MAIL: subject "CS121 Event 42" successfully sent
01/17/2007,16:35:40,MAIL: subject "CS121 Event 43" successfully sent
01/17/2007,16:35:51,MAIL: subject "CS121 Event 44" successfully sent
01/17/2007,16:35:57,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 device or connection port.
01/17/2007,16:36:30,MAIL: subject "CS121 Event 54" successfully sent
01/17/2007,16:36:41,MAIL: subject "CS121 Event 55" successfully sent
01/17/2007,16:36:48,MAIL: subject "CS121 Event 56" successfully sent
01/17/2007,16:36:57,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,17:41:12,MAIL: subject "CS121 Event 62" successfully sent
01/17/2007,17:41:36,MAIL: subject "CS121 Event 63" successfully sent
01/17/2007,17:43:23,MAIL: subject "CS121 Event 64" successfully sent
01/17/2007,17:44:01,MAIL: subject "CS121 Event 65" successfully sent
These 4 Emails indicate the status of the digital alarm contacts of the sensors (for Emergency
OFF, fire extinguisher and the like) connected with the SENSORMANAGER, showing either
the status is NORMAL or that nothing is connected.
01/17/2007,17:52:13,MAIL: subject "CS121 Event 70" successfully sent
This Email shows 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 will be logged with timestamp into the CS121 DataLog.
47
Figure 45: HTTP CS121 DataLog
The data of the connected devices (e. g. temperature sensor) will be logged into the 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 unify UPS their events will be imported out of the UPS directly and are displayed into the
48
Figure 47: HTTP CS121 UPS Events
4.4 RCCMD
t successful shutdown client for
heterogeneous networks and is the most secure way to establish a UPS multiple server
shutdown sequence today. RCCMD clients are listening to an RCCMD server which is usually
an UPSMAN software, CS121 or any third-party UPS manager which has a license to use
RCCMD. An RCCMD server is found inside any CS121 and is triggering RCCMD clients in
case of alarms. Therefore RCCMD requires such listeners on each client-computer you wish to
forward RCCMD signals. For installation of RCCMD at client-side please see the section in
chapter - .
Note: RCCMD clients are optional and not freeware. Most CS121 are
equipped today with a single RCCMD standard license, some UPS
makers add more licenses, other do not deliver any license at all with a
CS121. Contact your UPS maker and ask for the license regulations for
RCCMD in conjunction with your CS121.
Powerfail
This event occurs, if the UPS will lose the power supply. This event might be the optimal fitting
for the definition of RCCMD shutdowns.
System Shutdown
This event will be triggered, if the defined system shutdown time was reached. This event
should be used for operations only, which will force a shutdown immediately.
49
Note: This event is the last event, that the CS121 can execute prior of the UPS
shutdown. Do not use this event to execute RCCMD shutdowns, because the remaing time is
not assured! We recommend to use the event powerfail for the RCCMD shutdowns.
Battery low
This event will be triggered from the UPS, if the battery capacity of the UPS has reached a
critical state.
UPSMAN started
This event will be triggered periodical, if the CS121 is in normal operation. You can use this
event, if you want to start actions, which should be triggered into normal operation.
50
Figure 48: 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 « . ».
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 which is transmitted to an
51
RCCMD client V1 will cause a shutdown of this server ) RCCMD Version 3 is capable to
handle also redundant UPS installations (eg. PC with 2 power supplies and 2 UPS).
Note: For all 3 RCCMD event functions a list of the user configured RCCMD
receivers appear in every RCCMD event.
The amount of RCCMD clients is limited and dependent of the size of the RAM. 50 RCCMD
clients per CS121 are guaranteed. If you need more than 50 clients to reach, we recommend
to use RCCMD relays (see chapter 5.1.4). However it is only possible to execute 50 clients at
the same time, meaning that the first 50 RCCMD clients are executed followed by the next 50
etc. We recommend to change the timing parmeters of the RCCMD-jobs that always less than
50 commands are transmitted at the same time. We also recommend to use an RCCMD client
as Relaystation if you want to shutdown more than 50 computers from a single CS121. (see
section 6.1.1 RCCMD with SSL for Windows
The Secure Sockets Layer (SSL) protocol is a cryptographic protocol that provides security
and data integrity for communications over TCP/IP networks.
Use your Web-browser to navigate to the address of your UPS Web-Manager. Click the
ion button and enable the SSL network feature.
timeserver.
settings.
52
Figure 52: Settings Confirmation
Note: The RCCMD timeout is 60 seconds, meaning that after this time the
communication to the RCCMD client will be stopped and a logfile entry
will be made. When an OK response from the client is received, the
53
system assumes a successful RCCMD Shutdown 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.
Note: All network 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.
4.4.4 RCCMD Shutdown
54
Figure 54: HTTP Event Configuration
Enter the ip-address of the client, that should receive the shutdown.
The timer settings in the blue framed scheduler box will 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 was
present, the action will be triggered.
See below the explanation of all timer event configuration options for this type :
Action/Job will be executed in case that this EVENT is true immediately and
repeated always as long as the EVENT is true (every 5 seconds according to poll cycle
default of a CS121).
Action/Job will be executed in case that this EVENT is true with a delay
55
of x seconds and repeated every x seconds again.
Action/Job will be executed in case that this EVENT is true after a delay
of x seconds. Action will be cancelled, if EVENT is false before time has run out.
Action/Job will 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.
Action/Job will be executed in case that the EVENT UPS ON
BATTERY or POWERFAIL 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".
"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).
In this example a RCCMD Shutdown is configured for the event Powerfail. The shutdown
signal should be send after 5 minutes (300 seconds).
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
SD).
56
Figure 59: HTTP Event Editor / Test
ted immediately
without consideration of the defined delay), the following message will be displayed:
57
and resets the redundancy alarm of a RCCMD Client into initial state. For this the events
remote
RC
58
Figure 64: HTTP - Job Editor: RCCMD execute/command
Any CS121, SITEMANAGER, SITESWITCH can also act as an RCCMD listener; see the
following examples:
Example of use 1: CS121-adapter as RCCMD-listener
If it is necessary to execute a command with parameters or a user defined script then these
commands must be prepared as an executable batch on the RCCMD client.
The following example toggles the state of AUX output port 2 to high. To ensure that the above
command works with a CS121 as RCCMD client the following four criteria must be met:
Add IP of UPSMAN sender in the SNMP community of the CS121-RCCMD client (see also
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 Software.
Example of use 2: CS121-adapter switches an output
CS121 receives an external RCCMD signal to switch an output at the SS4 (Power Switch)
which is connected to the AUX of a CS121.
If you want 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 switch
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
59
support)
Syntax examples:
|UPSCMD|20000|1,1 = Output 1 on
|UPSCMD|20000|1,0 = Output 1 off
|UPSCMD|20000|2,1 = Output 2 on
|UPSCMD|20000|8,0 = Output 8 off
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\
Syntax : |UPSCMD|20001|x
where x is the Portnr. (1-
Syntax example: |UPSCMD|20001|2
This command confirms the Digital-Alarm 2 on a SITEMANAGER, SITEMONITOR,
SITESWITCH or CS121 AUX Inputs.
60
Confirm an analog alarm : The way it works with the ACK of analog alarms like
Temperature thresholds exceed on the UNMS.
Syntax : |UPSCMD|20002|x
where x is the Portnr. (1-
Syntax example: |UPSCMD|20001|4
This command confirms the Analog-Alarm 4 on a SITEMANAGER, SITEMONITOR,
SITESWITCH or CS121 AUX Inputs.
4.4.8 UPS shutdown
This event action enables an UPS shutdown. It is possible to configure when to send a
shutdown signal to the UPS in case of an e.g. battery low, fire alarm or if a complete power
down is wanted.
Attention: This command will cut off the power supply only for UPS which support
this function!
Note: Not all network cards are supporting this function. Some cards require a
password. Activate this function into the BIOS settings of the target workstation.
Note: If you want to send WOL signals in different sub-networks, its required, that the
switch,
61
Figure 68: HTTP - Job Editor: Wake On LAN
4.4.10 Scheduled Actions
In this menu you can schedule actions for the CS121 like switch on/off UPS, execution of
battery tests, switch on/off bypass mode or the periodical sending of emails with attached log
files etc..
Once
Daily
Weekly
Monthly
Note: Please check the time and timeserver settings! A correct internal adapter clock
is necessary for scheduled actions!
62
Figure 70: HTTP Status Page Socomec Transfer Switch
All ASYS, AEG and PILLER transfer switches are using the extended RFC1628 SNMP MIB
(Download). The models SOCOMEC STS and LTM got their own MIB (STS LTM MIB), which
is available as download from our website:
63
http://www.generex.de/index.php?option=com_content&task=view&id=63&Itemid=104
Note: We strongly recommend to update any firmware lower than 2.69 to the
actual version!
All actual Firmware-updates are provided at www.generex.de download page.
Note: Any interruption of a firmware upload may damage your adapter. If this is
the case, you have to reformat the adapter with special software See
more information.
The boot procedure of the CS121-adapter performs several steps:
First, the firmware 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 firmware-version, by using the Setup-tool or via FTP.
5.1 Firmwareupdate via Setup-tool
Firmware updates are available for free at www.generex.de. Download the specified version
(mind your OEM ID) and follow up the setup-procedure. If necessary, consult your UPS
dealer for further information.
5.2 Firmwareupdate via FTP
You can download the update file from www.generex.de or from your manufacturer site.
A firmware update via FTP does not change the operating system of the CS121 only. If you
want to change the manufacturer data, please contact your UPS dealer directly.
64
5.3 Firmware flash renewal and recovery
General information regarding the upgrading process of the CS121 - Known Problems
and Preliminary Precautions:
Any update will 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 upsman.cfg file in the flash directory 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 upsman.cfg.
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 10.10.10.10. Put DIP Switch 1 and
2 in the OFF position before starting.
Please avoid the use of routers and switches 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 always OFF) and follow the procedure below:
1. Before starting the update, unplug the adapter from the power 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
10.10.10.10 <your IP address>". Also 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.
5.4
Click on the web-interface of your CS121 into the con
Via FTP: Enter the following into the address field of a web-browser: ftp://<ip-address of your
CS121>. Enter the username admin and the password cs121-snmp. You will find the
65
Figure 74: CS121-FTP Access
66
Figure 77: CS121-FTP Upsman.cfg
editor. Now check, if the parameter of the new data are present into the stored data. If not, you
need
67
Figure 79: CS121-Reboot
6. Additional Software
6.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.
68
Use your Web-browser to navigate to the address of your UPS Web-Manager. Click the
ion button and enable the SSL network feature.
timeserver.
settings.
69
Figure 83: Settings Confirmation
70
6.1.4 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 www.generex.de-
download 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 package does usually contain a single license for RCCMD
to shutdown 1 computer. For more computers to shutdown you have to order separate
RCCMD client licenses. If you want to shut down more than 50 clients in one company or
organisation, please contact your UPS dealer and order an enterprise license. Then you will
get one RCCMD license for all clients only.
6.2 jChart
jChart is a GENEREX Web 2.0 Control Chart for all web-browsers, which simple visualizes the
data log file of the CS121 (since CS121 firmware version 4.27).
71
check the accordant variables.
the colours for the values, click the coloured box prior of the variable.
72
Figure 88: jChart Colour Selection
6.3 gChart
gChart is a GENEREX plug-in for the MS Internet Explorer available as a free download from
the GENEREX web site. Quickly and easily visualise all of the CS121-adapter logfiles using
Generex's ActiveX graphical log controller GChart when using the Internet Explorer. Discover
UPS problems more easily and optimise system tuning more rapidly. Navigate through the
data with 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.
73
Get the gChart experience now by visiting our online CS121 at: http://q01.generex.de/ and be
sure to follow the GChart logfile links.
In order to activate this function, the following adjustments in the Internet Explorer Options are
required:
Select the
74
Figure 91: Security Settings
Initialize and script ActiveX controls not marked as save for scripting
75
and status information, which are stored in the UPSMAN log file, can be requested from every
computer with an installed UPS monitor module.
Features:
Monitoring of all UPS systems that are connected in the network via UPSMAN and
respective SNMP adapter
gCHART dynamic visual log file graphic tool
Remote controlling of all UPS systems via the network
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)
76
This task can also be achieved using the full version of the UNMS UPS Network Management
Software.
Note: (only SS4, not SS4AUX) If you wish to use a UPS with your SS4 then
you must install the appropriate CS121 Firmware on your SS4. The
default Firmware 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 (not included) to connect the SS4 with your UPS.
Note: Due to errors that may cause the switched off power outlet to remain on
it is necessary to conduct the following: 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
77
that the SITESWITCH 4 is not connected to the power supply by pulling
its power cable out of the power socket.
Use the
This means that none of the sockets are being provided with power thus cutting the connected
devices from the power supply.
The CS121 establishes a user interface for the SS4 for which the user has the option of using
either UPSMON, Webbrowser, 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.
7.1.4 SS4 - Technical data
Inputvoltage: 230V AC +/- 5%
Max. Power Input: 16A
Max. Power Output per socket: 8A (Load at cos phi 1)
Dimensions
Operating temperature: 0-40°C/rel.Humidity0-95% non condensating
7.2 Sensor SM_T_COM
The SM_T_COM is a temperature sensor for the use with a GENEREX CS121. It has a range
from -25° - 100° Celsisus (-13° 212° Fahrenheit) and comes with 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.
78
The SM_T_COM (also available as SM_T_H a combination of Temperature and Humidity) is
a temperature sensor with an RS232 protocol which can be connected directly to the CS121
COM2 port. (Not BUDGET series).
The SM_T_COM shows the actual values on the CS121 Webserver screen and allows to
trigger alarms, emails, messages in case the values exceed configurable thresholds.
SM_T_COM is simply connected with the original CS121-TEMP cable (part of every CS121
SC and L) to the COM2. In the Webinterface COM2 & AUX you have to change to the COM2
boot to start the CS121 with your
new settings. The Configuration of thresholds and Events is made via the Event-configuration
windows and the SM_T_COM configuration page.
7.2.1 SM_T_COM configuration
79
Figure 99: CS121-Configuration Threshold Events of analogue Inputs
In this example, a below threshold of 13 was defined for SM_analogue 1, in this case for the
temperature in °C, which will appear into the Event Configuration, after you executed the
80
7.3 SENSORMANAGER & SENSORMANAGER II
7.3.1 General information
If more than 1 or 2 environmental values are wanted to manage, than the SENSORMANGER
(SensorMan) is your choice. This device is a data measurement and collecting unit which
allows the individual measurement and monitoring of 8 analog measurement devices (0-10V)
and 4 digital alarm inputs or 4 outputs (open collectors).
81
7.3.2 Installation and Network integration
82
Figure 103: SENSORMANAGER II Settings
Using the splitting plugs (order number SPSMRJ) it is possible to connect up to 8 sensors and
4 contacts to the SENSOR- MANAGER. A MOUNTING KIT (sold separately) is available for
affixing the SENSORMANAGER to walls and railings.
The power supply for the SENSORMANAGER may also supply an external CS121 using a
SM-CS121 type cable (sold separately) by simply connecting the POWER OUT of the
SENSORMANAGER with the POWER IN of the CS121 external.
Startup the SENSORMANAGER
Connect the sensors to the SENSORMANAGER. Connect the SENSORMANAGER using the
Mini8-DBSub9 cable to the COM 2 port of the CS121. Finally, plug the power supply into one
of the UPS power outlets. Check the LEDs on the bottom of the SENSORMANAGER; the right
one should be flashing (reading request from CS121 COM2) and the left one should be
constantly lit (power supply on). The flashing LED shows the requests from the CS121, the
other LED shows that the device has started.
otherwise the CS121 will not start making requests to the SENSOR
MANAGER.
83
See the CS121 user manual for instructions on how to configure the CS121 for operation with
the TEMPMAN/SENSOR MANAGER and how to manage and set the alarms.
The latest version of CS121 user manual is available for download at:
http://www.generex.de/wwwfiles/dokus/1/cs121/german/pdf/cs121.pdf
When the SENSOR MANAGER is running, you will 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
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
84
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 Power 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 switch any relays or send high signals to the OUTPUT, you may connect your
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 will now show the values in its Web browser. Alarm thresholds and actions may be
configured via the EVENT manager of the CS121.
7.3.3 Special features of theSENSORMANANAGER II
Unlike the CS121 and the older SENSORMANAGER type, the new SENSORMANAGER II
configuration data will 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:
Acknowledged alarms are displayed in yellow in the status bar of the SENSORMANAGER II.
Not confirmed alarms are displayed in red (at older SENSORMANAGER always in yellow).
85
some basic sensor models are already listed, which you can choose to set predefined values
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.
releasing an alarm. This is important e.g. for temperature measurements, which are not
increasing/decreasing continuously.
the logfile.
Note: If you do not want to use a name for the Analog-, Digital Inputs or rather the
Outlets, please set the following into the single name area:
86
Figure 108: Alarm matrix Marker configuration
In the figure above is shown the alarm matrix with its 8 markers to be set or unset. Each
marker thereby is a new state on which specific alarm scenarios can be released.
For example: In the figure above is configured that the Marker1 will be set, when at the
analogue that
Marker1 will be unset in case of an alarm at analogue input 1 or 3.) Furthermore marker 2 will
be set, when at the digital input 2 and at the analogue input 2 an alarm state occurs at the
same time. (Means that an alarm at just one input is not sufficient for setting marker 2)
Accordingly it is possible to set (or unset) each marker in dependency of different digital and/or
analogue input states.
After having defined the conditions when markers are to be set resp. unset, you can specify
the actions to be executed when a marker will be set/unset. Therefore you have two
possibilities: The first is to handle the actions through the event configuration, described later
in chapter 3.2.5 Events / Alarms. This is possible because each marker has its own event
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
87
Figure 110: Alarm Matrix Switching of relay outputs
Detection of the analog temperature values via variables:
#SM2_ANALOG0
#SM2_ANALOG1
#SM2_ANALOG2
#SM2_ANALOG3
#SM2_ANALOG4
#SM2_ANALOG5
#SM2_ANALOG6
#SM2_ANALOG7
7.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 between 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.
88
Figure 112: PIN Adjustment Adapter-Connector GSM_A
Alternative, you can make a Mini8-DSUB9 cable for the Siemens GSM TMA T35i Modem by
yourself, as follows:
89
the message.
90
7.6 LED-Matrix Display
The LED-Matrix display is a remote display unit for relaying RCCMD messages that can be
operated via the Ethernet.
Note: MODBUS response changed: Now MODBUS will 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".
91
Figure 119: CS121MODBUS Installation
92
Figure 121: UNMS-Installation
7.9 SNMP
The CS121 can be monitored via web-browser, UPSView, MODBUS, PROFIBUS, LONBUS,
Email and SNMP (e. g. NAGIOS). The RFC1628cs121 SNMP MIB is at present.
The installation and setup of a SNMP browser is described into the Appendix.
To complete the SNMP adapter installation and configuration process, you must compile the
necessary MIBs to configure the NMS. Any NMS with a MIB compiler can manage the SNMP
adapter.
control. The manager must have read permission to execute a get command and read / write
permission to execute a set command successfully.
93
For instructions on how to compile MIBs for the most popular NMSs - Novell's NetWare
Management Station, Hewlett-Packard´s OpenView Network Node Manager, and SunConnect;
SunNet Manager; see the corresponding heading below.
Please note that the CS121 uses the standard MIB, which 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:
iso.org.dod.internet.mgmt.mib2.upsMIB
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 software 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 will answer with the UPS data.
Alternatively the Windows UPSMON, JAVAMON or the UPS SNMP WATCH of the DataWatch
Pro Software can be used. The UPS data will then be displayed graphically and internal UPS
information, which are only useful to the technical 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 software, 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 will now
no longer return any OIDs, which are not supported by this UPS.
8. Troubleshooting FAQ
8.1 Common Problems
Problem 2: Inform Pyramid DSP Series Communication with UPS See page 100 Error!
Slotcard inside does not start the UPS communication Reference
source not
found.
Problem 3: CS121 reboots again and again after a few time into See page 100 Error!
company´s network environment Reference
source not
found.
94
Problem 4: Sending of RCCMD signals, the following error is See page 100 Error!
logged into the CS121 AlarmLog Reference
source not
found.
Problem 5: No communication possible to APC UPS SURTD from See page 101 Error!
2011 Reference
source not
found.
8.2 Solutions
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
95
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 following folder:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W32Time\TimeProviders\Ntp
Server
Click with the right mouse
After this change stop/start the W32 Time service.
The Network Time Protocol is defined in RFC1305 and provides the transfer and the
maintenance of the time functions via distributed network systems.
Basic Configuration
The following command executes the synchronization of the local system to another server, to
get the most accurate time, prior of the start of the NTP server configuration.
96
[bash]#ntpd b
[bash]#ntp b
97
restrict 2.pool.ntp.org mask 255.255.255.255 nomodify notrap
noquery
# To allow all the workstations inside the internal private network to be able to query
the #time from your server, use the following access control rule (adjust subnet if
needed).
restrict 192.168.1.0 mask 255.255.255.0 nomodify notrap
server 127.127.1.0 # local clock
fudge 127.127.1.0 stratum 10
driftfile /var/lib/ntp/drift
broadcastdelay 0.008
keys /etc/ntp/keys
[bash]#ntp b
You should now set the runlevels, which are required for the NTPD service:
chkconfig --level 2345 ntpd on
/etc/init.d/ntpd restart
or
chkconfig --level 2345 ntp on
/etc/init.d/ntp restart
You can check with the following command, which runlevels are active::
[bash]# chkconfig --list ntpd
or
[bash]# chkconfig --list ntp
98
Figure 127: Check Configuration
99
Figure 129: NTP Query
Problem 2: Inform Pyramid DSP Series Communication with UPS Slotcard inside does not
start the UPS communication or if the external RS232 communication does not work.
Solution 2: It is required to put the DIP switches onto the UPS mainboard into the position
! Put the DIP switches into the posit
you are using an external CS121 via RS232 interface!
100
Solution 4:
101
Appendix
A. CS121 - Technical data
Operating
Product Power 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)
Power supply 12 V DC 12 V DC 12 V DC
Power output 350mA 100mA bei 12V 100mA bei 12V
Size 69x126 mm 69x126 mm 60x120 mm
Ethernet connections 10/ 100Base-T 10/ 100Base-T 10/ 100Base-T
RS-232 interface 2 2 2
4 4 4
DIP Switches 2 2 2
Operating temperature 0 40 °C 0 40 °C 0 40 °C
Humidity during normal 10-80%, no condensation
operations
B. CE- and UL-Certification
Both models, CS121L and CS121SC, are certificated by Underwriters Laboratories Inc. for the
US and Canada with the power supply 12 V DC, 300 mA.
As well, for both hardware specifications 121 and 131 of CS121-Adapter a certification of
Conformity has been drawn up. Please see the download page at www.generex.de to get a
copy of the certifications and documents.
C. Cable and Circuit board configuration, Pin/AUX-Ports, SensorMan
102
Figure 133: Cable configuration HW121 COM2
103
Figure 136: Slot version: Circuit board connection
Pin1: -> GND
Pin2: -> VDD
Pin3: -> TxD
Pin4: -> RxD
Pin9: -> GND
Pin8 connected with Pin 10
Figure 138: AUX-Port (Hardware Revision 1.1 = from Serial numbers 0121-1203, 0122-00198,
0123-00564 onwards) RJ11 6-pol
104
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 139: Example (Inputs): Opener or closer contact (only on hardware model CS121)
105
Figure 142: Examples: AUX Inpu -
-
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
Watchdog function: The watchdog starts 5 minutes after the CS121 has rebooted. If then the
Watchdog does not receive within 120 seconds no alive signal from the processor, it will
disconnect the power supply for a reset.
Powermanager function: Additionally this device checks the input power supply and blocks
the startup of the processor until the power supply is stabilized and has reached at least a level
of 8 Volt. This avoids startup problems at non stabilized power supplies or other power supply
problems in UPS slots.
106
This product is designed to work as add-on for all CS121 based products with an internal
connector such as all BACS WEBMANAGER BUDGET, CS121 SC,L,SCM,LM and the CS121
BUDGET series with 16MB flash ROM built after 2010.
Installation: To mount the CS121WDP Piggy Board on the CS121 Board, be sure, that the
power supply is disconnected. Plug the CS121WDP Board on the CS121-Board like in the
below pictures. The Piggy Board runs without any configuration and starts his functions
immediately after connection. For using the Watchdog functionality, a firmware release after
FW 4.28 is required. The Powermanager function is not depending on any FW level.
Figure 144: CS121 WDP piggyboard installed on a CS121 SC/BSC view from left and behind
Figure 145: CS121 WDP connecting PINs on a CS121 SC/BSC board top view
E. MODBUS Interface
E.1. General information
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 specific measurement
values (e.g. battery low).
107
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
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 network, because the CS121 is a multi device,
which has to handle several tasks at the same time.
NOTE: Please define a response timeout of at least 2000ms (at a fast MODBUS over IP or
RS485 network/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.
108
E.3. Exception Codes
Except for broadcast messages, when a master device sends a query to a slave device it
expects a normal response. One of four possible events can occur from the master's query:
If the slave device receives the query without 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 will 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 will 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 will 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 device error.
E.4. MODBUS Modes in the CS121 M (ASCII and RTU)
MODBUS Command
The following 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 two 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 word 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:
109
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
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, which will 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 word 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.
-
-65536. In this
ant to poll.
110
If you are using a PILLER UPS with a CS121 firmware 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 will be available via MODBUS.
111
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)
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
112
156 U 3/4 Sensormanager sensor 5 Analog value 1
157 U 3/4 Sensormanager sensor 6 Analog value 1
158 U 3/4 Sensormanager sensor 7 Analog value 1
159 U 3/4 Sensormanager sensor 8 Analog value 1
160 U 3/4 TrueOutputPower Phase A in KW True Output Power Current 1
Phase 1 in Kilowatt
161 U 3/4 TrueOutputPower Phase A in KW True Output Power Current 1
Phase 1 in Kilowatt
162 U 3/4 TrueOutputPower Phase A in KW True Output Power Current 1
Phase 1 in Kilowatt
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)
113
9 bit 2 Battery discharging Status 0: Normal, Status 1: 1
Alert
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
114
24 word 4 Temp 3 0.1degC
battery temperature
25 word 4 Temp 4 0.1degC
battery temperature
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
115
160 U 3/4 TrueOutputPower Phase A in KW True Output Power Current 1
Phase 1 in Kilowatt
161 U 3/4 TrueOutputPower Phase A in KW True Output Power Current 1
Phase 1 in Kilowatt
162 U 3/4 TrueOutputPower Phase A in KW True Output Power Current 1
Phase 1 in Kilowatt
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
Alarm: Output Off As
119 U 3/4 Requested 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
117
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
118
127 U 3/4 Alarm: Overtemperature 1 = active; 0 = not active 1
128 U 3/4 Alarm: Input Bad 1 = active; 0 = not active 1
129 U 3/4 Alarm: Output Bad 1 = active; 0 = not active 1
130 U 3/4 Alarm: Output Overload 1 = active; 0 = not active 1
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
119
SensorManager/SMTH_COM,
151 U 3/4 Sensor 1 Analog Value 1
SensorManager/SMTH_COM,
152 U 3/4 Sensor 2 Analog Value 1
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
120
not
117 Alarm: Battery Low not supported supported x
not
118 Alarm: Battery Depleted x supported x
not
119 Alarm: Overtemperature x supported x
120 Alarm: Input Bad x x x
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 Power 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
121
98 U 3/4 BATTCAP Battery capacity in percent 1
99 U 3/4 OUTPUT Outputvoltage in Volt 1
100 U 3/4 OUTFREQ0 Output Frequency 1
For details please contact
101 U 3/4 SOLAWROV0 your manufacturer 1
For details please contact
102 U 3/4 SOLAWROV1 your manufacturer 1
For details please contact
103 U 3/4 SOLAWROV2 your manufacturer 1
For details please contact
104 U 3/4 SOLAWROC0 your manufacturer 1
For details please contact
105 U 3/4 SOLAWROC1 your manufacturer 1
For details please contact
106 U 3/4 SOLAWROC2 your manufacturer active 1
107 U 3/4 OUTPOWER0 Outpower Phase 1 % 1
108 U 3/4 OUTPOWER1 Outpower Phase 2 % 1
109 U 3/4 OUTPOWER2 Outpower Phase 3 % 1
110 U 3/4 SOLSETEMPBAD Temperature bad 1
111 U 3/4 SOLSEINPUTBAD Input bad 1
112 U 3/4 SOLSEOVERLOAD Overload 1
113 U 3/4 SOLSEBYPASSFAULT Bypass fault 1
114 U 3/4 SOLSECHARGERFAULT Charger fault 1
115 U 3/4 SOLSEGENERALFAULT General fault 1
122
106 S 3/4 INVOLT2 Input Voltage Phase 3 V 1
109 U 3/4 STATUS (e. g. UPS normal = UPS Status (ASCII HEX), please 1
"4", Powerfail = "12", Battery note UPSMAN status bytes table
test running = "68", Bypass = below
"5")
123
1
124
157 U 3/4 AEESerModuleError(1,1) Status data, for details please 1
contact Effekta directly
125
174 U 3/4 AEESerModuleError(5,2) Status data, for details please 1
contact Effekta directly
126
191 U 3/4 AEESerModuleState(5) Status data, for details please 1
contact Effekta directly
127
155 U 3 / 4 OUTPUT_CURRENT1 Output Current Phase 2 in Ampere 1
*10
156 U 3 / 4 OUTPUT_CURRENT2 Output Current Phase 3 in Ampere 1
*10
128
101 U 3 / 4INVOLT0 AC Input Voltage Phase 1 1
102 U 3 / 4OUTPUT_VOLT0 DC Output Voltage 1
103 U 3 / 4EX_OUT_CURR0 Total Output Current 1
104 U 3 / 4EX_OUT_WATT0 Output Power in Watt 1
105 U 3 / 4BATTVOLT Battery Voltage 1
106 U 3 / 4EX_BATT_CURRPOS Battery Current 1
107 U 3 / 4EX_NOM_VOLT Nominal Voltage 1
108 U 3 / 4EX_NOM_CURR Nominal Current 1
109 U 3 / 4STATUS GENEREX UPS Status (see below) 1
129
UPS Status Hex-Value Dec-Value Description
Example (decimal):
! = UPS on Bypass!
NOT last device. To terminate the RS485 bus at your CS121, please close the Jumper.
130
E.8. Configuration
Please use Telnet (network connection) for the configuration with the default IP address
-232/ RS-485 converter
position.
131
Figure 148: MODBUS - Cable 112
NOTE: it is very important that the Shield is connected to the MINI 8 housing and to the
MODBUS requesting device common ground!
F. Available Variables of the CS121
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 specified 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 Power-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
132
CABLE ID of the used cable type
POWER Configurated UPS Power
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
TIME Time
ATTACHED_DEVICES Attached devices
BATTINSTDATE Battery installation date
AGENTSOFTREV Firmware 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
133
INPUT 3:
Pin 1 Input 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 Input 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
Event Description
UPS service is started into the CS121. This event is always true, if the
CS121 is running and therefore ideal for permanent recurrent jobs
suitable like the forwarding of emails always after restart of the UPS or
UPSMAN Started to produce log file entries steady.
UPS Connection Lost UPS RS232 communication lost, CS121 tries to restore the connection.
UPS Connection Restored UPS RS232 communication restored
134
Output Breaker Closed Output breaker closed. Load will be supplied.
Maintenance breaker closed (active). Load will be supplied through the
Maintenance Breaker Closed grid directly.
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.
135
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
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
136
Redundancy Ok Redundancy is at hand
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
Event Descripon
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
137
UPS service is started into the CS121. This event is always true, if the CS121
is running and therefore ideal for permanent recurrent jobs suitable like the
forwarding of emails always after restart of the UPS or to produce log file
UPSMAN started entries steady.
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
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 bae r i es ar e 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
138
J. Configuration of Microsoft SCOM 2007 as CS121 Trap Receiver (Monitor)
In this section we will configure Microsoft Operations Manager 2007 (SCOM/OpsMgr) as an
SNMP Trap receiver, discover SNMP-enabled cs121 network devices, and configure an alert-
generating SNMP-trap-based monitor to raise alerts when specific traps are received from
cs121 devices.
139
Activate the SNMP Trap Service (on Windows Server 2003)
In the Services Panel, select the SNMP Trap Service
In the SNMP Trap Service properties dialog select « Startup type : Automatic », then
click the « Start » button to start this service now.
In the Operations console (Authoring space), start the Create a Monitor Wizard.
On the Select a Monitor Type page, do the following:
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.
140
Figure 152: Select a Monitor Type
141
Figure 153: 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: 1.3.6.1.2.1.33.2.3
(upsTrapAlarmEntryAdded). Then click Next.
142
Figure 154: 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:
1.3.6.1.2.1.33.1.6.3.2 (The 1.3.6.1.2.1.33.1.6.3.2 is the well known alarm OID for
upsAlarmOnBattery).
143
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: 1.3.6.1.2.1.33.2.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:
1.3.6.1.2.1.33.1.6.3.2 (The 1.3.6.1.2.1.33.1.6.3.2 is the well known alarm OID for
upsAlarmOnBattery).
144
Figure 157: 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.
Target and Data variables to include in the description, such as Device Name.
Select a Priority from the list, such as High.
Select a Severity from the list, such as Critical.
Click Create
145
Figure 159: Configure Alerts
146
Figure 160: Discovery Method
Discovery for even a single device will run for a couple of minutes by default. If you specify an
IP range, it will take a little longer.
On the Select Objects to Manage page, select the devices desired for management.
On the Summary page, click Finish. The objects will display in the Network
Devices node of the Operations Console Administration space.
At this point, SNMP-enabled device availability monitoring will start automatically. Any traps (of
kind upsAlarmOnBattery) received from the cs121 target devices will be raised as alerts in the
Operations console.
147
Figure 161: Telnet DHCP Settings
5 255.255.255.255
You can enter the accordant IP address of the DHCP server, if you know it. If you want to
disable DHCP, please enter the following:
5 0.0.0.0
1. Install a RCCMD client on a Windows OS and copy/create a file, like the following, into the
RCCMD directory (default C:\Program Files\RCCMD) and use a SNMPwalk tool from an open
source with the mandatory distribution txt-file « Copying.txt ». This file is included for legal
reasons (Open Source).
148
Figure 162:
The command is called « pxout.bat » and expect 4 parameters :
tes
and translates these into SNMP set commands for the Raritan.
Outlet: This is the number of the Raritan Outlet 1 to 12, which you want to switch.
On/Off
If this works 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, which will
located.
149
Figure 163: CS121 Configuration for such a relay command
The target of the RCCMD command is the Windows computer with RCCMD and the
with the IP address 192.168.200.41
the socket number 1 at the Raritan with the IP address 192.168.222.43 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
4. The Raritan with firmware 1.4.1 is unfortunetaley buggy. Here the workaround:
150
The default Raritan user is
Attention! This does not work with MS Internet Explorer! Use any other web-browser,
e. g. Mozilla Firefox.
tart.
151
Table of figures
152
Figure 52: HTTP Event Editor.........................................................................................53
Figure 53: HTTP - Job Editor.............................................................................................53
Figure 54: HTTP - Job Editor / Function ............................................................................54
Figure 55: HTTP CS121 Configuration Manager.............................................................55
Figure 56: HTTP Event Editor / Test ...............................................................................55
Figure 57: HTTP Job Test Page .....................................................................................55
Figure 58: HTTP AlarmLog.............................................................................................55
Figure 59: HTTP Job Editor RCCMD WAKEUP ..............................................................56
Figure 60: HTTP Job Editor RCCMD WAKEUP ..............................................................56
Figure 61: HTTP - Job Editor: RCCMD execute/command ................................................57
Figure 62: HTTP Enable RCCMD Listener .....................................................................58
Figure 63: HTTP - Job Editor: RCCMD-Command ............................................................58
Figure 64: HTTP - Job Editor: Shutdown UPS-Job ............................................................59
Figure 65: HTTP - Job Editor: Wake On LAN ....................................................................60
Figure 66: HTTP Scheduled Actions...............................................................................60
Figure 67: HTTP Status Page Socomec Transfer Switch ................................................61
Figure 68: HTTP Status Page Eaton Transfer Switch .....................................................61
Figure 69: HTTP - Firmware Update Page.........................................................................62
Figure 70: CS121-Configuration Manager .........................................................................63
Figure 71: CS121-FTP Access ..........................................................................................64
Figure 72: CS121-FTP Context Menu................................................................................64
Figure 73: CS121-FTP Folders..........................................................................................64
Figure 74: CS121-FTP Upsman.cfg...................................................................................65
Figure 75: CS121-FTP File Replacement ..........................................................................65
Figure 76: CS121-Reboot..................................................................................................66
Figure 77: RCCMD - Overview ..........................................................................................66
Figure 78: RCCMD SSL Settings.......................................................................................67
Figure 79: Timeserver Settings..........................................................................................67
Figure 80: Settings Confirmation .......................................................................................68
Figure 81: jChart Display of the CS121 Data Log ..............................................................69
Figure 82: jChart Display of a Measurement Value ............................................................69
Figure 83: jChart Display of the Loads ...............................................................................70
Figure 84: jChart Zoom-In of an Area .............................................................................70
Figure 85: jChart Colour Selection ..................................................................................71
Figure 86: gchart plug-in for the internet explorer ..............................................................71
Figure 87: Internet Options of the internet explorer ............................................................72
Figure 88: Security Settings...............................................................................................73
Figure 89: SideSwitch4 and SS4 AUX ...............................................................................74
Figure 90: CS121-Installation with SideSwitch4 .................................................................74
Figure 91: Exchange COM Ports 1 & 2 for SS4 .................................................................75
Figure 92: The Sensor SM_T_COM ..................................................................................76
Figure 93: CS121-Installation with temperature SM_T_COM.............................................76
Figure 94: CS121- SM_T_COM Settings ...........................................................................77
Figure 95: CS121- SM_T_COM Functions ........................................................................77
Figure 96: CS121-Configuration Threshold Events of analogue Inputs ..............................78
Figure 97: CS121-Configuration Threshold Event for SM_analogue 1 ...............................78
Figure 98: Sensor Manager (SensorMan)..........................................................................79
Figure 99: CS121-Installation with SENSORMANAGER....................................................80
Figure 100: SENSORMANAGER II Settings........................................................................81
Figure 101: SENSORMANAGER II LEDs ............................................................................81
Figure 102: SENSORMANAGER II Status Site....................................................................83
Figure 103: SENSORMANAGER II Configuration Analog Inputs .........................................84
Figure 104: SENSORMANAGER II Configuration Outlets....................................................84
Figure 105: Alarm matrix Marker configuration .................................................................85
Figure 106: Alarm Matrix Switching of relay outputs .........................................................85
Figure 107: Alarm Matrix Switching of relay outputs .........................................................86
Figure 108: RASMANAGER network integration .................................................................86
Figure 109: PIN Adjustment Adapter-Connector GSM_A.....................................................87
153
Figure 110: Mini8-DSUB9 Cable Cross-Section .................................................................. 87
Figure 111: COM2 Mode: GSM Modem .............................................................................. 87
Figure 112: Configuration of the Function ........................................................................... 88
Figure 113: Siemens GSM TMA T35i Modem ..................................................................... 88
Figure 114: GSM Signal Quality Display ............................................................................. 88
Figure 115: LED-Matrix display network integration ............................................................ 89
Figure 116: CS121MODBUS Installation ............................................................................ 90
Figure 117: CS121 PROFIBUS Installation ......................................................................... 90
Figure 118: UNMS-Installation ............................................................................................ 91
Figure 119: MS-Timeservices ............................................................................................. 93
Figure 120: Registry NTP Server ........................................................................................ 94
Figure 121: Bash ntpd b.................................................................................................... 95
Figure 122: Bash ntp b...................................................................................................... 96
Figure 123: Runlevel........................................................................................................... 96
Figure 124: Check Configuration......................................................................................... 96
Figure 125: Check Configuration......................................................................................... 97
Figure 126: NTP Query....................................................................................................... 98
Figure 127: Mainboard Inform Pyramid DSP....................................................................... 98
Figure 128: CS121 AlarmLog, ProtMan Connection............................................................ 98
Figure 129: CS121 Network Card Speed Configuration ...................................................... 99
Figure 130: Cable configuration HW121 COM2 ................................................................ 101
Figure 131: Cable configuration HW121/HW131 COM2.................................................... 101
Figure 132: External D-SUB 9-polig male.......................................................................... 101
Figure 133: Slot version: Circuit board connection ............................................................ 102
Figure 134: Pin COM2 Mini-DIN 8 pol female ................................................................... 102
Figure 135: AUX-Port (Hardware Revision 1.1 = from Serial numbers 0121-1203, 0122-
00198, 0123-00564 onwards) RJ11 6-pol....................................................... 102
Figure 136: Example (Inputs): Opener or closer contact (only on hardware model CS121)103
Figure 137: Opto coupler logic .......................................................................................... 103
Figure 138: Example (Outputs) ......................................................................................... 103
Figure 139: -
- ............................................................................. 104
Figure 140: AUX Port Assignment .................................................................................... 104
Figure 141: CS121 WDP piggyboard installed on a CS121 SC/BSC view from left and
behind............................................................................................................ 105
Figure 142: CS121 WDP connecting PINs on a CS121 SC/BSC board top view............ 105
Figure 143: MODBUS - Jumper ........................................................................................ 128
Figure 144: MODBUS CS121 COM2 Settings................................................................ 129
Figure 145: MODBUS - Cable 112.................................................................................... 130
Figure 146: SNMP Service Properties............................................................................... 137
Figure 147: SNMP Trap Service ....................................................................................... 138
Figure 148: General Properties ......................................................................................... 138
Figure 149: Select a Monitor Type .................................................................................... 139
Figure 150: General Properties ......................................................................................... 140
Figure 151: Configure the trap OIDs to collect .................................................................. 141
Figure 152: Build Event Expression .................................................................................. 141
Figure 153: Configure the trap OIDs to collect .................................................................. 142
Figure 154: Build Event Expression .................................................................................. 143
Figure 155: Configure Health ............................................................................................ 143
Figure 156: Configure Alerts ............................................................................................. 144
Figure 157: Discovery Method .......................................................................................... 145
Figure 158: Telnet DHCP Settings ................................................................................. 146
Figure 159: ...................................................................................................... 147
Figure 160: CS121 Configuration for such a relay command ............................................ 148
Figure 161: Raritan Device Settings.................................................................................. 148
Figure 162: Raritan SNMP Settings .................................................................................. 149
154