GE Digital Energy Power Quality Operating Manual Digital Energy™ SNMP / WEB ADAPTER P/N 1018959 3-ph SNMP/Web plug-in adapter P/N 1019070 1-ph SNMP/Web plug-in adapter P/N 23954 SP SNMP/Web plug-in adapter P/N 1019071 1-ph SNMP/Web external adapter GE Consumer & Industrial SA General Electric Company CH –...
Page 2
The present publication and any other documentation supplied with the UPS system is not to be reproduced, either in part or in its entirety, without the prior written consent of GE. The illustrations and plans describing the equipment are intended as general reference only and are not necessarily complete in every detail.
Page 3
Dear Customer, We thank you for selecting our products and are pleased to count you amongst our very valued customers at GE. We trust that the use of the SNMP/Web adapters for our Uninterruptible Power Supply systems, developed and produced to the highest standards of quality, will give you complete satisfaction.
ARCHITECTURE ARCHITECTURE DIAGRAM Windows Linux UNIX 10/100 Mbit/s Ethernet Local console NOTE: 1:1 RS232 only required for configuration Contact i/f (1-ph plug-in version only) SAFETY All maintenance and service work should be performed by qualified service personnel only. Please read carefully the Installation Manual before installing or operating the adapters. For more information on the UPS system, please refer to the applicable Installation and User Manual.
VT-100 • Establish the connection and press <enter> • The default username (login) and password are ge and ge • A command-line configuration interface is entered Modifications reserved Page 11/69 OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter...
Launch a telnet client (e.g. on a PC running Windows, select Run from the Start menu and type telnet <IP>) • The default username (login) and password are ge and ge • A command-line configuration interface is entered SSH (Secure SHell) combines user authentication with encryption, to provide a higher degree of communication security.
Both username and password are case-sensitive, and are always specified in lower case • By default, only one user is defined, with username and password set to ge and ge • Depending on the user class, not all commands and settings may be available 2.1.4 Saving the settings...
NOTE: FW file to be uploaded via FTP Start the kernel upgrade. kernel_upgrade NOTE: Kernel upgrade should only be performed when instructed to do so by GE personnel. Unnecessary upgrades should be avoided. System restart (soft-reset) reboot NOTE: All unsaved changes will be lost...
2.2.2 Network command group The network command group allows to configure the board for communication over the network. Command Parameters Description showip Show the current network settings Show ARP table Define the network settings at boot-up (*) manual static IP configuration, the device configuration boot-method manual | dhcp | bootp (ref.
Setting the boot-method to manual has the side effect that manual-dns is also set to ON. Mind that the reverse is not true (setting boot-method to DHCP does not forced manual-dns to OFF). However, if the boot method is set through the quick network configuration menu, setting the boot-method to DHCP will also force manual-dns to OFF.
Change supervisor login name [name] New supervisor username supername [name] NOTE: By default, the superuser is the only configured user with username and password set to ge and ge. showuser Show user settings Add a user [user] username for the new user [telnet] 1 –...
2.2.5 Service command group The service command group allows to enable/disable different services. Note that the local (serial) connection cannot be disabled. Command Parameters Description Enable/disable HTTP server (port:80) http-server on | off Web server enabled Web server disabled Enable/disable HTTPS server (port:443) https-server on | off Secure web server enabled...
2.2.6 Time command group The time command group allows to enable/disable different services. Note that the local (serial) connection cannot be disabled. Command Parameters Description showtime Show all configured time settings Enable/disable NTP client ntponoff on | off NTP client enabled NTP client disabled Define NTP server ntp-server...
2.2.7 Smtp command group The smtp command group allows to configure the e-mail sending functionality for e-mail notification of UPS events and alarms: Command Parameters Description showsmtp Show detailed e-mail settings Enable/disable email functionality email-alert on | off E-mail alert enabled E-mail alert disabled Set timeout for TCP communication with SMTP server smtp-timeout...
2.2.8 Snmp command group The snmp command group allows to configure the SNMP Agent for UPS monitoring via SNMP and trap notification of UPS events and alarms: Command Parameters Description showsnmp Show detailed system information Set SNMP server listening port (*) snmpport [port] [port] SNMP port...
Show detailed trap configuration Enable/disable send trap [RFC1628] function sendtrap on | off Trap sending enabled Trap sending disabled Enable/disable send trap [GE-MIB] function Trap sending enabled sendgetrap on | off Trap sending disabled NOTE: 3-ph version ONLY Add a trap address [X.X.X.X]...
2.2.10 UPS command group The UPS command group allows monitoring and configuration of the managed UPS system. Command Parameters Description upsinfo Show detailed UPS information upstest Start/Stop UPS tests upscontrol Control the UPS (1-ph/SP versions ONLY) upsconfig Configure UPS parameters Set UPS attached device [device] Device which is powered/protected by the UPS...
Command Parameters Description Enable/disable write commands to the UPS Setting readonlymode to on will stop any write operation towards the UPS (the SNMP/Web adapter will effectively switch to read-only mode). The UPS Test, Control and Config readonlymode [on | off] web pages will not be shown in the navigator bar.
2.2.12 Modbus command group The modbus command group controls the Modbus TCP slave functionality. Command Parameters Description Enter the license key to enable Modbus TCP feature [key] License key in GUID format modbus_key [key] Note: Modbus TCP support requires a license key. Refer to the Modbus section of this manual for details Enable Modbus TCP slave mb_tcp_enable...
2.2.14 Log command group The log command group allows to access the logs maintained by the SNMP/Web adapters. Command Parameters Description syslog Dump the System log to the console upslog Dump the UPS log to the console logdump Dump the System and UPS log to the FTP area clearlog Clear the UPS event log Modifications reserved...
Note that authentication (username / password pair) can be required. The only user configured by default is the supervisor with username /password set to ge and ge. In case any problem is encountered during web access refer to the Troubleshooting section.
3.1.4 Saving the settings Apart from some network parameters, most setting are immediately active. However, the adapter will revert to the last save settings at reboot. Therefore, in order to permanently modify the SNMP/Web adapter setting, remember to save the configuration after every change. NAVIGATION BAR The top navigation bar features the following items: •...
3.3.2 Battery page The Battery page shows the following information. Parameter Name Description Battery Status The current status of the battery: 1 – unknown 2 – normal The remaining run-time on batteries is greater than the UPS low battery time (ref. UPS Config page) 3 –...
Finally, a 3-ph system featuring the PMAD functionality will also show the following: Parameter Name Description Power factor The present output power factor. A positive value indicates an inductive load; while a negative value indicateS a capacitive load. Note: the power factor cannot be reliably determined in low load conditions. In this case, the value will not be available (N/A) Peak current The output peak current...
Service Engineers – the data provided is not expected to be meaningful for the end user. The diagnostic information can be exported by pressing the Highlight button and copying the selected text (e.g. CTRL+C) to a separate application in order to be sent to a GE Customer Service Centre. Modifications reserved Page 31/69 OPM_CNT_SNM_BAS_CRD_1GB_V014.doc...
Page 32
When the UPS system includes one of these high-efficiency options, an additional section is available on the top navigation bar. NOTE: Both IEMi and eBoost options are available ONLY if enabled at the factory or by a GE Service Engineer.
SYSTEM SECTION 3.5.1 Network page Network configuration of the card – refer to the NETWORK CONFIGURATION chapter within this manual. Note that the settings on this page will only take effect after a reboot of the card. 3.5.2 Date&Time page Through this page it is possible to configure the adapter date and time settings.
This page shall only be accessed when the SNMP/Web adapter SW is to be upgraded. Refer to the section for details on the SW upgrade process. NOTE: Use only GE officially released SW. Only perform the SW upgrade when requested to do so by GE. Modifications reserved Page 34/69 OPM_CNT_SNM_BAS_CRD_1GB_V014.doc...
SNMP SECTION The SNMP section deals with SNMP and trap configuration. 3.6.1 SNMP settings page The most relevant SNMP settings are the following: Parameter Name Description Port Number Set SNMP server listening port. Default port is 161. Get Community Defines the community name for receiving SNMP information (GET). The get community name controls access to the SNMP Agent –...
SMTP SECTION The SMTP page controls the e-mail notification functionality. 3.7.1 SMTP configuration page The basic SMTP settings are the following: Parameter Name Description SMTP Server Hostname or IP-address of the SMTP server Sender name The MAIL FROM field of the mail message Recipent e-mail address The RCPT TO field of the mail message If the SMTP server requires authentication, the following sections shall also be defined.
UTILITY SECTION This section includes some useful tools for troubleshooting and configuration: • DNS lookup: a tool for verifying DNS server configuration, useful for troubleshooting DNS problems • Mii-tool: shows the media technology currently selected / negotiated • Speed/Duplex: set the media technology to be used / advertised. As most network devices, SNMP/Web adapters use an auto-negotiation protocol (Auto setting) to communicate what media technologies they support, and then select the fastest mutually supported media technology.
RFC1628 MIB is available in the upsMIB group. Additional UPS information is available in the GE MIB under the geUPS group (limited to the 3-ph SNMP/Web plug-in adapter). RFC1628 MIB OBJECTS The SNMP/Web adapters support the following RFC1628 Objects: OIDs TRAPS &...
Two different version of the GE private MIB exist: • GE Single MIB: to be used for monitoring of a 3-ph UPS is single unit configuration • GE Parallel MIB: to be used for monitoring of a 3-ph parallel UPS system The MIB structure is shown in the following picture.
NETWORK CONFIGURATION The SNMP/Web adapter network interface is very flexible and can be configured for operation in various environments. This section details all possible network configuration combinations, while it is recommended to refer to Console/Web interface sections for the specific configuration commands / menus.
DNS CONFIGURATION DNS configuration affects the SNMP/Web adapter ability to resolve symbolic hostnames to IP addresses, and may impact other functionality (such as e-mail sending, for example): The SNMP/Web adapters can be configured to automatically obtain DNS server address (e.g. Primary and Secondary DNS server as specified in the DHCP response).
6 MULTI-SERVER NETWORK SHUTDOWN (RCCMD) The SNMP/Web adapters include a module for Multi-Server Network Shutdown. This module allows the configuration of a shutdown strategy for several servers powered by the UPS when the batteries are running low following a prolonged mains failure. NETWORK SHUTDOWN WITH RCCMD RCCMD (Remote Console Command) is a mechanism that allows the execution of commands on remote systems.
Finally, it is possible to configure the actual condition that triggers the RCCMD Shutdown command: • After X minutes that the UPS is running on battery • At X minutes of estimated minutes remaining of battery autonomy • When the UPS signals a low battery condition Note that a low battery condition will force the shutdown of the configured RCCMD Clients regardless of the chosen shutdown condition.
RCCMD CLIENT RELAY The maximum number of RCCMD Clients that can be managed by the SNMP/Web adapter is limited. In order to reach a higher number of RCCMD Clients, one or more of these clients can be configured to operate as relays. Basically, the RCCMD Client needs to be configured so that it will execute a batch or script file that issues more RCCMD Shutdown commands.
For 3-ph parallel systems, it is possible to monitor each single UPS and obtain similar information for the parallel system as a whole. NOTE: A License Key is needed to activate the Modbus TCP functionality on the SNMP/Web adapters. Please contact your local GE distributor to obtain a valid License Key. MODBUS TCP CONFIGURATION 7.1.1 Licensing As stated, a License Key is needed to activate the Modbus TCP functionality.
MODBUS REGISTER MAP The following tables give the Modbus register map for GE UPS. Note that the actual values that are available on a specific UPS will depend on the UPS type, model and rating. Refer to the Data Types section for the value encoding corresponding to the ‘not available’...
Page 49
Address Type Description Notes Word Word 2 30X08 30X09 FLOAT Input Frequency L1 The present input frequency. Units: Hertz 30X10 30X11 FLOAT Input Voltage L1 The present input voltage, RMS value. Units: Volts 30X12 30X13 FLOAT Input Current L1 The present input current, RMS value. Units: Amp 30X14 30X15 FLOAT...
Page 50
Discrete Inputs (1xxxx) – Function code 02: Read Discrete Input Address Description Notes 10X01 upsAlarmBatteryBad One or more batteries have been determined to require replacement. 10X02 upsAlarmOnBattery The UPS is drawing power from the batteries. 10X03 upsAlarmLowBattery The remaining battery run-time is less than or equal to upsConfigLowBattTime.
Page 51
Address Description Notes 10X32 Not Used (Reserved) 10X33 upsStatusEcomodeIsOn Ecomode is ON. 10X34 upsStatusBatteryIsCharging Battery is being charged. 10X35 upsStatusBatteryIsDischarging The UPS is drawing power from the batteries. Identical to upsAlarmOnBattery. 10X36 upsStatusAlarmIsActive UPS has a general fault. Identical to upsAlarmGeneralFault. 10X37 upsStatusRectifierIsOn Rectified is ON.
7.2.1 Register addressing In a parallel 3-ph UPS system, the various UPS in the system can be addressed by using a particular register address encoding yyXyy, where X represents the UPS ID in the system: 0 - UPS1; 1 - UPS2; 2 - UPS3; 3 - UPS4; 4 - UPS5; 5 - UPS6; 6 - UPS7; 7 - UPS8; 8 - System The System UPS is a virtual UPS that reports alarms, status and measures for the entire UPS system.
Page 53
Output Frequency 50.0 Hertz: exponent –8 (F8h), mantissa 12’800 (00 32 00h), coded value F8 00 32 00 F8 00 32 00 00 32 00 h = 12800mantissa F8 h = -8exponent 50.0 12800 x 2 Output Power 1370 Watts: exponent 0 (integer value), mantissa 1’370 (05 5Ah), coded value 00 00 05 5A 00 00 05 5A 00 05 5A h = 1370 mantissa...
The adapters come with a predefined supervisor user, whose default username and password are ge and ge. New users can then be created using either the console or the web interface. NOTE Only the supervisor user can create new users.
SERVICES (ACCESS METHODS) The table below lists the available services (access methods), highlighting the major security features for each interface. Interface Access methods Security features Local console interface Serial cable Authentication via user/pwd pair Remote console interface Telnet Authentication via user/pwd pair Plain text SSH (Secure SHell) Authentication via user/pwd pair...
Page 56
The fingerprint may be checked against the information provided by the SNMP/Web adapter to confirm to SSH server identity. On the console interface inject the ssh-fingerprint command. Below is a sample output of the ssh-fingerprint command: GEDE> ssh-fingerprint 1024 6e:07:31:58:16:91:ae:2e:43:6f:03:64:94:57:55:6d ssh_host_rsa_key.pub 1024 06:97:69:97:cd:93:1b:b6:29:ca:34:e5:8c:35:7c:6e ssh_host_dsa_key.pub 1024 d1:9b:50:13:b3:e3:98:8e:8c:76:49:14:be:21:ed:b3 ssh_host_key.pub The output can be interpreted as follows:...
8.3.2 SSL Certificates HTTPS is not a protocol itself, but it actually refers to HTTP communication over SSL (Secure Sockets Layer) connection. HTTPS uses public-key cryptography to protect the communication. With HTTPS, the server sends back its identification in the form of a digital certificate. The certificate usually contains the server name, the trusted certificate authority (CA), and the server's public encryption key.
Page 58
On the console interface inject the ssl-fingerprint command. Below is a sample output of the ssl- fingerprint command: GEDE> ssl-fingerprint MD5 Fingerprint=8F:A1:CE:8B:B3:04:E7:07:90:6D:02:77:6F:EE:9E:22 SHA1 Fingerprint=F5:D2:CA:27:BF:DA:98:31:39:6F:18:8C:C5:9C:BC:6C:D3:62:15:AC It can be seen that the thumbprint shown by the web browser (with thumbprint algorithm shown as sha1) matches the SHA1 fingerprint as shown by the ssl-fingerprint command.
Particularly, it is recommended to focus on the following settings: • The default username and password for the superuser are ge and ge. It is recommended to change default username and password (by configuring new and unique ones) at the initial card configuration •...
OTHER FUNCTIONALITIES SYSTEM TIME The SNMP/Web adapter provides means to maintain the system time. Particularly, the adapter will maintain an internal clock when powered-up, while an RTC with battery back-up will hold date/time information when off (or during power-cycles). This system offers a sufficient accuracy in the short term. However, in the longer term the time drift may become significant.
9.3.1 UPS Load Alert The SNMP/Web adapter monitors the UPS Output Percent Load and reports a UpsLoadAlert when the load drops of a defined percentage (the actual load step detected is also saved in the UPS log). This functionality warns the user that there has been a drop in the UPS load. This could indicate potential issues with the UPS load (fuse blown, breaker tripped, unit off, etc.).
Therefore: • Never power off or un-plug the device during upgrade • Use only GE officially released software • Avoid unnecessary upgrades (in line of practice, only perform upgrades when recommended to do so by GE) 10.1.1 OS Kernel upgrade The SNMP/Web adapters also provide a kernel upgrade facility for upgrading the OS kernel.
adapter may be severely affected by a corrupted configuration file. In any case the procedure is described below: • Transfer the new configuration file (gedeups.cfg) to the device using ftp or sftp • Update the configuration by injecting the nvupdate command at the console •...
11 TROUBLESHOOTING 11.1 TROUBLESHOOTING UPS CONNECTION The SNMP/Web adapter front panel features a LED marked ‘UPS’. This LED should be OFF in normal conditions. If the LED is ON then there is a problem in the communication with the UPS. NOTE: It may take up to one minute for the adapter to synchronise the communication with the UPS.
11.3 TROUBLESHOOTING NETWORK CONNECTION When experiencing difficulties in the network access to the card follow the flowchart below to identify the root-cause of the problem and implement proper corrective actions. Network interface Network interface Verify if required Verify if required Network I/f OK Network I/f OK service is running...
11.4 TROUBLESHOOTING WEB ACCESS Refer to the following table for troubleshooting most common problems in accessing the embedded web interface. Please note that proper browser configuration is responsibility of the user – this section aims to give guidance to understanding the common access problems and browser errors. Problem Recommended resolution Browser error:...
11.6 TROUBLESHOOTING E-MAIL NOTIFICATION (SMTP) When e-mail notification via SMTP is configured and enabled, the SNMP/Web adapter will notify the selected recipients upon UPS alarm activation / deactivation. If problems are experienced with this functionality, follow the flowchart below to identify the root-cause of the problem and implement proper corrective actions.
11.7 TROUBLESHOOTING NETWORK SHUTDOWN When experiencing difficulties with the Network Shutdown functionality (RCCMD), there are a few diagnostic tools that can be used. The first step is to ensure that the SNMP/Web adapter can reach the RCCMD Client. The actual network connectivity between the two nodes can be checked with the usual ping command.
12 CUSTOMER SUPPORT 12.1 FIRST LINE SUPPORT Please contact your local GE distributor for problems with the installation of the product or its use. 12.2 INTERNET On-line support available on request (Internet access required). 12.3 WWW SERVER We have a WWW server running at www.gedigitalenergy.com...