Powerware NetWatch for NetWare
Installation and Configuration Instructions


Note: This document applies to Powerware NetWatch 5.0.1 for NetWare.

Click on any link to move to that section...


Introduction

Powerware NetWatch for Novell NetWare monitors the status of a UPS being managed by a Powerware Shutdown Server such as a ConnectUPS-X, ConnectUPS-BD, ConnectUPS-E, Network Management Card(NMC) or BestLink Web/SNMP Card. During an extended power failure, the Powerware NetWatch may alert users that are logged into the server, log UPS-related events to a log file and if necessary, shut down the NetWare operating system before the UPS reaches a critical, low battery condition.

For Powerware Shutdown Server users, Powerware NetWatch for Novell NetWare also incorporates the shutdown client functionality required for a Powerware Shutdown Server to control the shutdown of one or more NetWare servers during an extended power failure. NetWatch client software is available separately for those other operating systems (Windows XP, 2003, Vista, 2008 and UNIX) that also need to be shutdown automatically by a Powerware Shutdown Server.

This NetWatch software is compatible with Novell NetWare versions 5.x, and 6.x. As you progress through the configuration of the Powerware NetWatch software for Novell NetWare, be advised that all configuration updates are applied to the main NetWatch Configuration display. Due to the nature of the NetWare screen interface, they will not be displayed on any overlay windows that are open as they cannot be updated dynamically.

Back to Top of Page



Firewall User Notice

NetWatch normally requires UDP ports 200, 2844, and 2845 for communicating with Web/SNMP Cards and 4679 and 4680 for Network Management Cards(NMC). If your system uses a Firewall, then these ports must be unblocked.

See the Option: Advanced Network Settings topic for more information about UDP port configuration.

Back to Top of Page


How Netwatch shuts down your NetWare Server

Powerware NetWatch monitors the status of a UPS being managed by a ConnectUPS-X, ConnectUPS-BD, ConnectUPS-E, Network Management Card (NMC) or BestLink Web/SNMP Card. During an extended power failure, the Web/SNMP/NMC Card will send NetWatch UPS ON BATTERY or UPS SHUTDOWN IMMINENT messages. NetWatch will react to these message according to how the NetWatch Shutdown is configured.

NetWatch Shutdown Methods

  1. Web/SNMP Card Initiated Shutdown: When NetWatch receives a UPS SHUTDOWN IMMINENT message from the Web/SNMP Card, it will initiate the System Shutdown Process.
  2. Time ON Battery: When NetWatch receives a UPS ON BATTERY BACKUP message from the Web/SNMP/NMC Card, it will begin a countdown time based on the number of minutes selected for the length of Power Failure value (m), selectable from 1 to 99 minutes, with the default being 5 minutes. After m minutes, NetWatch will initiate the System Shutdown Process. If NetWatch receives a UPS SHUTDOWN IMMINENT message from the Web/SNMP/NMC Card during the countdown period, it will immediately begin the System Shutdown Process. If NetWatch receives an AC Power Has Been Restored message from the Web/SNMP/NMC Card during the countdown period, the shutdown process is halted, and NetWatch will return to normal status.

System Shutdown Process

Once the System Shutdown Process has begun, communications with the Web/SNMP/NMC Card are terminated, and OS shutdown is mandatory. The length of the System Shutdown Process is controlled by 2 variables:

  1. Time To Allow For User Logout
  2. Minutes Required For Batch File Execution (if Batch File is Enabled)

The System Shutdown Process will wait the Time To Allow For User Logout period, and then the Minutes Required For Batch File Execution before shutting down the NetWare OS.

Important!

Make sure that there is enough UPS Battery Runtime to accomplish either shutdown method before the UPS shuts down and AC power is lost.

Back to Top of Page


Installing NetWatch on a NetWare Server

