PowerChute network shutdown
Installation Guide

 
Table of Contents
 
Installation

Requirements:

  • APC UPS which supports the use of an APC Web/SNMP Management Card. This currently includes any Smart-UPS with a SmartSlot, any Smart-UPS DP, any Matrix Rev Y firmware and later, any Symmetra, and any Silcon DP300E.
  • APC Web/SNMP Management Card (APC part number AP9606) which has a PowerChute link under the UPS navigation menu of the web interface. If your APC Management Card does not have a PowerChute link under the UPS Navigation menu, you must update the firmware; obtain APC OS(AOS) firmware module and Application firmware module version 2.x from APC's web site.
    Note: PowerChute network shutdown cannot be used with APC SNMP PowerNet Adapters. If your card is an APC part number AP9605, AP9205, or AP9603, contact APC support or your APC dealer about upgrading the card.
  • One of the following operating systems (click on the operating system to see specific versions): Windows NT, NetWare, HP-UX, Solaris, Linux, AIX.
  • IP address for the APC Management Card.
  • A monitor with 800x600 or greater resolution.

  • Note: APC does not recommend using PowerChute network shutdown on the same computer as PowerChute plus

Below are the basic steps required to install and operate the PowerChute network shutdown software.

1.   Install the APC Management Card in your UPS (See the Management Card Installation Guide and Quick Start)

It is recommended that you install the Management Card in your UPS and configure it with an IP address before beginning the software installation. You can install the software first, but additional steps will be required when installing the Management Card. Refer to your Management Card User Manual for instructions on installing the Management Card.

2.   Set an IP address for the Management Card (See the Management Card Installation Guide and Quick Start)

PowerChute network shutdown will communicate with the Management Card in your UPS. Your Management Card must have an IP address. The Management Card and the systems running PowerChute network shutdown do not need to be on the same domain.

3.   Configure the UPS and the Management Card

Use the Management Card user interface to configure the UPS so that it meets your needs. At a minimum, APC recommends setting the following:
  • On the Configuration page, set the Low-Battery Duration to at least five minutes
  • On the User Manager page, set the Administrator User Name, Password and Authentication Phrase. You will need to enter the same information when you install the software.
Note: The Management Card uses the same default User Name, Password and Authentication Phrase as the software, so you can leave them at the default settings if you wish.

Note: If you are installing PowerChute network shutdown on more than 50 computers powered by the same UPS, then please read the document "PowerChute network shutdown with a UPS powering more than 50 computers" available on the APC web site. If you have 50 or fewer computers powered by a single UPS, then proceed with the installation as described below

4.   Select the installation program for operating system(s) that you require. The installation program runs on a server. Start the PowerChute network shutdown program:

On Windows NT, you can double click the install program icon or launch the self-extracting executable on a command line.

For NetWare, follow the instructions in the NetWare section below.

For installation on AIX, Solaris, Linux and HP-UX, change your working directory to the directory containing the installation files, then type:

<Java home dir>/bin/jre -cp .:pcns200.jar:swingall.jar:util.jar load

You can also use the Silent Installation to set up many servers on the same UPS and with the same PowerChute network shutdown configuration.

You will be prompted with the following message:
"You are about to install a new application. Continue?" Choose "yes" to continue the installation.

Note: If you already have PowerChute network shutdown installed, the installation program will overwrite the old version. If you cancel the installation after this point, your old installation will no longer function. You must complete the installation process to have a fully functional version of PowerChute network shutdown.

5.   When the "About" box is displayed, select Next.

6.   Review the PowerChute network shutdown license agreement:

If you accept the agreement, select "I Agree" to continue with the installation. If you do not accept the agreement, select "Cancel." You will not be able to install PowerChute network shutdown if you do not accept the license agreement.

7.   Select the location where you want the PowerChute network shutdown software to be installed:

APC recommends the default location. You may choose another location by typing in the full path name, or by using the "Browse" button. Be sure to include the drive letter or volume name in the path name.
When you have chosen the directory, select Next.

8.   Enter the Initial Configuration information:

  • Management Card IP: This is the network address of the APC Management Card attached to your UPS. The installation program will automatically register with the Management Card if the Card is available on the network. If the installation program cannot register with the Management Card, you will receive a message; you may install the software, but you must manually enter the server IP address at the Management Card.
  • The http port number being used by the Management Card. The default is 80; you do not need to change this unless you have changed the http port being used by your Management Card.
  • The PowerChute network shutdown http port number. The default is 3052. You do not need to change this unless this port is already in use on your system. Port 3052 is registered for use by PowerChute network shutdown, so it should be available.
  • Click "Next" to continue.

