Home

Manual - Generex

1. OK Abbrechen Figure 36 UPSMAN Mail Server Configuration 39 SMTP Authentification is required in networks where the mail server is not locally but elsewhere eg at an internet provider For the correct configuration please contact your system administrator Since UPSMAN version 5 9 42 the TLS encryption is provided In addition you can define the SMTP port 3 5 5 Advanced User Menu EVENTS Page Actions and reactions to UPS events alarms will be defined in the UPSMAN Event Manager The UPSMAN service can execute certain actions jobs NOTE Although the jobs in the joblist of the EVENT manager are executed top down but since every job has its own timer eg delayed immediately etc the priority of the jobs depend on the individual timers not on the rank in the job list If you want to change the rank of a job you can drag amp drop the job in this list but still the individual timer remains unchanged Which events are configurable depends on the type of UPS Every UPS contain individual alarms large UPS have usually more alarms than smaller UPS The following section explains the pre settings of such an event list on the example of a 1 phase UPS _ The event overview displays all available events of this tyoe of UPS and the user configuration of the corresponding actions Every X means that this event has at least 1 job as executable listed Witha T double mouse click the
2. ccccccccccccccscccccsscccsceeceeecceeceeseeeeeeeeeeeseeneaaeasaaaaaaaaaaaaaaas 14 Figure 11 UPSMAN Tray ICON Status rrinin AR 15 Figure 12 UPSMAN Tray Context MenU ccccccesesssceeeeeceeeeeeeeeeesseseesnaseeeeeeeeeeeseseeseaas 15 Figure 13 UPSMAN ConnouralOn aaas oko oie eta edad Meta eas 16 Figure t4 Select UPS Model waco al ee ee ha een es 17 Figure T5 WiIndGWS S ChVICCS anasan a dooms secs E EN 18 Figure 16 Protect 3 33 UPS Webinterface cccccccccccceceeeessseeeeeeeeeeeeeeeeeeeaeaeeeeeaeeaaanaaees 19 Foure TA UPSMAN PTODEIG S ana aA E T e heres 20 Foure Ige Socec USE a E E A EEE E A 20 120 Figure 19 Figure 20 Figure 21 Figure 22 Figure 23 Figure 24 Figure 25 Figure 26 Figure 27 Figure 28 Figure 29 Figure 30 Figure 31 Figure 32 Figure 33 Figure 34 Figure 35 Figure 36 Figure 37 Figure 38 Figure 39 Figure 40 Figure 41 Figure 42 Figure 43 Figure 44 Figure 45 Figure 46 Figure 47 121 UPSMAN Properties This ACCOUNL cccccccceeeeceseseeeeeeeeeeeeeseeaeesaeeseeeeees 21 Content of the installer properties ccccccccccccssssceecceeesseeeecscseesseeeesssaaaaeess 22 UPSMON Statuspage of a Protect 3 33 UPS ceeeeeeeeeeeeeeeeseeeeeeeeeeeeeeees 23 Scheduler in UPSMON interface to program actions on your UPSMAN 24 UPSMON Statuspage of a Standard UPS without OEM Design 0 25 UPSMON Device Comm
3. Add custom application button In addition users can determine the shutdown sequence order Configure Shutdown Sequence _ X File C Program Files UPS upsman shutdown bat Available Commands Current Sequence Log off user Shut down Windows Power off Windows prom Restart Windows Hibernate Windows Suspend Windows Quit Lotus Notes Quit Microsoft Office Quit Siemens SIMATIC 4 m p Description of Add custom application Log off user Ends your session leaving the computer running on full power Cancel OK Figure 34 Windows UPSMAN Shutdown Sequence Configuration e Enable UPS shutdown Defines if the UPS will be turned off after the completion of the shutdown procedure of the server The UPS shutdown section is not Supported by all UPS manufacturers In particular devices with the connection type cable do not support a schedule controlled shutdown and restore function e UPS Down Delay s Defines how many seconds after beginning the shutdown procedure see Down time the UPS will turn off e UPS Restore Delay s Defines how many seconds after turning off the UPS the system is turned on again For most UPS types it is necessary that the power has been restored before the UPS has completely switched off With some UPS devices the entry 0 disables an automatic restart and the UPS needs to be switched on manually e Enable SNMP Support Enables or disables the SNMP support
4. Power VA 500 Holdtime fm 0 Load VA 500 Recharge time fh 6 Date of Battery Installation DD MM YYYY 01 08 2011 Baudrate Listen Port Licencekey tial version expires afte UPSID Reset to Factory Settings 1995 2011 Generex GmbH Hamburg Germany V 5 8 25 Figure 4 Thirty Day Trial Version without Key Code Installation and Use of UPSManager Requires Acceptance of the Following License Agreement Copyright The information contained in the manual of this product is nonconditional and may be changed without due notice GENEREX nor the reseller of this product undertakes no obligations with this information The software described in this brochure is given on the basis of a license contract and an obligation to secrecy i e an obligation not to further publicise the software material The purchaser may make a accept the terms of the License Agreement do NOT accept the terms of the License Agreement Figure 5 License Agreement Read and confirm the license agreement and continue with the NEXT button In the next window enter the path where you want to install the software Default is the subdirectory UPS into the program files folder onto the hard disk C 11 Where Would You Like to Install Restore Default Folder C Program Files UPS InStallA 0 _ _ Figure 6 Choose Install Folder Cli
5. Counter Power failure Battery low Shutdown Summary Alarm Advanced User OK Figure 76 Advanced User Events Page Choose the desired function and set a timer and define when and how often this function should be executed Any event that contains a delay will be executed ONLY if the alarm is still valid when the timer has run out E g if you configure to send an RCCMD shutdown after 30 sec this job will be executed ONLY if the powerfail is still the case after the 30 sec have run out If the power has returned at 29 sec nothing will happen 80 CD ROM IDE 1 0 E Ethernet E 4 Sound Adapter QS Shell Konsole JUPSCFG UPSMAN Configuration foe l a x Session Edit View Insert Function Retrying Installabl a Deferral retries do There were no defer function Send RCCMD MAIL TXT to remote client Send RCCMD MAIL_TXT to remote client send RCCMD MESSAGE_ID to remote client ADDRESS Execute Program f Send Messagebox with text aption error 2 No such file or di Send RCCMD SHUTDOWN to remote client Installer pass 1 RECIPIENTISend RCCMD LOG_TXT to remote client acute Command etc init d ups_man Send RCCMD MAILID to remote client BrowserLauncher ope Send RCCMD MESSAGE to remote client Did not match to me SHUTDOWN REQUESTED This function will send a RCCMD MAIL Text to a remote client REGISTRY ALREADY ST cleanUp calling cleanUpUNIX Exiting wi
6. installer properties It is required to remove the hash mark prior of the variable INSTALLER UI silent In addition the setting of the license key is required behind the variable GKLICENSEKEY The UPS Management Software 5 8 04 or higher provides the parameter preselection for the UPS communication Remove the hash mark prior of the variable UPSDEVICE COM20 2400 e 8 1 and adjust the parameters accordingly 3 3 UPSMON for Windows UPSMON for windows is a graphical interface which is individually customized for every UPS maker for this a large variety of screens exists Depending on the UPS makers design and functions in the UPS the UPSMON appear more or less complex In this manual we desribe the basic functions which are part of any UPSMON version When UPSMON starts it will ask for a connection to a server Enter the IP address or hostname To start a connection click on the button Connect 22 NOTE The UPSMON windows is a monitoring tool for any UPSMAN unregarded on which OS this UPSMAN is running So you may use this tool to connect via an UPSMAN server at UNIX MAC or CS121 To start a connection to different UPSMAN processes at the same IP address enter the port and the IP address or host name respectively separated by a comma e g 5769 192 10 200 6 The port address can also be left out if a single UPSMAN has been started at the default port The entry of the IP address 191 10 200 6 is enough We recommend using the
7. 147 456 SWARNLIS DLL lt DIR gt TEMP 28 866 TLI_WIN DLL 475 241 UBMPCTRL DLL 148 992 UBTCTRL DLL 196 668 UCHART DLL 196 668 uchartdll dll 188 416 UCKCHART DLL 1 215 upsman txt 1 515 667 UPSMON32 exe 275 upsmon32 ini 625 356 upstyp ups 540 778 USTDCTRL DLL 87 24 2687 237 659 UTRTICTRL DLL 11 206 318 bytes 4 Dir s gt 12 213 1606 544 bytes free UPSMAN x86 gt UPS upsmon gt Figure 55 UPSMON Folder Execute the upsmon32 exe to start the UPSMonitor The UPSView enables the remote access to the UPS data via web browser To be able to use the UPSView it is required to open the firewall port 8081 as follows netsh firewall add portopening tcp 8081 upsviewport Enter the following into your web browser http IP AddressCore 8081 59 Lesezeichen Extras Hilfe AN http 192 168 200 64 8081 cgi bin ups_view exe ups view Vy Google No UPS model defined Time 10Min Capacity 100 Figure 56 UPSView 4 Unix amp MAC X 4 1 Basic Installation UPSMAN on UNIX and MACX General The UPSMAN modules installation on UNIX exists in 2 versions The older command line based install version which is based on the installation script install and the new graphical based installupsman bin installation Since the graphical installation installupsman bin is the new standard we describe this procedure first The older scriptb
8. In the Start Menu On the Desktop In the Quick Launch Bar Other Choose V Create Icons for All Users lnstallaryewhere Figure 8 Choose Shortcut Folder In the next menu you see an overview of your installation and you may now press INSTALL to begin 13 Please Review the Following Before Continuing Product Name UPSManager Install Folder C Program Files UPS Shortcut Folder C ProgramData Microsoft Windows Start Menu Programs Generex Management Software Product Features UPS Manager UPSMAN Help Graphical Charts GChart L UPS Web View InstallAriywrere Figure 9 Pre Installation Summary Into the next window you got the opportunity to open the required firewall ports 960 and 5769 automatically UPSTCP needs ports 960 and 5769 opened in the Firewall Should these ports now be opened in the Windows Firewall Installaryenere Cancel Figure 10 Firewall Configuration The port 960 is used by the UPSMAN tray The UPSMAN tray provides the appearance of the UPSMAN message box as pop up into the foreground If you do not want to receive messages from the UPSMAN please close the UPSMAN tray via the context menu To disable the UPSMAN tray permanently you can disable it into the UPSMAN configuration 14 The UPSMAN tray appears into the taskbar From UPSMAN version 5 8 75 the UPSMAN tray displays the status or rather a change of the status of the
9. Programs UPS Upsman Backup the existing rccmd pem e Replace the existing rccmd pem with your own 54 Restart the RCCMD Client Restart the RCCMD Sender 3 6 10 Examples WOL Wake On LAN Insert Function we e E This function will wake up hibernating Function Send Wake On LAN signal X or sleeping computers to go back Function Parameters online The receiving computers of this Parameter Value signal must have network cards and aa operating systems that support this PASSWO function magic packet The MAC address can be determined in dos Required Enter the MAC address of the computer to wakeup consoles by entering the command ipconfig all at the DOS prompt Here you can find your network card MAC address To wake up this computer Example The format is x x x xi x where x Is a hexadecimal number Do immediately Do aft i Seconds Dane ek enter the MAC address in this Do Always Doafter 0 Seconds repeat DoEvey 0 Seconds Do at 0 Minutes remaining UPSMAN job A password is not needed unless you have a BIOS where you can define such a password for WOL magic packets Cancel OK Figure 53 Wake On LAN Signal 3 6 11 Examples Scripting The transfer of internal variables of the UPSMAN to self created batch files is possible with the UPS Management software The normal batch file programming is used for this In the batch file the valu
10. Protect 3 33 UPS Webinterface 3 1 Settings of the Authorization of the UPSMAN Service This function is used for the commitment of the user authorization of the UPSMAN service which exceeds the system shutdown e g execution of batch files script files etc Open the menu of the properties window for the UPSMAN service via control panel administration and services and click the Log On button 19 UPSMan Properties Local Computer Po Allow service ta interact with GESLON fe Help me configure user 2 TA PARIY ee AS SE NA A NA ting using hardware profiles anaue Figure 17 UPSMAN Properties Enable This account delete the passwords and click the Browse button Select User PSI a GS8 Admirnistratar Figure 18 Select User Enter the object name Administrator click the Check Names button and click the OK button 20 UPSHan Properties Local Computer General Log On Recover Dependencies Log on as C Local System account Silay serice ta interact with desktop This account Administrator Fazzword tsesesess Confirm password sesesess Help me configure user account log on options You can enable or disable this service for the hardware profiles listed below Hardware Profile Undocked Profile Enabled Troubleshooting using hardware profiles Enable Disable mea ao Figure 19 UPSMAN Properties This
11. The following functions are available in most UPS 41 Send a Shutdown UPS Signal Send Message box with text Send RCCMD SHUTDOWN to remote client 42 Switches the UPS output off after a pre set time Please make sure that the UPS is not being switched off before a system shutdown is executed as otherwise important data may get lost This shutdown signal only executes the output switch off but NOT the shutdown of connected computers If you define such an action make sure that RCCMD is triggered before The user can configure a delay in seconds before the switch off is executed Sends a network message using net send The Windows Messenger Service has to be active to use this function Enter a user or a machine name or use the character in order to send the message to all users If you want to add several addresses please part them with semicolon and a blank This is the most important function in this job list it sends a RCCMD shutdown message to RCCMD clients in the network RCCMD Remote Console Command is a program used for the execution of executable files via network mainly used for the remote shutdown of computers with different OS using TCP IP as common basis From RCCMD Version 2 0 it is possible to use the as wildcard to shutdown complete segments e g 192 168 202 255 will send the signal to all computers in the network 192 168 202 0 to 255 RCCMD can be used as client receive a signal
12. UNMS JAVAMON or other The moment you can read UPS data from your monitoring interface the installation was successful and you may close the monitoring tool and keep the UPSMAN running in the background In the following figure is the UPS VIEW webinterface of a Protect 3 33 UPS It shows the most important UPS data and alarms The UPSMANHTTP windows service running in the background and provides the data for this webinterface The following chapters explain now the various UPSMAN monitoring tools starting with most common UPS interface for Windows UPSMON 18 gt 3 localhost 8081 cgi bin ups_view exe ups_view 3 UPS View Web client Identification UPS Typ Date Time Event A 28 11 2011 16 58 40 Information UPS manager fuer Protect 3 33 ist gestartet worden p 28 11 2011 16 58 22 Masterlizenz Nur fr Testzwecke nicht fr Installationen beim Kunden verwenden 28 11 2011 16 55 46 Information UPS manager fuer Protect 3 33 ist gestartet worden 28 11 2011 16 55 27 Masterlizenz Nur fr Testzwecke nicht fr Installationen beim Kunden verwenden hi p Mains input 1 L1 L2 L2 L3 L3 L1 Frequency Mainsfault counter Autonomy Time Status Normal 999 Min 100 245V 3A Temperature 23 0 C Output Voltage Current Phase L1 231 V OA 0 Phase L2 231V OA 0 Phase L3 231V OA 0 Frequency 50 0 Hz Location GENEREX Hamburg DataLog Chart Log file Functions Scheduler Figure 16
13. and a server transmitting a signal So the syntax to send a shutdown signal to a specific computer is RCCMD s a 192 168 200 201 This example will send a shutdown signal to this IP which will be executed if on this IP also an RCCMD client is running and the sender is in the valid address list of senders The entry of a IP address or hostname will send RCCMD only to those named If it is required to shutdown more than one client additional event jobs can be configured Note If the number of additional RCCMD clients is very large a batch Send email Send RCCMD EXECUTE to remote client Send RCCMD MESSAGE ID to remote client Start Alarm Beeper with messagebox Send RCCMD MAIL ID to remote client 43 file which contains the RCCMD s commands can be used instead rccmd relay This allows you to send rccmd calls much faster and is easier to handle than the executing of along list of jobs by the UPSMAN Such a batchfile can be executed from the Special or Events Execute Program functions Please note that RCCMD shutdown calls should always be configured in the UPS Battery low without any further delay Sends an individual email text at this event Enter an email address and the corresponding text into the field Please note that you need a configured SMTP server on the UPSMAN computer Qblat is the email program which is triggered by UPSMAN email configuration This action initi
14. name usri sbin ntpd name de fault pid 1793 May 5 10 31 04 linux f36j ntpd 4087 ntpd 4 2 4p501 1541 0 Wed Dec 3 07 22 15 UTC 2008 1 May 5 10 31 04 Linux f36 ntpd 4109 precision 1 000 usec Hay 5 10 31 04 linux f36j ntpd 4169 ntp_io estimated max descriptors 1024 initial socket boundary 16 Hay 5 16 31 04 Linux f36 ntpd 4109 Listening on interface 0 wildcard 0 6 6 G 123 Disabled Nay 5 16 31 04 Linux f36 ntpd 4109 Listening on interface 1 wildcard 2123 Disabled Way 5 16 31 04 Linux f36 ntpd 4169 Listening on interface 2 lo 12123 Enabled A Me Figure 101 Log messages You can now query the NTP server with the ntpq query tool bash ntpq pn 117 File Edit View Scrollback Bookmarks Settings Help Linux f36 Linux F36 Linux F36 Linux F36 Linux F36 Linux F36 Linux F36 Linux f36 Linux f36 clear Linux f36j ntpg pr remote refid st t when poll reach delay offset jitter 127 127 1 0 LOCL Sl Sl 64 377 0 060 0 066 4 601 85 214 116 15 192 953 103 108 2u 63 256 377 27 006 9 076 1 490 188 193 216 74 DCF lu 196 256 377 62 568 9 612 2 250 89 238 71 13G 1952 53 103 1085 u 182 256 377 21 631 1 951 2 113 127 127 1 0 LOCL ll 27 64 377 0 000 0 000 6 001 Linux f36j ff Figure 102 NTP query E UPSMAN configuration without graphical interface Linux Perform a Silent Installation text only ou
15. ups_conf in the folder usr ups All configuration tools use the same config file ups cfg which may also be changed by an Editor but some technical knowledge is required here and you may need the help of our support The ups_conf will ask you to create this file if it does not exists The file ups cfg contains the configuration data and has to be in the same directory as that in which the UPSMAN process is started from Within the configuration program ups_conf the keyis available to read the help texts and the Esc key is available to close the menu Finally do not forget to save your settings and restart UPSMAN We continue with the ups_conf configuration with Step 7 configuration of the UPS comport and interface Choose in the ups conf menu Set Ups values to enter youre Ups model and interface 90 1 Z GX TF GET root SSH Secure Shell File Edit view Window Help EH SAa SS BRee2 4 H9 s er E Quick Connect Profiles Connected to Gx UPSM4AN Configuration F L Set UFS values Set System values Set Job walues Set Fath values Set Event parameter save Configuration Exit Exit Figure 80 Unix Configuration Menu i tester gx245 usr ups Shell Konsole Session Edit View Bookmarks Settings CD ROM IDE 1 0 Help iai 55H1 3des icbc crc32 none eox27 Ka lg CS Ethernet la 4 Sound Adapter Serial Port Set UPS values L
16. 1 Basic Installation UPSMAN on UNIX and MACX 4 1 1 Silent Installation of the UPSMAN Installation 4 2 Start UPSMAN on UNIX and MACX 4 3 UNIX WEB Server 4 4 1 Advanced User DEVICE Page 4 4 2 Advanced User Menu SYSTEM Page 4 4 3 Advanced User Menu Files Page 4 4 4 Advanced User Menu Events Page 4 4 5 Email Usage on Linux OS 4 4 6 Remote UPSMAN Configuration 4 4 7 Older Install Script Based Installation with ups_conf 4 4 8 Unix MAC commandline UPSMON OO NNO 21 22 29 32 32 34 38 39 40 45 45 45 46 47 50 51 52 52 54 55 55 57 58 60 60 71 72 13 74 76 78 79 84 85 86 100 4 5 Apple Macintosh 4 5 1 UPSMAN for MAC OS 9 MAC OS 10 5 UNMS UPS Network Management System 6 Simple Network Management Protocol SNMP 6 1 UPSMAN with SNMP on Windows 7 FAQ Appendix Supported Systems Know How Pool Automatic Start of the UPSMON after Reboot Windows NTP time synchronization UNIX UPSMAN configuration without graphical interface Linux Error codes UPSMAN Cable types Picture catalog roammoowr 102 102 103 103 104 105 108 108 108 112 113 118 118 120 120 1 What is the UPS Management Software The UPS Management Software is a client server application for networks and local workstations The server module of the UPS Management Software is UPSMAN which communicates via RS 232 USB or network cable with the UPS When UPSMAN start
17. Agent Ser VMware Ag Manual Local Syste auftritt Zur Konfigurartion starten s VMware Authoriza Authorizati Started Automatic Local Syste Sie upsman config VMware DHCP Ser DHCP servi Started Automatic Local Syste VMware NAT Serz Network ad Started Automatic Local Syste 4 VMware USB Arbit Started Automatic Local Syste Volume Shadow C Manages an Manual Local Syste WebClient Enables Win Started Manual Local Service Windows Audio Manages au Started Automatic Local Service Windows Audio E Manages au Started Automatic Local Syste Windows Backup Provides Wi Manual Local Syste Windows Biometri The Windo Manual Local Syste Windows CardSpa Securely en Manual Local Syste Windows Color Sy The WesPlu Manual Local Service Windows Connect WCNCSYC Manual Local Service _ oo ae a i n Extended A Standard Figure 15 Windows Services Installation and basic configuration FINISHED Your computer is now UPS protected and will be shutdowned automatically in case of an extended Powerfailure For a simple UPS communication and automatic shutdown of the UPSMAN computer the configuration is complete For further UPSMAN configuration issues please continue to read in chapter 3 2 Advanced User UPSMAN Windows configuration To check your configuration you may use one of the monitoring tools provided with your UPSMAN software UPS View UPSMON
18. BOOK inis aoni nan E E 50 RCOCMD Email Ex menes A ATA AT 51 Message ID EXIM le rnnr N 51 Figure 48 RCCMD Execute Example cccccccccccccccceeesssseeeeeseseeeeeeeeeeeeeeeeeaeeaaeaaeaaaaaaaaeaes 52 Figure 492 SSL Mami ACV ALON acu cccssecs ese se poxseac ted TEE RTA 52 Figure 50 SSL Activation of a single FUNCTION ccccccccccceceeeeeeseeeeeeeeeeeeeeeeeeeaeeeeeaaeaaaeaaes 53 Figure 512 SOL C OnfQuration citata sick aca E E E 53 Figure 52 Advanced Network Settings ccccccccccccccccccceessseseseseeeeeeaeeeeeaeeeeeeaaaaeaaaaaaaaaaaaaas 54 Restat the RCOCMD S6NdEr ana se eat seea ace eareue dee areca snd A 55 Figure 53 W ake On LAN Signal s 2en cee eae a a ee ee 55 Figure 543 Installation Folder eenia a r nE ERREA 58 igure SS UPSMONIFOIJE mona a a a a a cbehedancted 59 Figure 365 RG ViICW arene E Sechealse ahi a secekd aise sah a secekd Secale 60 Figure S7 GD RON Oli sss carats net ed ac ete 61 Figure 58 Download Menuaren tacked dedes sas kaa eiei tara AE rE EE aaa 61 Figure SO AIMS ANON File Seere EE atnd ced aa 62 Figure 60 IN FOGUCTION Page oes dana N E 62 Figure 61 Enter Licence Key PAG 6 as visas cota sicnucuan ea caasl oii deed Gene sl sa vuueluaveel cebu e a deseaeelaiet 63 Figure 62 License Agreement Page ccccssssssssseceeeeceseeeeessceeeeeeeeeeeeeeseeeaaasseeeeeeeeeeeeseaes 63 Figure 63 Install Custom Page riisin aa aaa a a a 64 Figure 64 Pre Installation Summary Page cc
19. File upsdata csv This file contains the logged measurement values of the UPSMAN like voltages and currents e Logfile max Size kb Defines the size of the log files in KB e Write raw data to file Enable this function for logging of the RS232 USB communication between the UPS device and your computer to a file called line raw into the UPSMAN folder This features will be used for the analysis by the UPSMAN support team Attention This file can be very huge in a short time especially at USB communications We recommend to enable this function for the analysis only 3 5 4 Advanced User Menu MAIL SERVER Page This page is for the Email Server configuration of the email client module QBLAT which is provided with your UPSMAN installation This configuration has to be made if you want that the UPSMAN send emails in case of alarms A valid mail server email address SMTP authentication has to be entered in the UPSMAN Mail Server Configuration in order to use the mail service Device System Files Mail Server Events _ E Mail Configuration V Use E Mail E Mail address of the sender generex test googlemail com Name of the mail server smtp googlemail com UPS Administrator E Mail e schulz generex de SMTP Authentification V Use SMTP Authentification Login generex test Password ITTTITITTT Server Configuration SMTP pot 25 V Use secure connection TLS encryption
20. MAIL TXT instead to create its own text Like the send RCCMD mail function an email is send from the RCCMD client as relay The user may enter here any individual text This writes a log file text Customized or as predefined text if you use ID into the RCCMD remote clients log file This maybe useful if a common log file is wanted where all UPSMAN computers write into This log file maybe on any network computer with RCCMD The user can configure a text message customized or as predefined text if you use ID which is transferred to the RCCMD client and pops up as text box This is useful if you want to send a messagebox from Windows UPSMAN to a UNIX system the problem of sending messages to different operating systems can be solved through this Executes a configured program on this computer Please enter the full path to the executable file on the UPSMAN computer It is recommended that the executable file is located in the UPSMAN folder or in any other folder where a path is set to Writes any text into the upslog csv text file on this UPSMAN computer Sends pre set network messages using the receiver name and message ID This standard message can be configured in the message dat Open the file with an editor in order to change or check the text of the corresponding message ID When an alarm occurs this function write to the MS EVENT LOG called also Event Viewer The user can now alter the Windows standard e
21. Menu SYSTEM Page Beside the UPS configuration page more pages will appear if you click the Advanced User button All configuration data in the menus have tool tips in the corresponding language Every menu feature will be explained online following we start to describe the SYSTEM page of UPSMAN 34 UPSMOWN Password UPS Check Rate s 5 Upsman HTTP For UPSMAN RCCMD 2 traps enabled Message Port Enable network broadcast for events O Use SSL as default for all RCCMD events System Shutdown Enable Local Shutdown Down time m 3 Configure E Initiate Shutdown always after m on battery 5 UPS Shutdown Enable UPS Shutdown UPS Down Delay fe 180 UPS Restore Delay e 0 SNMP Enable SNMP Support Restat SNMP Service Figure 32 UPSMAN System Configuration 35 e UPSMON Password Default no password The user may enter here a password which will be requested whenever you open the UPSMAN onfiguration program or the sheduler and device functions in UPSVIEW e UPS Check Rate s Defines the timing in seconds of the polling data from the UPSMAN to the UPS The system will be slowed down if this value is too small because of continous communication with the UPS If the value is too high the system will react more slowly in case of a power failure For continous use we recommend a value between 15 and 30 seconds UPSMAN RCCMD2 Traps enabled When this function is activated UPS events will be
22. SD Counter for shutdown CNT_SA Counter for summary alarms CNT_TF Counter for test errors INVOLT Current Input voltage in Volt V For the special UPS integration into the UPSMAN software more variables can be provided Please ask your UPS dealer manufacturer for more information on additional variables 3 6 12 Start Options of the UPSMAN Module Upsman exe is a Windows service application The configuration parameters are read from the Windows registration database By default the UPSMAN service is set to start automatic In the following we describe options to start and configure UPSMAN service Please start the upsman exe via the control panel with the help of the service icon Alternatively start the UPSMAN with a command line net start upsman To use the UPSMON graphical interface please install the TCP IP protocol on your system Upsman exe can also be started from the command line as foreground process The following parameters are supported e install installs the UPSMAN as a service e remove uninstalls the UPSMAN service config starts the configuration program e libver shows the version release of the UPSMAN debug starts the UPSMAN as foreground process not as service and displays a window for error function analysis In addition a line raw file is created which logs the entire communication between COM port and end device The file can be decoded by our service team in order to trac
23. Spell_ Replace LJ Status Events d short yvbin Configuration Events Label OY Application Alert Events _J All Events Display Label 4 Yes No r e vflt Status Normal Status Source Symbol i p_volt f 2ld n vflt vflt Location sd zd 2d sd zd d sdin bl b 5 b 6 b 7 k A eedigatie Behavior w Explode Execute yflt Application Action nputVoltFuji C Lazy Font L1450 059 71 IP Tables ping arID d Size d pData sld n VarID Size pData f3 IP Tables rping IP Tables sysInfo Navigation Submap AddThisSubm sacar Submap lt AddThisSym pota aes double j N t ubmap 0 pData f ld f n ouble pData pData x Ge GECRON G d gd d gd zd zd zd zd a Openview Terminal Connect HPTerm Telnet e Open iew Terminal Connect XTerm Telnet OpenView Windows Print_Wlindow Var f n double arf Selection Dw UPSHON V4 i upsmon Target Objects OK Cancel Help i unc C Lazy Font L526 058 26 enerex sol fuspetupsman current gt upsman current upsdev upsdev c Asar E oi S Bin Ad Wy Ey Gad Ay Ed wee E Bad E Ead aoe Bay E EEs Gd FRED LOBY 06 Figure 94 Symbol Object Properties C Automatic Start of the UPSMON after Reboot Windows If the UPSMON should start after reboot automatically it is required to link the supplied GO BAT file which is located into the default folder C Program Files UPS U
24. TCP IP protocol as a communication protocol Once connected with a server the UPSMON responds with the main screen allowing all features to be operated After a connection has been established the status main screen shows several windows The menu and toolbar is at the top of the status chart The bar contains the buttons Open A Connection Close A Connection Searching The LAN For Active UPSMAN Services Get Datalog As Text Get Graphical Datalog Open Scheduler Change Of Logdata Program and Open Remote Configuration The Windows installation of UPSMON contains gChart a graphical log file viewer File View Chart Functions Help le E E wi Count PF BL SD Identifizierung USV Typ Protect 5 Firmware D61xx14l Standort GENEREX Hamburg Netzeingang 1 Frequenz Netzfehlerzahler Status Batteriezeit Kapazitat Spannung Strom Temperatur Netzeingang 2 NORMAL 999 Min 100 245 V 3A 23 0 C Ereignisliste Date Time Event o O 11 28 2011 17 01 Status Normalbetrieb 11 28 2011 17 01 Information Verbindung zur USV hergestellt Auslastung Batteriezeit ix Ausgang Spannung Strom Auslastung Leistung Leistun ow ow ow Strom Auslastun 231V 0A 0 231 V OA 0 231V OA 0 Phase L1 Phase L2 Phase L3 m Localtime Figure 21 UPSMON Statuspage of a Protect 3 33 UPS 23 17 02 20 Servertime 17 02 20 The Windows U
25. UPS Restore Delay s Defines how many seconds after turning off the UPS the system is turned on again For most UPS types it is necessary that the power has been restored before the UPS has completely switched off With some UPS devices the entry 0 disables an automatic restart and the UPS needs to be switched on manually Enable SNMP Support Enables or disables the SNMP support Please check in the event log if this function is properly started A message SNMP communication could not be started shows that an error occurs No message means that this function is working 4 4 3 Advanced User Menu Files Page e Event Logfile Filename upslog txt is the name of the event alarm text protocol The default is a MS Excel compatible CSV file format e Data Log File upsdata txt This file contains all UPSMAN variables ID 700 or 800 which are part of the message dat e Logfile max Size kb Defines the size of the log files in KB JUPSCFG UPSMAN Configuration Event Logfile Filename pslod txt Logfile max Size kB Data Logfile Filename Enable Z Logfile max Size kB 1000 Update Rate s Advanced User Cancel Figure 75 Advanced User Files Page 78 4 4 4 Advanced User Menu Events Page Actions and reactions to UPS events alarms will be defined in the UPSMAN Event Manager The UPSMAN service can execute certain actions jobs NOTE Although the jobs in the joblist
26. UPS comm cable is very oftern a special cable which is provided by the manufacturer of your UPS system Please see the corresponding cable configurations in the appendix of your UPS manual 2 2 Windows 2000 XP 2003 VIST A 7 2008 UPSMAN Installation General The UPSMAN for Windows is a real background service and has no graphical output The UPSMAN is the only necessary process for all UPS management actions The graphical client modules eg Webinterface or UPSMON are only for viewing the UPS data or for for the graphical administration but not compulsory for normal operation of a UPS software like shutdown messaging etc Installation The UPS Management Software is distributed on a CD ROM or as full version download from the web site of the UPS manufacturer A license key is required for both distributions The Windows part of the software is found in the root directory of the distribution package and is started automatically or executing the INSTALL EXE command This SETUP process copies the desired UPS files to your local hard drive Licensing The first input window is the license key of the CD license license key key code This key code is shipped separately as electronic document paper document or in any other form please contact your UPS dealer for information where to find the key code Every license key allows the customer to install one UPSMAN software suite consisting of UPSMAN and several graphical c
27. a security prompt Exception Site List Applications launched from the sites listed below will be allowed to run after the appropriate security prompts ee Edit Site List Restore Security Prompts Manage Certificates ox canei Figure 79 Java Control Panel Security Settings 4 4 7 Older Install Script Based Installation with ups_conf This install script runs also without a graphical interface but is not supported for new UNIX MACX versions We recommend to use for new OS the graphical installation which is almost 100 identical to the windows version described above INSTALL Script based installation The software is distributed on CD ROM or as downloaded TAR file from the internet In both cases you find after mounting CD ROM or having the file unpacked tar xovf you find a new directory UNIX or GENEREX which contains the install script and the install 86 executable for the graphical installation To start the script installation you have to use install Tip CD Rom instalaltion On UNIX itself you need a CD ROM drive and a CDFS filesystem driver ISO 9660 If there is no CD drive on the system where the software could be installed from you can use any other Unix system or PC with a CD driver via a network to install the software Other way Use a DOS or Windows workstation in your network and insert the CD there Now you can copy the sof
28. account Enter the password for the Administrator confirm it click the Apply button and restart the RCCMD service 3 2 Silent Installation of the UPSMAN Installation The UPS Management Software provides a silent installation but it is required to enter some settings into the installer properties file This file is located into the CD folder Upsman Windows OEM ID 2 for AEG 3 for Piller etc 21 c If you want to install a subset of features from this installer make a list of a features you want to be installed The List must be entered in the CHOS N INSTALL FEATURE LIST variable for t ist are UPSMan UPSWeb UPSMon Plic2 Help FEATURE LIST UPSMan UPSWeb UPSMon Plfc2 Prolifi Help Choos Enter your OEM number here OCEM 0 FE Ch FF If you want to install a different language than English you will want to yvi valid country code here This is only img E for si gt installations Valid codes are zh c je fr el it ja c gt 19 silent installation your License Key must be provided here GXLICENSEFEY yournumber GXLICENSEKEY c F If you want to use the installer in Console mode with a command line interface or in silent mode with no user interaction you can set this variable to one of the offered value Options are silent console INSTALLER UI silent INSTALLER UI silent Figure 20 Content of the
29. any intellectual property right including without limitation any copyright patents relating to the Products shall remain the exclusive property of Generex Generex will undertake to deal promptly with any complaints about the content of this document Comments or complaints about the document should be addressed to Generex Systems GmbH Copyright of the European Union is effective Copyright EU Copyright c 1995 2014 GENEREX GmbH Hamburg Germany All rights reserved Revision 001 011 012 013 014 015 016 017 018 019 020 021 022 023 024 025 026 027 028 History First Release Update RCCMD with SSL via UPSMAN New functions Attach log files to mail events Write raw data to file Added UPSMAN configuration without graphical interface Linux Added Multiple UPSMAN Installations Added UPS Extended Commands Added Silent Installation Added Console Installation UNIX Added Remote UPSMAN Configuration Added Threshold Events Added NTP time synchronization UNIX Added Installation configuration on WIN 2008 Server Core x64 Added Know How Pool UPSMON Windows PollRate Edit Added FAQ Added Silent Installation UPS Communication Parameter Preselection Added UPSView Description Added UPSMAN Tray Description Added Email Usage Linux OS Update UPSMON password Date 10 2008 01 2009 02 2009 03 2009 05 2009 08 2009 11 2009 11 2009 01 2010 03 2
30. battery voltage got a difference of more than 10 PRIOR of the battery test an error will be logged Advice Always execute a battery test with load Please use the nominal load which will be present in normal mode Location Enter the name or place of your server or where the UPS in installed e g Berlin Port Selecting the serial port USB port To select a serial port COM port click with the mouse on the COM check box on the right side The communication parameter will be set automatically corresponding to the in step 1 selected UPS model Normally these settings do not have to be changed by the user The COM ports are in most cases already installed and activated See in the Control Panel if the COM ports exist The baud rate mentioned here is not important for the UPSMAN the UPSMAN has its own internal baud rate settings which match the UPS manufacturer defaults e OK button and Reset to factory settings When you click on the OK button in the dialog window the new configuration settings will be stored in the registration database The UPSMAN configuration will ask you if you wish to start the UPSMAN service now If you like to return to the old pre set configuration values and to start from scratch please click the Restore factory settings button This will execute in the background the file upsman bat which resets your configuration and returns with an empty configuration page 3 5 2 Advanced User
31. book ix Ske workstation users Add Group webmaster lt webmaster generex de gt system administrator lt server room generex net gt H A UPS service office Add User supplies Delete Edit Write to File Read to File Selected item workstation users Cancel Figure 45 UPSMAN Address Book 50 The send email job can send individual emails to single receivers or receiver groups These users or groups may be defined in either the UPSMAN address book for groups or in the MS Outlook address book Click the Upsman Addressbook button and create a new group Enter a list of email addresses in this group which will receive the text message for this event if an alarm occurs The UPSMAN address book makes it easy to organize recipients into groups The read and write function allow the user to make back ups of this UPS group address book 3 6 6 Examples RCCMD Mail ID Insert Function oce OXJ Function Send RCCMD MAIL_ID to remote client Function Parameters Parameter Value ADDRESS PORT 6003 SSL Enable SSL ID RECIPIENT Enter the e mail address ot your recipient The RCCMD client will forward your e mail to this recipient Example generex qgenerex de Do immediately once Do after 0 Seconds Do Always Do after 0 Seconds repeat DoEvey 0 Seconds Do at 0 Minutes remaining Cancel OK Figure 46 RCCMD Email Example
32. data stamp event logging extensive logging of all UPS activity and user messaging Ti Battery management surveillance and counter for power events Ti SMTP compatible system with messaging service for e mail e mail to SMS or other external services a Menu for several UPS test functions such as economy mode UPS temperature battery load power socket switching and UPS emergency power off Ti Shutdown and test functions can be executed with a scheduler W Graphical display of quality of incoming power load frequency in minimum maximum or average values W Also monitors UPS systems via SNMP connection 1 1 UPSMAN double function UPS and RCCMD Server The UPSMAN module is not only reading and managing the computer where the UPSMAN is running on it is at the same time the RCCMD server to the computer which sends RCCMD commands into the network which will start the shutdown procedure on remote computers The program RCCMD is designed to execute a command on a remote system in a TCP IP network RCCMD works like the Remote Shell RSH known in the UNIX environment Inside the UPS Management Software RCCMD is used to shutdown several servers that are all powered by a single UPS For this job one of these computers is configured as UPS master server Install the UPS Management Software UPSMAN on your UPS server and connect it to the UPS Alternatively a SNMP adapter type CS 121 or compatible device can be used for this as we
33. gt default values wo UPSMAH RCCMD ver 4 0 0 7 Cancel Figure 51 SSL Configuration 53 Advanced network settings IP address and port IP to bind to 127 0 0 1 Browse for IF an Park 6003 SSL W Use secure connection 55L Cancel OF Figure 52 Advanced Network Settings 3 6 9 Examples RCCMD with own SSL certificates In this chapter we will describe how to use an own SSL certificate with RCCMD e g OpenSSL http www openssl org Be your own CA Using OpenSSL it is quite simple to become your own CA Just run CA pl newca Done Just ensure that you select a useful CN common name Create your RCCMD certificate You need to create your certificate for RCCMD now As it will use it for verification it should contain the same useful common name CN that you selected for the CA The private key must not be encrypted to let the RCCMD Client service start without trouble Therefore we use the nodes option and the newreq command CA pl newreg nodes Sign with your CA CA pl sign Now create an empty file named rccmd pem and copy the cert information of newcert pem rccmd certificate newkey oem private key and cacert oem CA into it Please note that the exact copying is required to use it without trouble Use your own RCCMD certificate Do the following steps at the RCCMD Client and every sender UPSMAN default directory C
34. l Temperature Autonomy Single Phase Capacity Single Phase Time min 100 0 Localtime 17 18 53 Servertime 17 18 53 74 Figure 23 UPSMON Statuspage of a Standard UPS without OEM Design Since there are too many UPSMON screens we can not show those all in this manual UPS Functions To execute tests of your UPS system choose UPS Functions from the menu Functions The results will be displayed in a table The outcome of the tests depend on the settings of the manufacturer Selftest is a UPS hardware check Battery Test is a short test of the UPS working on battery Custom Test switches the UPS on battery mode and will keep discharging the batteries until the downtime has passed With this command you may check your batteries to see if they are still capable of supplying your system with the downtime configured autonomy Full UPS test is a deep discharge of the batteries and is used for calibrating the battery Tests should only be carried out if no user users are active Some tests may be deactivated depending if the UPS supports those features 25 oO Note oO Attention Note Some OEM versions require the default password cS121 snmp to get access to the UPS Functions When running a UPS Full test please note not to interrupt the test as long as it is active If the test gets interrupted the software will configure the autonomy time as the time span of which the test has been running on the UPS
35. s 0 SNMP Audible settings Enable SNMP Support Beep off Beep endless Restart SNMP Service Beep 3 times 1 to 9 Figure 49 SSL Main Activation 52 The SSL network feature requires correct time settings so it is required to configure a correct time at the work station where the UPSMAN software is installed It is required to enable SSL for each RCCMD event function Click the tab Events Click on the desired event to add an accordant function Click the Insert button and select the desired RCCMD function Enable the SSL box to activate the SSL feature Function Send RCCMD SHUTDOWN to remote client Function Parameters Parameter Value ADDRESS 192 168 222 111 PORT 6003 SSL Enable SSL PARAMET Enable SSL Check this box to enable SSL Do immediately once O Do after 0 Seconds Do Always O Do after 0 Seconds repeat DoEvey 0 Seconds Do at 0 Minutes remaining Figure 50 SSL Activation of a single function Close the configuration windows with the Ok button and restart the UPSMAN service Start the RCCMD Wizard installation and enable the SSL network feature IP address list of all RCCMD servers that are allowed to send a shutdown command to this client no entry means every server Add Address Delete Address Edit Address Network settings Configure advanced network settings like IP address to bind port and SSL or use the
36. send in form of UPSMAN text message traps to RCCMD clients On the RCCMD client side the two functions Check UPSMAN alive and XRCCMD2 UNMS traps have to be activated to receive such messages When a power failure occurs e g a message box is displayed on the RCCMD client 4 UPSMAN Message me ES 2008 06 25 12 05 04 An input condition is out of tolerance gt 2008 06 25 12 05 04 UPS Alarm Powerfail GX72 detected 2008 06 25 12 05 04 GX72 UPS has detected a power failure The time which can be backed up is 110 00 minutes Figure 33 Message on RCCMD client when UPSMAN trap has been received Enable network broadcast for events This enables the NET SEND broadcast MS Messenger Service has to be enabled with alarm messages to the network If the messenger service is not running a local message will pop up automatically Use SSL as default for all RCCMD events This will activate that all RCCMD Remote Console Commands to client computers events will use SSL Secure Socket Layer encryption This requires that ALL your RCCMD clients use SSL as well Enable Local System Shutdown Defines if the system will start the shutdown routine in the event of a shutdown call from the UPS during a power failure If you disable this function no shutdown will be performed In the case of a shutdown the internal event routine will close down all active applications The shutdown of the UPSMAN computers is followi
37. shutdown proberly Defines how many minutes before the UPS battery is discharged the shutdown procedure is initiated This time interval has to be large enough to guarantee a graceful shutdown of the system before the UPS is switched off Calculate the value on a large scale e g with 10 minutes hold time of the UPS start the shutdown procedure at least 3 minutes before the discharge of the battery The following functions are not supported by all UPS types In particular devices with the connection type cable do not support a scheduled down and restore command Shutdown UPS UPS shutdown delay UPS restore delay 94 Defines if the UPS will be turned off on completion of the server shutdown procedure This command will turn off the UPS before a complete discharge of the batteries Defines how many seconds after beginning the shutdown procedure see Downtime that the UPS will turn off Defines how many seconds after turning off the UPS the system is turned back on again For most UPS types it is necessary that the power has been restored before the UPS has completely switched off Enable fixed shutdown Defines if a shutdown needs to be initiated after a power fail independent from the remaining time of the UPS and the configured system down time Fixed shutdown delay Defines after how many minutes a fixed shutdown should be initiated The basic configuration is now complete Exit the menu ESC and leave config to
38. software fails to start Error Errorname Description code 2 ENOENT No such file or directory This happens if the device name is not found The reason can be a missing colon at the end of the device name 5or6 ElO No such device or address l e the device name ENXIO exists but the physical device does not E g the device name is dev ttyS2 but the computer has only 119 two serial devices 22 EINVAL Invalid argument The serial port driver of the UNIX system does not support a function call the UPSMAN programm 25 ENOTTY Not a serial device Please choose a device name which is not a serial device G Cable types For UPS communication cable please refer to GENEREX website download documentation or contact you UPS maker H Picture catalog Figure 1 UPSMAN and RCCMD in a network environment cccssssstsssssssteesetseeeeeeees 7 Figure 2 INTFOOUCTION raii a a a a A E EE I ER REA 10 Figure 3 Enter your License Key sssssssssnessrnnrnrrrerrreressrrrrrrtttrrrtrresrrnnnnrrreeresrrnnnnntttrreeene 10 Figure 4 Thirty Day Trial Version without Key Code ssssssssssssessserrrnrrnnnnrenssnrrrrnnrnnnnnene 11 Foure S License Agreement cre a a a a 11 Figure 6 Choose Install Fold r ncns a E Er EEr Eie 12 Figure Choose INSTAll Seisan 12 Figure 8 Choose Shneur Folder rraioa Aaea AEREA 13 Figure 9 Pre lnstallation Summary steaesd eet cetlec cation tie ATEEN 14 Figure 10 Firewall Configuration
39. the local system time against another server ensuring nearest possible time is available before configuring the NTP server bash ntpd b If failed try the following command bash ntp b 113 File Edit View Scrollback Bookmarks Settings Help Linux f26 ifconfig eth2 Link encap Ethernet Headdr 00 6C 29 57 EC 55 inet addr 192 168 206 60 Bcast 192 168 206 255 Mask 255 255 255 0 anet6 addr feB0 20c 29ff feS7 ecSS 64 Scope Link UP BROADCAST RUNNING MULTICAST ATU 1500 Metrac 1 RX packets 594 errors dropped 6 overruns 6 fram 0 TX packets 441 errors 0 dropped 6 overruns 0 carrier 0 collisions 0 taquevelen 1600 RX bytes 244373 233 6 Kb TX bytes 50308 49 1 Fb Interrupt 19 Base address 0x2024 Link encap Local Loopback inet addr 127 0 0 1 Mask 255 0 0 0 anet6 addr 1 128 Scope Host UP LOOPBACK RUNNING ATU 16436 Metric 1 RX packets 70 errors 0 dropped 0 overruns 0 fram 0 TX packets 70 errors 0 dropped 6 overruns 0 carrier 0 collisions 6 txquevelen RX bytes 4364 4 2 Kb TX bytes 4364 4 2 Kb limuz f35j ntpd b Linux f36 i Figure 97 Bash ntpd b Make a backup of the original file etx ntp conf bash cp etc ntp conf etc ntp conf original Edit the configuration file and do the following changes bash vi etc ntp conf The following declarations into the etc ntp conf file are required 114 Finding a Time Source The de
40. time h 8 Date of Battery Installation DD MM YYYY 04 03 2011 Set Battery health level in Device Port lusb Baudrate UPS ID 0 Restore Factory Settings c 2001 2011 GENEREX GmbH Hamburg Advanced User Cancel Figure 73 Advanced User Device Page T9 4 4 2 Advanced User Menu SYSTEM Page Beside the UPS configuration page more pages will appear if you click the Advanced User button All configuration data in the menus have tool tips in the corresponding language Every menu feature will be explained online following we start to describe the SYSTEM page of UPSMAN JUPSCFG UPSMAN Confi guration Device System Files Events System Upsmon Password UPS Check Rate s 5 UpsmanHTTPPo 8081 System Shutdown Enable Local Shutdown Down time m 7 C Initiate Shutdown al after m on battery UPS Shutdown Enable UPS Shutdown UPS Down Delay 5 18 UFS Restore Delay so Advanced User OK Cancel Figure 74 Advanced User System Page 76 e UPSMON Password Default no password The user may enter here a password which will be requested whenever any UPSMON or other graphical interface tries to connect e UPS Check Rate s Defines the timing in seconds of the polling data from the UPSMAN to the UPS The system will be slowed down if this value is too sma
41. user may open the event to see which jobs are already configured Now the user may add extra jobs or actions to this event The most important event is Powerfail here the ukakaa user has to configure which RCCMD lt gt Treshold events clients are to be triggered in case of Advanced User alarms In addition it is possible to define BO Threshold Events for the variables Battery Voltage Seconds On Battery Battery Autonomy Battery Charge UPS Temperature Input Voltage and Output Load Please also check the following chapters of the manual ery UPS Battery bad Figure 37 UPSMAN Event Config 40 Threshold Event Definition Variable Direction Threshold Seconds on Battery Battery Autonomy m Battery charge UPS Temperature Input voltage P N Output load ee der to configure the event click on the Device System Files Events designated event and the Event Jobs list SS opens For every event there are pre Powofas vevien settings most of them are log file entries Seg tenes and RCCMD messages as traps In the abo eis example there are three jobs configured for eine eee the event Powerfail 2 jobs will send out ae Eoad savess RCCMD Test standard text messages can be edited in oa os ee the Message dat file whereas the 3 Battery low eee event
42. writes a message into the log file In Shutdown 0 Reset oo eel order to add a job please click the Insert Test failure 0 Reset button and the following functions page opens misrani toe ox l rd The Reset buttons below are to reset the alarm counters of UPSMAN visible in the Figure 38 Advanced Buttons UPSMON or other graphical viewers statistical information since the software has started Function Choose the desired function and set a ae timer and define when and how often this Function Parea ith tex Start Alam Boaper wih Messagebox function should be executed Any event Paramet Send default message IDs from file messages dat Execute Program H H Send RCCMD SHUTDOWN to remote client th at contal ns a d el ay WI Il be exec uted Send RCCMD WAKEUP to remote client Send FCCMD EXECUTE i cs ad Send RCEMD MESSAGE ID to remote client ONLY if the alarm is still valid when the Send ACCMD MAIL ID to temoto clent timer has run out E g if you configure to Do nothing Send RICEMD LOG ID to remote cient gt trap x P Send RECMD trapmessage by ID this job will be executed ONLY if the send eMail RE Wits tao avort vaner powerfail is still the case after the 30 sec Send a Shutdown UPS Signal epee cord wake On LAN signal i have run out If the power has returned at Boe Be ee eee 29 sec nothing will happen DoEvey 0 Seconds Do at 0 Minutes remaining Figure 39 Insert Functions
43. 010 06 2010 07 2010 11 2010 01 2011 03 2011 04 2011 06 2011 08 2014 01 2015 Table of contents 1 What is the UPS Management Software 1 1 UPSMAN double function UPS and RCCMD Server 2 Quickstart Installation Configuration UPS Software 2 1 Preparation of the Installation 2 2 Windows 2000 XP 2003 VISTA 7 2008 UPSMAN Installation 3 Start Installation Basic configuration of UPSMAN 3 1 Settings of the Authorization of the UPSMAN Service 3 2 Silent Installation of the UPSMAN Installation 3 3 UPSMON for Windows 3 4 UPSVIEW for Windows 3 5 Advanced User Windows UPSMAN Configuration 3 5 1 Advanced User DEVICE Page 3 5 2 Advanced User Menu SYSTEM Page 3 5 3 Advanced User Menu FILES Page 3 5 4 Advanced User Menu MAIL SERVER Page 3 5 5 Advanced User Menu EVENTS Page 3 6 Avanced User Special Tools and Configuration Advices 3 6 1 Advanced User UPSMAN Debug and Line raw Tools 3 6 2 Email to SMS 3 6 3 Save amp Load Configurations 3 6 4 Examples Execute Program with Parameters 3 6 5 Examples Send Email Function 3 6 6 Examples ROCCMD Mail ID 3 6 7 Examples Send RCCMD execute to remote client 3 6 8 Examples RCCMD with SSL via UPSMAN 3 6 9 Examples RCCMD with own SSL certificates 3 6 10 Examples WOL Wake On LAN 3 6 11 Examples Scripting 3 6 12 Start Options of the UPSMAN Module 3 6 13 UPS Management Software for WIN 2008 Server Core x64 4 Unix amp MAC X 4
44. 3 07 22 15 UTC 2008 1 Hay 4 15 44 08 linux f36j ntpd 28157 precision 1 000 us Way 4 15 44 08 linux f36 ntpd 28157 ntp tov estimated max descriptors 1024 initial socke 16 Way 4 15 44 08 Linux f36 HE Listening on interface 0 wildcard 0 0 0 0 123 Disabled May 4 15 44 08 linux f36j 28157 Listening on interface 1 wildcard 123 Disabled May 4 15 44 08 Linux f36 nt 157 Listening on interface 2 lo 1 123 Enabled Hay 4 15 44 08 linux f36j fitpd 28157 Listening on interface 3 eth feg 20c 29ff fe57 ec55 123 Enabled May 4 15 44 08 Linux f36 ntpd 28157 Listening on interface 4 lo 127 0 0 1 123 Enabled Nay 4 15 44 08 Linuz f36 ntpd 28157 Listening on interface 5 lo 127 0 0 2 123 Enabled May 4 15 44 08 Linux f36 1 Listening on interface 6 eth 192 168 200 66 123 Enabled Hay 4 15 44 08 Linux f36 kernel tim syne status 0040 May 4 15 44 08 Linux f36 Frequency initialized 3 749 PPM from var lib ntg drift ntp drj May 5 69 45 32 Linux f36 ntpd 28184 atpd 4 2 4p5 1 1541 0 Wed Dec 3 07 22 15 UTC 2008 1 Hay 5 09 45 32 Linux f36 ntpd 28185 precise May 5 09 45 32 Linux f36 ntpd 28185 ntp_io estimated max descriptors 1024 initial socket boundary 16 Hay 5 09 45 32 Linug f36 ntpd 28185 unable to bind to wildcard socket address 0 0 0 0 another process may be running Ex CITING May 5 10 30 27 Linux f36 kernel type 1505 auditi 1273048221 584 16 operatiore profile_Load
45. Advanced User DEVICE Page The configuration window is opened automatically and the user has to choose the correct UPS model manual startup of configuration UPSMAN CONFIG This is the most important part of the configuration because with the model name the correct UPS RS 232 USB protocol is linked If a wrong model is chosen from the list the UPSMAN can not start If you would like to enter the configuration at a later point in time you may do so by logging on as administrator and click on UPSMAN configuration from the program group UPS software This icon is only available from the user account from which the installation was performed in the first place default From other user accounts the configuration can be started from the command line calling upsman_config in the UPSMAN folder Automatic start at server boot The default of every UPSMAN is to start automatically at every new server boot If you want to change this go to the control panel services and mark the UPSMAN Service under Start You can now change the start up now from automatic to manual Selecting the UPS Model To select your UPS model click with the mouse on the scroll box symbol on the right side of the model list Next choose the UPS model that you want to install All other adjustments which correspond with your selected UPS model will be done automatically if the UPS has serial or USB communication We recommend NOT to change the default sett
46. B Serial Adapter with UPSMAN on MACX Use the Ray ecan Keyspan Serial Assistant Serial Assistant to eT a display the Serial Ports name stub of 7 8 1 USA19 the serial port on the Keyspan product You can find the Keyspan Serial Assistant in the Program Group on your Mac Be sure to use the last displayed name in the list The name of the serial port in our example screenshot is KeySerial Depending on ssi ies _ 5 your Keyspan MMMM Ties laa 2 product the macintoshi generex ls dev KeySerial E serial port fdevcu keySeriglt or dev tty key5eriall name maybe macintosh generex jj be extended by additional characters To display the real device name that is used by your Mac Opena Terminal windows and execute the following find command KeySerial sie EF dev Key Serial This will display a list of the Keyspan port s on 69 Now type the JPSMAN C device name H from above in the Port Device Configuration Device field in our gt example dev cu Ke em La Search UPS _ ZINTOA1000 F serial Click the OK button to save the configuration and restart UPSMAN to listen on this sos o Port i DD MM YYYY 22 02 2008 c fo ae Restore Facto Settinc S Advanced User USB interface If you want to use an USB interface just enter USB into the Port ar
47. ER for list execute at remaining time m 4 Extra Job 1 Path usr ups ups_exetl Enable Extra Job 2 no lt ENTER for list execute at remaining time m 4 Extra Job 2 Path usr ups ups_exeZ Enable Extra Job 3 no lt ENTER for list execute at remaining time m 1 Extra Job 3 Path usr ups ups_exe3 ESC Exit Screen E Root Shell Figure 82 Defining Paths ups_conf Advanced User Set Event Parameter The UPS Events enables the user to utilise and configure the different applications of a UPS Depending on the matter of use via Events Event messages of the UPS certain actions Jobs can be executed with the UPS Management software Via an Event it is possible to transfer measured values status messages to own processes in order to process those even further e g load statistics etc The Event configuration starts from the UPSMAN configuration See picture G Root Shell Konsole Session Edit View Bookmarks Settings Help UPSMAN Configuration Set UPS values Set System values Set Job values Set Path values parameter Save Configuration amp Exit Exit E Root Shell Figure 83 UNIX ups_conf Events Menu In this part of the configuration the event parameter will be configured The user can now choose a event which needs configuring See picture below Which Events are configurable depends on the type of UPS The standard messages which can be
48. Instead of the a respective machine name e g Workstation1 must be entered In order to send messages to several users a Send Message job must be inserted per user Please note that the Windows NT user database is not empty and that the computer belongs to a domain as otherwise the network messages can not be sent RCCMD remote console command is a program used for the execution of executable files via network This tool transmits a TCP IP signal that is absorbed of the recipient module RCCMD client software on another computer This function is normally used for sending a shutdown command call of shutdown bat over the network to another computer of any supported operation system starting from CD 4 17 From RCCMD Version 2 0 it is possible to use Send eMail Send RCCMD EXEUTE to remote client Execute Program 99 the wildcard or other syntax For example 192 255 255 255 will send the signal to all computers in the corresponding subnets A RCCMD s a 192 168 200 255 will send the signal to all computers in the subnet 200 The entry of a IP address or hostname will send RCCMD only to those named If it is required to shutdown more than one client additional event jobs can be configured Hint If the number of the additional RCMD clients is too high a batch file which contains the RCCMD s commands can be used instead This much faster and also easier to handle than the a long list of event job list Thi
49. Jan 8 06 25 28 ALIX1D 2 kernel 664692 312727 usb 1 4 usbfs process 27300 upsman did not claim interface 0 before use Solution Proceed as follows to discard messages from syslog Creat the file var log messages 01 blocklist conf Add the line msg contains upsman Restart syslog with etc init d syslog restart Problem with Ubuntu 10 04 syslog messages Since Ubuntu 10 04 rsyslog is used instead of plain syslog Solution Proceed as follows to discard messages from syslog Create the file etc rsyslog d 01 blocklist conf the 01 part into the filename forces rsyslog to load this config prior it loads anything else Add the line msg contains upsman the lines into the file find any messages containing the text you want to ignore and discard those messages right away Restart rsyslog with etc init d rsyslog restart Problem with the installation of multiple UPSMAN services on one PC Information We do no longer support it 05 2011 Problem with the installation on a 64bit UNIX OS Solution If the installer is not running on a 64bit Debian Ubuntu GNU Linux system it is required to install the compatibility libraries with the following command sudo aptitude install ia32 libs If the installer is not running on a 64bit Fedora 12 GNU Linux system please do the following Open an editor create a new file called install and copy the following lines into it 1 bin sh libs 32 libXext i686 lib
50. P address This bat file is pean configured to start programs on the remote H SSL Enable SSL machine Additional Parameters can be entered here In this example the execute bat file will be executed at remote client IP address 192 168 202 156 at port 6003 The entry made in the parameter field will be sent Do immediately once D Doafter 0 Seconds Do Always D Do after 0 Seconds repeat from UPS MAN aS a parameter to DoEvey 0 Seconds Do at 0 Minutes remaining execute bat and in this way my Goma 0K program exe is started Figure 48 RCCMD Execute Example 3 6 8 Examples RCCMD with SSL via UPSMAN The Secure Sockets Layer SSL protocol is a cryptographic protocol that provides security and data integrity for communications over TCP IP networks Open the UPSMAN configuration Click the Advanced User button on the lower left side then the tab System and enable the Use SSL as default for all RCCMD events box svan ooo eS Device System Fies Mail Server Events System UPSMON Password UPS Check Rate s 5 Upsman HTTP Port 8081 V UPSMAN RCCMD2 traps enabled Message Port 960 V Enable network broadcast for events V Use SSL as default for all RCCMD events System Shutdown V Enable Local Shutdown Downtime m 3 E Initiate Shutdown always after m on battery 5 UPS Shutdown V Enable UPS Shutdown UPS Down Delay s 180 UPS Restore Delay
51. PSMON versions and the UPS VIEW Webinterface have an inbuilt Scheduler interface to program actions on the remote UPSMAN This Scheduler interface is in both applications identical and allow to execute UPS tests or regular shutdowns on certain days or time settings Following a screenshot of the Scheduler in Windows the UNIX version is identical to this When connecting to your UPSMAN you can choose SCHEDULER If you have password on your UPSMAN configured a password request will pop up After this you will receive a scheduler screen similar to the one we show below UPS Monitor of x File View Chart Functions Help A serer Moget TRMD Locator i Vrime cS al eela ale s CountPr _0_ er _o_ so o Status Chart Efel Input Volt R Input Volt Input Volt T La a 170 280 ill Fi Scheduler Everyday 20 14 Daily Batterptest active Batteytest x Si wd Entry Load Phase T Delete Entry ia 100 Edit Entry Local time 20 14 17 1 9 Servertime 20 14 22 Refresh Battery Capacity 100 Cancel Ok Encel 999 min j 29 C l 100 0 PE gt we z UPS STATUS Normal Localtime 20 14 17 Servertime 20 14 22 74 Figure 22 Scheduler in UPSMON interface to program actions on your UPSMAN The scheduler allows you to add new jobs which will be executed at the programmed time The UPSMAN logfile will show after the job has been executed about t
52. Please check in the event log if this function is properly started A message SNMP 37 communication could not be started shows that an error occurs No message means that this function is working To install SNMP service add this software function via Microsoft additional software installation e Restart SNMP Service This will activate a stop start of the SNMP service under Windows This function avoids start problems of the UPSMAN agents using older or not maintained systems e Audible Settings You can define the audible settings of the UPSMAN message box Beep off Beep endless Beep 1 to 9 times 3 5 3 Advanced User Menu FILES Page Device System Files Mail Server Events V Attach logfiles to Mail Events Event Logfile Filename upslog csv Logfile max Size kB 200 Data Logfile Filename UpsData csv Enable V Logfile max Size kB 1000 Update Rate s Debug Write raw data to file Figure 35 UPSMAN Files Configuration Attach log files to Mail Events Enable this function if you want to attach the upslog csv and the UpsData csv at all emails that will be send by the UPSMAN e Event Logfile Filename upslog csv is the name of the event alarm text protocol The default is a MS Excel compatible CSV file format Status Dump writes regularly approx every 10 minutes the current UPS status into the text log file 38 e Data Log
53. S reseller 3 4 UPSVIEW for Windows The Unix WEB SERVER offers the possibility to display all UPS data with a platform independent WEB Browser In order to establish a connection from a WEB Browser to a UNIX WEB SERVER please enter the IP address and a port number Example http 192 168 202 91 8081 Port 8081 is used as a standard at the start up of the server Enter the following into a web browser if you want to get a remote connection to an UPS http IP address of the UPSMAN server 8081 cgi bin ups_view exe ups_view uly Favoriten 33 Web Slice Katalog v UPS View Web client MULTI DIALOG MDM10 L1 225 V 50 0 Hz 30 V Temp 21 0 C Log file Functions Scheduler Figure 27 UPSView Remote Access Via the Log file button you can get the Data or rather Log files 29 Log Files Windows Internet Ex i i http 192 168 200 50 8081 logfile htm Data file Log file Internet Gesch tzter Mo fa 100 v Figure 28 UPSView Log File Via the menu Functions you can execute UPS tests E Test Functions Windows Internet Explorer b http 192 168 200 50 8081 cgi bin ups_view exe logon getUPS Battery Test Cancel Test Self Test Full Test Bypass Test Get Test Result Last Results Self Test Battery Test Full Test Bypass Test Current Test amp Internet Gesch tzter Modus Inaktiv fg v 10 v Figure 29 UPSView Func
54. Select Message ID Ex Jj Message SERVER USY hat einen Stromausfall erkannt Die al USY Alarm Stromausfall bei LOCATION SERYER USY Stromversorgung bei USY LOCATION SERVE Sichere Dateien und fahre das System SERVER her USY LOCATION RS232 USB Verbindung gestoert USV LOCATION RS232 USB Verbindung wiederher US LOCATION Batterien sind zu alt US benoetigt USY LOCATION Ueberlast Alarm WA Fe ores oe DOF asese me he eee Dem ree I Cancel Figure 47 Message ID Example 51 With this function an email will be send from the RCCMD client as relay Instead of an individual text a pre defined message ID will be send Enter the IP address or hostname of the RCCMD client which you want to relay this email Enter the port parameter into the field PORT The standard port is 6003 for receiving RCCMD signals The message ID can be selected by clicking the Browse button see next figure This function may be useful if the UPSMAN computer is not able to send emails directly Using an RCCMD client as relay solves this problem Using an editor you can modify message IDs in the default messages dat file 3 6 7 Examples Send RCCMD execute to remote client Insert Function x iio Sib This action initiates the execution of a Function Send RCCMD EXECUTE to remote clien v g i l l mn batchfile execute bat on a defined remote aN IY RCCMD client I
55. Template Terminal Hardwired was Detail Basic More bii Baud Rate 9600 _ F Service Enable Terminal Type f Options f nitialize Only Login Prompt ogi tts lt sSS _J Bidirectional SOE bc a Service Tag ttyb Port Monitor Tag zsmon Software Carrier Expert Options j Create utmp Entry Service ust bin lagin Idterm ttcompat _ Connect on Carrier Streams Modules p Timeout secs Never OK Apply Reset Cancel Help Figure 91 Example Settings SUN Solaris 2 6 2 7 TTY configuration UPSTCP This program connects the remote Windows or Java UPS monitoring software using the local UPSMAN program It must be started if the you want to connect with the UPSMON software to UNIX controlled UPS This can be done within the ups rc startup script The upstcp program is based on the TCP IP network protocol Any UNIX system has these protocol implemented there is no need to install TCP IP separatly UPSTCP has to be started if UPSMON for the graphical UPS monitoring is used CS122 Network Adapter When using the an older CS122 UPS network adapter instead of the serial port of the UPS the following procedure must be followed Set the IP adress of the CS122 using ar webbrowser or telnet as described in the Quickstart set up for the CS122 Start ups_conf Go into the Set UPS values screen Replace all of the values in the field COM port Options uptil the colon with wit
56. UPSMAN as follows Green Output Active ECO Mode Yellow Bypass Mode UPS Test Active Inverter Warning Overtemperature Input High Output High Inverter Failure Battery Bad Red Backup Mode Battery Low Shutdown Active Grey Communication Lost UPS Status f UPS Status Output active FY Output active Backup mode 16 05 11 09 2012 a BW DFi 11 09 2012 Figure 11 UPSMAN Tray Icon Status In addition from UPSMAN tray version 1 0 0 7 the UPSMAN tray provides a context menu with the following features e About Opens the UPSMAN tray window with its version number copyright e UPSMAN Configuration Start of the UPSMAN configuration directly e Start UpsView Start of the UpsView directly e Close UPSMAN Tray Close UPSMAN tray Abouk UP SMAN configuration Stark Ups view Close UPSMAN Tray 12 095 201 Figure 12 UPSMAN Tray Context Menu The USB support of your UPS depends on the hardware interface In some cases HID compatible interface no additional driver is needed since HID is already part of 15 Windows and Linux In all other cases you receive a USB driver eg LibUSB driver with the UPSMAN software which is installed separately or you receive a USB 2 serial driver which creates a new virtual com port on your system The difference between an USB and an USB 2 serial driver is that using USB driver you use USB as communication port in UPSMAN and with USB 2 serial dri
57. URSES based configuration tool ups_conf This tool has a different look and feel compared to WINDOWS so we describe in the following this tool and not the JAVA based configuration NOTE ups_ conf is not longer supported since CURSES libraries do not exist on most modern UNIX If your system does have a GUI nor supports CURSES you may configure your UPSMAN via a network computer eg Windows with a Webbrowser and JAVA runtime The software is now extraced and installed the basic configuration of UPS model and interface is the next step ups_conf Basic Device Configuration 89 As described in Step 6 the grafical configuration is identical to the Windows UPSMAN configuration described in this manual and is self explanatory In the following pages we focus only on the older CURSES based version ups_conf which is no longer supported but may be needed if no graphical interface is present of if you configure a no longer supported OS version of UPSMAN After a successful extraction through the installscript install the UPS Management Software tries to start the graphical configuration JUPSCFG if this fails and you can not use any other computers Webbrowers to connect to this UNIX machine HTTP lt IP address gt 8081 you may fall back to the configuration tool ups_conf which is found in the target installation folder default usr ups You can start this tool again by typing
58. Version 2014 08 11 UPS Management Software UPSMAN UPSMON UPS View UNMS User Manual Copyright Statement for Intellectual Property and Confidential Information The information contained in this manual is non conditional and may be changed without due notice Although Generex has attempted to provide accurate information within this document Generex assumes no responsibility for the accuracy of this information Generex shall not be liable for any indirect special consequential or accidental damage including without limitations lost profits or revenues costs of replacement goods loss or damage to data arising out of the use of this document Generex the manufacturer of the BACS products undertakes no obligations with this information The products that are described in this brochure are given on the sole basis of information to its channel partners for them to have a better understanding of the Generex products Generex allows its channel partners to transfer information contained in this document to third persons either staff within their own Company or their own customers either electronically or mechanically or by photocopies or similar means Generex states that the content must not be altered or adapted in any way without written permission from Generex It is agreed that all rights title and interest in the Generex s trademarks or trade names whether or not registered or goodwill from time to time of Generex or in
59. Xtst 1686 libstdct i686 tor lib in libs 32 do yum install Slib done Call the command as root to install the required 32bit libs 106 terminal install Problem No communication possible to APC UPS SURTD from 2011 Solution This UPS model communicates with a proprietary protocol It is required to use the APC slot card Legacy AP9620 for the establishment of a communication Problem Mount of USB stick via command line Solution Change into the directory dev Execute Is There you will see the connected devices Note the devices like sda sda1 Connect your USB stick Execute Is again into dev Now you should see more entries under sda My stick got the entry sdc1 Enter the following mount dev sdc1 mnt Use this command on FreeBSD OS mount_msdosfs dev da0s1 mnt usb Execute Is lisa Now you should the folders of your stick Change into the accordant directory cd mnt name of the folder which contains the installation data Extract the the upsinst tar file tar xvf upsinst tar Execute the binary file installupsman bin Problem The UPSMAN Message Box does not appear in the front Solution Click on the warning triangle icon with the right mouse button and select Always on top Verschieben x Schlie en e nicht fur Installationen beim Always on top Figure 89 qblat Debug 107 Appendix A Supported Systems The UPS Management Software supports all c
60. and Window ccccccssssceceeeeeeesenneeeeeeseesnneeeeeeeseees 26 UPSMON Extended Commands Window eeceeeeeeeeeeeeeeneneeeeeeeeeeneeeeeeeeneas 27 UPSMON Programmable Outlet Settings Window ccccccceeeeesseeeeseeeeeeeees 27 UP SV ISWARSMOlG ACCO SS oain ite beet 29 UPS VEW Log File Secs seceeecee aes ee oe eae al ae aan 30 TS VIS WW Fe UNCON aiina ce a ease octet alates ca anesioe camer E 30 LIPS VICW SCIOOUIGK poscies 555i atn a a andes a neue bods tunes E ETS 31 UPSMAN Device Configuration ssesseeseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeesees 33 UPSMAN System Configuration sesseesssseeseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeseeeeees 35 Message on RCCMD client when UPSMAN trap has been received 36 Windows UPSMAN Shutdown Sequence Configuration ccccccceeeeeseeeeeees 37 UPSMAN Files Configuration sssssessesssesseeesesesseeeeeeeesessesseeeeseeeeeeeeess 38 UPSMAN Mail Server Configuration ssssessseesseeeeeeeeeeeseeeeeeeeeeeeeeeeeeees 39 DIP SMAN Event CONG derina a E ed eed 40 Advanced IT ING nns ans AA aa 41 IS CVE FUNCUOMS ppano a aA 41 Load SAV SU OS anra E 47 Meer ODsINS UG HONS rasire inini e E E E EE 48 Execute Proga een E 48 Laststat File using a Text EdItOr iisiriiicisraiiinis ania a a a e 49 Send Email Config rati N esena arena nen aaraa EAA Ea AAAA a AAAA RA AAE ATA AAAA RA Eaa TA 50 WPSMAN Address
61. as wildcard to shutdown complete segments e g 192 168 202 255 will send the signal to all computers in the network 192 168 202 0 to 255 RCCMD can be used as client receive a signal and a server transmitting a signal So the syntax to send a shutdown signal to a specific computer is RCCMD s a 192 168 200 201 This example will send a shutdown signal to this IP which will be executed if on this IP also an RCCMD client is running and the sender is in the valid address list of senders The entry of a IP address or hostname will send RCCMD only to those named If it is required to shutdown more than one client additional event jobs can be configured Note If the number of additional RCCMD clients is very large a batch file which contains the RCCMD s commands can be used instead rccmd relay This allows you to send rccmd calls much faster and is easier to handle than the executing of a long list of jobs by the UPSMAN Such a scriptfile can be executed from the Special or Events Execute Program functions Please note that RCCMD shutdown calls should always be configured in the UPS Battery low without any further delay Send email Sends an individual email text at this event Enter an email address and the corresponding text into the field Please note that you need a configured SMTP server on the UPSMAN computer sendmail is the email program which is triggered by UPSMAN email configuratio
62. ased install version is found in chapter 4 4 6 of this manual ATTENTION If you got an OS without grafical interface please take a look into the FAQs how to mount a USB stick INSTALLATION via CD Open your CD ROM folder and click the start html HTML file starts a web browser button Enter your license key See below where to find it 60 Be UPSS81_14 Dolphin JOG re File Edit View Go Tools Settings Help s Window Help Back gt Forward Up ss Icons Details Columns W Preview Split 5581_14 start html Places gt UPS581_14 Information ey Sj Home Network DRIVERS Recmd Upsman Root X Trash B PAA autorunint SETUPICO EAEN ful Floppy Drive start html his Installation CD Type HTML document your license key Size 2 2 KiB Modified Friday August Key a 13 2010 11 47 am start html selected 2 2 KiB a Figure 57 CD ROM Folder Click into the download menu the UPSMAN Suite button and select the accordant operating system Unix UPSMAN Suite Installation jstallation enue UPSMAN Suite RCCMD Agents i Kaanane UNMS II Free UPSMAN Suite for Linux ONN OT a Y UPSMAN Suite daemon for HPUnix SS n e UPSMAN Suite daemon for IBM_AIX lt l SOLARIS UPSMAN Suite daemon for Solaris Figure 58 Download Menu A tab will appear on the upper left side with your OEM ID UPS inverter rectifier accumulator manufacturers number This n
63. ates the execute bat on a defined RCCMD remote client IP address Through this function the UPSMAN can execute any command on the remote computer if the correct path and name of the program is known on this remote computer with RCCMD running In this menu the user can send an ID from the messages dat to other users These IDs are pre defined text messages Open the file message dat to see the default text of such messages Text entries can be altered with an editor The edited text is then given out ina textbox at the remote client This is useful if you want to send a messagebox from Windows UPSMAN to a UNIX system the problem of sending messages to different operating systems can be solved through this This function displays a message box with an audible warning on the screen of the UPSMAN computer Similar to RCCMD message ID a message ID is send which is then forwarded from the RCCMD client as an email to the corresponding receivers This is useful if the UPSMAN computer for any Send RCCMD MAIL TXT to remote client Send RCCMD LOG TXT LOG ID to remote client Send RCCMD MESSAGE ID or TEXT to remote client Execute Program Write to Log file UPSLOG CSV Send default messages IDs from file messages dat Write to MS Event Viewer 44 reason can not send emails directly than the remote client can do this job The user can pick on of the default text messages as ID no from the file message dat or us RCCMD
64. before it has been interrupted A test can be re started after a 8 hour waiting period A manual reset is possible by starting the upsman bat Pe device Functions E Battery Voltage Full UFS Test Custom Test Battery Test Extended Cmds HHL Result Figure 24 UPSMON Device Command Window UPS Extended Commands Outlet switching You can program the switching of the outlets or manually switch on or rather off the outlets into the menu Extended Commands vase 26 Not every UPS supports this option File View Chart Functions Help soner Moder PNCI21WA Locatons upime 0Daye 00 1550 jS al Aea ale Bil CountPF 0 Bi o so 0 Q Event Chart Date fme Be s 08 07 2009 12 06 USV Status Normal 08 07 2009 12 06 Information Verbindung zur USV hergestellt EF Status Chart z j Load Curr Bi Autonomy Single Phase ime min Restart System Switch off RESTART will switch off UPS load offion Switch will switch off UPS no restart Programmable Outlet Settings Configure the programmable outlets n 4 i n b Figure 25 UPSMON Extended Commands Window Click the Programmable Outlet Settings button for the configuration of the Outlets Programmable Outlet Settings Programmable Outlet 1 Turn outlet ON after UPS is on Seconds 0 3600 Tum outlet OFF after AC failure fo Seconds 0 3600 Tum outlet ON after AC recovery f
65. ccccccccecceeeeeceeseeeeeeeeeeaeaeaeaeeeaaeaaeaaaaaeaaaaaaaes 64 Figure 6s Installing WP SWAN eee read eid ceeded 65 Figure 66 UPSMAN Start Selection cccccccccesessessssessneeeeeeeeeeeeeeeseeseeenaeeeeeeeeeeesesssseeaas 65 Figure 672JUPSGCFG AUth ONiZatiOn syan a N 66 Figure 68 JUPSCFG UPSMAN Configuration Device Page ccceeeeeeeeeteeeeeeees 66 Figure 69 Select UPS Model Page call startupsman config for reopening this page 67 Figure FO USB COMNGUEAN ON sa E E E ETE EiS 71 Figure 71 Content of the installer properties ccccccsssssecccccesseeeeecseeaeeceeeesseaeeeeeesseaees 72 Figure 72 Protect 3 33 UPS Webinterface ccccccccccccccceceesseeeeeeeeeeeeseeeaeeaaeaeeaaaaaaaaeaaaaes 74 Figure 73 Advanced User Device Page ccccccccccccccecceeeenseensseeseeeeeeaeaeeaaeaaaeaaaaaaaaaaaaas 75 Figure 74 Advanced User System Page cccccssessssseeeeeeeeeeeeeeeeeeseseesnaeeeeeeeeeeeeesseessaas 76 Figure 75 Advanced User Files Page ccccccccccccccceecsnseneesseaseeeeeeeseeeeeeaeeaeaaaeaaaaaaaaaaes 78 122 Figure 76 Advanced User Events Page cccccccccccccccceceeessssseseeeeeeessaeeeeeaaaeaaaaaeaaaaanaaaas 80 Figure 78 Error message Java plugin cccccccccccecceececeenseeeeeeeeeeeeeeeeeeeeeeeeeeaeeeaeaeeaaaaaaaes 85 Figure 79 Java Control Panel Security Settings ccceceeeeeeceeeeeeeeneeeeeeeeeeeeeeeeeeeeeeas 86 Fi
66. ck the Next button and choose the install set Install Set Complete b Description Upsman is a system service that communicates with the UPS via RS232 USB or SNMP This feature provides the basic functionality of UPS management SE EEE a e Figure 7 Choose Install Set In the Install Set menu you can choose the following modules Ti UPS MANAGER UPSMAN This is a background process UPSMAN the core of the system The UPSMAN is the service which maintains the direct UPS RS 232 USB or network connection with the computer and the UPS 12 Ti Support Tools This is the UPS Monitor Software It is used to display a graphical visualization of the data the UPS manager provides This feature and the gchart software are disabled by default and will not be installed automatically W ups Viewer UPSVIEW The webinterface of the UPS accessible through Webbrowser It shows the most important UPS data and alarms Ti Help files are provided with the software basicly its the user manual which you are reading here and some extra informations which may be added from time to time In next menu you can choose to create a new program group default or to choose icons elsewhere or not at all Where would you like to create product icons In a new Program Group Generex Management Software In an existing Program Group NETpower Management
67. corresponding to the search requests please pick the right model from the list and confirm with OK Runodetectnng Geneeean Lx Searching USB and i COM ports for connected Lat UPS device Current port COM1 During the auto search process this box will appear you may stop the search at anytime and choose the UPS from the drop down list manually to speed up the process Device 7 Model Search UPS No UPS model defined v MSRT PRO 1kVA r Location MSRT PRO 1kVA 1Batt MSRT PRO 1kVA 2Batt MSRT PRO 2kVA MSRT PRO 2kVA 1Batt MSRT PRO 2kVA 1Batt XL MSRT PRO 2kVA 2Batt Power VA Load VA MSRT PRO k amp VA 2Batt XL Date of Batten MSRT PRO compact kVA MSRT PRO compact 2k A 1Batt MSAT PRO compact 2k VA 1Batt XL fp e MSRT PRO compact 2k VA 2 Batt SRT PRO compact 2k VA 2 Batt XL Port MSAT PRO 3kVA 400 j MSRT PRO 3kVA 1 Batt MSRT PRO 3k VA 1Batt XL Address MSRT PRO 3kVA 2Batt 3763 MSRT PRO 3k VA 2Batt XL Licencekey MSRT PRO compact 3kVA 0 MSRT PRO compact 3kVA 1Batt MSRT PRO compact 3kVA 1 Batt XL MSRT PRO compact 3kVA 2Batt MSAT PRO compact 3k VA 2Batt XL Cable 2 _ Germany V 5 8 25 e0 EN C contact F SNMP Adapter RFC 1628 Figure 14 Select UPS Model If the model SNMP Adapter RFC 1628 is selected please note that it is required that the battery installation date is identical in the UPSMAN and CS121 configuration After ha
68. e system group Start the SNMP service from the command line by net start snmp or start with the help of the icon Services from the control panel If the installation has been completed successfully you should receive a cold boot trap on your management console In addition you can access system group data In order to connect the UPSMAN software and an SNMP adpter is it required to start the SNMP service The UPSMAN computer needs to be configured in the SNMP adapter Please also refer to your SNMP adapter installation manual The UPSMAN SNMP MIB RFC1356 is located into the private tree 104 MIB tree MIB Tree ccitt 0 iso 1 org 1 3 dod 1 3 6 internet 1 3 6 1 C directory 1 3 6 1 1 J mgmt 1 3 6 1 2 mib 2 1 3 6 1 2 1 system 1 3 6 1 2 1 1 C interfaces 1 3 6 1 2 1 2 G at 1 3 6 1 2 1 3 C ip 1 3 6 1 2 1 4 J icmp 1 3 6 1 2 1 5 C tcp 1 3 6 1 2 1 6 C udp 1 3 6 1 2 1 7 C egp 1 3 6 1 2 1 8 C transmission 1 3 6 1 2 1 10 C snmp 1 3 6 1 2 1 11 upsMIB 1 3 6 1 2 1 33 upsObjects 1 3 6 1 2 1 33 1 j upsTraps 1 3 6 1 2 1 33 2 upsConformance 1 3 6 1 2 1 33 3 bacs 1 3 6 1 2 1 33 4 bacs2 1 3 6 1 2 1 33 5 J experimental 1 3 6 1 3 enterprises 1 3 6 1 4 1 pUpsman 1 3 6 1 4 1 1356 J security 1 3 6 1 5 snmp 2 1 3 6 1 6 FF FR Figure 87 SNMP MIB Tree 7 FAQ Problem with SuSE 11 3 x64 UPSMAN is running remo
69. ea 70 JUPSCRG UPSMAN Configuration E R Device Model Type IDK 1000 serial a Lec asic UnB GTi Power WA Lod Hold time m cl Load WA 1000 Recharge time jh E Date of Battery installation DOMM TTT Derice Pont US Baudirate 2400 7 UPS IDe Restore Factory Settings fe 00L 2007 GENERES GmbH Hamburg WE 6 36 Advanced User OF Cancel Figure 70 USB configuration Finishing installation and basic configuration After having choosen the correct UPS type and serial USB device the UPSMAN standard installation is finished If you press now OK the UPSMAN daemon will ask to start press YES to make the service daemon start If no further error message appears within 1 minute the UPSMAN will now watch the UPS and send messages in case that an alarm occurs If the UPS runs on battery and the battery have only 3 minutes left downtime the UPSMAN will automatically shutdown this computer In case of alarms a messagebox will pop up similar to the one above and the user can connect with UPS VIEW UPSMON or any other graphical viewer to see the actual UPS alarms 4 1 1 Silent Installation of the UPSMAN Installation The UPS Management Software provides a silent installation but it is required to enter some settings into the installer properties file This file is located into the CD folder Upsman Linux OEM ID 2 for AEG 3 for Piller etc 71 c If you
70. ection from a WEB Browser to a UNIX WEB SERVER please enter the IP address and a port number Example http 192 168 202 91 8081 Port 8081 is used as a standard at the start up of the server Please adjust the script usr ups startupsman sh if you would like to use a different port It is possible to start the Web server with different port addresses if several UPS monitor a Unix server Start the WEB Server by executing the script usr ups upshttpd sh When connecting with your browser a graphical UPS viewer will open and show the UPS data according to the specifications of the UPS maker The Webserver interface are varying for every OEM following some examples for such interfaces All interface have in common that they are mainly viewers so not essential for a UPS USPMAN installation 73 C Jocalhost 8081 cgi bin ups_view exe ups_view UPS View Web client Identification UPS Typ Date Time Event a Protect 5 28 11 2011 16 58 40 Information UPS manager fuer Protect 3 33 ist gestartet worden Firmware 28 11 2011 16 58 22 Masterlizenz Nur fr Testzwecke nicht fr Installationen beim Kunden verwenden J 28 11 2011 16 55 46 Information UPS manager fuer Protect 3 33 ist gestartet worden 28 11 2011 16 55 27 Masterlizenz Nur fr Testzwecke nicht fr Installationen beim Kunden verwenden ie GENEREX Hambure a gt Mains input 1 L1 L2 403 V L2 L3 400 V L3 L1 396 V Autonomy Frequency 50 0 Hz Time Mainsfau
71. emaining Figure 42 Execute Program On the register card Events please choose the event UPS MAN startea This is the only event which is always TRUE when the UPS runs normally So if you want to start actions which are executed anytime choose the event UPSMAN started Next click the Insert button Select the function Execute Program Enter the name of a batch file in the field here laststat bat Program The field Parameter should be filled with the variables LOAD connected to load to the UPS and LOCATION Enter the full path to the executable file Is the desired file in the same directory as the UPSMAN no path entry is necessary The bottom part of the dialog contains the buttons for the configuration of the time and how often the execution of the configured function should be done Here the load will be written to the laststat file every 20 sec Please note that when entering several parameters every parameter has to be separated by a set of quotation marks separated by one space See the following example LOAD LOACATION INVOLT At the beginning and at the end no are allowed The variables are only for separating the By clicking the Ok button the configured function is allocated to the chosen event Before starting the UPSMAN service please create the file laststat bat via e g NOTEPAD EXE 48 The content of t
72. es x86 UPS ts Administrator G Windows system32 cmd exe C Program Files Internet Explorer gt netstate netstate is not recognized as an internal or external command Q aP ao Dn WE Generex Management Software 3 Installationsordner ausw hlen Einf hrung Bitte w hlen Sie einen Zielordner f r diese Installation aus Lizenzvertrag v Installationsordner aus Pra Installation bers F Wo soll installiert werden Programm wird installia c Program Files x86 UPS Installation abgeschlossen Standardordner wiederherstellen W hlen InstallArrywhere oy tlacrovision Abbrechen UDP L 1 5355 es C Program Files Internet Explorer gt Figure 54 Installation Folder Please take a look into chapter 3 on page 7 for further information of the installation procedure and the basic configuration The UPSMonitor will be started out of the following folder 58 C Program Files x86 UPS upsmon t Administrator C Windows system32 cmd_exe 69 18 2668 625 info txt 65 488 Lib ini 48 468 libi ini 2 228 license txt 22 182 LOGO BMP 692 logo html 13 926 Logol bmp 73 796 messages dat 139 264 METACTRL DLL A MONITOR LOG 39 858 normalbetrieb bmp 147 856 NWCALLS DLL 41 088 NWIPKSPR DLL 71 245 QBLAT ERE 99 846 QDLLMT DLL 135 244 QPARSMD DLL 268 972 QPARSMT DLL 164 352 QSCRLL32 DLL 1 132 032 QSNet dl1ll 1 215 readme txt 98 369 REGSNI EXE 491 664 scanUPSMAN d11 173 SNIUIEW BAT
73. es can be selected with 1 2 etc as usual The definition is created directly in the JOB Example net send GX9 UPS autonomy tine AUTONOMTIME This entry in the JOB sends a network message to GX9 with the information on AUTONOMTIME which is transferred directly from the UPSMAN Example 2 net send GX9 autonomy time AUTONOMTIME minutes Battery Capacity BATTCAP o 55 This entry in the JOB sends a network message to GX9 with the information on UPS Autonomy time and battery capacity which are transferred directly from the UPSMAN The receiver GX9 gets this message from GX 0 to GX 9 Autonomy Time 46 minutes battery capacity 85 000 Example 3 JOB Power fail c ups mybatch bat AUTONOMTIME INVOLT OUTPOWER This entry defines AUTONOMYTIME as 1 INVOLT as 2 HOUTPOWER as 3 etc In the batch file itself the following can be configured Mybatch bat Net send Power fail at UPS detected Net send lt USER gt Power fail Inputvoltage 2 Volt only 1 minutes left Every UPSMAN provides at least the following variables HOUTPOWER Actual load in at the UPS LASTTSTBUPT Last tested BACKUPTIME UPS test in minutes TIMEUNTILSHTDWN Actual Remaining time remaining battery time until SD RUNTIME Actual Remaining time remaining battery time until SD BATTVOLT Battery load in Volt V CNT_PF Counter for power failure CNT_BL Counter for battery low 56 CNT
74. est gt t customtest batterytest selftest fulltest 101 lt ups test result gt r customtest batterytest selftest fulltest Example Command for read autonomy time upson i autonom Response from upsman upsmon Inquiry autonomietime ups answer 25 48 Command for Shutdown UPS and Restore upsmon c shutdownrestore 90 120 Note More information about the UPSMON modul is given in part Ill of this manual 4 5 Apple Macintosh 4 5 1 UPSMAN for MAC OS 9 MAC OS 10 MAC OS 9 is no longer supported only RCCMD should be used on such older MAC systems UPSMAN is currently only supported for MAC OS X 10 4 and higher UPSMAN on MAC X 10 4 and higher is identical to the UNIX UPSMAN description and installation UPSMAN for MAC X is designed for MAC OS 10 4 or higher Its is using the same installation routine as UNIX and WINDOWS UPSMAN for MAC OS X is identical regarding installation and configuration as the UPSMAN for UNIX Please refer to UPSMAN user manual for UNIX when installing UPSMAN for MAC X 102 The only difference in MAC X configuration compared to UNIX is the different device name for the serial USB interface Since the device name for a RS232 USB interface is created during the installation of eg a USB to Serial adapter the user has to find out the device name for his new COM or USB port in the MAC X device finder 5 UNMS UPS Network Management System UNMS is an additional v
75. fault configuration for ntpd servers after version 4 2 uses the NTP Pool for the default server sources Server OQ pool ntp org server l1 pool ntp org Server 2 pool ntp org Access Controls restrict default kod nomodify notrap noquery nopeer The NTP Pool servers have been listed as a time source already ver 4 2 onwards and they too need restrictions applied so the local server can synchronise from them Ensure the access control parameters are strict enough that the remote servers can only be used for queries restrict O pool ntp org mask 255 255 255 255 nomodify notrap noquery restrict 1 pool ntp org Mask 255 255 255 255 nomodify notrap noquery restrict 2 pool ntp org mask 255 255 255 255 nomodify notrap noquery To allow all the workstations inside the internal private network to be able to query the time from your server use the following access control rule adjust subnet if needed restrict 192 168 1 0 mask 255 255 255 0 nomodify notrap server 127 127 1 0 local clock fudge 127 127 1 0 stratum 10 driftfile var lib ntp drift broadcastdelay 0 008 keys etc ntp keys Starting the NTP bash ntpd b If failed try the following command bash ntp b File Edit View Scrollback Lii ur F356 E ntpd 6 f Onur tIS F mtp b bash mtp commend met found Limur F365 a Figure 98 Bash ntp b You should now set the runlevels required for the ntpd service then restart it chkconfi
76. ftware 5 8 04 or higher provides the parameter preselection for the UPS communication Remove the hash mark prior of the variable UPSDEVICE dev ttyS0 2400 e 8 1 and adjust the parameters accordingly 4 2 Start UPSMAN on UNIX and MACX General After the configuration has been done the installscript will ask to start the UPSMAN service 2 To start stop the UPSMAN process use always the prepared script startupsman For starting the UPSMan with all its necessary processes and services type startupsman start To stop the processes call the script with the parameter stop as follows startupsman stop By startupsman config you open the JUPSCFG graphical configuration page again Automatic Start at Server Boot Every Unix system has a certain method to start programs at the boot procedure Usually a main start up script or program reads off specific directories e g etc rc1 d etc rc2 d etc and executes the enclosed shell scripts If you use this method you can start the UPS Management Software at system boot time automatically The UPSMAN installation will enter a new startup script and remove older ones automatically In the Appendix you find a section which describes the technical details of such a startup script so that you may change it yourself 4 3 UNIX WEB Server The Unix WEB SERVER offers the possibility to display all UPS data with a platform independent WEB Browser In order to establish a conn
77. g level 2345 ntpd on etc init d ntpd restart ou chkconfig level 2345 ntp on etc init d ntp restart 115 Fie Edit View Serollback Bookmarks Linu f36j ntpd b Linua f36j ntp bash mtp command mot found Lonum f26 i 8 chkeenfig Level 2345 mepi on mpd unknown service Linumef36j 8 chkeemfig Level 2345 mtp on Linua F26ji fj Figure 99 Runlevel You can check which runlevels the service will be active with the following command bash chkconfig list ntpd Or bash chkconfig list ntp File Edit View Serollback Bookmarks Settings Help Lirwa f26j chkcenfig Ust ntpd ntpd umknown service Linua f36j chkeonfig Ligt ntp ntp koff koff Zion Zon dn Sien Goff Linum f36j1 F I Figure 100 Check config To see if the service started successfully you should check the system log file with the following command bash grep ntpd var log messages 116 i root bash E B kupdateapplet Fie Edit View Scrollback Bookmarks Settings Help EPET AE mete Se acm May 4 14 52 17 Linus f36 ntpd 20974 Listening on interface 2 lo 12123 Enableg repo oss Valid metadata not found at s May 4 14 52 17 Linux 36 ntpd 20974 Listening on interface 3 eth fe8G 20c 294 repo update Valid metadata not found May 4 14 52 17 Linuz f36 ntpd 20974 Listening on interface 4 lo 127 6 0 12123 H May 4 14 52 17 Linuz f36 ntpd 20974 Listening on i
78. g File for Charts and wait for the measurements to be transferred from UPSMAN to Upsmon After the file transfer has been completed you may display the measurements of voltage and frequency via the menu Chart The menu Chart lets you choose between a chart showing minimum maximum results or mean values The bar colours show whether the results have been outside the range of tolerance The accepted tolerance of the UPS rectifier is displayed by a blue line To monitor a certain part of the recorded time period use the command Time Frame from the menu Chart After selecting a time period with the desired frame choose a voltage or frequency chart again to display the measurements It shows only the measurements within this range higher resolution of input data Textlog In the menu File select Get TextLog File and wait for the measurements to be transferred from UPSMAN to Upsmon The event protocol includes all UPS events that have occurred to date A default UPS dump is printed if no errors have occurred Only messages like Power fail Alarm Overload Battery low etc show a unusual situtation 28 The UPSMAN log file can also be opened directly from the UPSMAN directory please use any standard text editor for this All other UPSMON functions which are not described in this manual come with a self explanatory description in the interface itself tooltips For further questions about those functions please contact your UP
79. gure 82 Denno Pats sraa a ta vas taaand ved A E sick ta saa E E tenes 96 Figure 83 UNIX Ups CONT Events Menu sicccccceisvenesavececcseiecevscenecevedieadveats sazseelteegejehieanveatd sede 96 Figure 42 UNIX ups cont Event List asie e a A a E AE Aaaa aii 97 Figure 85 UNIX ups_conf Menu Add Job Parameter ccccceeeeeceeeeeeeeeeeeeeeeeeeeeeeees 97 Figure 86 UNMS IEENVrOnNMe M rsrs naa ETSN R Ei 103 Figure J0 UPSMONGZINT Edit eanes A 108 Figure 91 Example Settings SUN Solaris 2 6 2 7 TTY configuration ccccccceeees 109 Figure 93 Configuration for HP OV Javamon ccccccccccccecceeeeeeesseeeeaeaeaeeaaaeeaaaaaaaaaaaaaaas 111 Figure 94 Symbol Object Prope rties cccccccccsccccecceesseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeaaeeaeaaaaaaes 112 FIGUKE 95 GO BAT ipto SLANTED eene ce sects r E cede te aaah eared e Aa Naia 112 Figure 96 Properties of the GO BAT Link 0 0 0 2 cceeeeeeeeecceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeenes 113 Fiore Ro Weir 1 ea 016 cern npernanen Anre eter nett a a noe nn oor eee eC oe eee ee 114 Figure 98 ro io QIN Chea entietremerie irre E rrr rrr rrr rr Te 115 Figure DOD RUNIGVG rry aaa a aaa a E A a a 116 Figure 1005 Check EON recni a e 116 Figure 1 01 LOG MOSS AOS aa e E AEE A E N 117 Figure TO INT OUG eet eshte ec ec wats E E E A 118 123
80. h the CS122 connection For example replace the Linux Comport dev ttyS0 2400 n 8 1 by the virtual CS122 Comport vcom1 192 168 202 122 2400 n 8 1 Note that the values for the baudrate and other values following the colon will automatically be set when changing the UPS model 109 lolx File Edit View Window Help EH SAa SS ee2 4 S S er E Quick Conmeck Profiles Set UPS values Location l COM port Options onla 166 202 124 2400 n 6 1 l UPS Ia Write to logfile iz 300 logfile max size Mb 1l UPS modelname SINUS 1000 lt ENTER for list UPS cable serial lt ENTER for list UPS max load VA 1000 l UPS act load FAL 1000 l UPS maxholdtime mi 7 UPS rechargetime hj a Battery install date 25 10 2004 ESC Exit Screen gt Help a al Connected ta G87 55H1 Sdes icbe crc32 none 50x27 Fap E Figure 92 Settings for a CS122 network TCP IP to Serial converter MOXA or other No longer supported Virtual comport in the UPS values NOT for CS121 The CS121 does not need to communicate with any UPSMAN software the UPSMAN is part of the CS121 This is only useful if you use a RS232 to TCP converter like the CS122 or devices from MOXA HP OPENVIEW Bug_ RFC 1628 Trap receiver does not interprete correct MIB 2 Traps This bug is know in HP OV 5 6 for Windows The moment the trap definition is manually changed HP OV tra
81. he remote client can do this job The user can pick on of the default text messages as ID no from the file message dat or us RCCMD MAIL TXT instead to create its own text Like the send RCCMD mail function an email is send from the RCCMD client as relay The user may enter here any individual text This writes a log file text customized or as predefined text if you use ID into the RCCMD remote clients log file This maybe useful if a common log file is wanted where all UPSMAN computers write into This log file may be on any network computer with RCCMD The user can configure a text message customized or as predefined text if you use ID which is transferred to the RCCMD client and pops up as text box This is useful if you want to send a messagebox from Windows UPSMAN to a UNIX system the problem of sending messages to different operating systems can be solved through this Execute Program Executes a configured program on this computer Please enter the full path to the executable file on the UPSMAN computer It is recommended that the executable file is located in the UPSMAN folder or in any other folder where a path is set to Write to Log file Writes any text into the upslog csv text file on UPSLOG CSV this UPSMAN computer Send default messages IDs Sends pre set network messages using the from file messages dat receiver name and message ID This standard message can be configured in the message dat file Open
82. he results of the programmed action Generally the Scheduler shows the actual active job and the time or date when it will be executed Already executed actions are list and automatically removed from the list if those jobs are expired or not longer recursing By ADD Entry a new job is created and added to the list With DELETE Entry jobs may be removed from the list With EDIt entry you can change an already exisiting job The other functions on the Scheduler should be self explanatory and do not require further explanation Generally we recommend NOT to program more batterytest jobs than once a month Especially fulltests may discharge your UPS batteries to a low level which may damage your batteries if this is made too often We recommend to do only short battery tests and replace the UPS 24 batteries in regular terms interval depends on battery type If you use BACS Battery Analyse and Care System on your UPS batteries you can see the actual status of the batteries and decide when change is necessary Without BACS we recommend to to this on a regular basis JPS Monita File View Chart Functions Help kl Server Model No UPS model defined Location GENEREX Hamburg Uptime 0 Days 00 00 12 EAC l P S CountPF 0 e o so o Event Chart 11 28 2011 17 18 USV Status Normal 11 28 2011 17 18 Information Verbindung zur USV hergestellt i Status Chart l o E Load Curr l Battery l Input Volt V
83. his example file may look like the following A UltraE dit 32 C Program Files UPS laststat_bat E Fie Edit Search Project View Format Column Macro Advanced Window Help la x DTH erga WwW H E Se EIIE Ayee Bnl laststat bat Gecho off ia echo echo date echo time echo echo echo 4 gt gt Load statistics txt Date gt gt Load statistics txt ft gt gt Load statistics txt Time gt gt Load statistics txt ft gt gt Load statistics txt gt gt Load statistics txt 1 Volt Ampere at UPS 2 gt gt Load statistics txt gt gt Load statistics txt oft For Help press F1 Ln 9 Col 14 CW DOS Mod 05 02 02 09 47 48 File Size 331 INS 7 Figure 43 Laststat File using a Text Editor Start the Upsman service If you have followed the above example now every 20 seconds the file Load statistics txt containing the current values of the UPS load is created and updated 49 3 6 5 Examples Send Email Function Upeman Addresshook Outlook Addressbook Value Insert Function Function Parameters Parameter ADDRESS monitoring somewhere com TET Attention powefailure at LOCATION Please enter the text to be sent Example General Fault on UPS ssx O Do ater 0 Seconds D Do after 0 Do immediately once Do Always Seconds repeat DoEvey 0 seconds F Do at T Minutes remaining Figure 44 Send Email Configuration Address
84. iewing tool for UPS installations It s a UPS network monitor designed to monitor your UPS devices on different locations in the network This tool is useful if you have more than 1 UPSMAN CS121 to manage For standalone UPS this software is not needed The UNMS may be delivered as a limited versionwith the UPSMAN license depends on UPS makers license regulations The UNMS Server Service runs intermittent checks on UPS devices you specify When problems are encountered the UNMS Server Service can send notifications out to administrative contacts in a variety of different ways For example Email Current status information historical logs and reports can all be accessed via a web browser Web Console Web Console Web Console Web Console IP Network LAN WAN sf SE iih UPS cn a ae a1 tip UPS T UPS N lt j En SLE nT 0 UPS Sit Sit wie ite ite O Server Figure 86 UNMS II Environment The UNMS is not described in this manual a separate UNMS user manual is distributed with the UNMS software or can be downloaded from WWW GENEREX DE documentation download area 6 Simple Network Management Protocol SNMP The Simple Network Management Protocol SNMP is a worldwide standard communication protocol It is used to monitor any device in the network via simple control language The UPS Management Software also provides its data in this SNMP format 103 UPSMAN supports under Windows the priva
85. il EVENT The logic is other way round in the case of setting cable type to Typ C closed Other configuration Parameters on page Set Ups values Write to logfile Defines the time interval in seconds the UPS Management Software logs the Input Voltage and Frequency Values The standard entry to the text file Ok status are done every 15 minutes if no unusual Events occur Logtime min Defines the minimum time range in hours of the Logfile for Input Voltage and Frequency Values Logfile Size max Defines the maximum time range in hours of the log file for Input Voltage and Frequency Values The log file will be set back to min size value of logfile size min if the log file contains more data than the configured value 93 ups_conf Basic Set System values Check UPS interval Enable shutdown ATTENTION System downtime Defines the time interval in seconds that the UPS Management Software polls the UPS for new data via the serial port The system will be slowed down due to permanent communication with the UPS if the value is too small If the value is too high the system will react more slowly if a power failure occurs Defines if the system will start the shutdown procedure in case of a power failure Make sure that this entry needs to be yes at all times if there are no customised shutdown jobs configured This is to avoid that the UPS switches off before the system has performed a
86. ings of communication parameters of the UPS most UPS have a fixed baudrate which must not be changed UPS models with serial connections do not need additional adjustments because these models transfer all values to the UPS Management software If you have a UPS model with a port tyoe cable which does not transfer the connected Load to the UPS Mana gement Software you have to enter the values of the actual load manually Add the input power requirements in Watts of all connected units and calculate the Watt 0 8 VA D ATTENTION If you use a UPS model with the port type cable please notice that the values for Hold and Recharge time are in accordance with the manufacturers specifications and should only be altered in special configurations since the UPS could be discharged before the system has been shutdowned Power Load Hold Time Recharge Time are usually only for informative purposes but we strongly recommend to set these values properly because UPSMAN uses these configuration data whenever the UPS can not transmit such informations We recommend 32 in any case to set the values for Hold Time and Recharge Time correctly because the user can not know which UPS calculate the autonomy time out of these data Power VA 500 Hold time m 10 Load VA 500 Recharge time fh 6 Date of Battery Installation DD MMYYYY 27 07 2011 Device Port Baudrate 2400 Address Listen Por
87. ion Upsman is a system service that communicates with the UPS wia RS232 USB or SNMP This feature provides the basic functionality of UPS management Figure 63 Install Custom Page e UPS MANAGER UPSMAN daemon This is a background process UPSMAN the core of the system The UPSMAN is the service which maintains the direct UPS RS 232 USB or network connection with the computer and the UPS e UPS Monitor Web This is the grafical interface for the UPS monitoring e Help files are provided with the software additionally this folder contains the user manual v Generex Management Software O Please Review the Following Before Continuing Product Name UPSManager Install Folder usr ups Link Folder tmp install dir 19530 none Product Components UPS Manager Help UPS Monitor Web Java VM Installation Folder Figure 64 Pre Installation Summary Page 64 v Generex Management Software 3 IP Network LAN WAN sim g S Se ae Cancel Figure 65 Installing UPSMAN Selection of the UPSMAN start To Generex Management Software E Do you want to enable Upsman to start automatically at system boot time Start Upsman at system boot O Start Upsman manually Cancel Previous Figure 66 UPSMAN Start Selection Click the Next button to continue 65 Press DONE to continue with UPSMAN graphical configuration It is required to allocate a password which will be requested prio
88. k down errors In order to allow an automatic start of the UPSMAN module at server boot please set the service start up status in the control panel to automatic In case the service needs to be removed or deactivated please change the start up status in the control panel section SERVICES to manual In case an automatic start under Windows is not desired please enter the command line Upsman remove or deactivate via the corresponding icon UPSMAN Remove 57 In order to reinstall the service after removing it please change to the UPSMAN directory and enter the command line UPSMAN BAT This is a reset command where UPSMAN service is now reinstalled and the configuration program will start The local UPSMAN directory contains send bat log file entries messages dat which are part of the event configuration where the file is existing Using an editor all of these files can edited and modified The event configuration however enables a complete configuration of these files Stop the USV Management Software In order to stop the UPSMAN service a command line with the command net stop Upsman can be entered Also the control panels services in the Windows UPSMAN Icon in the status panel can be used 3 6 13 UPS Management Software for WIN 2008 Server Core x64 The installation configuration of the UPS Management Software on a Windows 2008 Core x64 system got some specifics The default folder is C Program Fil
89. l you have selected the UPSMAN Software has automatically set the UPS parameters and the corresponding UPS cable type UPS cable In general there are three different UpsCables which are automatically assigned by the UPS modelname Serial setting Default for all modern UPS with a serial or USB protocol The UPS Management Software uses a data protocol to get status information from and to send commands to the UPS For such protocol types the original UPS cable has to be used Cable 2 to 13 With these settings the UPS Management Software uses modem control connection to get the status from the UPS e g the UPS sets a signal high or low In this case the software is only able to get the status Powerfail and Battery Low and to shutdown the UPS immediatly The cable settings 2 to 9 are not very appropriate for non X86 x64 based UNIX because they do not support modem control exploitation If you use any x86 based UNIX we recommend to use cable logic 2 However supported in every UNIX are the cables types C opened closed or O Typ Oand Typ C This is the most simple form of a dry contact monitoring in this case the software sends a byte to the UPS and tries to get it again via the usual send receive wires In the case of Type O open the contact is open so the the send byte can not return in normal UPS operation The moment the contact closes Ups Alarm the byte returns and the UPSMAN triggers the Powerfa
90. lient modules To install RCCMD another separate license key is required for every installation a new RCCMD key is needed DO NOT install the same license key more than once The RCCMD sender functionality is already integrated into the UPSMAN Only for the client computers a new RCCMD license is required Additional RCCMD installations can be executed from the same CD ROM or download image using different license keys Beside copy protection the license key distinguishes the different OEM UPS customers from each other It is not permitted to use any other license key than the one provided with the software 3 Start Installation Basic configuration of UPSMAN To start please make sure that you have full administrator rights in order to complete the installation Step 1 Put the CD into the CD ROM drive of your computer or download the software into a specific directory on your computers harddisk Step 2 Please execute the installation program install exe in order to install the files to your system and choose a desired setup language Step 3 Please enter your UPSMAN or RCCMD license key to choose the correct software package The license key determines which module can be installed The installation software shows a progress bar until the software has been extracted and the installation begins C 1997 2010 Flexera Software Inc and or InstallShield Co Inc You can choose the language of your in
91. ll because of continous communication with the UPS If the value is too high the system will react more slowly in case of a power failure For continous use we recommend a value between 15 and 30 seconds e Enable Local System Shutdown Defines if the system will start the shutdown routine in the event of a shutdown call from the UPS during a power failure If you disable this function no shutdown will be performed In the case of a shutdown the internal event routine will close down all active applications The 7 shutdown of the UPSMAN computers is following the sript in the file shutdown sh from where the shutdown programs will be started Down time Defines how many minutes before the UPS battery is discharged that the shutdown procedure begins This timing has to be large enough to guarantee a proper shutdown of the system before the UPS is turned off Ensure that this value is calculated on a large scale e g with 10 minutes hold time of the UPS start the shutdown procedure at least 3 minutes default before the batteries are empty battery low Enable UPS Shutdown Default on When OFF the UPSMAN computer will not execute the shutdown file Initiate shutdown always after x minutes This enables disables the execution of the shutdown after a period of time wherein the UPS is working on batteries UPS Down Delay s Defines how many seconds after beginning the shutdown procedure see Down time the UPS will turn off
92. ll The other servers are only connected to the UPS power supply no RS 232 connection is necessary On these remote systems install RCCMD client software and create a shutdown routine for every system This shutdown routine may be a batch or shell script file that contains the down and other commands for this system After that add RCCMD to the shutdown job or to the EVENT configuration of the computer running as UPS master server Send Email Net send message Shutdown Shutdown i Shutdown RCCMD 2 client RCCMD 2 client RCCMD 1 client C NOVELL Server Windows Server Novell Server UPSMAN Server RCCMD 2 Sender ff Firewall Firewall Windows Server CS 121 SS UPSMAN Server L OS 2 UNIX Server RCCMD 2 Sender RCCMD 1 client RCCMD 2 client Shutdown Shutdown Figure 1 UPSMAN and RCCMD in a network environment 2 Quickstart Installation Configuration UPS Software 2 1 Preparation of the Installation Before you install the UPS Management Software please ensure that your UPS is working correctly Connect the UPS to the relevant serial USB port of your computer using the original cable coming with the UPS Some UPS models provide several connections interfaces please check the user manual for detailed information which port has to be used for the UPSMAN software Attention The
93. lt counter 0 Battery Status Normal 999 Min 100 245 V 3A Temperature 23 0 C Output Voltage Current Load Power Phase L1 231V OA 0 Phase L2 231V OA 0 Phase L3 231V OA 0 3 999 Min Frequency 50 0 Hz Location GENEREX Hamburg DataLog Chart Log file Functions Scheduler Figure 72 Protect 3 33 UPS Webinterface NOTE For installations without a grafical interface runtime level 2 or without KDE or other desktop we provide a non grafical UPSMON through the commandline For syntax please refer to chapter 3 8 7 page 87 4 4 1 Advanced User DEVICE Page The graphical configuration is started by startupsman config the JUPSCFG windows is opened automatically and the user has to choose the correct UPS model similar to the windows configuration described above You may reopen the configuration at anytime by entering startupsman config again The DEVICE page shows a drop down list of UPS models which is the most important part of the configuration because with the model name links the correct UPS RS 232 USB protocol wioth each other If a wrong model is chosen from the list the UPSMAN can not start The configuration may also be started from the user account from which the installation was performed the install bin creates a link to startupsman config automatically default From other user accounts the configuration can be started from the command line in the usr ups directory startups
94. man config 74 Automatic start at server boot The default of every UPSMAN is to start automatically at every new server boot If you want to change this edit your startup script entries in etc rc directoy Selecting the UPS Model To select your UPS model click with the mouse on the scroll box symbol on the right side of the model list Next choose the UPS model that you want to install All other adjustments which correspond with your selected UPS model will be done automatically if the UPS has serial or USB communication We recommend NOT to change the default settings of communication parameters of the UPS most UPS have a fixed baudrate which must not be changed Set battery health level in The UPSMAN version 5 7 3 or higher provides an option for UPSs which are not able to give a result after a battery test The default is 10 that means if the battery voltage got a difference of more than 10 PRIOR of the battery test an error will be logged Advice Always execute a battery test with load Please use the nominal load which will be present in normal mode UPS models with serial connections do not need additional adjustments because these models transfer all values to the UPS Management software BOC JUPSCFG UPSMAN Configuration Device System Files Events Model Type YUNTO Q 450 serial_ Location Unknown Power VA 450 Hold time m 1l Load VA 450 Recharge
95. module which executes a command on a remote system similar to the Remote Shell Program RSH known in the UNIX world RCCMD is used to provide a simultaneous shutdown of several servers that are all supported by the same UPS The following listed features depend on the UPS model Please ask your UPS dealer which of these functions are available with your UPS model The following list shows you the maximum variety of features of the current UPS Management Software Client server software for heterogeneous networks with one and three phase UPS Look amp feel is identical on all platforms a Support for almost all UPS types and UPS manufacturers with serial RS 232 USB network or dry contact UPS protocols Integrated proxy SNMP agent for WINDOWS and Linux lv Modular structure optional it is possible to extend the system for multi UPS surveillance via UNMS External modules hardware allow for a variety of system extensions such as SENSORMAN RASDIALER modem solution UPS SNMP Watch JAVAMON HP OpenView UPSMON and others Support all important network protocols for the graphical control of the UPS from every Windows station in the network lv Automatic unattended shutdown of local and remote computers in networks Master Slave via RCCMD module Low battery warning on screen autonomy time battery time countdown low battery warning UPS temperature such as battery and internal temperature defect battery warning time and
96. n Please make sure that sendmail is configured correctly before using email Send RCCMD EXECUTE to This action initiates the execute bat on a defined 82 remote client Send RCCMD MESSAGE ID to remote client Start Alarm Beeper with messagebox Send RCCMD MAIL ID to remote client Send RCCMD MAIL TXT to remote client Send RCCMD LOG TXT LOG ID to remote client Send RCCMD MESSAGE ID or TEXT to remote client 83 RCCMD remote client IP address Through this function the UPSMAN can execute any command on the remote computer if the correct path and name of the program is known on this remote computer with RCCMD running In this menu the user can send an ID from the messages dat to other users These IDs are pre defined text messages Open the file message dat to see the default text of such messages Text entries can be altered with an editor The edited text is then given out ina textbox at the remote client This is useful if you want to send a messagebox from Windows UPSMAN to a UNIX system the problem of sending messages to different operating systems can be solved through this This function displays a message box with an audible warning on the screen of the UPSMAN computer Similar to RCCMD message ID a message ID is send which is then forwarded from the RCCMD client as an email to the corresponding receivers This is useful if the UPSMAN computer for any reason can not send emails directly than t
97. nfiguration again please make sure that the UPS type has NOT changed Only event files which have been recorded previously will work when reloaded if the UPS type has not changed 3 6 4 Examples Execute Program with Parameters The following shows some examples for customized configurations of UPSMAN Example How to create a load statistic via UPS EVENTS on Windows The log file datalog csv constantly creates the current MS Excel compatible log file with all important UPS data and can also be extended or adjusted via the messages dat ID 700 file Single phased UPS or messages dat ID 800 three phased UPS In the following example we show how the EVENT manager can be used to create a load statistic 47 Device System Files Mail Server Events Extra Jobs Event i UPSMAN started Overview Jobs I eee Ce eee Load Save Power failure Battery low rt Shutdown Summary Alarm 0 Reset Test failure 0 Reset 0 A AAAA Figure 41 Insert Job Instructions re Function Execute Program Function Parameters Parameter Value PROGRAM laststat bat PARAMET LOAD LOCATION If exe or bat requires a parameter enter it here Example test exe 1 Do immediately once O Doafter 0 Seconds D Do Always Do after 0 Seconds repeat DoEvey 0 Seconds Do at 0 Minutes r
98. ng the sript in the file shutdown bat in unix shutdown sh from where the shutdown programs in windows exitwin exe and other commands will be started ATTENTION Make sure that the check box System Shutdown enabled is 36 always active if you have additionally the UPS Shutdown fuction active Otherwise the UPS might be turned off during a power failure before the system has been shutdown properly Down time Defines how many minutes before the UPS battery is discharged that the shutdown procedure begins This timing has to be large enough to guarantee a proper shutdown of the system before the UPS is turned off Ensure that this value is calculated on a large scale e g with 10 minutes hold time of the UPS start the shutdown procedure at least 3 minutes default before the batteries are empty battery low e Enable UPS Shutdown Default on When OFF the UPSMAN computer will not execute the UPS shutdown Initiate shutdown always after x minutes This enables disables the execution of the shutdown after a period of time wherein the UPS is working on batteries e Configure shutdown The type and sequence of a shutdown can be selected and edited here Please note that the UPS can not boot the computer after power returned when POWEROFF is active ATX boards Default is shutdown windows Exit shutdown In the shutdown configuration users can add self defined actions to the shutdown sequence via the
99. nsforms the version 2 trap indentifier in to version 1 How to override You can manually correct in the trapd conf file You will see that the trap ID has changed from 1 3 6 1 2 1 33 2 1 to 1 3 6 1 2 1 33 0 1 this is trap 1 not trap 2 Change this string to 1 3 6 1 2 1 33 2 1 again to correct this problem HP OV Version 5 and 6 SNAP IN under HP UNIX Configuration for HP OV Snap in in etc opt OV share registration C 110 the following file must be present upsmonov reg After the reboot the process upsmonov must be present in the process list This process incorporates normally all objects which are SNMP supported and also support the RFC1628 MIB or PPC MIB Please check the following picture X Object Description X Attributes for Object hpux mytrix de 11570 Jun 21 1997 ipmap 2197 Jun 21 1997 netmon 829 Jun 21 1997 nnm 891 Jun 21 1997 ovHomePage 575 Jun 21 1997 ovhelp 1024 Mar 23 1999 ovip 1024 Mar 23 12042 Jun 21 199 1218 Jun 21 1997 ovweb 3094 Jun 21 1997 ovwnavigator 1997 ovwww 1997 terminal 1 1999 upsmon reg 1997 xnmpolling Figure 93 Configuration for HP OV Javamon In etc opt OV share registration C the following file must be present upsmon reg The following must be configured in the symbol properies for the object 111 oix e gt Event at A ns Buffers Tools Top lt lt lt j Ej Error Events Symbol Type ie 6 e F _J Threshold Events Computer zHP UX Paste Undo
100. nterface 5 lo 127 0 0 24123 H May 4 14 52 17 Linusz f36 ntpd 20974 Listening on interface 6 eth2 192 168 200 May 4 14 52 17 Linux f36 ntpd 20974 kernel time syne status 0040 May 4 14 52 17 Linuz f36 ntpd 20974 frequency initialized 3 749 PPM from varf Lib ntp driftintp drift May 4 14 52 50 Linux f36 ntpd 21194 ntpd 4 2 4p5 1 1541 0 Wed Dec 3 07 22 15 UTC 2008 1 May 4 14 52 50 Linux f36 ntpd 21195 precision 1 000 usec May 4 14 52 50 Linux f36 ntpd 21195 ntp_io estimated max descriptors 10624 initial socket boundary 16 May 4 14 52 50 Linuz f36 ntpd 21195 Listening on interface 0 wildcard 0 0 0 0 123 Disabled May 4 14 52 50 Linuz f36 ntpd 21195 Listening on interface 1 wildcard 123 Disabled May 4 14 52 56 Linux f36 ntpd 21195 Listening on interface 2 lo 1 123 Enabled May 4 14 52 50 Linux f36 ntpd 21195 Listening on interface 3 eth2 fe8G 20c 29ff feST ecSS 123 Enabled May 4 14 52 50 Linuz f36 ntpd 21195 Listening on interface 4 lo 127 6 0 12123 Enabled May 4 14 52 50 Linuz f36 ntpd 21195 Listening on interface 5 lo 127 0 0 2 123 Enabled Hay 4 14 52 50 Linux f36 ntpd 21195 Listening on interface 6 eth2 192 168 200 60 123 Enabled Nay 4 14 52 50 Linux f36 ntpd 21195 kernel tim syne status 6646 May 4 14 52 50 Linug 36 ntpd 21195 frequency inLtialized 3 749 PPM from war lik ntp drift ntp drift May 4 15 44 08 linux f36j ntpd 28156 ntpd 4 2 4p501 1541 0 Wed Dec
101. o Seconds 0 3600 Tum outlet OFF when battery lower o 20 80 Turn outlet OFF when UPS overload Write settings Programmable Outlet 2 Turn outlet ON after UPS is on fo Seconds 0 3600 I Tum outlet OFF after AC failure 0 Seconds 0 3600 Tur outlet ON after AC recovery fo Seconds 0 3600 Turn outlet OFF when battery lower o 20 80 l Tum outlet OFF when UPS overload Write settings Figure 26 UPSMON Programmable Outlet Settings Window 2 The following configuration options are available for the outlets Turn Outlet ON after UPS is on Delayed switching on of the outlets in seconds after the UPS was switched on Turn Outlet OFF after AC failure Delayed switching off of the outlets in seconds during a power failure Turn Outlet ON after AC recovery Delayed switching on of the outlets in seconds after a power failure Turn outlet OFF when battery lower Definition of the switching off if the battery capacity is lower than x in percent Turn Outlet OFF when UPS overload Switching off of the outlets during UPS overload Click the Write settings button after you finished the configuration Voltage and Frequence Chart Here the input voltage and frequency values of the last 24 hours default are displayed in a bar or line chart graphic Depending on the UPS system single or thriple phased one measurement per phase is recorded In the menu File choose Get DataLo
102. oca COM UPS Writ logf UPS UPS UPS UPS UPS UPS Batt ES tion port Options Id e to logfile s ile max size Mb modelname cable max load VAI act load VA maxholdtime m rechargetime h ery install date C Exit Screen Mill Shell Figure 81 SUSE Linux Set UPS Values Menu 91 Serverroom fdev ttyso 300 4 Smart UPS serial 1000 1000 5 8 2400 n 8 fel lt ENTER for list lt ENTER for list ups_conf Basic Set UPS Values Menu The most important entries in this page are Com port options amp UPS model name For all UNIX and MACX computers you have to enter in this menu at COM port Options the name of your serial device usually found in the dev directory Enter here eg for Linux dev ttyS0 2400 n 8 1 if you want to use the first COM port AS next step choose the UPS model listbox which you have connected to this COM port These entries have to be correct otherwise the UPS will not start The entry UPS com port options contains also the information about the settings of the com port i e baud rate parity data bits etc Syntax is UPS Com port options device baud parity data stop Example for serial interface dev ttyS0 2400 n 8 1 Example for USB interface USB 2400 n 8 12 where device is the device name parity is either e even o odd or n no data is the number or data bits 7 or 8 and sto
103. of the EVENT manager are executed top down but since every job has its own timer eg delayed immediately etc the priority of the jobs depend on the individual timers not on the rank in the job list If you want to change the rank of a job you can drag amp drop the job in this list but still the individual timer remains unchanged Which events are configurable depends on the type of UPS Every UPS contain individual alarms large UPS have usually more alarms than smaller UPS The following section explains the pre settings of such an event list on the example of a 1 phase UPS In order to configure the event click on the designated event and the Event Jobs list opens For every event there are pre settings most of them are log file entries and RCCMD messages as traps In the example there are three jobs configured for the event Powerfail 2 jobs will send out standard text messages can be edited in the Message dat file whereas the 3 event writes a message into the log file In order to add a job please click the Insert button and the following functions page opens The Reset buttons below are to reset the alarm counters of UPSMAN visible in the UPSMON or other graphical viewers statistical information since the software has started 79 JUPSCFG UPSMAN Contiguration Extra Jobs Evert Fowerfail Job Sends the messageid 601 Sends the messageid 600 Log Event send RCCMD trap messaqge
104. ol by Save Configuration amp Exit The UPSMAN may be started now ups_conf Advanced User Set Job values Following part of this manual explains the Advanced User configuration items of UPSMAN software using the ups_conf tool This analogue to the Windows description Special Jobs and allows the execution of own programs e g shell scripts at a defined point of time during the discharge of the battery As soon as the UPS transmitts a Remaining Time which equal or lower than the configured value the corresponding procedure is executed As soon as the Enable Extra Job is set to yes the program name or shell script of the desired job can be entered in the Extra Job x Path line This script is than started at a certain set Remaining Time of m minutes Example Different network servers should be stopped at different times via shutdown script depending on the importance This way it is possible to provide depending on the circumstances more autonomy time for the important components Additionally 3 jobs can be executed time controlled Path for textfile Defines the filename and path of the event log Path for datafile Defines the filename and path of the log file for Input Voltage and Frequency Values Path for custom file Defines the file name and path of the custom file 95 O Root Shell Konsole Session Edit View Bookmarks Settings Help Set Job values Enable Extra Job 1 lt ENT
105. p is the number of stop bits respectively It is recommended NOT to change the default entries for the serial port parameters baudrate partiy databits stopbits for the UPS since these are default settings of the UPS maker The devicename depends on the driver on your UNIX MACX system Original drivers are using the name dev tty or USB and can be found in the dev folder Third party drivers add a new devicename in the folder dev these new devicenames have to be identified by the user and may now be used in the configuration Attention The baudrate settings and the corresponding parameters are changed to the correct settings automatically by choosing the correct UPS model from the drop down list Please do not changed the baudrate settings of the UPS settings unless you have changed the pre programed settings of the UPS previously UPS usually have fixed baudrate settings Attention Please ensure you have to entered the correct serial port device name because the UPSMAN Software cannot identify to which com port the UPS is connected If a AUTOSEARCH function is provided you may use this to find out which interface an UPS type is connected 92 UPS model Goto the UPS model list and choose from the listbox the UPS type which you have connected to your interface If you can not find the UPS model in this list check if you have installed the correct software OEM version for this UPS maker Corresponding to the UPS mode
106. pening this page Serial interface You have to choose now the correct serial or USB interface where the UPS cable is connected NOTE If you use a USB 2 serial converter youre interface will appear as tty not as USB The identification of the correct serial device name on UNIX is not easy to find The following table gives the usual device names for some popular UNIX systems 67 nix system Normal device name for the haces natal devittyOp0 devitty0 deviterm ser0 DEC Unix dev ttyO0 Make sure that that there is no active entry getty process within your system file inittab concerning the device which should be connected to the UPS If there is an entry with the same device name this entry must be disabled Commented or respawn otherwise the UPS Management Software will not work Tip If you are not sure if you are connected to the right device COM port on your UNIX system you can find it out with the following procedure Choose cable settings to Type O Plug a serial 1 1 cable to your computer Start the software at the directory usr ups upsman Shorten the pins 2 and 3 with a paper clip If you don t see a message like powerfail you are using the wrong device In this case choose another device name and repeate the procedure above until you see this message Now youre port has been identified and you can reconfigure your correct UPS model from the drop down list box 68 Using Keyspan s US
107. ported we recommend to use the graphical configuration JUPSCFG Java based for any configuration in the advanced user area 4 4 8 Unix MAC commandline UPSMON The UPSMON for Unix is a simple monitoring tool for the display of the current UPSMAN data and for the programming of own scripts for further processsing UPS information In addition all UPS functions and UPS tests can be activated by UPSMON Parameter for UPSMON usage upsmon vicdirh n start number V Program information i lt value gt Query of a UPS measurement C lt ups command gt Execution of a UPS function d lt ups command with duration gt lt seconds gt Execution of a timed UPS function t lt ups test gt Execution of a UPS test function r lt ups test result gt Query of a UPS test functions result h Display of extended help n lt start number gt lIs a definite number if more than one UPSMAN is running on the Unix machine several UPS at one computer lt values gt i status inputvolt inputcurrency battvolt 100 temperature autonomietime autotime battcap batterycapacity outputpower inputfrequenz outputfrequenz lt ups command gt c canceltest cancelbatterytest cancelshutdown only certain UPS supporting this command alarmreset bypassmode shutdownrestore down seconds restore seconds switchoutlet O off 1 on outlet nr lt ups command with duration gt d shutdown restore cancelbypass outputoff lt ups t
108. psmon into the startup of Windows Startup a InterVideo WinCinema Manager X SuperviSor AEI co Ai Terzio 73 763 02 02 2009 19 56 m ted A aA 1 130 558 04 12 2008 13 02 j OS 38 524 27 11 2008 12 55 gt 921 654 27 11 2008 12 55 AF P Windows Update Windows Commander I Re 1 215 26 09 2008 18 18 h Apple Software Update 1 215 26 09 2008 18 18 625 18 09 2008 17 22 eee 6 144 07 07 2008 16 37 InterVideo Information Service 475 241 05 06 2008 16 06 i Documents gt J Windows Calendar 16 979 28 05 2008 08 22 indole Cokie 173 544 12 03 2008 13 43 48 Windows Defend 69 977 08 08 2007 15 37 gt 429 Windows Fax and Scan G2 Windows Live Messenger Download Windows Mail 5 Windows Media Player g Windows Meeting Space E Windows Movie Maker I Windows Photo Gallery Figure 95 GO BAT into startup 112 BI GO Shortcut Properties xi Compatibility Securty Details Previous Versions General Shortcut Options Font Layout Colors ak GO Shortcut Target type Windows Batch File Target location upsmon Target Shotctkey Noe SSS Es Open File Location Change Icon Advanced cet fa Figure 96 Properties of the GO BAT Link D NTP time synchronization UNIX The Network Time Protocol is defined in RFC1305 and allows the transfer and maintenance of time functions over distributed network systems Basic Configuration The following command will synchronize
109. r of the calling of the configuration because a remote configuration is also available JUPSCFG Authorize oo x This option is password protected Please enter your password to continue Password a Figure 67 JUPSCFG Authorization The system requires a moment to startup the graphical configuration JUPSCFG FA JUPSCFG UPSMAN Configuration Model Location Unknown Power VA 500 Hold time m 10 Load VA 500 Recharge time h e Date of Battery Installation DD MM YYYY Device Restore Factory Settings c 2001 2007 GENEREX GmbH Hamburg Figure 68 JUPSCFG UPSMAN Configuration Device Page 66 When the UPSMAN configuration starts up choose from the UPS modellist your UPS type or use Search UPS to make UPSMAN try to identify your UPS type If not clearly identified the UPSMAN will show you a list of UPS devices which are corresponding to the search requests please pick the right model from the list and confirm with OK Model Type Location YUNTO P 250 YUNTO P 500 Power VA YUNTO P 750 10 YUNTO P 1250 Load VA YUNTO H 400 h 6 D is YUNTO H 600 sr ate of Battery YUNTO Q 450 Device Port dev tty usbse Baudrate ee HA UPS ID 0 Restore Factory Settings c 2001 2007 GENEREX GmbH Hamburg Advanced User Cancel Figure 69 Select UPS Model Page call startupsman config for reo
110. ral specific options for this command depending on the used Unix system The following table displays these options but please check yourself if this matches also for your system and OS Unix Options device name Linux o mode 777 t iso 9660 dev cdrom Sinix F hs dev iosO sdisk id sO 87 Reliant UNIX HP UX SCO Unix Unixware DEC Unix SPARC Solaris IBM AIX Step 3 Step 4 88 F hs o dos ro dev iosO device cdrom F cdfs o cdcase ro dev dsk cOt id dO Oro dev cd0 F cdfs r o fperm 777 dev cdrom cObOt id O f cdfs o noversion dev rz id a F hsfs r dev dsk cOt id d0s2 F hsfs r dev dsk cOt id d0s2 O ro v cdrfs dev cdrom There are two possible case modes of filenames at your CD ROM all file names are upper or lower case This has to be noted when you call the installation programm or when you change the subdirectory at the CD ROM The ISO 9660 specification supports also version numbers at filename so at Some systems you will find suffixes semicolon or dot with filenames As you can abbrivate filnames with wildcards After successfully mounting the CD ROM into your system you can start with installation by calling the install script i e Start the instal script As anext step please start the install script install by entering install or install from the CD Unix directory In case your CD file system does not support the execution please copy the comple
111. reen If you want to change something on a previous screen click the Previous button You may cancel this installation at any time by clicking the Cancel button Installer version 0005 Cancel Previous Figure 60 Introduction Page 62 ae py os es a 7 mal senerex Manage men sonw x i lt Enter your license key LES Management Salling Sate Mo 1 2ad 56a 1tFeiGr ae UPS Software License Key Enter license key 125HA4 Usually the license key is located on the installation booklet or on a label on the rear side of the CD sleeve ae Aa v x a enerex Management Softw Installation and Use of UPSManager Requires Acceptance of the Following License Agreement Copyright The information contained in the manual of this product is nonconditional and may be changed without due notice GENEREX nor the reseller of this product undertakes no obligations with this information The software described in this brochure is given on the basis of a license contract and an obligation to secrecy 7 6 an obligation not to Further publicise i accept the terms of the License Agreement do NOT accept the terms of the License Agreement Cancel 7 Previous Next Figure 62 License Agreement Page Press NEXT to continue 63 v Generex Management Software W UPS Manager W UPS Monitor Web Help 4 gt Descript
112. s it collects the protocol messages from the UPS as a background program service UPSMAN interprets received messages and makes them available to the client module a webserver interface UPS View the WINDOWS UPSMON JAVAMON or to any other SNMP application The data communication to the client modules is achieved via TCP IP or SNMP The SNMP protocol of UPSMAN with UPSMAN MIB is a special private MIB type 1 the UNIX UPSMAN and CS121 web adapters use the newer MIB 2 standard RFC 1213 amp 1628 All UPSMAN clients using TCP IP may using the GENEREX communication protocol UPSMON which is provided as an API to all OEM customers in order to create own applications lf UPSMAN detects voltage variations or a power loss it can execute different system event routines EVENTS which for example may shutdown the server or send warnings to connected users These system event routines which are part of the UPS Management Software are fully customisable The client modules are used for operating and monitoring the active UPSMAN software connected to an UPS You can program UPS Routines e g define dates for automatic UPS tests shutdown the system at defined dates etc check the status of the UPS execute different UPS tests or create power quality statistics With the client modules you can also constantly monitor and evaluate the event protocol log file that is permanently updated by UPSMAN RCCMD Remote Console Command is an additional
113. s batch can be executed from the SPECIAL or EVENTS EXECUTE PROGRAM function Please note that RCCMD should always be additionally configured in the UPS Battery low Event and if the Event UPS shutdown imminent is used RCCMD must always be located before the shutdown UPS in default seconds command For moving the command lines click with the left mouse on the line hold the button and now move the command Sends an E mail Here we use the SMTP email client of your UNIX system sendmail Configure SENDMAIL first before you use this function Enter the E mail address and the corresponding text into the field This action initiates the execute bat on a defined remote client IP address This bat file can be configured individually by the user The user may execute a random program on the remote client computer where the execute bat is located It is also possible to attach parameters whereas these parameters must be added to the execute bat which is executed as described above Executes a configured program Please enter the full path to the executable file Is the desired executable the same directory as the upsman exe or nim no path entry is necessary The handling of other variables is explained further on in this chapter Write to Log file Writes the Event into the local log file of the UPSLOG CSV UPSMAN computer ATTENTION Since ups_conf which is CURSES based is no longer sup
114. slog Warning Shutdown System UPS in default seconds Add Job to List Delete Job from List Exit Menu 25 Root shen Figure 85 UNIX ups_conf Menu Add Job Parameter 97 Please choose the desired function and set when and how often this function should be executed Please note listed functions depend on the used operating system and not all of them might be available In this case please refer to share or freeware programs which allow the desired function The following jobs can be added to a event Send a Shutdown UPS Signal Send Message box with text Send RCCMD SHUTDOWN to remote client 98 Switches the UPS off after a pre set time Please be aware that the UPS is not being switched off before a system shutdown is executed as otherwise important data may get lost This shutdown signal only executes the switch off of the UPS but not the shutdown of connected computers The user can configure a delay in seconds before the switch off is executed This is recommendable when a switching off of an UPS is necessary because of over heating etc Sends a network message Enter a user name or use the character not with NetWare in order to send the message to all users Please note that the Windows 95 98 Clients NT message can only be only received if Winpopup exe or another message service is active Please also consider that net send lt text gt with Windows 95 98 does not function correctly
115. stallation in the welcome screen Choose your language and click the OK button InstallAnywhere will quide you through the installation Itis strongly recommended that you quit all programs before continuing with this installation Click the Next button to proceed to the next screen If you want to change something on a previous screen click the Previous button You may cancel this installation at any time by clicking the Cancel button Installer version 108 Installanywhere Figure 2 Introduction In the next menue you can see the progress column where the next steps are visible Click the NEXT button to continue Enter your license key LES Maragement Software Suite 123456789 108 te are License Key Ideos KT TSS TES Network TDooRXS 123456788 Enter license key Usually the license key is located on the installation booklet or on a label on the reverse side of the CD sleeve lnstaliarnywhere Cancel Figure 3 Enter your License Key In the next menue you have to enter your license key a picture shows an example Enter the license key an click the NEXT button to continue Attention If you enter a wrong license number at this stage the UPS Management software will be set to a 30 day trial version You may enter the correct license in the main window of the UPSMAN configuration at a later stage Please see figure below 10 Model Location
116. start as root the UPSHTTPD onto the system where the UPSMAN is installed upsman_path upshttpd D Advice Please note that it is required to start the UPSHTTPD on Ubuntu OS via sudo s Open a web browser on a random system and enter the following into the address line http IP Console System 8081 jupscfg html It is required to install the JRE Java Runtime Environment Plugins onto the system where you want to start the remote connection and enable the option Allow Starting Of Applets Additionally you have to open the port 8081 tcp in your firewall 192 168 200 114 8081 jupscfg htm Ein Plugin wird ben tigt um diese Inhalte darzustellen Plugin installieren Figure 78 Error message Java plugin 85 Since the end of 2013 JRE plugins are blocked in alle common webbrowsers by default The security settings in the Java control panel have to be changed so that you can still use the Java remote configuration To do this you have to open the Java Control Panel which you can find in the startmenu There you have to switch to the Security tab and set the Security Level to Medium to save this Change click the Apply button Java Control Panel DS General Update a Security Advanced Enable Java content in the browser Security Level ral Very High High minimum recommended CO Medium Least secure setting All Java applications will be allowed to run after presenting
117. t 3 69 Licencekey 145IC4X UPS ID 0 71995 2011 Generex GmbH Hamburg Gemany Figure 31 UPSMAN Device Configuration e Power in VA Nominal UPS voltage output in VA Please do not change the default value unless you want to use the dry contacts communication e Current UPS load in VA Enter here the load currently supplied from your UPS in VA You can read this from the UPSMON the webinterface or from the UPS display E g If your UPS shows a load of 25 and has a nominal power of 1000 VA enter here 250 e Hold time UPS autonomy time in minutes at 100 load E g If your UPS provide according to the manufacturer at 100 load an autonomy time of 30 minutes than enter here 30 e Recharge time Battery recharge time in hours Please do never change the default value unless you get an advice from the manufacturer e Date of Battery Installation A warning for the battery durability will be reported after 4 years depend of type of the UPS 33 Some UPS models have both port types cable and serial To guarantee the correct function of your UPS Management Software use the default settings and the cable provided with the UPS or the software Different cables will be required for different port types e Set battery health level in The UPSMAN version 5 8 00 or higher provides an option for UPSs which are not able to give a result after a battery test The default is 10 that means if the
118. te GENEREX MIB found as MIB file in the UPSMAN directory upsman mib At Linux we support the RFC 1628 standard UPS MIB which is present in most SNMP software already and does not need to be compiled With any SNMP Management software e g HP OpenView Novell NMS etc capable of compiling an external MIB UPSMAN MIB or having the standard RFC MIBs already implemented can now connect to the UPSMAN SNMP agent and read UPS data The UPSMAN software supports the SNMP interfaces from Windows On all other operating systems the UPSMAN does not have an SNMP interface For SNMP data on such OS we recommend to use an SNMP adapter eg CS121 instead In case you use a CS121 the UPSMAN software is obsolete since already running inside the CS121 6 1 UPSMAN with SNMP on Windows To be able to connect to the UPSMAN via SNMP you have to install and configure the Windows SNMP service Open the Windows Components Wizard click Start Control Panel double click Add Remove programs and then click Add Remove programs again In components click Management and Monitoring Tools but do not select or clear its check box and then click Details Select the Simple Network Management Protocol check box and click ok After the SNMP service has been installed you have to configure the SNMP service via the control panel icon Administrative Tools Services Enter the community string of your management station and the address of the trap target and enter th
119. te Unix directory tree to e g TMP and change with CHMOD the execution rights of the install script Start the the installation with install again The procedure can look like this for e g cd CDROM cp pr unix tmp cd tmp chmod 700 inst inst Enter UPSMAN license key Please enter your CD key at this point and choose the desired operating system from the list The installscript tries to recognize your OS and shows a list of OS versions to choose from The found system is already preset and you simply need to confirm the with a Y or RETURN The installation script will copy all required files into the default directory usr ups If you move manually the installation directory later don t forget that also the startup scripts have to be changed Edited the scipts in the directory letc rc2 d the start stop scripts usually carry the names S99Upsman andr K99Upsman This is necessary because these files contain reference to the directory usr ups Step 5 Configuration tools After the files have been copied to the system the configuartion program starts automatically Per Default the JAVA based configuration will be started startupsman conf On as UNIX with a grafical shell the JAVA UPSMAN configuation tool starts and the configuration and look amp feel is identical to the WINDOWS version as described above If no grafical interface is present the user may use the former on C
120. te configuration is possible but UPSView does not start no error message into web browser Solution Manually installation of the libstdc 32bit with the following command yeast anstall libstdc 32 bit t Problem email transmission on Windows OS If the UPSMAN should not transmit emails you can get more information with the program qblat into debug mode Enter the following command out of the UPSMAN default folder C Program Files UPS upsman gblat exe debug to email address of the receiver text C2 Program Files UPS upsman qhlat exe debug to erik generex de test qblat v2 2 8 6 Chuild May 6 2684 16 14 16 gt Sending stdin txt to erik generex de Login name is erik generex de gt gt gt putline gt gt gt AUTH PLAIN AGU yalsAZ3I1dHpreg lt lt get linet lt lt 235 Authentication successful 2 gt put line MAIL From lt erik generex de gt ct lt lt tgetline lt lt lt 258 Ok gt gt gt putline gt gt RCPT To erikP generex de gt lt lt lt qetline lt lt lt 258 Ok gt gt gt put line gt gt gt DATA lt lt qetline lt lt lt 354 End data with lt CR gt lt LF gt lt CH gt lt LF gt lt t gqet linet lt lt 258 Ok queued as 7166243960682 gt eeput line gt gt gt QUIT lt lt lt qet linet lt lt lt 221 Bye Ci Program Files UPS upsman gt Figure 88 qblat Debug 105 Solution Send the faulty output to support generex de Problem with Linux syslog messages
121. ter Modus Inaktiv fa 7 100 v Figure 30 UPSView Scheduler The scheduler allows you to add new jobs which will be executed at the programmed time The UPSMAN logfile will show after the job has been executed about the results of the programmed action Generally the Scheduler shows the actual active job and the time or date when it will be executed Already executed actions are list and automatically removed from the list if those jobs are expired or not longer recursing By Add Entry a new job is created and added to the list With Delete Entry jobs may be removed from the list With Edit Entry you can change an already exisiting job The other functions on the Scheduler should be self explanatory and do not require further explanation Generally we recommend NOT to program more batterytest jobs than once a month Especially fulltests may discharge your UPS batteries to a low level which may damage your batteries if this is made too often We recommend to do only short battery tests and replace the UPS batteries in regular terms interval depends on battery type If you use BACS Battery Analyse and Care System on your UPS batteries you can see the actual status of the batteries and decide when change is necessary Without BACS we recommend to to this on a regular basis 31 3 5 Advanced User Windows UPSMAN Configuration The following part of the user manual explains the advance user configuration items which are optional 3 5 1
122. th exit c tmp GEinstal 5 startupsman Do Once Do after Seconds tmp GEinstal fusr ups GEup Startupsman O Do Every Seconds usr ups GEup Starting UPSMAN con Starting UPSMAN con Starting UPSMAN con Cancel Do Always Do after Seconds repeat Figure 77 Advanced User Insert Function Page The following functions are available in most UPS Send a Shutdown UPS Switches the UPS output off after a pre set time Signal Please make sure that the UPS is not being switched off before a system shutdown is executed as otherwise important data may get lost This shutdown signal only executes the output switch off but NOT the shutdown of connected computers If you define such an action make sure that RCCMD is triggered before The user can configure a delay in seconds before the switch off is executed Send Message box with text Sends a network message to the user at this terminal Enter a user or a machine name or use the character in order to send the message to all users Send RCCMD SHUTDOWN to This is the most important function in this job 81 remote client list it sends a RCCMD shutdown message to RCCMD clients in the network RCCMD Remote Console Command is a program used for the execution of executable files via network mainly used for the remote shutdown of computers with different OS using TCP IP as common basis From RCCMD Version 2 0 it is possible to use the
123. the UPS support service if you encounter communication problems with your UPS 3 6 2 Email to SMS In order to send a SMS message in case of an alarm you have to use the Email to SMS Service of your GSM provider This is a service where the UPSMAN sends an email to the service center of your GSM provider who converts the email into an SMS This service is standard in most GSM networks and very reliable compared to modem solutions For receiving emails as SMS you have to contact your GSM provider to open 45 this service In the following we describe how this works with some GSM providers in Europe since these providers change this very often please refer to the website of your GSM provider to find out how Email to SMS can be activated for your cell phone Example GSM Provider T Systems D1 Your D1 email address will be DiNr t d1 SMS de e g 01711234567 t d1 sms de Please note that you enable receiving emails on your cell phone This is done by sending a SMS with the message OPEN to the number 8000 Only the subject or the text field of the email will be transferred as a SMS 160 characters from the subject and text field Important If you want to stop receiving emails please send a SMS to the number 8000 with the text CLOSE If you want to enable the email transfer again just send a message to the number 8000 containing the text OPEN as described before GSM Provider Vodafone In germany
124. the file with an editor in order to change or check the text of the corresponding message ID Send RCCMD trap message This function enables UPSMAN to send by ID RCCMD2 UNMS traps which shows the UPS status as a text message on the remote client If activated it will display a local message box on the client whenever the UPS status changes Please also note that the RCCMD2 UNMS trap enabled box is activated at the RCCMD client to receive the trap messages Send RCCMD trap message Identical to RCCMD trap messags by ID but the user may define his own text 4 4 5 Email Usage on Linux OS Linux OS contain the program mailx which is using the settings of the mail server A configuration is required to send emails of root via e g GMX An account at GMX for the authentification is required In the following we use the account username gmx de with the password geheim We created the file mailrc into the home folder of root with the following content set smtp use starttls 84 set ssl verify l1gnore set smtp auth login set smtp smtp mail gmx net 25 set from user name lt username gmx de gt Set SMtp auch Uuser user name set smtp auth password geheim The rights were set that root only can read this file chown root root mailre chmod 600 MALLE 4 4 6 Remote UPSMAN Configuration To accomplish the remote UPSMAN configuration onto a system without grafical interface via web browser it is required to
125. the vodafone email to SMS server is called vodafone sms de Please take a look onto the vodafone website of your country for the accordant server name Please note that you enable receiving emails on your cell phone This is done by sending a SMS with the message OPEN to the number 3400 Only the subject or the text field of the email will be transferred as a SMS 160 characters from the subject and text field Important If you want to stop receiving emails please send a SMS to the number 3400 with the text CLOSE If you want to enable the email transfer again just send a message to the number 3400 containing the text OPEN as described before Other providers Please ask your cell phone network provider for informations about the email to SMS settings 3 6 3 Save amp Load Configurations The number of available events and jobs depend on the type of the UPS Although each event and job may differ from UPS to UPS the general configuration process for each job is the same as follows Your configured event files can be saved and loaded for backup purposes or for simply having alternative configurations available 46 Device System Files Mail Server Events Extra Jobs Event UPSMAN started Jobs Log Event Figure 40 Load Save Jobs Your configuration for this UPS model will be saved into a file If you later want to use this co
126. tions To execute tests of your UPS system choose UPS Functions from the menu Functions The results will be displayed in a table The outcome of the tests depend on the settings of the manufacturer Selftest is a UPS hardware check Battery Test is a short test of the UPS working on battery Custom Test switches the UPS on battery mode and will keep discharging the batteries until the downtime has passed With this command you may check your batteries to see if they are still capable of supplying your system with the downtime configured autonomy Full UPS testis a deep discharge of the batteries and is used for calibrating the battery Tests should only be carried out if no user users are active Some tests may be deactivated depending if the UPS supports those features Note Some OEM versions require the default password cs121 snmp to get access to the UPS Functions 30 Attention When running a UPS Full test please note not to interrupt the test as long as it is active If the test gets interrupted the software will configure the autonomy time as the time span of which the test has been running on the UPS before it has been interrupted A test can be re started after a 8 hour waiting period Via the menu Scheduler you can schedule appointments for your UPS UPS Scheduler Windows Internet Explorer L esn Appointments Delete Entry Edit Entry Add Entry Cancel Save Internet Gesch tz
127. tput on the Linux machine Store the cd data into usr ups and start the UPSMAN web server with the command upshttpd Start a java compatible web browser on a machine with graphical interface Enter the following address http lt ip or name of upsman machine gt 8081 jupscfg html Enter the desired configuration data and restart the UPSMAN daemon Done F Error codes UPSMAN List of the UPSMAN Error codes which consist of 4 digits e g 4603 indicates an error at the serial interface Severity information codes OXxxx Success information 1 XXX Severity informational 2XXX Minor error warning 4XXX Major error process stopped Error type X1Xxx Unknown error 118 X2XX X3XX X4XX XDXX X6XX X7XX X8XX Extended error information xxx1 XXX2 XXX3 XXxX4 XXXD XXX6 XXX XXx8 XXX9 XXXxXA xxxB XxxC Out of heapspace Module not installed UPS protocol failure Locked failure during operation Connection failure Capability failure UPS database error Unknown error Error in installation Error at serial interface No communication with UPS but COM port opened OK No answer from UPS within 3 seconds Incorrect data from UPS received Header of UPS protocol is missing or defect Checksum error in protocol string of UPS Unspecified error UPS did not accept the command End of command string or byte was missing COM port could not be opened The following error codes in table are displayed when the UPSMAN
128. tware e g via FTP to the hard drive of your Unix system tmp directory For that purpose copy the complete Unix directory tree The Unix part of the UPSMAN modules is found in the Unix directory As there is no standard binary executeable format for non graphical installations for all the different Unix systems we use a Shell script to install the software onto your computer Usually this shell script should have executable permissions If permissions are set correctly on your CD ROM drive you can start it directly from CD ROM In other cases you have to copy the UNIX folder on your system and use chmod to make the install script executable Using the install script only the UPSMAN modul command line based version of the UPSMON scripting tool to read write to the UPSMAN module eg for reading variables like UPS batteryvoltage start tests etc will be installed on your Unix system Please make sure you have root user rights in order to proceed with the installation using the install script Step 1 Insert your CD lf the reading of the CD file format is not supported by your system proceed as described above Step 2 Mount CD ROM The first step you have to do after inserting the CD ROM into your CD ROM drive is to mount this device i e give the system access to the files at the CD ROM The comon command at Unix systems to mount the CD ROM is like this mount cd rom device mount directory However there are serve
129. umber indicates your device manufacturer You will find the required data into the accordant folder e g Linux OS OEM ID 14 is the manufacturers number the folder 14 contains the accordant files 61 o 14 Konqueror File Edit View Go Bookmarks Tools Settings Window Help e A Gv ie FT imediauPsse1_14 Upsmar Linux 14 SUSE 9 Planet KDE KDE at openSUSE starthim QS 4 B c d lt gt j YA gpg pub txt Install CD_ installer installer installupsm installupsm installupsm versionOE Key bt info properties an bin an bin asc an bin md5 M14 xml Figure 59 Installation Files The displayed files are your required installation files Copy the data into a desired folder and execute the installupsman bin INSTALLATION using ANYWHERE installer installupsman bin G Advice Please note that it is required to execute the installation on Ubuntu OS via sudo s Start the installupsman bin command installupsman bin If you get permission denied use the chmod 777 on install bin command to make the file executable The installation will show the following sequzence of screens please follow the instructions during the installation Generex Management Software InstallAnywhere will guide you through the installation It is strongly recommended that you quit all programs before continuing with this installation Click the Next button to proceed to the next sc
130. urrent operating systems Please use our internetsite for updates and additional information http www generex de B Know How Pool In this section you will find a collection of Know how informationof different operating platforms and operating systems Please note that an update of to the latest version of the UPS Management software will solve many problems and minor bugs Please contact your UPS dealer or visit our webs ite under hittp www generex de The free update to the latest version of the UPS Management software is available from CD version 4 17 Change UPSMAN Window start up in the registry This can be done by changing the script please change the path Hkeylocal_machine system currentcontrolset services in the registry and find the entry start This enrty should be set to 0x2 automatic by default 0x3 manual and 0x0 means that the driver will be loaded by the Kernel loader at startup However 0x1 means that the dribver will be loaded by ethe I O subsystem at Kernel startup Change UPSMON Window PollRate To change the PollRate of the UPSMON to the UPSMAN service it is required to edit the value in seconds into the file upsmon32 ini which is stored into the default folder C Program Files UPS upsmon PollirateSec 5 Figure 90 UPSMON32 INI Edit 108 Example settings SUN Solaris 2 6 2 7 TTY configuration Settngs of the serial interface with the admintool i Admintool Modify Serial Port
131. used can be found in the file message dat in the UPSMAN directory 96 C Root Shell Konsole lt i iA Session Edit View Bookmarks Settings Help Eventlist Powerfail Power restored System shutdown UPSMAN started UPS connection lost UPS connection restored Overload Load Normal OK Overtemperature Temperature Normal OK Battery low Battery charged Battery charging Battery discharing Battery EOL v EF Root shell Figure 84 UNIX ups_conf Event List In order to process the Events please go to the Eventlist in the UPSMAN configuration There is a pre set default for every Event In the above example the event UPS System shutdown imminent is configured with 3 default jobs The first will send a standard message message id 603 which can be edited in the messages dat file The second job will write the event into the log file of the UPS Management software whereas the third job will execute a shutdown after x minutes default Add Event Job In order to add a Job to event please highlight the corresponding event and confirm with the Enter key In the following window the Add Job to List a additional job can be added By using Delete Job from List a single event job can be deleted from the list Exit menu will take the user back to the Eventlist windows see picture J Root Shell Konsole Session Edit View Bookmarks Settings Help Log Event log to sy
132. vent viewer entries by choosing the type informational warning and error and by adding text to the event viewer entries In the Event Viewer you will find the UPSMAN events as Information 8 Upsman Stopped Information 7 Upsman Started For further text entries use this function and add your text and severity Send RCCMD trap message This function enables UPSMAN to send by ID RCCMD2 UNMS traps which shows the UPS status as a text message on the remote client If activated it will display a local message box on the client whenever the UPS status changes Please also note that the RCCMD2 UNMS trap enabled box is activated at the RCCMD client to receive the trap messages Send RCCMD trap message Identical to RCCMD trap messags by ID but the user may define his own text 3 6 Avanced User Special Tools and Configuration Advices 3 6 1 Advanced User UPSMAN Debug and Line raw Tools After the installation the files are found in default c program files ups Directory Here the files of the UPSMAN and UPSMON other optional components have subdirectories UPSMAN DEBUG Usually UPSMAN windows starts as service in the background If you want to start UPSMAN as application in the foreground to create tracefiles than open a command line stop any upsman service and enter upsman debug Thereby the UPSMAN service will display support information at the command line This information may be requested from
133. ver you use a COM port The installation of 3 party drivers will be through in some seconds after this you may receive a message to reboot your computer This may be ignored if you have already a USB driver from prolific on your system In other cases please try first to communicate with the UPS through UPSMAN and restart your system only if the communication or the search UPS does not work at once NOTE If a reboot is necessary you can continue the configuration by clicking in the Program group on UPSMAN configuration the configuration will pop up and you can continue the configuration following the instruction on the next pages The main configuration page of UPSMAN is the DEVICE PAGE DEVICE PAGE Device System Files _ Mail Server Events Model No UPS model defined v ROpen Search Location Power VA 500 Hold time m 10 v Load VA 500 Recharge time h 6 Date of Battery Installation DD MM YYYY 27 07 2011 Device Port COM1 Baudrate Address Listen Port Licencekey 14SIC4X UPS ID Reset to Factory Settinas 1995 2011 Generex GmbH Hamburg Germany Figure 13 UPSMAN Configuration 16 When the UPSMAN configuration starts up choose from the UPS modellist your UPS type or use Search UPS to make UPSMAN try to identify your UPS type If not clearly identified the UPSMAN will show you a list of UPS devices which are
134. ving choosen the correct UPS type the UPSMAN standard installation is finished If you press now OK the UPSMAN service will ask to start press YES and if no further error message appears within 1 minute the UPSMAN will now watch the UPS and send messages in case that an alarm occurs If the UPS runs on battery and the battery have 17 only 3 minutes left the UPSMAN will automatically shutdown this computer In case of alarms a messagebox will pop up similar to the one above and the user can connect with UPS VIEW UPSMON or any other graphical viewer to see the actual UPS alarms UPSMAN runs in windows as service see windows service list how to stop start the upsman and related services If A Services o s File Action View Help es MEn H m au mp amp Services Local Services Local UPSMan Name Description Status Startup Type LogOnAs A UNMS UPS Networ Manual Local Syste Description M UPnP Device Host Allows UPn Manual Local Service USV Manager f r fe Unterbrechungsfreie Si UPSMan USV Manag Automatic Local Syste Stromversorgung Dieser Service UPSMAN HTTP Started Automatic Local Syste berwacht Ihre USV und sendet User Profile Service This service Started Automatic Local Syste Netzwerk Nachrichten und RCCMD Virtual Disk Provid M Syst Shut Down Signale in Ihr Netzwerk B rea as TOVTEER M anug Soca Ayssi wenn ein l ngerer Stromausfall VMware
135. want to install a subset of features from this installer make a list of a features you want to be installed The List must be entered in the CHOS N INSTALL FEATURE LIST variable for t ist are UPSMan UPSWeb UPSMon Plic2 Help FEATURE LIST UPSMan UPSWeb UPSMon Plfc2 Prolifi Help Choos Enter your OEM number here OCEM 0 FE Ch FF If you want to install a different language than English you will want to yvi valid country code here This is only im t for si gt installations Valid codes are zh c je fr el it ja c gt 19 silent installation your License Key must be provided here GXLICENSEFEY yournumber GXLICENSEKEY gz 0c F If you want to use the installer in Console mode with a command line interface or in silent mode with no user interaction you can set this variable to one of the offered value Options are silent console INSTALLER UI silent INSTALLER UI silent Figure 71 Content of the installer properties It is required to remove the hash mark prior of the variable INSTALLER UI silent In addition the setting of the license key is required behind the variable GKLICENSEKEY Execute the installupsman bin as root If you want to activate the console installation it is required to remove the hash mark prior of the variable INSTALLER UI console and to set the word console instead of silent The UPS Management So

Manual - Generex

Contents

Download Pdf Manuals

Related Search

Related Contents