File Installation Process

  1. Copy NetWatch_501_NetWare.zip on your workstation.
  2. To unzip the file, double-click on NetWatch_501_Netware.zip from the file manager, or type NetWatch_501_NetWare.zip and press Enter.
  3. The software files will be unzipped to the default directory "NW_Netware" in the same drive.
  4. At the server console/Rconsole prompt, type NWCONFIG
  5. Select Product Options > Install a Product Not Listed.
  6. Depending on where you unzipped the NetWatch files complete one of the following steps:
    • From your local workstation, press F4, then specify the path, including the drive name (for example, C:\NW_Netware).
    • From the local SYS volume, press F3, then specify the path, including the volume name (for example, SYS:\<directory name>).
    • From a different server on the network, press F3, then specify the full path including the server name. (for example, <server_name>\VOL1:\<directory name>). You will be prompted for a login name and password for the other server.
  7. Press Enter. The Installation Group menu will be shown:

    Install Menu Selection

Back to Top of Page


Uninstalling NetWatch from a NetWare Server

File Uninstallation Notes

Expand the self-extracting file NetWatch_501_NetWare.zip into a directory on your workstation. Follow the specific install requirements for each version of NetWare.

File Uninstallation Process

  1. Copy NetWatch_501_NetWare.zip on your workstation.
  2. To unzip the file, double-click on NetWatch_501_Netware.zip from the file manager, or type NetWatch_501_NetWare.zip and press Enter.
  3. The software files will be unzipped to the default directory "NW_Netware" in the same drive.
  4. At the server console/Rconsole prompt, type NWCONFIG
  5. Select Product Options > Install a Product Not Listed.
  6. Depending on where you unzipped the NetWatch files complete one of the following steps:
    • From your local workstation, press F4, then specify the path, including the drive name (for example, C:\NW_Netware).
    • From the local SYS volume, press F3, then specify the path, including the volume name (for example, SYS:\<directory name>).
    • From a different server on the network, press F3, then specify the full path including the server name. (for example, <server_name>\VOL1:\<directory name>). You will be prompted for a login name and password for the other server.
  7. Press Enter. The Installation Group menu will be shown.
  8. Use the UP and DOWN arrow keys to highlight a file group. Use the SPACEBAR to select/deselect options. Deselect the INSTALL and ADD groups, and select the UNINSTALL group.
  9. Press F10 to accept the marked option and continue.
  10. Press Enter to end.

    Uninstall Menu Selection

Back to Top of Page


Loading and Configuring NetWatch on a NetWare Server

Loading the NetWatch NLM

As administrator of your NetWare server, gain access to the SYS:SYSTEM directory and type the following to start the NetWatch software:

load netwatch

To load the NLM and reset the NetWatch configuration defaults, type the following:

load netwatch i

Back to Top of Page


Select Monitoring Option

The Monitoring Options selection box will be displayed containing the following choices:

Select Powerware Shutdown Server to advance to the next option menu.

If you need to reset the program to its factory defaults, select Reset Defaults.

Back to Top of Page


Option: Powerware Shutdown Server

Upon selecting Powerware Shutdown Server as the Monitoring Option, you will then be presented with the following Shutdown Server Options menu:

Select Shutdown Server Menu

To begin monitoring a Powerware Shutdown Server, follow one of the steps listed below:

Discover Powerware Shutdown Servers

NetWatch will attempt to locate any ConnectUPS, Network Management Card(NMC) or BestLink Web/SNMP Cards on your network using a 255.255.255.255 IP network broadcast. Upon doing so, NetWatch will present a Shutdown Servers list from which you can select the IP Address (or Hostname) of the ConnectUPS, NMC or BestLink you wish to obtain your UPS status data from. Typically, you would pick the one that is monitoring the UPS that provides power to the NetWare server you are currently configuring NetWatch software for. Selecting a valid IP Address from the list and pressing Enter starts the communications process with the Powerware Shutdown Server.

Enter Shutdown Server IP Address, Hostname, or Subnet Broadcast IP Address

