background image

© 2011 Racktivity NV 

 

41/52

 

Antwerpsesteenweg 19 - 9080 Lochristi - Belgium  -  www.racktivity.com 

v 2014.3.27 

 

Network interfaces and their info: IP, transmitted bytes, received bytes  

 

CPUs and their info: speed, cores, sockets, cores per socket, load  

 

All processes and their info: name, CPU usage, memory usage, connections (src IP, src 
port, dst IP, dst port, duration, amount) 

Installation 

The Agent installation package can be obtained by contacting Support and is available for the 
following operating systems and distributions: 

 

Windows 

 

Linux 

 

Debian 

 
After installation, the Agent configuration file (agent.ini) can be found at: 
 

 

Windows

 

C:\Program Files\Racktivity\agent.ini or 
C:\Program Files (x86)\Racktivity\agent.ini 
 

 

Linux

 

/etc/racktivity/agent.ini 

Configuration 

The agent.ini file contains the following sections and editable parameters: 
 
 

MAIN

 

 

host:

 The IP on which the Agent listens 

0.0.0.0 means listen on any available IP address. 

Default: 0.0.0.0 

 

port:

 The port on which the Agent listens 

Default: 6666 

 

workers:

 The amount of worker threads that are used to handle the connections. 

Don’t change this setting 

Default: 4 

 

allowed:

 A comma separated list of IPs (cannot contain whitespace characters) that are 

allowed to communicate with the Agent. If the IP is not in the list the connection is 
closed instantly. 

Default: an empty list 

 

debug:

 Whether or not the Agent adds debug information the logs and/or console. Set to 

1 to enable. 

Default: 0 

 

SHUTDOWN

 

 

url:

 The URL of the web page that will be called when the shutdown command is 

received. When this value is left empty the machine on which the Agent is running will be 

Summary of Contents for ES2000 Seriesl

Page 1: ...User Manual ES2000 Series ES6000 Series EnergySwitch ...

Page 2: ...liance 11 Recycling 12 Servicing Repair 12 Additional Documentation 12 Getting Started 13 Receiving Inspection 13 Inventory 13 Installation 14 Rack Mounting Instructions 14 Mounting the EnergySwitch 15 Additional Earthing 15 Connecting the EnergySwitch 15 Overview 16 Front Panel 16 Status LEDs 16 Outlet LED 16 Alarm LED 16 Power LED 16 Quick Configuration 17 Using the TFT Panel Display 17 Activati...

Page 3: ...agement 27 Settings 27 Network Configuration 28 SNMP Configuration 29 SNMP Settings 29 Device Settings 30 Thresholds 30 Resetting Measurements 32 Startup Delay 32 Priority 33 Overheat Protection 33 Network Time Protocol NTP 33 CLI 34 Connecting 34 UPS Integration 35 Configuration 35 Compatible Devices 35 Connecting the UPS 35 Enabling the Link 37 Operation 37 Rules 38 Agent Communication 40 Config...

Page 4: ...tivity com v 2014 3 27 Measurement 46 Management Information Base MIB 47 Upgrade Firmware 48 Obtaining Files 48 Troubleshooting 49 Downloading the diagnostics 49 Resetting Login Credentials 49 Connecting to the Web Interface 49 Knowing your EnergySwitch IP Address 49 Support 51 ...

Page 5: ...ivity com v 2014 3 27 Preliminary Information Applicable Models Unless specified otherwise all information in this document is applicable to the following Racktivity EnergySwitch devices ES2024 16 ES2024 32 ES2124 30L ES2124 32 ES6024 16 ES6024 20L ES6124 16 ES6124 30L ES6124 32 ...

Page 6: ... total cULus 24A 16A 24A Phase s 1 Φ 1 Φ 1 Φ 1 Φ 3 Φ 3 Φ 3 Φ 3 Φ 3 Φ C13 Outlets 24 24 21 21 24 24 21 21 21 C19 Outlets 0 0 3 3 0 0 3 3 3 Output bank CE 16A 20A 20A 20A 16A 20A 16A 20A 20A Output bank cULus 16A 16A 16A Output outlet C13 8A 8A 8A 8A 8A 8A 8A 8A 8A Output outlet C19 16A 16A 16A 16A 16A Circuit breaker 20A Thermal Thermal Magnetic Magnetic Thermal Thermal Magnetic Magnetic Magnetic T...

