GE Digital Energy 1018959 Operating Manual

Snmp / web adapter
Hide thumbs Also See for Digital Energy 1018959:
Table of Contents
GE Digital Energy

Power Quality

GE Consumer & Industrial SA
General Electric Company
CH – 6595 Riazzino (Locarno)
Switzerland
T +41 (0)91 / 850 51 51
F +41 (0)91 / 850 51 44
www.gedigitalenergy.com
GE imagination at work
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
Table of Contents
loading

Summary of Contents for GE Digital Energy 1018959

  • Page 1: Power Quality

    GE Digital Energy Power Quality 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 1019071 1-ph SNMP/Web external adapter GE Consumer & Industrial SA General Electric Company CH – 6595 Riazzino (Locarno)
  • 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.
  • Page 4: Table Of Contents

    Table of contents INTRODUCTION... 7 FEATURES...7 OVERVIEW...7 ARCHITECTURE ... 10 SAFETY... 10 CONSOLE INTERFACE... 11 INTRODUCTION ... 11 2.1.1 Local connection... 11 2.1.2 Remote connection... 12 2.1.3 Log-on... 13 2.1.4 Saving the settings... 13 COMMAND LIST ... 14 2.2.1 General command group ... 14 2.2.2 Network command group...
  • Page 5 SAVE SECTION... 34 3.10 USER SECTION... 34 SNMP AGENT ... 35 MIB STRUCTURE ... 35 RFC1628 MIB OBJECTS ... 35 GE MIB OBJECTS ... 37 NETWORK CONFIGURATION... 39 ETHERNET CONNECTION ... 39 TCP/IP CONFIGURATION... 39 5.2.1 Static IP address... 39 5.2.2...
  • Page 6 10.3 TROUBLESHOOTING NETWORK CONNECTION 10.4 TROUBLESHOOTING WEB ACCESS ... 55 10.5 TROUBLESHOOTING DATE&TIME (NTP) 10.6 TROUBLESHOOTING E-MAIL NOTIFICATION (SMTP)... 56 10.7 TROUBLESHOOTING NETWORK SHUTDOWN... 57 CUSTOMER SUPPORT ... 58 11.1 FIRST LINE SUPPORT ... 58 11.2 INTERNET... 58 11.3 WWW SERVER... 58 Modifications reserved OPM_CNT_SNM_BAS_CRD_1GB_V012.doc ...
  • Page 7: Introduction

    Digital outputs (open-collector outputs for relay drive) – 1-ph plug-in version only • SNMP Traps and E-mail notification upon UPS alarm • Advanced security features OVERVIEW 3-ph SNMP/Web plug-in adapter (P/N 1018959) Site Pro / SG Series RS-232 RS-232 Active Active...
  • Page 8 1-ph SNMP/Web plug-in adapter (P/N 1019070) Active Active UTP 10/100 UTP 10/100 • 1 – RJ45 Connector Ethernet connection, 10Base-T or 100Base-TX • 2 – LEDs Ref. specific section • 3 – RS-232 port Local console connection (115200-N-8-1) • 4 – Reset button HW reset •...
  • Page 9 • 1 – RJ45 Connector Ethernet connection, 10Base-T or 100Base-TX • 2 – LEDs Ref. specific section • 3 – RS-232 port Local console connection (115200-N-8-1) • 4 – Reset button HW reset • 6 – Power-in AC adapter connection •...
  • Page 10: Architecture

    ARCHITECTURE ARCHITECTURE DIAGRAM 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. Particularly, refer to Safety Rules, Warnings and Cautions as laid out in the cited document.
  • Page 11: Console Interface

    115,200bps, 8 data bits, terminal emulation VT-100 • Establish the connection and press • The default username (login) and password are ge and ge • A command-line configuration interface is entered Modifications reserved OPM_CNT_SNM_BAS_CRD_1GB_V012.doc 1 stop bit, parity none,...
  • Page 12: Remote Connection

    Launch a telnet client (e.g. on a PC running Windows, select Run from the Start menu and type telnet ) • 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.
  • Page 13: Log-On

    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...
  • Page 14: Command List

    COMMAND LIST The various commands are split in different groups, depending on the involved functionality, and are listed here in accordance with their group classification. The command-line interface includes a command auto-completion feature. Normally, typing a command without any parameter displays usage information on the command. A help command is also available.
  • Page 15: Network Command Group

    2.2.2 Network command group The network command group allows to configure the board for communication over the network. Command Parameters showip boot-method manual | dhcp | bootp [address] setip [netmask] [gateway] hostname [hostname] dhcphost on | off mii-tool recheck auto | 100baseTx-FD | speedduplex 100baseTx-HD |...
  • Page 16: Dns Command Group

    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.
  • Page 17: User Command Group

    Description Change supervisor login name [name] New supervisor username NOTE: By default, the superuser is the only configured user with username and password set to ge and ge. Show user settings Add a user [user] username for the new user [telnet] 1 –...
  • Page 18: Service Command Group

    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 http-server on | off https-server on | off ssh-server on | off ftp-server on | off telnet-server on | off makecert...
  • Page 19: Time Command Group

    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 showtime ntponoff on | off ntp-server [hostname] ntpdate tmzone settime MMDDhhmm[[CC]YY][.ss] (*) By running the tmzone command, an interactive menu is launched – follow the on-screen instructions.
  • Page 20: Smtp Command Group

    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 showsmtp email-alert on | off smtp-timeout [seconds] smtp-server [hostname] email-authen on | off email-account [user] email-passwd [pwd] smtp-sendername...
  • Page 21: Snmp Command Group

    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 showsnmp snmpport [port] snmp-server on | off syscontact [contact] (**) syslocation [location] (**) getcommunity [community]...
  • Page 22: Trap Command Group

    OPM_CNT_SNM_BAS_CRD_1GB_V012.doc Description Show detailed trap configuration Enable/disable send trap [RFC1628] function Trap sending enabled Trap sending disabled Enable/disable send trap [GE-MIB] function Trap sending enabled Trap sending disabled NOTE: 3-ph version ONLY Add a trap address [X.X.X.X] IP-address of the trap target...
  • Page 23: Ups Command Group

    2.2.10 UPS command group The UPS command group allows monitoring and configuration of the managed UPS system. Command Parameters upsinfo upstest upscontrol upsconfig attacheddevice [device] alarmdelay [time] retrydelay [time] retrycount [count] serialbypass on | off cardaddress [address] readonlymode [on | off] Modifications reserved OPM_CNT_SNM_BAS_CRD_1GB_V012.doc Description...
  • Page 24: Rccmd Command Group

    (*) By running these commands, an interactive menu is launched – follow the on-screen instructions. The menu also provide a complete on-line help section. NOTE: When using the local serial connection, make sure that the terminal emulation is set to VT-100, otherwise the interactive menu may not be rendered correctly.
  • Page 25: Events Command Group

    2.2.12 Events command group The events command group controls the alarm notification via traps and/or e-mail. Command Parameters showevents event [row] [e-mail] [trap] 2.2.13 Log command group The log command group allows to access the logs maintained by the SNMP/Web adapters. Command Parameters syslog...
  • Page 26: Web Interface

    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.
  • Page 27: Saving The Settings

    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: •...
  • Page 28: Battery Page

    3.3.2 Battery page The Battery page shows the following information. Parameter Name Battery Status Seconds On Battery Estimated Minutes Remaining Estimated Charge Remaining Battery Voltage Battery Current Battery Temperature Battery Ripple Modifications reserved OPM_CNT_SNM_BAS_CRD_1GB_V012.doc Description The current status of the battery: 1 –...
  • Page 29: Ups Status Page

    3.3.3 UPS Status page The UPS status page shows the following information for each of the input / output / bypass lines. Parameter Name Description Frequency Line frequency (in Hertz) Voltage Line RMS voltage (in Volts) Current Line RMS current (in Amperes) Power / True Power Line True Power (in Watt) Load %...
  • Page 30: Ups Test Page

    3.3.6 UPS Test page This page presents allows to initiate a specific UPS test, and reports the status of the last performed test (if any). The page includes a table with clear explanation of the test result reading. For an explanation of the various test procedures please refer to the applicable UPS documentation. 3.3.7 UPS Control page (1-ph/SP units ONLY) The UPS control page mainly controls UPS shutdown and reboot behaviour.
  • Page 31: System Section

    SYSTEM SECTION 3.4.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.4.2 Date&Time page Through this page it is possible to configure the adapter date and time settings.
  • Page 32: Configuration Page

    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. SNMP SECTION The SNMP section deals with SNMP and trap configuration.
  • Page 33: Smtp Section

    SMTP SECTION The SMTP page controls the e-mail notification functionality. 3.6.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.
  • Page 34: Save Section

    SAVE SECTION This section allows to save the current settings to non-volatile memory (Save) and/or to reboot the adapter (Reboot). Remember that the SNMP/Web adapter will revert to the last saved settings at reboot. Therefore, in order to permanently modify the settings the configuration must be saved. 3.10 USER SECTION This section offers access to the user management web page.
  • Page 35: Snmp Agent

    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:...
  • Page 36 OIDs ==== upsInput Group ==== upsInputLineBads upsInputNumLines upsInputFrequency upsInputVoltage upsInputCurrent upsInputTruePower ==== upsOutput Group ==== upsOutputSource upsOutputFrequecny upsOutputNumLines upsOutputVoltage upsOutputCurrent upsOutputPower upsOutputPercentLoad ==== upsBypass Group ==== upsBypassFrequency upsBypassNumLines upsBypassLineIndex upsBypassVoltage upsBypassCurrent upsBypassPower ==== upsAlarm Group ==== upsAlarmsPresent ==== upsTest Group ==== upsTestID upsTestSpinLock upsTestResultSummary...
  • Page 37: Ge Mib Objects

    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.
  • Page 38 upsInputVoltage upsInputCurrent upsInputTruePower upsInputVoltageMin [*] upsInputVoltageMax [*] ==== upsOutput Group ==== upsOutputSource upsOutputFrequecny upsOutputNumLines upsOutputVoltage upsOutputCurrent upsOutputPower upsOutputPercentLoad upsOutputPowerFactor [*] upsOutputPeakCurrent [*] upsOutputShareCurrent [*] ==== upsBypass Group ==== upsBypassFrequency upsBypassNumLines upsBypassLineIndex upsBypassVoltage upsBypassCurrent upsBypassPower ==== upsAlarm Group ==== upsAlarmsPresent upsAlarmMaskA [*] ==== upsTest Group ==== upsTestID upsTestSpinLock...
  • Page 39: Network Configuration

    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.
  • Page 40: Dns Configuration

    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).
  • Page 41: Multi-Server Network Shutdown (Rccmd)

    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.
  • Page 42: Network Configuration

    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.
  • Page 43: Rccmd Client Relay

    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.
  • Page 44: Security

    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.
  • Page 45: Services (Access Methods)

    SERVICES (ACCESS METHODS) The table below lists the available services (access methods), highlighting the major security features for each interface. Interface Local console interface Remote console interface SNMP Agent File transfer Web interface ENCRYPTION As stated above, the SNMP/Web adapter offers interfaces providing encryption for protecting data confidentiality and integrity, and particularly the following: •...
  • Page 46 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:...
  • Page 47: Ssl Certificates

    7.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 48 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.
  • Page 49: Customer Responsibility

    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 •...
  • Page 50: Other Functionalities

    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.
  • Page 51: Ups Load Alert

    8.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.).
  • Page 52: Maintenance

    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) CONFIGURATION FILE The SNMP/Web adapter settings are stored in non-volatile memory.
  • Page 53: Troubleshooting

    10 TROUBLESHOOTING 10.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.
  • Page 54: Troubleshooting Network Connection

    10.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 Network I/f OK Network I/f OK Check LAN LED Check LAN LED Verify connection to...
  • Page 55: Troubleshooting Web Access

    10.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 Browser error: ”Connection refused”...
  • Page 56: Troubleshooting E-Mail Notification (Smtp)

    10.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.
  • Page 57: Troubleshooting Network Shutdown

    10.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.
  • Page 58: Customer Support

    11 CUSTOMER SUPPORT 11.1 FIRST LINE SUPPORT Please contact your local GE distributor for problems with the installation of the product or its use. 11.2 INTERNET On-line support available on request (Internet access required). 11.3 WWW SERVER We have a WWW server running at www.gedigitalenergy.com...

Table of Contents