Select Enter Shutdown Server IP Address, Hostname, or Subnet Broadcast IP Address - If for some reason, the Powerware Shutdown Server you wish to monitor is not listed in step 1, then you may enter its IP Address or Hostname manually, or perform a discovery within an IP Address Subnet. If using a Subnet Broadcast IP Address, please fill in the proper broadcast address taking into consideration the subnet mask configuration of your network card(s). An example Subnet Broadcast IP Address could be '10.222.51.255'. Selecting a valid IP Address from the discovered list and pressing Enter will start the communications process with the Powerware Shutdown Server.

Use Current Shutdown Server Configuration

Select Use Current Shutdown Server Configuration – Upon selecting this option, NetWatch will use the Server IP Address or Hostname listed in the NetWatch Configuration display box, the communications process with the Shutdown Server will be started.

Back to Top of Page


Option: Advanced Network Settings

Select option 2 in the Select Monitoring Option menu to bring up the Advanced Network Settings selection menu.

UDP Port Selection

The UDP ports that NetWatch uses to discover and monitor Powerware Shutdown Servers can be customized if required.

  1. Default - NetWatch will use Powerware assigned UDP port numbers (2844 and 2845) and NMC assigned (4679 and 4680) for network communications.
  2. Manual - Use this option if UDP ports need to be some value other than default. The allowable range of port values is (2000-32000). Use caution in selecting port numbers in order to avoid conflicts with other programs that may be using the same port numbers. The Discover and Monitor port settings must be different.
  3. Note: For MGE Network Management default ports used for communications are (4679 and 4680).

  4. Random - NetWatch will use random UDP port numbers for network communications. These port numbers will change each time NetWatch is run.

Network Address Translation (NAT) Selection

Select this option if your network uses a Network Address Translation (NAT) firewall between the computer running the NetWatch client software and the Powerware Shutdown Server.

Back to Top of Page


Shutdown Server Monitoring Started

Once communications has been established with the Shutdown Server to be monitored, the NetWatch main screen is updated, showing the current ConnectUPS, NMC or BestLink (monitoring) Configuration and the current (simple) status of the UPS being monitored.

Normal Monitoring Screen

Back to Top of Page


Selecting NetWatch Options

Proceed by configuring NetWatch to correctly handle UPS-related events, including possible operating system shutdown. To do so, press the F8 key for more options.

Upon doing so, you will be presented with the following options:

Edit Configuration

Configuration Screen

Operating System Shutdown Options:

There are three shutdown options to choose from:

Selecting the current shutdown option and pressing the Enter key displays the three choices (in alphabetical order as shown above). Once you make a new selection, NetWatch requires that you provide any timing value associated with that choice. The shutdown options are explained in detail below.

Operating System Shutdown Disabled

By default, this selection is disabled. If a power failure occurs the UPS will turn off based on the configuration of the Shutdown Server or it will (alternately) runs out of battery runtime and just turn off. If you select this option, the server will not be properly shut down, however, you will receive notification on power-related events as communicated by the Shutdown Server.

Start Shutdown after Operating on Battery for 5 min

By default, this selection is disabled. This allows the NetWatch NLM to start the automatic shutdown of the NetWare server at a specific amount of time following the start of a power failure as reported by the Shutdown Server.

The user is allowed to select a length of Power Failure value (m) from 1 to 99 minutes, with the default being 5 minutes.

The value you choose instructs NetWatch to wait m minutes after the start (and continuation) of a power failure before starting the automatic shutdown of the NetWare server.

Please note that the occurrence of a UPS-generated, Shutdown Server -reported Low Battery Alarm before the length of the power failure reaches the number of minutes selected, causes the start of an immediate shutdown.

Start Shutdown only when instructed by the Shutdown Server