Page 7: ...0 F Humidity 5 to 85 RH non condensing Dimensions For the models ES2024 16 ES2024 32 ES6024 16 ES6024 20L Dimensions cm WxHxD 5 x 171 x 9 Dimensions inch WxHxD 2 x 67 3 x 3 5 For the models ES2124 30L ES2124 32 ES6124 16 ES6124 30L ES6124 32 Dimensions cm WxHxD 5 x 181 x 9 Dimensions inch WxHxD 2 x 71 3 x 3 5 Some newer models may exceed these dimensions in height please contact Support for exact ...

Page 8: ... Open CLI session Yes Yes Yes View current status states data values Yes Yes Yes Toggle outlets Yes Yes No Edit thresholds Yes No No Edit outlet names Yes No No Change SNMP notification settings Yes No No Edit device settings Yes No No View download logs Yes No No Default user name admin restricted guest Default password 1234 1234 1234 The same features and options apply to both the website and th...

Page 9: ...ndard straight through RJ45 patch cable unless noted otherwise Cisco Cisco devices that have a Console which uses the pin lay out of the 72 3383 01 Management cable RJ45 DB9 Hewlett Packard HP devices that have a Console which uses the pin lay out of the 5188 3836 Console cable RJ45 DB9 require that Pin3 RxD and Pin6 TxD are switched Fortinet Depending of the model Fortinet devices either require ...

Page 10: ...and plug are in good condition Do not connect the EnergySwitch to an ungrounded utility power outlet Do not operate your EnergySwitch with any covers removed or when it is damaged This EnergySwitch contains potentially hazardous voltages There are no user serviceable parts inside the EnergySwitch All repairs and service should be performed by authorized service personnel only The power requirement...

Page 11: ... is not intended to be user replaceable Certifications Not all certifications are applicable to every model Please check the label on your device CE FCC This device is designed in compliance with the requirements of the 4 following regulations EN 55022 Class B EN 61000 3 2 EN 6100 3 3 and EN 55024 This device is certified to comply with Part 15 of the FCC rules UL US Canada This device is in the c...

Page 12: ... Repair There are no user serviceable parts inside the EnergySwitch All repairs and service should be performed by authorized service personnel only Please refer to the Service manual for RMA procedure Additional Documentation Additional documentation regarding the following subjects is available on the Racktivity Support Website http www racktivity com support API o Manual o GUID Overview o pytho...

Page 13: ...or shipping damage and make sure that all parts were received Report any damage immediately to the shipping agent and report missing contents damage or other problems immediately to your reseller Inventory Please verify the contents of the box Standard Package Item Quantity EnergySwitch 1 Power cable 1 Mounting bracket set Flat 1 Mounting bracket set 90 1 Retention brackets 24 Quick Start Guide 1 ...

Page 14: ... supplied around the sides of the unit Mechanical Loading Mounting of the equipment in the rack should be such that a hazardous condition is not achieved due to uneven mechanical loading The unit should be mounted with screws suitable for up to 10kg 22lbs Circuit Overloading Consideration should be given to the connection of the equipment to the supply circuit and the effect that overloading of th...

Page 15: ... point on the front of the case may be used as an additional means of protectively grounding this product and the rack Connecting the EnergySwitch 1 For North America Connect the NEMA input plug to a compatible NEMA outlet receptacle For Europe and other countries using IEC 309 based power receptacles connect to the IEC 309 receptacle compatible to the IEC 309 cord plug provided Note The AC power ...

Page 16: ... is unpowered 1 R BUS A RS485 peripheral bus connector A for external modules 2 R BUS B RS485 peripheral bus connector B for external modules 3 CLI RS232 Command Line Interface connector 4 LAN Ethernet connector with connectivity indicator LEDs 5 TFT Color graphics TFT display 6 UP Move to the previous page or to browse upwards in a list 7 MENU Access menu function or return to the previous screen...