9.   Enter the Security Configuration information

The communication between PowerChute network shutdown and the Management Card is authenticated. The User Name and Authentication Phrase are used for this authentication, and they must be the same for PowerChute network shutdown and the Management Card. The User Name and Password are used to log into the user interface for PowerChute network shutdown and for the Management Card. It is recommend that the password be the same for both user interfaces. The default settings for PowerChute network shutdown and for the Management Card are the same. If you have not changed the default settings in the Management Card, you can select Next; otherwise, enter the correct information now.

10.  Complete the Software Installation

After you complete the Security information and select Next, PowerChute network shutdown will register with the Management Card. This means that PowerChute network shutdown and the Management Card will be able to communicate. If this registration fails, you will receive an error message. The most likely reason for the registration to fail is that the User Name and Authentication Phrase are not correct.
If PowerChute network shutdown cannot register with the Management Card, you may continue the installation, but you will have to manually enter the server IP address at the Management Card.
To manually enter an address at the Management Card, or to confirm that PowerChute added the address, open the Management Card user interface and select the PowerChute menu option.
Note: If you select the Cancel button to stop the installation, you must then delete the PowerChute directory.

11.  Start the PowerChute network shutdown process

The PowerChute network shutdown service will start automatically when the installation is completed. The installation files can be deleted.
Note: After installation, set access on the PowerChute directory so that only authorized users can access, execute or remove the software.

12.  Open the PowerChute network shutdown user interface

Using a web browser, enter either of the following URLs:
{servername}:3052
{serverIPaddress}:3052
For example, if your server is named COMP1 and has an IP address of 159.215.6.18, use one of the following URLs:
COMP1:3052
159.215.6.18:3052
If, during the installation of PowerChute network shutdown, you chose a web server port other than 3052 (the default), then use that web server port in the URL.
Note: PowerChute network shutdown has been designed for use with the following browser versions:
  • Microsoft Internet Explorer version 4.0 or newer
  • Netscape Navigator version 4.05 or newer
If you are using a browser version other than these, some functions may not be available.
 
Silent Installation