By default, this selection is enabled. It instructs the NetWatch NLM to only start the automatic shutdown of the NetWare server whenever the settings of the Web/SNMP Card dictate. By default, the Web/SNMP Card is configured to wait until a UPS-generated Low Battery alarm before forcing the server’s shutdown through the NetWatch client.

Back to Top of Page


Time To Allow For User Logout Before Shutdown Begins (Default: 2)

NetWatch will wait this many minutes after determining that the Shutdown Process has begun. This wait time is to allow users enough time to logoff the system before OS shutdown commences. NetWatch will broadcast a logoff message every minute during this wait period.

To change the numerical value, press Enter to select the setting. Then type in the number of minutes required, followed by pressing Enter again to accept the setting.

Execute Batch File prior to Operating System Shutdown (Default: No)

If you need to run a batch file prior to the actual NetWare shutdown, you may instruct NetWatch to do so.

To change the value, press Y for Yes or N for No, followed by pressing Enter.

Minutes Required for Batch File Execution (Default: 1)

If you enable the Execution of a Batch File prior to the NetWare shutdown, you must instruct NetWatch how long it needs to wait for the batch file to complete its execution.

This time can range from 1 to 60 minutes, but the user must be conscious of the other numerical settings on the Shutdown Server to ensure enough time is allowed for the system to complete its shutdown prior to the UPS running out of battery runtime or turning off under the control of the Shutdown Server.

To change the numerical value, press Enter to select the setting. Then type in the number of minutes required, followed by pressing Enter again to accept the setting.

Batch File Name (Default: SYS:SYSTEM\NETWATCH.NCF)

Pressing Enter to select this setting, allows the user to edit the actual batch file from within NetWatch.

Enable Event Logging (Default: Yes)

By default, UPS-related events are logged into the file SYS:SYSTEM\NETWATCH.LOG. You may instruct NetWatch not to log the events as they happened, but this is not recommended.

To change the value, press Y for Yes or N for No, followed by pressing Enter.

Enable Event Message Broadcasting (Default: No)

By default, UPS-related events are not broadcast as messages to logged-in users. In most cases it is desirable to keep users informed as UPS-related events take place.

To change the value, press Y for Yes or N for No, followed by pressing Enter.

Start Monitoring when NLM is loaded (Default: Yes)

Once you successfully establish communications with a Web/SNMP/NMC Card, NetWatch automatically updates this setting to Yes. By doing so, NetWatch will start monitoring the Web/SNMP/NMC Card each time the NetWatch NLM is loaded.

Back to Top of Page


View Event Log

Select View Event Log to allow you to scroll up or down in the Event Log found on the bottom of the NetWatch main screen. The up and down arrow keys found on your keyboard will then be active. Press the Esc key to exit the log

View Event Log File

Select View Event Log File to allow you to view the physical NetWatch log file found at SYS:SYSTEM\NETWATCH.LOG. All four arrow keys found on your keyboard will then be active. Press the Esc key to exit the log.

Stop Monitoring

Select Stop Monitoring to instruct NetWatch to discontinue monitoring the UPS in the current manner. This is useful during initial testing, but should be used with caution since no UPS monitoring or automatic shutdown functionality will be active if monitoring has been discontinued.

Exit

Select Stop Monitoring to instruct NetWatch to discontinue monitoring the UPS in the current manner. This is useful during initial testing, but should be used with caution since no UPS monitoring or automatic shutdown functionality will be active if monitoring has been discontinued.

Back to Top of Page


NetWatch Command Line Options

Type load netwatch h at the console to display the NetWatch command line options.

Note: For NetWare 6.x, the help text output will be directed to the Logging Screen, rather than the System Console.

Powerware NetWatch v5.0.1.3 Copyright 1998-2009 Eaton Corporation. All Rights Reserved.
------------------------------------------------------------------------------
Usage: netwatch [arguments]

All parameters indicated with [ ] are optional.

[help|h|usage] - Help for command line usage

[i]            - Initialize program defaults and load netwatch.

Back to Top of Page