Page 17: ...r through a selection list in the menus Press OK to select the highlighted item and MENU to go back When in a menu the symbol indicates that clicking this item will open a submenu The symbol indicates that this menu item leads directly to a setting Hot Keys Several Hot Key combinations are available by using the navigation buttons next to the display To activate the functions press the necessary b...

Page 18: ... v1 2 the EnergySwitch has secure HTTP HTTPS enabled by default Use https instead of http in your browser to access the web portal Firmware version 1 2 or higher Dynamic IP Address Assignment DEFAULT 1 Press the MENU button until the MAIN menu appears select Network Settings using the DOWN button and press OK 2 Within the Network Settings menu select DHCP When the value at the bottom of the screen...

Page 19: ...name is admin and the default password is 1234 Manual IP Address Assignment 1 Obtain the correct IP address standard gateway DNS Server IP and subnet mask from your network administrator 2 Press the MENU button until the MAIN menu appears select Network Settings using the DOWN button and press OK 3 Within the Network Settings menu select DHCP When the value at the bottom of the screen shows Disabl...

Page 20: ...ps for the Subnet Mask Standard Gateway and DNS Server settings 7 Use the UP button to select Apply Settings and press OK Press the MENU button to cancel or the OK button to apply the settings 8 On a computer in the same network use a browser to open the chosen IP address for example https 192 168 14 250 When surfing to the web portal a popup appears requesting a username and password The default ...

Page 21: ...m and return to the NETWORK menu 10 Use the UP and DOWN buttons to select Save IP Settings and press OK Use the UP and DOWN buttons to change the setting Select yes and press MENU to save and return to the NETWORK menu 11 Press UP to select CURRENT IP ADDRESS The assigned IP address is shown in yellow at the bottom of the TFT 12 On a computer in the same network use a browser to open the assigned ...

Page 22: ...NETWORK menu select Use DHCP When the value in yellow at the bottom of the screen shows no the device already has a fixed IP if not press OK 12 Use the UP and DOWN buttons to change the setting Select no and press MENU to confirm and return to the NETWORK menu 13 Use the UP and DOWN buttons to select SET IP ADDRESS and press OK 14 Use the UP and DOWN buttons to change the currently selected value ...

Page 23: ... to select Save IP Settings and press OK Use the UP and DOWN buttons to change the setting Select yes and press MENU to save and return to the NETWORK menu 17 On a computer in the same network use a browser to open the chosen IP address for example http 192 168 14 250 18 When surfing to the web portal a popup appears requesting a username and password The default username is admin and the default ...

Page 24: ...t been fully tested by Racktivity Logging in For instructions on how to set up the TCP IP settings to connect to the Web Interface please see the Network Settings chapter To recover from a lost password please refer to the Troubleshooting chapter Use an internet browser to open the EnergySwitch IP address You will be asked for login credentials the default values for the administrator account are ...

Page 25: ...ed off GREEN the outlet is on and working normally ORANGE a warning threshold has been crossed but the port state has not yet changed only visible on the Overview tab and the affected parameter s tab RED an off threshold has been crossed port state has changed BLUE the outlet will be toggled after the set delay has expired during boot and whilst power cycling 6 Outlet toggle Toggle the outlet stat...

Page 26: ...ng Control fuse and or line currents Oscilloscope view for an outlet Overview of connected Agents Environment Use the Environment Tab to monitor and manage Internal sensors as applicable Voltage status history and management Logging The logging tab provides access to both the Event and the Detailed logging After selecting the desired module and time range the log can be downloaded or viewed inside...

Page 27: ...ding Energy Sensors For more information regarding the managing of Energy Sensors please see the Energy Sensor documentation Available as of firmware version 1 2 Settings Use this tab to configure the following settings Network SNMP Telnet Device and User Accounts NTP Network Time Protocol Startup delay and priority Overheat protection Energy Cloud Sentinel Uninterruptible Power Supply UPS ...

