UPS Utility Manual
1 INTRODUCTION........................... 5
1.1 Intended Users............ 5
1.2 Product Environment 6
1.2.1 Hardware Environment.................. 6
1.2.2 Software Environment.................. 6
1.3 Product Structure...... 6
2 UPSUTIL OVERVIEW...... 7
2.1 Functional Overview...... 7
2.2 Product Invocation and Security........ 7
2.3 Use of Files.............. 9
2.4 Product Restrictions & Limitations... 9
2.4.1 Batch Mode Limitations 9
2.4.2 Language Localization Limitation 10
2.5 UPSUTIL User Interface..................... 11
2.5.1 Type of User Interface 11
2.5.2 UPSUTIL Commands Summary 11
2.5.3 General Command Parser Errors................ 11
3 UPSUTIL Commands..... 13
3.1 HELP Command... 14
3.2 EXIT Command... 15
3.3 CONFIG Command... 16
3.4 NEWCONFIG Command... 18
3.4.1 Requirements for UPS Monitor Configuration Files.... 19
3.4.2 UPS Monitor Configuration Options 20
3.4.2.1 Powerfail Message Routing 20
3.4.2.2 Powerfail Command File..... 20
3.4.2.3 Powerfail Grace Period 21
3.4.2.4 Powerfail Low Battery 21
3.4.3 The Default UPS Monitor Configuration File...... 22
3.4.4 If No UPSCNFIG.PUB.SYS File Exists...... 23
3.4.5 Observing Results of NEWCONFIG Command................ 23
3.5 STATUS Command... 27
3.5.1 The Status Display.. 28
3.5.2 UPS Monitor Process Status Display.. 28
3.5.2.1 UPS Monitor Operating State... 28
3.5.2.2 UPS Monitor Version Number 28
3.5.2.3 System Power State... 29
3.5.2.4 Powerfail Recovery Messages............ 29
3.5.2.5 Configuration File Name.. 29
3.5.2.6 Powerfail Command File Name............ 30
3.5.2.7 Powerfail Command File Parms............ 30
3.5.2.8 Powerfail Grace Period 30
3.5.2.9 Powerfail Grace Timer.. 30
3.5.2.10 Powerfail Command File..... 31
3.5.2.11 Action on UPS Low Battery 31
3.5.2.12 Pin...... 32
3.5.2.13 UPS Devices Configured......... 32
3.5.2.14 UPS Devices Monitored......... 32
3.5.2.15 UPS Devices Allocated............ 32
3.5.3 UPS Devices Status Display.. 33
3.5.3.1 UPS #. 33
3.5.3.2 LDEV # 33
3.5.3.3 Alloc (Allocated Indicator)............ 33
3.5.3.4 Init (Initialized Indicator)............ 33
3.5.3.5 State... 34
3.5.3.6 Power. 34
3.5.3.7 Hardware Status 35
3.5.4 Additional Examples 36
3.6 RESETPFAIL Command... 43
3.7 START Command... 45
Page
2
of
48
UPS Utility
7/18/2008
http://jazz.external.hp.com/papers/upsutil.htm