GE Digital Energy 1018959, Digital Energy 1019070, Digital Energy 23954, Digital Energy 1019071 Operating Manual
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 – 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
Modifications reserved Page 2/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
Model:
3-ph SNMP/Web plug-in adapter
1-ph SNMP/Web plug-in adapter
SP SNMP/Web plug-in adapter
1-ph SNMP/Web external adapter
Date of issue: 06.Jul.2010
File name: OPM_CNT_SNM_BAS_CRD_V014
Revision: 1.4
Identification No.
P/N 1018959
P/N 1019070
P/N 23954
P/N 1019071
Up-dating
Revision Concerns Date
1.0 First Issue 15.02.2008
1.1 Updated for the 3-ph and SP SNMP/Web plug-in adapters 13.05.2008
1.2 Updated following the introduction of the RCCMD functionality 05.12.2008
1.3 Introduction of the Modbus TCP functionality 20.11.2009
1.4 Introduction of IEMi and eBoost 06.07.2010
COPYRIGHT © 2010 by GE Consumer & Industrial SA
All rights reserved.
The information contained in this publication is intended solely for the purposes indicated.
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.
The content of this publication may be subject to modification without prior notice.
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.
Please read carefully the Installation
Manual, which contains all the necessary
information about the installation of the
adapters.
Thank you for choosing GE !
Distributed by:
Your service contact:
g
GE Digital Energy
General Electric Company
CH – 6595 Riazzino (Locarno)
Switzerland
Modifications reserved Page 3/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
Table of contents Page
1 INTRODUCTION............................................................................................................................................ 7
1.1 FEATURES.............................................................................................................................................................................................. 7
1.2 OVERVIEW.............................................................................................................................................................................................7
1.3 ARCHITECTURE ................................................................................................................................................................................ 10
1.4 SAFETY................................................................................................................................................................................................. 10
2 CONSOLE INTERFACE................................................................................................................................11
2.1 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
2.2 COMMAND LIST............................................................................................................................................................................... 14
2.2.1 General command group ............................................................................................................................................................. 14
2.2.2 Network command group............................................................................................................................................................ 15
2.2.3 DNS command group .................................................................................................................................................................... 16
2.2.4 User command group.................................................................................................................................................................... 17
2.2.5 Service command group............................................................................................................................................................... 18
2.2.6 Time command group ................................................................................................................................................................... 19
2.2.7 Smtp command group .................................................................................................................................................................. 20
2.2.8 Snmp command group ................................................................................................................................................................. 21
2.2.9 Trap command group.................................................................................................................................................................... 22
2.2.10 UPS command group..................................................................................................................................................................... 23
2.2.11 Rccmd command group ............................................................................................................................................................... 24
2.2.12 Modbus command group............................................................................................................................................................. 25
2.2.13 Events command group................................................................................................................................................................ 25
2.2.14 Log command group...................................................................................................................................................................... 26
3 WEB INTERFACE......................................................................................................................................... 27
3.1 INTRODUCTION ...............................................................................................................................................................................27
3.1.1 Supported browsers ....................................................................................................................................................................... 27
3.1.2 Initial web access............................................................................................................................................................................. 27
3.1.3 Sample page...................................................................................................................................................................................... 27
3.1.4 Saving the settings.......................................................................................................................................................................... 28
3.2 NAVIGATION BAR............................................................................................................................................................................ 28
3.3 UPS SECTION.................................................................................................................................................................................... 28
3.3.1 UPS Identification page................................................................................................................................................................. 28
3.3.2 Battery page....................................................................................................................................................................................... 29
3.3.3 UPS Status page............................................................................................................................................................................... 29
3.3.4 UPS Alarm page................................................................................................................................................................................ 30
3.3.5 UPS PMAD page (3-ph version ONLY)...................................................................................................................................... 30
3.3.6 UPS Test page.................................................................................................................................................................................... 30
3.3.7 UPS Control page (1-ph/SP units ONLY)................................................................................................................................. 31
3.3.8 UPS Config page............................................................................................................................................................................... 31
3.4 SYSTEM SECTION ............................................................................................................................................................................ 33
3.4.1 Network page.................................................................................................................................................................................... 33
3.4.2 Date&Time page............................................................................................................................................................................... 33
3.4.3 RCCMD page ...................................................................................................................................................................................... 33
3.4.4 Modbus page..................................................................................................................................................................................... 34
3.4.5 Password page ................................................................................................................................................................................. 34
3.4.6 Configuration page......................................................................................................................................................................... 34
3.4.7 Upgrade page.................................................................................................................................................................................... 34
3.5 SNMP SECTION ................................................................................................................................................................................35
3.5.1 SNMP settings page........................................................................................................................................................................ 35
3.5.2 Trap settings page........................................................................................................................................................................... 35
3.5.3 Alarm notification page................................................................................................................................................................. 35
Modifications reserved Page 4/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
3.6 SMTP SECTION................................................................................................................................................................................. 36
3.6.1 SMTP configuration page............................................................................................................................................................. 36
3.6.2 Alarm notification page................................................................................................................................................................. 36
3.7 LOG SECTION.................................................................................................................................................................................... 36
3.8 UTILITY SECTION ............................................................................................................................................................................. 37
3.9 SAVE SECTION.................................................................................................................................................................................. 37
3.10 USER SECTION.................................................................................................................................................................................. 37
4 SNMP AGENT .............................................................................................................................................. 38
4.1 MIB STRUCTURE.............................................................................................................................................................................. 38
4.2 RFC1628 MIB OBJECTS................................................................................................................................................................ 38
4.3 GE MIB OBJECTS............................................................................................................................................................................. 40
5 NETWORK CONFIGURATION.................................................................................................................... 42
5.1 ETHERNET CONNECTION ............................................................................................................................................................42
5.2 TCP/IP CONFIGURATION.............................................................................................................................................................. 42
5.2.1 Static IP address............................................................................................................................................................................... 42
5.2.2 BOOTP / DHCP ................................................................................................................................................................................... 42
5.3 DNS CONFIGURATION.................................................................................................................................................................. 43
5.4 HOSTNAME........................................................................................................................................................................................ 43
6 MULTI-SERVER NETWORK SHUTDOWN (RCCMD) ................................................................................ 44
6.1 NETWORK SHUTDOWN WITH RCCMD.................................................................................................................................. 44
6.1.1 Set-up and Configuration of controlled Servers ................................................................................................................ 44
6.1.2 Configuration of the SNMP/Web adapter............................................................................................................................. 44
6.1.3 Network configuration................................................................................................................................................................... 45
6.1.4 RCCMD Shutdown............................................................................................................................................................................ 45
6.1.5 Alive Check functionality............................................................................................................................................................... 45
6.2 RCCMD CLIENT RELAY.................................................................................................................................................................. 46
7 MODBUS TCP (LICENSE REQUIRED) ........................................................................................................ 47
7.1 MODBUS TCP CONFIGURATION............................................................................................................................................... 47
7.1.1 Licensing.............................................................................................................................................................................................. 47
7.1.2 Configuration..................................................................................................................................................................................... 47
7.2 MODBUS REGISTER MAP............................................................................................................................................................. 48
7.2.1 Register addressing ........................................................................................................................................................................ 52
7.2.2 Data Types .......................................................................................................................................................................................... 52
8 SECURITY..................................................................................................................................................... 54
8.1 USER AUTHENTICATION & AUTHORISATION...................................................................................................................... 54
8.1.1 User Management........................................................................................................................................................................... 54
8.1.2 User class ............................................................................................................................................................................................ 54
8.1.3 Selective service activation ......................................................................................................................................................... 54
8.2 SERVICES (ACCESS METHODS).................................................................................................................................................. 55
8.3 ENCRYPTION..................................................................................................................................................................................... 55
8.3.1 SSH and SFTP..................................................................................................................................................................................... 55
8.3.2 SSL Certificates ................................................................................................................................................................................. 57
8.4 CUSTOMER RESPONSIBILITY...................................................................................................................................................... 59
8.4.1 Physical security............................................................................................................................................................................... 59
8.4.2 Changing default configuration................................................................................................................................................ 59
8.4.3 User & Service management...................................................................................................................................................... 59
8.4.4 Encryption ........................................................................................................................................................................................... 59
8.4.5 Firewalls ............................................................................................................................................................................................... 59
9 OTHER FUNCTIONALITIES ........................................................................................................................60
9.1 SYSTEM TIME..................................................................................................................................................................................... 60
9.2 SERIAL BY-PASS (1-PH/SP VERSION ONLY)......................................................................................................................... 60
9.3 HTTP BASED MONITORING (1-PH/SP VERSION ONLY) ................................................................................................... 60
9.3.1 UPS Load Alert................................................................................................................................................................................... 61
Modifications reserved Page 5/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
Modifications reserved Page 6/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
10 MAINTENANCE ........................................................................................................................................... 62
10.1 SOFTWARE UPGRADE................................................................................................................................................................... 62
10.1.1 OS Kernel upgrade .......................................................................................................................................................................... 62
10.2 CONFIGURATION FILE................................................................................................................................................................... 62
10.3 LOGS..................................................................................................................................................................................................... 63
11 TROUBLESHOOTING.................................................................................................................................. 64
11.1 TROUBLESHOOTING UPS CONNECTION.............................................................................................................................. 64
11.1.1 3-ph SNMP/Web plug-in adapter............................................................................................................................................. 64
11.1.2 1-ph SNMP/Web external adapter........................................................................................................................................... 64
11.2 TROUBLESHOOTING LOCAL CONNECTION......................................................................................................................... 64
11.3 TROUBLESHOOTING NETWORK CONNECTION................................................................................................................. 65
11.4 TROUBLESHOOTING WEB ACCESS......................................................................................................................................... 66
11.5 TROUBLESHOOTING DATE&TIME (NTP)................................................................................................................................. 66
11.6 TROUBLESHOOTING E-MAIL NOTIFICATION (SMTP)........................................................................................................ 67
11.7 TROUBLESHOOTING NETWORK SHUTDOWN.................................................................................................................... 68
12 CUSTOMER SUPPORT ................................................................................................................................69
12.1 FIRST LINE SUPPORT ..................................................................................................................................................................... 69
12.2 INTERNET............................................................................................................................................................................................ 69
12.3 WWW SERVER.................................................................................................................................................................................. 69
1 INTRODUCTION
1.1 FEATURES
Each SNMP/Web adapter provides the following features:
• 10/100 Mpbs connection speed
• Use of DHCP / BOOTP or manual configuration for the TCP/IP network settings
• SNMP Agent
• Web server
• Console interface
• UPS status / alarms / readings, alarm logging over different interfaces
• Digital outputs (open-collector outputs for relay drive) – 1-ph plug-in version only
• SNMP Traps and E-mail notification upon UPS alarm
• Multi-server network shutdown
• Modbus TCP slave (license required)
• Advanced security features
1.2 OVERVIEW
3-ph SNMP/Web plug-in adapter (P/N 1018959)
Front panel / User interface view
Site Pro / SG Series LP33 Series
Reset
RS-232
UTP 10/100
Active
LAN
UPS
Reset
RS-232
UTP 10/100
Active
LAN
UPS
1
4 3 2
Reset
RS-232
UTP 10/100
Active
LAN
UPS
Reset
RS-232
UTP 10/100
Active
LAN
UPS
1 4
3
2
• 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
Modifications reserved Page 7/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
1-ph SNMP/Web plug-in adapter (P/N 1019070)
Reset
RS-232
UTP 10/100
Active
LAN
Contact
interface
UPS
Reset
RS-232
UTP 10/100
Active
LAN
Contact
interface
UPS
Front
Panel –
User
Interface
anual SNMP/Web Adapter
• 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
• 5 – RJ11 Connector Contact interface, open-collector output
SP SNMP/Web plug-in adapter (P/N 23954)
• 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
1-ph SNMP/Web external adapter (P/N 1019071)
Net link
Fault
A
ctive
reset
Front
View
2
4
1 2
View
3
4
5
Reset
RS-232
UTP 10/100
Active
LAN
UPS
Reset
RS-232
UTP 10/100
Active
LAN
UPS
Front
Panel –
User
Interface
View
1 2
3
4
Modifications reserved Page 8/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating M
1 3
Rear
View
6
7
• 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
• 7 – UPS port RS-232 connection to the UPS
LEDs
The various front panel LEDs have the following meaning:
• LAN / Netlink
Status Meaning
Off No LAN connection detected
On LAN connection established, no communication
Blink LAN connection established, receive or transmit active
• UPS / Fail
Status Meaning
Off OK / No Fault
On No UPS Connection
• Active
Status Meaning
Off Fault of device
Blink Device OK / No fault
Modifications reserved Page 9/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
1.3 ARCHITECTURE
ARCHITECTURE DIAGRAM
UPS
Windows
Linux UNIX
Ethernet
Local console
NOTE
:
only required for
configuration
UTP
1:1 RS232
10/100 Mbit/s
Contact i/f
(1-ph plug-in version only)
1.4 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.
The knowledge of (and FULL compliance to) the safety instructions and the warning contained in the
cited documents are THE ONLY CONDITION to avoid any dangerous situations during installation,
operation, maintenance work, and to preserve the maximum reliability of the UPS system.
Modifications reserved Page 10/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
2 CONSOLE INTERFACE
2.1 INTRODUCTION
The console interface provides a simple way to configure the SNMP/Web adapters through a commandline interface. Actually, the console interface provides a full set of commands, extending far beyond the
adapter initial configuration and allowing access to all advanced functionalities. Nevertheless, access
using the console interface (by means of a local serial connection) is normally needed only for initial
configuration, when no DHCP server is available or the IP-address is not known.
The console interface can be accessed locally (serial connection) or remotely (Telnet, SSH).
2.1.1 Local connection
Local access requires a local computer connected to the adapter serial port using a straight serial
cable:
• Connect the SNMP adapter to a computer using a standard 1:1 serial communication cable.
• Run a terminal simulator (e.g. HyperTerminal on a PC running Windows)
• Configure the terminal simulator as follows:
115,200bps, 8 data bits, 1 stop bit, parity none, flow control none
terminal emulation 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
2.1.2 Remote connection
The console interface can also be accessed remotely from any computer on the same subnet using
either Telnet or SSH (under the hypothesis that the relevant service is running and enabled for the
selected user).
TELNET
Telnet provides basic user authentication. The SNMP/Web adapter uses the standard telnet port.
To start a Telnet session and connect to the 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
SSH (Secure SHell) combines user authentication with encryption, to provide a higher degree of
communication security. In any case, the user access rights are the same regardless of the
service/interface used.
Below is a sample SSH session using a popular SSH client (putty):
• Start the SSH client application (putty.exe)
o In the Host Name section specify the card hostname or the IP address
o In the Connection Type section select SSH
o Select Open to launch the SSH session
NOTES The SNMP/Web adapters use the standard SSH port
The SNMP/Web adapters support both SSH v1 and SSH v2
Normally, no further settings are required. In any case, SSH protocol and version settings
are accessible on putty on the SSH category on the left-hand side menu
Modifications reserved Page 12/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
• Most SSH clients display the host key fingerprint at the start of the session. Make sure the
fingerprint shown matches the SNMP/Web adapter fingerprint (see Encryption section for details
on figuring out the SSH fingerprint)
• A login window should then be available in a few seconds. The default username (login) and
password are ge and ge
2.1.3 Log-on
User authentication requires inputting the username and password. Remember that:
• 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
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.
Modifications reserved Page 13/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
2.2 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.
Note that all commands are case-sensitive.
2.2.1 General command group
The general command group consists of the following commands:
Command Parameters Description
help
general | network | dns |
user | service |
time | smtp | snmp |
trap | ups | rccmd |
events | log
Show help information
general shows all general commands
network shows all network commands
etc …
list List all available commands
version Display the board FW version
logout
User logout
NOTE: Auto-logout after 10 min inactivity
exit User logout
passwd
Change current user password
NOTE: Password length is limited to 8 chars.
The command line interface may accept longer passwords,
although only the first 8 characters are significant.
ping [hostname] | [X.X.X.X]
Ping IP address or hostname
hostname fully qualified hostname
X.X.X.X IP-address
nvdefault Reset the configuration to factory default
nvsave Save changes to non-volatile memory
nvdump Dump configuration file (gedeups.cfg) to FTP area
nvupdate
Update the SNMP/Web configuration with the gedeups.cfg file from
the FTP area
NOTE: The adapter performs no checks on the received file. Make
sure the file format is correct - unexpected behaviour may occur.
upgrade
Start the upgrade with the uploaded firmware
NOTE: FW file to be uploaded via FTP
kernel_upgrade
Start the kernel upgrade.
NOTE: Kernel upgrade should only be performed when instructed to
do so by GE personnel. Unnecessary upgrades should be avoided.
reboot
System restart (soft-reset)
NOTE: All unsaved changes will be lost
Modifications reserved Page 14/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
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
arp Show ARP table
boot-method manual | dhcp | bootp
Define the network settings at boot-up (*)
manual static IP configuration, the device configuration
(ref. setip) is used
dhcp network settings retrieved from DHCP server
bootp network settings retrieved from BOOTP server
setip
[address]
[netmask]
[gateway]
Set static IP/mask/default gateway
[address] IP-address
[netmask] Subnet mask
[gateway] Default gateway IP-address
NOTE: network settings can be specified manually only when
boot-method is set to manual
hostname [hostname]
Define the full qualified domain name
[hostname] Full qualified domain name
dhcphost on | off
Get the hostname from DHCP server
NOTE: This functionality is disabled (off) by default
mii-tool recheck
As most network devices, SNMP/Web adapters use an autonegotiation protocol to communicate what media
technologies they support, and then select the fastest
mutually supported media technology.
Running this command shows the negotiated media.
speedduplex
auto |
100baseTx-FD |
100baseTx-HD |
10baseT-FD |
10baseT-HD
As most network devices, SNMP/Web adapters use an autonegotiation protocol to communicate what media
technologies they support, and then select the fastest
mutually supported media technology.
Some passive devices, such as single-speed hubs, are
unable to auto-negotiate. To handle such devices, the
SNMP/Web adapter can be forced to operate in one mode,
instead of auto-negotiating.
menu
Quick network configuration menu
Running this command lunches an interactive menu –
follow the on-screen instructions
(*) NOTE: Network settings become effective only after a reboot. Therefore, if these settings must be
modified, the following actions shall be performed in sequence:
• Update the settings, using the applicable command
• Save the settings – nvsave command. Always remember that unsaved setting are lost in case of
reset / reboot
• Reboot the card – reboot command
Modifications reserved Page 15/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
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.
Unlike network settings, the DNS settings may become immediately active.
2.2.3 DNS command group
The dns command group allows to configure the setting for hostname address resolution.
Command Parameters Description
showdns Show detailed DNS settings
manual-dns on | off
Define DNS configuration
on Use DNS server address specified manually
off Obtain DNS server address automatically
adddnssrv [X.X.X.X]
Add a DNS Server
[X.X.X.X] DNS server IP-address
NOTE: In order to replace a DNS server address, remove the
DNS server first and then add the new one.
deldnssrv [X.X.X.X]
Delete a DNS Server
[X.X.X.X] DNS server IP-address
nslookup [host] [server]
Test DNS settings address resolution
[host] hostname
[server] DNS server IP-address (optional)
RESULT:
Successful
Server: [DNS server hostname]
Address: [DNS server IP address]
Name: [host]
Address: [Resolved IP address for the host]
Unsuccessful
[host]: No address associated with the name
Or
[host]: Hostname lookup failure
NOTE: DNS settings may be critical for the SNMP/Web adapter operation. Incorrect DNS configuration
may compromise the functionality of other network services. Therefore make sure the DNS is correctly
configured, especially when a manual configuration is selected.
Modifications reserved Page 16/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
2.2.4 User command group
The user command group is available only to the supervisor user, the only user who can perform user
management.
Command Parameters Description
supername [name]
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.
showuser Show user settings
adduser
[user]
[http]
[telnet]
[ftp]
[access]
Add a user
[user] username for the new user
[telnet] 1 – access allowed / 0 – not allowed
[http] 1 – access allowed / 0 – not allowed
[ftp] 1 – access allowed / 0 – not allowed
[access] ‘ro’ – read-only / ‘rw’ – read/write
NOTE: After entering the command, the console prompts for
the password, which needs to be re-confirmed.
Mind that the password length is limited to 8 chars.
The command line interface may accept longer passwords,
although only the first 8 characters are significant.
deluser [name]
Delete a user
[name] User to be deleted
moduser
[user]
[http]
[telnet]
[ftp]
[access]
Modify services and access rights for a user
[user] username for the new user
[telnet] 1 – access allowed / 0 – not allowed
[http] 1 – access allowed / 0 – not allowed
[ftp] 1 – access allowed / 0 – not allowed
[access] ‘ro’ – read-only / ‘rw’ – read/write
NOTE: The indicated services refer to the following access methods:
http
Web interface Controls access with both HTTP and HTTPS protocols
telnet
Remote console interface Controls access with both Telnet and SSH (Secure SHell)
protocols plus SFTP (Secure FTP)
ftp
File transfer Controls access with FTP
NOTE: Both username and passwords are case sensitive. It is recommended to always use lower case
for both.
Modifications reserved Page 17/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
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
http-server on | off
Enable/disable HTTP server (port:80)
on Web server enabled
off Web server disabled
https-server on | off
Enable/disable HTTPS server (port:443)
on Secure web server enabled
off Secure web server disabled
ssh-server on | off
Enable/disable SSH encryption (port:22)
on SSH encryption enabled
off SSH encryption disabled
NOTE: SSH encryption enables / disables both SSH (Secure
SHell) and SFTP (Secure FTP)
ftp-server on | off
Enable/disable FTP server (port:21)
on FTP server enabled
off FTP server disabled
telnet-server on | off
Enable/disable Telnet server (port:23)
on Telnet server enabled
off Telnet server disabled
makecert sitename
Create new digital certificate for the HTTPS server (*)
sitename The DNS name / IP address of the adapter
ssh-fingerprint Show the SSH key fingerprint (*)
ssl-fingerprint
Show the web server digital certificate fingerprint (also
known as thumbnail) (*)
ca-fingerprint
Show the digital certificate fingerprint (also known as
thumbnail) for the CA Root Certificate (*)
showftp Show FTP server info and connections
showlogin Show detailed telnet/ssh login information
(*) Refer to the Encryption section for details.
Modifications reserved Page 18/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
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
ntponoff on | off
Enable/disable NTP client
on NTP client enabled
off NTP client disabled
ntp-server [hostname]
Define NTP server
[hostname] hostname or IP-address of the NTP server
NOTE: using hostnames requires DNS connection.
ntpdate Force clock synchronisation with NTP server
tmzone (*)
Set the time-zone.
NOTE: the time-zone controls both the time difference with
respect to GMT and the daylight-saving settings. As the
time-zone is specified as a Region/Country pair, selecting
the correct time-zone will ensure that the adapter
computes the correct time.
settime MMDDhhmm[[CC]YY][.ss]
Set the date & time
MM month
DD day
hh hour
mm minute
[CC]YY year
ss seconds
(*) By running the tmzone command, an interactive menu is launched – follow the on-screen
instructions.
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.
Modifications reserved Page 19/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
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
email-alert on | off
Enable/disable email functionality
on E-mail alert enabled
off E-mail alert disabled
smtp-timeout [seconds]
Set timeout for TCP communication with SMTP server
[seconds] Timeout in seconds (range 5-60 seconds)
smtp-server [hostname]
Set SMTP server address
[hostname] hostname/IP-address of the SMTP server
NOTE: using hostnames requires DNS connection.
email-authen on | off
Enable/disable authentication for email server
on E-mail server requires authentication
off E-mail server does not require authentication
email-account [user]
Set email server account
[user] Username for e-mail server authentication
email-passwd [pwd]
Set email server password
[pwd] Password for e-mail server authentication
smtp-sendername [sender]
Set the 'mail from:' header
[sender] E-mail address (63 chars max)
NOTE: This may be a critical parameter, as some SMTP
servers require a valid sender address within a specified
domain. Confirm the exact requirement with your service
provider or IT function.
addrcpt [e-mail]
Add a recipient address
[e-mail] E-mail address (63 chars max)
NOTE: Maximum 8 recipients can be defined.
delrcpt [e-mail]
Delete a recipient address
[e-mail] E-mail address (63 chars max)
sendemail [msg]
Send a test mail
[msg] Test message to be send
Modifications reserved Page 20/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
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
snmpport [port]
Set SNMP server listening port (*)
[port] SNMP port
NOTE: Default SNMP port is 161.
snmp-server on | off
Enable/disable SNMP Agent
on SNMP Agent enabled
off SNMP Agent disabled
syscontact [contact] (**)
Set the system contact
[contact] contact person
NOTE: The syscontact parameter is the identification of
the contact person for the managed node.
syslocation [location] (**)
Set the system location
[location] location name
NOTE: The syslocation parameter is the identification of
the physical location of the managed node.
getcommunity [community]
Defines the community name for receiving SNMP
information (GET).
[community] community name
NOTE: The get community name controls access to the
SNMP Agent – the community in the request must match
the getcommunity parameter.
The default value is public.
setcommunity [community]
Defines the community name for writing SNMP
information (SET).
[community] community name
NOTE: The set community name controls access to the
SNMP Agent – the community in the request must match
the setcommunity parameter.
The default value is private.
(*) Changing the port causes the SNMP Agent to restart. This might have a temporary effect also on trap
notification.
(**) Both parameters have a maximum length of 63 chars. If these parameters contain blanks or special
characters they shall be specified in between double quotation marks (“...”) .
Modifications reserved Page 21/69
OPM_CNT_SNM_BAS_CRD_1GB_V014.doc Operating Manual SNMP/Web Adapter
Loading...