On Windows NT and Unix systems, you can install PowerChute network shutdown from a command line, which allows you to quickly set up many servers which communicate with the same Management Card, and which have the same PowerChute network shutdown configuration. To silently install PowerChute network shutdown, perform the following procedure:

    1.  Complete a normal installation.
    2.  Configure PowerChute network shutdown to have all of the desired settings.
    3.  Copy the m11.cfg and silentInstall.ini files from the PowerChute directory.
    4.  Put a copy of the m11.cfg file, the silentInstall.ini file and the PowerChute network shutdown installation program (pcns200.exe) into a temporary directory on the new server.
    5.  Edit the applicationDirectory parameter in the silentInstall.ini file to reflect the desired installation directory of the PowerChute network shutdown application.

    Note: When editing the silentInstall.ini file, do not enclose values in quotes, and preface all path separators ('\' for Windows, '/' for Unix) with an escape character ('\')

    6.  Set the RegisterWithAdapter parameter in the silentInstall.ini file to "yes" or "no" to indicate whether the installtion should register this host's IP address with the Management Card.

    Note: If you are installing PCNS on more than 50 hosts for one Management Card, please read the document "PowerChute network shutdown with a UPS powering more than 50 computers" available on the APC web site.

    7.  Uncomment and edit the adapterIPAddress parameter in the silentInstall.ini file if you want to use the same configuration for multiple Management Cards and are installing to a different Management Card than the one used to create the m11.cfg file in steps #2 through 4 above.
    8.  For a native install (Windows NT, Solaris, Linux), type the following at the command line:
    C:\ <temp dir> \ pcns200.exe -q <temp dir>\silentInstall.ini
    where <temp dir> is the location of the Installation program AND the valid m11.cfg and silentInstall.ini files

    Note: If you are using directory names with spaces, enclose them with quotation marks. For example:
    C:\pcinstall\pcns200.exe -q "C:\Program Files\InstallDir\silentInstall.ini"
    OR
    C:\pcinstall\pcns200.exe -q C:\Progra~1\InstallDir\silentInstall.ini
    For a UNIX install, use the following:
    <Java home dir>/bin/jre -cp .:pcns200.jar:swingall.jar:util.jar load -q <temp dir>/silentInstall.ini>
    Once you have completed the installation, you must check the install.log and errors.log files for error conditions.
 
Registering an IP Address with the Management Card

If the Installation program cannot communicate with the Management Card, you must manually register the IP address of the PowerChute network shutdown computer. In some cases, the Installation program registers the IP address, but is unable to confirm that it is registered; in this case, you must check to insure that the IP address is registered.

Access the Management Card web user interface by using the Management Card IP address as the URL.

From the Management Card user interface, click on the UPS model name displayed on the menu. Select the PowerChute menu option. This will display a list of the IP addresses which are registered with this Management Card.

To add a new IP address, type in the IP address of the PowerChute network shutdown server in the Add Client IP Address field, and select the Add button.

To remove existing IP addresses, select each address from the Configured Client IP Addresses list, and select Remove.

 
PowerChute network shutdown Configuration Utility

The PowerChute network shutdown Configuration Utility is a stand-alone utility that is not part of the PowerChute network shutdown user interface. The Configuration Utility allows you to change the following PowerChute network shutdown settings, once you have successfully installed PowerChute network shutdown:

  • IP address of the Management Card to monitor
  • Port number of the Management Card to monitor
  • PowerChute network shutdown port number
  • Administrator User Account
  • Administrator Password
  • Security Phrase

Run the Configuration Utility using the following command:

<Java home dir>\bin\jre -cp .;confutil.jar;swingall.jar;m11.jar PCNSUtilApp
Note: On UNIX platforms, substitute ":" (a colon) for ";" (a semicolon).
The Configuration Utility can also be used to set up m11.cfg files for silent installations to monitor multiple Management Cards. To use the same PowerChute network shutdown configuration for multiple Management Cards:
  1. Perform a complete installation
  2. Copy the m11.cfg file to \lib directory
  3. Run the Configuration Utility.
  4. Use the Configuration Utility to change the Management Card IP address
  5. Use the modified m11.cfg file to perform a Command Line install (see Silent Installation, step #4, in the Installation Guide)
 
PowerChute network shutdown on Windows NT

You must have Windows NT version 4.0 to use PowerChute network shutdown. APC recommends using the latest available Service Pack.

The PowerChute network shutdown service starts automatically when you finish the installation program.

The PowerChute directory includes executables to shut down some common applications. See the Configure Events section in the Help file for details on setting up PowerChute network shutdown to run these executables.

  • shutnote.exe - To shut down Lotus Notes
  • shutback.exe - To shut down Microsoft BackOffice
  • shutiis.exe - To shut down Microsoft Exchange Server
  • shutncs.exe - To shut down Netscape Enterprise Server
 
PowerChute network shutdown on NetWare

You must have NetWare 5.0 to use PowerChute network shutdown.

A Java Virtual Machine (JVM) is required on your server. NetWare 5.x includes a JVM.

Before installing PowerChute network shutdown, make sure that the SYS:\ETC\HOSTS file includes a line with your file server's IP address and server name.

Installing PowerChute network shutdown on NetWare requires a screen resolution of 800x600 or 1024x768.

Install PowerChute network shutdown on NetWare using the following procedure:

  1. Copy the .zip files to a temporary directory on the SYS: volume of the NetWare file server (note the name of the temporary directory for future use), then unzip the installation files.
  2. From the server's System Console command prompt, enter the following commands (where tempdirectory represents the temporary directory name noted in Step 1):
    load Java   <Enter>
    envset CWD=SYS:\tempdirectory   <Enter>

    Note: The following envset command must be entered on one line:
    envset CLASSPATH=$CLASSPATH;SYS:\tempdirectory\pcns200.jar;SYS:\tempdirectory\util.jar;
    SYS:\tempdirectory\swingall.jar   <Enter>
    Java load   <Enter>
  3. Follow the instructions in the Installation section of this guide.
    The Browse function is not available on the Installation Directory screen. If you do not wish to use the default directory, type in the new full directory path.

This will install PowerChute network shutdown on the SYS: volume. To install to a different volume, use the appropriate volume name in the command above.

Stop the PowerChute process using the following procedure:

  1. enter the following command at the server prompt:
    java -sh
  2. Note the process number of the PowerChute process, then type:
    java -kill{process number}
where {process number} is the number of the PowerChute process. For example, if the process number is 22, the command is:
java -kill22
To start the PowerChute process, execute the APCpcns.ncf file in the PowerChute directory.
 
PowerChute network shutdown on HP-UX

You must have HP-UX 10.20 or 11.00 to use PowerChute network shutdown. XWindows is required to install PowerChute network shutdown.

PowerChute network shutdown requires a Java Virtual Machine (JVM) on your server. Obtain this JVM and the associated operating system patches from the HP web site, or contact your HP service provider.

Install PowerChute network shutdown on HP-UX using the following procedure:

  1. Place the PowerChute network shutdown tar file in a temporary directory.
  2. Unwrap the files using the command "gzip -cd pcns.tgz | tar -xvf -"
  3. Make sure the location of the JVM executable (jre) is in the PATH environment variable.
  4. Follow the instructions in the Installation section of this guide.

The PowerChute network shutdown service starts automatically when you finish the installation program.

To stop PowerChute network shutdown, type the following at the command line:

/etc/rc.APCpcns stop
To manually start PowerChute network shutdown, type the following at the command line:
/etc/rc.APCpcns start
 
PowerChute network shutdown on Solaris

You must have Solaris 2.5.1, 2.6 or 2.7 to use PowerChute network shutdown. XWindows is required to install PowerChute network shutdown.

PowerChute network shutdown requires Java Virtual Machine (JVM) v1.1.7B or newer on your server. Obtain this JVM from the Sun web site, or contact your Sun service provider.

Install PowerChute network shutdown on Solaris using the following procedure:

  1. Place the PowerChute network shutdown tar file in a temporary directory.
  2. Unwrap the files using the command "gzip CD pcns.tgz | tar -xvf -"
  3. Make sure the location of the JVM executable (jre) is in the PATH environment variable.
  4. Follow the instructions in the Installation section of this guide.

When the daemon starts, the script adds 256 files handles; delete the "ulimit -n 256" from PCNS startup script if you don't need them.

The PowerChute network shutdown service starts automatically when you finish the installation program.

To stop PowerChute network shutdown, type the following at the command line:

/etc/rc2.d/S99PowerChute stop
To manually start PowerChute network shutdown, type the following at the command line:
/etc/rc2.d/S99PowerChute start
 
PowerChute network shutdown on Linux

You must have RedHat Linux 5.2 or 6.0 to use PowerChute network shutdown. XWindows is required to install PowerChute network shutdown.

PowerChute network shutdown requires Java Virtual Machine (JVM) v1.1.7B or newer on your server. Obtain this JVM from www.blackdown.org, or contact your Linux vendor or service provider.

Install PowerChute network shutdown on Linux using the following procedure:

  1. Place the PowerChute network shutdown tar file in a temporary directory.
  2. Unwrap the files using the command "gzip CD pcns.tgz | tar -xvf -"
  3. Make sure the location of the JVM executable (jre) is in the PATH environment variable.
  4. Follow the instructions in the Installation section of this guide.

The PowerChute network shutdown service starts automatically when you finish the installation program.

To stop PowerChute network shutdown, type the following at the command line:

/etc/rc.d/init.d/PowerChute stop
To manually start PowerChute network shutdown, type the following at the command line:
/etc/rc.d/init.d/PowerChute start
 
PowerChute network shutdown on AIX

You must have AIX 4.3, 4.3.1 or 4.3.2 to use PowerChute network shutdown. XWindows is required to install PowerChute network shutdown.

Install PowerChute network shutdown on AIX using the following procedure:

  1. Place the PowerChute network shutdown tar file in a temporary directory.
  2. Unwrap the files using the command "gzip CD pcns.tgz | tar -xvf -"
  3. Make sure the location of the JVM executable (jre) is in the PATH environment variable.
  4. Execute the PowerChute network shutdown script.
  5. Follow the instructions in the Installation section of this guide.
  6. Start the PowerChute network shutdown daemon. The installation program is unable to start the PowerChute network shutdown daemon on AIX. You must start the process manually (see below) or reboot the system.

To stop PowerChute network shutdown, type the following at the command line:

/etc/rc.APCpcns stop
To manually start PowerChute network shutdown, type the following at the command line:
/etc/rc.APCpcns start