UPS Web/SNMP Card UPSLink User Guide Version 2.2.
User Guide for the UPSLink Version 2.2.3 Firmware version 2.2.x Printed in Korea Copyright Information Copyright 2002-2007, Sena Technologies, Inc. All rights reserved. Sena Technologies reserves the right to make any changes and improvements to its product without providing prior notice. Trademark Information HelloDevice™ and UPSLink™ are trademarks of Sena Technologies, Inc. Windows® is a registered trademark of Microsoft Corporation. Ethernet® is a registered trademark of XEROX Corporation.
Revision history Date Part number Description 2003-04-30 V2.0.0 written by UIS 2003-05-02 V2.0.1 revise candidate by KCY, 2003-05-13 V2.0.2 revised done by KCY 2003-05-26 V2.1.1 revised by UIS with firmware upgrade to 2.1.0 2003-07-09 V2.2.1 revised by UIS 2005-11-08 V2.2.2 Temperature and Humidity update 2007-05-07 V2.2.
Contents 1. Introduction 6 1.1 Overview................................................................................................................................6 1.2 Package check list ................................................................................................................. 7 1.3 Product specification ..............................................................................................................7 1.4 Terminologies and acronyms .................................
4.4 SMTP configuration.............................................................................................................. 30 4.5 Access control...................................................................................................................... 31 4.6 SYSLOG server configuration............................................................................................... 32 4.7 NFS server configuration..............................................................................
1. Introduction 1.1 Overview The UPSLink is an embedded Linux-based Web/SNMP card for UPS. The UPSLink provides SNMP, HTTP and Telnet compatibility allowing those who manage power utilities of any equipments that demand fail-safe power such as servers, routers and other networking devices to monitor and control their equipments anywhere on the network.
1.2 Package check list UPSLink100: - 110~230 VDC power adaptor - Serial console cable - CD-ROM, including software and manuals 1.
Environmental Power Dimension LxWxH Weight (g) Certification Warranty o Operating temperature: 0 ~ 50 C Storage temperature: -20 ~ 66 o C Humidity: 90% Non-condensing 5VDC, 1.5A @ 5V 100 x 72 x 25 (mm) 3.9 x 1.8 x 1.0 (in.) 240 FCC, CE, MIC 5-year limited warranty 1.4 Terminologies and acronyms This section will define commonly used terms in this manual. These terms are related to networking, and defined in regards to their use with UPSLink.
ISP Internet Service Provider PC Personal Computer NIC Network Interface Card MAC Media Access Control LAN Local Area Network UTP Unshielded Twisted Pair ADSL Asymmetric Digital Subscriber Line ARP Address Resolution Protocol IP Internet Protocol ICMP Internet Control Message Protocol UDP User Datagram Protocol TCP Transmission Control Protocol DHCP Dynamic Host Configuration Protocol SMTP Simple Mail Transfer Protocol FTP File Transfer Protocol PPP Point-To-Point Protocol PP
2. Getting Started This chapter describes how to set up and configure the UPSLink. - 0 Panel layout explains the layout of the panel and LED indicators. - 0 2.2 Connecting hardware describes how to connect the power, the network, and the UPS to the UPSLink. - 0 Accessing the UPSLink describes how to access the console port using a serial console or a Telnet or Web menu from remote location. The following items are required to get started.
Lamps Power Ready Serial Rx/Tx 100Mbps LINK Act Function Turned on if power is supplied Turned on if system is ready to run Blink whenever there is any incoming or outgoing data stream through the serial port of the UPSLink 100 Turned on if 100Base- TX connection is detected Turned on if connected to Ethernet network Blink whenever there is any activities such as incoming or outgoing packets through the UPSLink Ethernet port Table 0-1 LED indicator lamps of the UPSLink 100 2.
The [Link] lamp will light up green. The [Act] lamp will blink to indicate incoming/outgoing Ethernet packets The [100Mbps] lamp will light up green if the UPSLink is connected to 100Base-TX network The [100Mbps] lamp will not turn on if the current network connection is 10Base-T. Figure 0-3 Connecting a network cable to the UPSLink 2.2.3 Connecting UPS to the UPSLink Connect both ends of the console cable to the UPSLink serial port and the serial data port of the UPS, Please refer to the 0 0 A.
2.3 Accessing the UPSLink There are several ways to access the UPSLink. These methods are dependent on whether the user is located at a local site or a remote site, or whether s/he requires a menu-driven interface or graphic menu system. System console: Local users can connect directly to the system console port of the UPSLink using the serial console cable and the terminal emulator like HyperTerminal in Windows.
Welcome to UPSLink Configuration Press Enter Login : admin Password : ***** ------------------------------------------------------------------------------Welcome to UPSLink configuration page Current time: 2003/07/09 14:20:42 F/W REV. : 2.2.1 Serial No. : UPSLINK-03040001 MAC Address: 00-01-95-04-20-30 IP mode : DHCP IP Address : 192.168.14.7 ------------------------------------------------------------------------------Select menu 1. UPS configuration 2. Network configuration 3. Serial port configuration 4.
Or run a Telnet program with the following parameters: Figure 0-6 Telnet program set up example (TeraTerm Pro) 2) The user must log into the UPSLink. Type in a user name and password and press [ENTER]. Factory default setting of the user name and password are admin (See the section 0. 7.1 User administration). 3) Upon authentication by the UPSLink, a text menu screen is shown to the user just like as system console.
Figure 0-7 Login screen of the UPSLink Web Management Figure 0-8 shows the user homepage of the UPSLink Web management interface. A menu bar is provided on the left side of the screen. The menu bar includes the uppermost configuration menu groups. Selecting an item on the menu bar opens a tree view of all the submenus available under each grouping. item.
3. UPS management 3.1 UPS information Once the UPSLink is connect to a UPS and communicates with the UPS through serial connection, the basic information about the UPS is gathered and is shown on this page. Figure 0-1 UPS information UPS identification Shows basic information that identifies the UPS and UPSLink UPS test information Shows UPS test related information if there is any test ever been initiated since the last start up of the UPSLink. All of these fields are listed on RFC1628 UPS MIB.
3.2 UPS status If there occurred any UPS alarms, the alarm records are shown on this page in red-colored font with their detected time. The information about the current status and capability of Battery, Input, Output and Bypass system is presented. When user logs into the UPS web page, this page first shows up and refreshes itself every 30 seconds. Figure 0-2 UPS status 3.
Figure 0-3 UPS status diagram 3.4 UPS graphics – gauge A dedicated java applet communicates with UPSLink continuously through a separate TCP port (TCP 9009) and this makes the gauges indicate the correct UPS status and capabilities in real time. Be noted that besides the java applet, the alarms and output source represented by text in the same page does not update themselves periodically.
The users may navigate between Battery, Input, Output and Bypass group by pressing buttons at the top of the applet. Figure 0-5 UPS status gauge – Input 3.5 UPS configuration UPS parameters are user-configurable on this web page. Among them RFC1628 compliant parameters can also be set by SNMP-set command. Parameters for Battery Information on Figure 0-6 are noncompliant with RFC1628. The configuration data is stored in volatile area of the UPSLink like UPS status data.
3.6 UPS control Besides the parameter configurations, the commands that control the UPS directly such as tests, shutdown, restart and reboot are offered in a separate page. The test or control commands are transmitted to the UPS immediately when user clicks on [Perform] button. These commands included by default are all defined in RFC1628 UPS-mib and deliverable by SNMP-set command also.
Alarm emails are sent in two forms, brief or detailed. Detailed messages contain additional UPS status information to the alarm information. Figure 0-8 UPS alarm logging 3.8 UPS serial program By default, there runs Sena’s UPS serial program on the UPSLink. The UPSLink reserves 100 kilobytes of user space for a private UPS serial program. Users can choose the application that runs on the UPSLink. See ‘UPS serial programming guide’for details.
4. Network configuration 4.1 IP configuration The UPSLink requires a valid IP address to operate within the user’s network environment. If the IP address is not readily available, contact the system administrator to obtain a valid IP address for the UPSLink. Please note that the UPSLink requires a unique IP address to connect to the user’s network. The users may choose one of three Internet protocols in setting up the UPSLink IP address: i.e.
4.1.1 Using static IP address When using a Static IP address, the user must manually specify all the configuration parameters associated with the UPSLink’s IP address. These include the IP address, the network subnet mask, the gateway computer and the domain name server computers. This section will look at each of these in more detail. Note: The UPSLink will attempt to locate all this information every time it is turned on. .
The IP address of the DNS server must be able to access the host site with the provided domain name. The UPSLink provides the ability to configure the required IP addresses of both the Primary and Secondary DNS servers addresses. (The secondary DNS server is specified for use when the primary DNS server is unavailable.) 4.1.
in the DHCP network, the administrator needs the MAC address of the UPSLink found on the label sticker at the bottom of the UPSLink. 4.1.3 Using PPPoE PPPoE (Point-to-Point Protocol over Ethernet) is a specification for connecting multiple computer users on an Ethernet LAN (local area network) to a remote site through a modem or similar device. PPPoE can be used to multiple users the ability to share ADSL, cable modem, or wireless connection to the Internet.
Figure 0-2 SNMP configuration 4.2.1 MIB-II system objects configuration MIB–II System objects configuration sets the System Contact, Name, Location, and Authenticationfailure traps used by the SNMP agent of the UPSLink. These settings provide the values used for the MIB-II sysName, sysContact, sysLocation and snmpEnableAuthenTraps Object Identifications (OIDs).
4.2.2 Access control configuration Access Control defines accessibility of managers to the UPSLink SNMP agent. Only a manager from the specified NMS can access UPSLink SNMP agent to exchange information and control actions. If there is no specific IP address (all IP address are defaulted to 0.0.0.0), a manager from any host can access the UPSLink SNMP agent with read-only privilege. 4.2.
18 A general fault in the UPS has been detected. 19 The result of the last diagnostic test indicates a failure. 20 A problem has been encountered in the communications between the agent and the UPS. 21 The UPS output is off and the UPS is awaiting the return of input power. 22 A upsShutdownAfterDelay countdown is underway. 23 The UPS will turn off power to the load in less than 5 seconds; this may be either a timed shutdown or a low battery shutdown. 24 A test is in progress.
To use the Dynamic DNS service provided by Dynamic DNS Network Services, the user must set up an account in their Members' NIC (Network Information Center - http://members.dyndns. org). The user may then add a new Dynamic DNS Host link after logging in to their Dynamic DNS Network Services Members’NIC. After enabling the Dynamic DNS service in the Dynamic DNS Configuration menu, the user must enter the registered Domain Name, User Name, and Password.
Consequently, the email address set for the device can use an arbitrary username with a registered hostname (i.e. arbitrary_user@yahoo.com or anybody@sena.com). The SMTP user name and SMTP user password are required when either SMTP with authentication or POP-before-SMTP mode is selected. Figure 0-4 SMTP configuration 4.5 Access control The UPSLink prevents unauthorized access to the management Web or Telnet service of the UPSLink by using IP address based filtering method.
Figure 0-5 Access control configuration A user may specify more than one host as allowed to configure the UPSLink. The user must then enter the IP address or subnet mask to include all the necessary hosts. The user may also allow only a specific host to have configuration access to the UPSLink by entering the specific IP Address with the static subnet mask: 255.255.255.255. The user must then be on the specified host to gain access to the UPSLink.
Figure 0-6 SYSLOG server configuration To receive log messages from the UPSLink, the SYSLOG server specified in the UPSLink’s configuration must be configured as “remote reception allowed”. If there is a firewall between the UPSLink and the SYSLOG server, the user must add a rule that will allow all outgoing and incoming UDP packets the ability to travel across. The UPSLink supports SYSLOG facilities from local0 to local7.
information about the configuration of the UPS alarm and system log storage location, please refer to section 0. 3.7 UPS alarm log and 0. 6.2 System log configuration. 4.8 Ethernet configuration The UPSLink supports several types of Ethernet modes: - Auto Negotiation - 100 BaseT Half Duplex - 100 BaseT Full Duplex - 10 BaseT Half Duplex - 10 BaseT Full Duplex After changing the Ethernet mode, the user must reboot the system. The factory default value of the Ethernet mode is Auto Negotiation.
5. Serial port configuration 5.1 UART configuration To connect the UPS to the UPSLink serial port, the serial port parameters of the UPSLink should match exactly to that of the UPS attached. The serial port parameters are required to match this serial communication. The parameters required for the serial communication are: baud rate, data bits, parity, stop bits and flow control.
6. System status and log The UPSLink displays the system status and the log data. The UPSLink can also be configured to deliver system log data daily via email to specified recipients. 6.1 System status System status data includes the model name, serial number, firmware version, current date/time, switch status and current network configuration of the UPSLink. Figure 0-1 System status display 6.2 System log configuration The UPSLink provides both the system logging feature and the system log display.
the user must set parameters to initiate the creation of an email. These parameters would include the time to trigger an email by hour, the recipient’s email address, etc. Figure 0-2 shows the configuration and system log page.
7. System administration The UPSLink utilizes three user profile types to control accessibility to different functions. These three levels of user types include: system admin, UPS admin and user. 7.1 User administration The UPSLink manages three user-level groups. Access to the configuration interfaces is controlled based on the level of a user’s group.
The user groups and their UPSLink access privileges for management web pages are summarized in the Table 0-2.
Figure 0-2 Adding a user Figure 0-3 shows the [Change password] screen. Figure 0-3 Changing the password Figure 0-4 shows the [remove a user] screen. Figure 0-4 Removing a user 7.2 Device name configuration The UPSLink has its own name for administrative purposes. Figure 0-5 shows the device name configuration screen. The device name is mainly utilized for management program, HelloDevice Manager.
7.3 Language The users of the UPSLink can switch language of the management web pages. Currently the UPSLink supports two language sets, English and Korean. For the language set extension, please contact Sena support. Figure 0-6 Language selection 7.4 Date and time settings Because there is no battery backup for the system clock in the UPSLink, the correct time is should be specified on every boot time of the UPSLink to avoid losing the track of time. There are two ways of doing this.
7.5 Factory default reset A user may restore the factory default settings at any time by selecting “Factory reset”or by pushing the factory default reset switch on the top side panel of the UPSLink. If a user must reset all settings except the IP Address, s/he may select “Factory reset except IP settings”. Figure 0-8 shows the factory default reset screen. Figure 0-8 Factory default reset 7.6 Firmware upgrade Firmware upgrades are available via serial, remote console or web interface.
To use either a Telnet or serial console to upgrade your firmware, the Telnet or terminal emulation program must support Zmodem transfer protocol. To upgrade firmware via Telnet or serial console: 1. Obtain the latest firmware. 2. Make connection using a terminal emulation program. (Telnet is recommended since the process of firmware upgrade by serial console may be slower.) 3. Select from the firmware upgrade menu as shown in Figure 0-10. 4.
Figure 0-11 Transfer binary file by Zmodem (HyperTerminal) ------------------------------------------------------------------------------System Administration ------------------------------------------------------------------------------Select menu 1. User administration 2. Device name : UPSLink 100 3. Date and time 4. Reload factory default settings 5. Reload factory default settings except IP setting 6.
Appendix A. Connections A.1 Ethernet pin outs The UPSLink uses the standard Ethernet connector that is shielded connector compliant with AT&T258 specifications. Table 0-1 shows the pin assignment and wire color. Figure 0-1 Pin layout of the RJ45 connector Pin 1 2 3 4 5 6 7 8 Description Tx+ TxRx+ NC NC RxNC NC Color White with orange Orange White with green Blue White with blue Green White with brown Brown Table 0-1 Pin assignment of the RJ45 connector for Ethernet A.
A.3 Ethernet wiring diagram Figure 0-3 Ethernet direct connection using crossover Ethernet cable Figure 0-4 Ethernet connection using straight through Ethernet cable A.
Appendix B. Well-known port numbers Port numbers are divided into three ranges: Well Known Ports, Registered Ports, and Dynamic and/or Private Ports. Well Known Ports are those from 0 through 1023. Registered Ports are those from 1024 through 49151. Dynamic and/or Private Ports are those from 49152 through 65535. Well Known Ports are assigned by IANA, and on most systems, can only be used by system processes or by programs executed by privileged users. Table 0-1 shows some of the well-known port numbers.
Appendix C. Guide to the Bootloader menu program C.1 Overview The bootloader menu provides a way to recover the UPSLink using BOOTP/TFTP as a disaster recovery option and to diagnose the system hardware. If the user presses the key within 3 seconds after the UPSLink is powered up with its console switch is selected, the user will enter the bootloader menu program. From this menu program, the user can set various system parameters, test system hardware, and perform firmware upgrades. C.
until the user presses the keys. In this mode, the ping test to the remote host (server IP address) and UART test are not performed. If the user selects Looping (with External test in Auto test)’, auto test is performed repeatedly until the user presses the keys. And, the ping test to the remote host (server IP address) and UART test are also performed repeatedly.
4. EEPROM test 5. Ethernet test Back, Refresh -----> Figure 0-2 Hardware test menu within Bootloader Menu Program When the user selects [Auto test], a test of all the hardware components is performed automatically. ------------------------------------------------------------------------------Hardware Test ------------------------------------------------------------------------------Select menu 0. Test Mode - One time 1. Auto test 2. DRAM test 3. FLASH test 4. EEPROM test 5.
5. Ethernet test Back, Refresh -----> 1 ******* Hardware auto -detect and auto-test ******* [DRAM] DRAM Test in progress ----------------------------------------[ 1280KB] DRAM Test ----------------------------------------------------[SKIPPED] [FLASH] Flash Test Status---------------------------------------------[ 7 %] FLASH Test ---------------------------------------------------[SKIPPED] Figure 0-4 Skip the specific test using ESC key C.
------------------------------------------------------------------------------Firmware upgrade ------------------------------------------------------------------------------Select menu 1. Protocol [TFTP] 2. IP address assigned to Ethernet interface [192.168.161.5] 3. Server's IP address [192.168.0.128] 4. Firmware File Name [upslink.bin] 5. Start firmware upgrade Back, Refresh -----> 5 Firmware upgrade cannot be stopped until finished.
Appendix D. Warranty D.1 GENERAL WARRANTY POLICY Sena Technologies, Inc. (hereinafter referred to as SENA) warrants that the Product shall conform to and perform in accordance with published technical specifications and the accompanying written materials, and shall be free of defects in materials and workmanship, for the period of time herein indicated, such warranty period commencing upon receipt of the Product.
D.3 HARDWARE PRODUCT WARRANTY DETAILS WARRANTY PERIOD: SENA warranties embedded hardware Product for a period of one (1) year, and external hardware Product for a period of three (3) or five (5) years according to the Product type. WARRANTY PROCEDURE: Upon return of the hardware Product SENA will, at its option, repair or replace Product at no additional charge, freight prepaid, except as set forth below.