Page 28: ...of the EnergySwitch Subnet Mask o The subnet mask of the EnergySwitch Standard Gateway o The IP address of the default node on the network DNS Server o The IP address of the Domain Name System DNS server Enable DHCP o Check to enable DHCP Force secure web access HTTPS o Check to force secure HTTP web access Force secure telnet access SSL o Check to force SSL telnet access Note When DHCP is enabled...

Page 29: ...related settings can be found in the Network Configuration chapter The following SNMP settings are editable SNMP Community read The community read string for GET requests SNMP Community write The community write string for SET requests SNMP Trap Community string Community string used when sending SNMP traps SNMP Trap Receiver port The port 1 65535 on which traps will be sent SNMP Trap Receiver IP ...

Page 30: ...gh the website Temperature o Temperature unit degrees Celsius C or Fahrenheit F Clock settings see the Network Time Protocol NTP chapter o Date Time Settings The real time clock dialog features several options Uncheck the Use NTP checkbox to be able to set a custom date time Uncheck the Use default NTP checkbox to not use an NTP server from pool ntp org and enter the custom IP address into the NTP...

Page 31: ...The designated outlet is toggled off and an SNMP notification is sent Low When the measurement goes below this value an SNMP notification is sent High When the measurement goes above this value an SNMP notification is sent To change a threshold enter the desired value into the appropriate input area and press the Save button If the background of the input area turns red an incorrect value has been...

Page 32: ...d kWh counter is not resettable o path Power Energy Individual total Apparent Energy kVAh o Note The Accumulated kVAh counter is not resettable o path Power Energy Temperature o path Environment Ambient Voltage o path Environment Electrical Note Clicking a Reset link in the column header will reset all values in that column except for the value in the Total row Startup Delay path Settings Startup ...

Page 33: ...h Settings Overheat Protection The EnergySwitch has built in temperature sensors that can help prevent overheating For more information regarding the thresholds and event notifications please refer to the Thresholds and SNMP Configuration chapters Note The EnergySwitch has a built in safety that switches off all ports when the temperature hits 60 C 140 F regardless of the settings in the Overheat ...

Page 34: ...gs 115200 8 N 1 115200Bd 8 data bits no parity 1 stop bit Telnet Connect to the device IP on port 23 over Telnet Please note that only Telnet over SSL is enabled by default This can be changed on the Settings tab on the WebGUI of the energy switch Telnet SSL Connecting to Telnet over SSL can be achieved through several 3rd party tools For example using stunnel cross platform Edit the configuration...

Page 35: ...orm actions when set parameters and rules are met In order to use the full capabilities of the functionality 2 components need to be installed and configured correctly UPS Integration The link with the UPS in the rack as explained in this chapter Agent Communication Communication with the Agent service on connected servers for more details see the Agent Communication chapter Configuration Compatib...

Page 36: ...80 Lochristi Belgium www racktivity com v 2014 3 27 CLI Specifications chapter connected to the CLI connector on the front of the unit On the side of the UPS a DB9 male connector RJ45 DB9 Function Pin Pin Function Tx 3 1 Rx GND 4 9 GND GND 5 Rx 6 2 Tx ...

Page 37: ...rgySwitch will perform automated actions according to strict pre defined rules based on battery level UPS status etc Please review these rules and actions carefully to avoid unexpected behavior Operation Once the UPS communication has been configured and established successfully the following items are available on the Settings Uninterruptible Power Supply UPS sub tab Communication status o Checke...

Page 38: ...figured the EnergySwitch will perform automated actions according to strict pre defined rules based on battery level UPS status etc Please review the following rules and actions carefully to avoid unexpected behavior 1 When the EnergySwitch boots communication with the UPS is OK and the Battery Level is above the UPS Recovery Threshold the outlets will be powered as configured by the user 2 When t...

Page 39: ...Level dropped below the UPS Emergency Threshold and the UPS is running on mains power again and the Battery Level goes above the UPS Recovery Threshold All powered outlets and outlets marked with Prevent Outlet Shutdown will be power cycled if their respective power consumptions are below the UPS Recovery Power Threshold ...

Page 40: ...evices 2 Configuring the EnergySwitch to communicate to the installed Agent WARNING If both UPS Integration is enabled and Agent Communication is correctly configured the EnergySwitch will perform automated actions according to strict pre defined rules based on battery level UPS status etc Please review these rules and actions carefully to avoid unexpected behavior Agent Service The Racktivity Age...

Page 41: ...i Linux etc racktivity agent ini Configuration The agent ini file contains the following sections and editable parameters MAIN host The IP on which the Agent listens 0 0 0 0 means listen on any available IP address Default 0 0 0 0 port The port on which the Agent listens Default 6666 workers The amount of worker threads that are used to handle the connections Don t change this setting Default 4 al...

Page 42: ...ing on the configuration Example reboot reconfigure Sets a configuration parameter on the agent side Example reconfigure shutdown url disabledA0B1C2D3E4F5G6H7I8J9 In the example we set the URL parameter of the shutdown section to disabled A0B1C2D3E4F5G6H7I8J9 is the SHA1 hash of reconfigure shutdown url disabled appended with the IP where the command is coming from For instance if we send the comm...

Page 43: ...ff manually and with UPS integration enabled will be managed differently see the Rules chapter for more information Mostly used for vital rack equipment Agent IP IP of the machine where the Agent for that outlet is installed Shutdown and or restart commands will be sent to this IP Agent Port Network port of the machine where the Agent for that outlet is installed Agent SNMP Flag When checked SNMP ...

Page 44: ...also be sent to an associated agent manually through the use of an HTTP API when logged in as administrator https DEVICE_IP agent cgi ADDR P X INDEX Y CMD z o DEVICE_IP IP of the PDU o X Number of the power module ES1000 Series 1 ES2000 6000 Series 1 3 o Y Number of the outlet 1 8 o Z Command switch 0 shutdown command 1 restart command ...

Page 45: ... browser or download it for offline use Module Select the appropriate module Start time The starting date time for the log End time The ending date time for the log Download Download the log as a text file Show View the log in your browser The Log is displayed as a table with the following columns from left to right Timestamp The timestamp of the event Event type The type of event outlet toggle th...

Page 46: ...itoring data of the selected module For interpretation of the data in this file refer to the manual of the selected device It s possible to select a specific Measurement log file by configuring the following options Type The type of Measurement log Module Select the appropriate module Start time The starting date time End time The ending date time Download Download the log as a text file ...

Page 47: ...x and above https DEVICE_IP ES RACKTIVITY MIB txt A direct link to the MIB file is also available under Settings Network Settings For firmware version v1 2 x x and above https DEVICE_IP ES RACKTIVITY MIB txt For firmware version v1 1 x x and above http DEVICE_IP ES RACKTIVITY MIB txt For firmware version v1 0 1 x and below http DEVICE_IP ES202430 MIB txt Where DEVICE_IP is the IP of your EnergySwi...

Page 48: ...e update the device continues working as normal Note Make sure all active connections to the EnergySwitch such as the website telnet and SNMP are closed before updating Open connections might result in a failed update Obtaining Files If you are unsure whether a firmware update is available for your device have a look at http www racktivity com support or contact Racktivity Support see Support chap...

Page 49: ...ials will now be reset to their default settings Credential User name admin Password 1234 Connecting to the Web Interface If you are unable to connect to the Web Interface please try one or more of the following options Ping the device on its IP address When unsuccessful the EnergySwitch is most likely not on the same network as your PC or communication is blocked by a network device Connect the E...

Page 50: ...lgium www racktivity com v 2014 3 27 Press MENU to enter the Menu Select Network or Network Settings v1 2 and press OK Press the DOWN button and select Current IP address or IP Address v1 2 The IP of your EnergySwitch is displayed in yellow at the bottom of the TFT ...

Page 51: ...eg 19 9080 Lochristi Belgium www racktivity com v 2014 3 27 Support Feel free to contact us if you need any support or have any other questions or remarks Online www racktivity com support E mail support racktivity com Phone 003293242095 GMT 1 ...

Page 52: ......

Reviews: