PowerChute Network Shutdown
Installation Guide

 
Table of Contents

Installation

Requirements:

To install and operate the PowerChute Network Shutdown software, perform the following steps.

  1. Install the Management Card in your UPS. For installation instructions, see the Management Card Installation and Quick Start Guide that was shipped with your card. If you are using multiple Smart-UPS devices, multiple Symmetra devices or a Parallel Silcon UPS, you will use one Management Card in each UPS in the system.

    Install the Management Card in your UPS and configure it with an IP address before beginning the PowerChute Network Shutdown software installation. If you install PowerChute Network Shutdown first, additional steps will be required when installing the Management Card.

  2. Using the Management Card user interface, configure the UPS and the Management Card. At a minimum, perform these tasks:
    • 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 must enter the same Administrator User Name, Password and Authentication Phrase when you install PowerChute Network Shutdown.

      Note: The Management Card uses the same default User Name, Password and Authentication Phrase as PowerChute Network Shutdown.

  3. Remove any existing version of PowerChute Network Shutdown before starting the installation program.
  4. The installation program must be run on the server console.
  5. To start the PowerChute Network Shutdown installation program:

    For installation on Windows NT, Windows 2000, Windows XP or Windows 2003, you can double-click the installation program icon or execute the file pcns220win.exe from a command line. Launch the installation program for Windows. After you complete the installation, you can use the Silent Installation to set up multiple computers to have the same PowerChute Network Shutdown configuration.

    For installation on Solaris and Linux, perform the following steps. After you finish the installation, you can use the Silent Installation to set up additional servers to have the same PowerChute Network Shutdown configuration.

    1. If you already have PowerChute Network Shutdown installed, you must first remove the old version. You cannot perform the installation process until you remove the old version.

    2. If you downloaded the file pcns220lnx.bin for Red Hat Linux or pcns220sol.bin for Solaris from the APC Web site, copy the file to a temporary directory on the file server.

      If the software is on a CD, copy the installation file from the CD to a temporary directory on the file server.

    3. Change your working directory to the directory containing the installation file. Change the permissions on the file to make it executable. Then type the following command:
      ./pcns220lnx.bin         for Red Hat Linux

      ./pcns220sol.bin         for Solaris 8 or 9

    4. At the following prompt, type "yes" to continue the installation:

      You are about to install a new application. Continue?

    5. In the "About" box, select Next.

    6. Select I agree to accept the terms of the PowerChute Network Shutdown license agreement. If you do not accept the agreement, you must select Cancel and cannot install PowerChute Network Shutdown.

    7. Select the location where the PowerChute Network Shutdown software will be installed. To choose a location other than the default, type the full path name, including the drive letter or volume name, or use the Browse button. Select Next.

    8. Choose the installation type.

      •  If you do not have multiple Smart-UPS devices, multiple Symmetra devices or a Parallel Silcon UPS, select Typical Install.

      •  If you have multiple Smart-UPS devices, multiple Symmetra devices or a Parallel Silcon UPS, select Custom Install. Select the appropriate setting for your UPS system, and select Next.

    9. Enter the initial configuration information:

      • Management Card IP: This is the network address of the Management Card attached to your UPS.

        If you are using multiple Smart-UPS devices, multiple Symmetra devices or a Parallel Silcon UPS, enter the IP address of the Management Card in the first UPS module, select Add, and then continue adding IP addresses for all of the cards in this UPS system. (Up to 3 IP addresses for multiple Smart-UPS devices and multiple Symmetra devices, and up to 9 IP addresses for a Parallel Silcon UPS.)

      • The http port being used by the Management Card. The default is 80. Do not change this number unless you changed the http port being used by your Management Card. For multiple Smart-UPS devices, multiple Symmetra devices or a Parallel Silcon UPS system, all of the Management Cards must use the same http port.

      Click Next to continue.

    10. Enter the security configuration information:

      The default settings for User Name, Authentication Phrase and Password are the same for both PowerChute Network Shutdown and the Management Card. If you have not changed the default settings in the Management Card, click Next; otherwise, enter the same values used by the Management Card and click Next.

      The User Name and Authentication Phrase authenticate the communication between PowerChute Network Shutdown and the Management Card. You use the same User Name and Password to log on to the user interface of PowerChute Network Shutdown and the Management Card.

      If you are using multiple Smart-UPS devices, multiple Symmetra devices or a Parallel Silcon UPS system, all of the Management Cards in the UPS system must use the same Administrator User Name and Authentication Phrase.

      Note: Any Java exceptions displayed during the installation will not affect the successful completion of the installation or operation of PowerChute Network Shutdown.

    11. Complete the software installation:

      PowerChute Network Shutdown registers with the Management Card automatically so that PowerChute Network Shutdown and the Management Card can communicate.

      If PowerChute Network Shutdown cannot register with the Management Card, you receive an error message. You may continue the installation, but you must enter the server IP address manually at the Management Card.

      Note: If you select Cancel to stop the installation, you must then delete the PowerChute directory.

    12. Start the PowerChute Network Shutdown process:

      The PowerChute Network Shutdown service (on Windows NT, Windows 2000, Windows XP and Windows 2003), or the daemon (on Linux and Solaris) starts automatically when the installation is completed. You can then delete the installation files.

      Note: After installation, set access on the PowerChute directory so that only authorized users can access, execute, or remove the software.

    13. Open the PowerChute Network Shutdown user interface:

      Using a web browser, enter either of the following URLs:

      http://servername:3052
      http://serverIPaddress:3052
      For example, if your server is named COMP1 and has an IP address of 117.14.53.59, use one the following URLs:
      http://COMP1:3052
      http://117.14.53.59:3052

      If you are using a browser version other than Microsoft Internet Explorer version 5.5 or 6.0, some functions may not be available.

    Silent Installation

    You can perform a silent installation on systems with a single UPS only. You must perform a normal installation on multiple Smart-UPS devices, multiple Symmetra devices or Parallel Silcon UPS systems.

    On Windows NT, Windows 2000, Windows XP, Windows 2003, Linux and Solaris systems, you can install PowerChute Network Shutdown from a command line, which allows you to set up multiple servers that run the same operating system and that have the same PowerChute Network Shutdown configuration. To install PowerChute Network Shutdown silently, perform the following steps:

    1. Complete a normal installation on one server.

    2. Configure PowerChute Network Shutdown to have all of the settings that you want.

    3. Copy the m11.cfg and silentInstall.ini files from the PowerChute directory.

    4. Edit the silentInstall.ini file to have new parameters, if required. Precede each path separator ('\' for Windows and '/' for Linux and Solaris) with an escape character ('\').

      • Edit the applicationDirectory parameter to specify the directory in which to install PowerChute Network Shutdown.
      • Set the RegisterWithAdapter parameter in the silentInstall.ini file to "yes" or "no" to indicate whether the installation should register this host's IP address with the Management Card.

        Note: This parameter is applicable only if you are installing PowerChute Network Shutdown on more than 50 computers for one Management Card. See the document "PowerChute Network Shutdown with more than 50 computers on One UPS," available from the download page for PowerChute Network Shutdown for your operating system on the APC Web site.

    5. If you are installing PowerChute Network Shutdown for a UPS with a different IP address, uncomment and edit the adapterIPAddress parameter in the silentInstall.ini file. Enter the IP address of the Management Card that is in the UPS.

    6. Put the m11.cfg file, the silentInstall.ini file, and the PowerChute Network Shutdown installation files in a temporary directory on the new server.

    7. For an installation on Windows NT, Windows 2000, Windows XP and Windows 2003, navigate to the temporary directory on the new server, and type the following command on one line:
      C:\tempdir\pcns220win.exe -q C:\tempdir\silentInstall.ini
      The variable tempdir is the location of the installation program and of the valid m11.cfg and silentInstall.ini files.

      Note: If you are using a directory name containing spaces, enclose the path name in quotation marks. Otherwise, no quotation marks are required. For example:
      C:\pcinstall\pcns220win.exe -q "C:\Program Files\InstallDir\silentInstall.ini"

      C:\pcinstall\pcns220win.exe -q C:\InstallDir\silentInstall.ini
    8. For an installation on Linux or Solaris, navigate to the temporary directory on the new server and use the following command:
      For Red Hat Linux:     ./pcns220lnx.bin -q tempdir/silentInstall.ini

      For Solaris:              ./pcns220sol.bin -q tempdir/silentInstall.ini

      If there are spaces in the path to the temporary directory, enclose the path in quotation marks.

      After you complete the installation, 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 computer on which PowerChute Network Shutdown is installed. In some cases, the installation program registers the IP address, but is unable to confirm that it is registered; in such cases, you must check to ensure that the IP address is registered.

    1. Access the Management Card's Web interface by using the Management Card IP address as the URL.

    2. Click on the UPS model name displayed on the menu.

    3. Select the PowerChute menu option to display a list of the IP addresses which are registered with this Management Card.

    4. To add a new IP address, type the IP address of the server on which PowerChute Network Shutdown is installed in the Add Client IP Address field, and click Add.

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

     
    PowerChute Network Shutdown Configuration Utility

    The stand-alone PowerChute Network Shutdown Configuration Utility allows you to change the following PowerChute Network Shutdown settings after you install PowerChute Network Shutdown:

    • IP address of the Management Card to monitor (not applicable for multiple Smart-UPS devices, multiple Symmetra devices and Parallel Silcon UPS systems)
    • Port number of the Management Card to monitor
    • Administrator User Account
    • Administrator Password
    • Security Phrase

    To run the Configuration Utility, type the command listed below for your operating system.

    Note: The following instructions assume that you installed PowerChute Network Shutdown to the default directory. If you installed PowerChute Network Shutdown to a directory other than the default directory, replace the path to the \lib directory with the appropriate path.

    • Configuration on Windows NT, Windows 2000, Windows XP and Windows 2003:
    • Copy the m11.cfg file to the PowerChute\lib folder. The default installation folder is C:\Program Files\PowerChute.

      • If you have java in the system path, from the PowerChute\lib folder, type this command on one line:
        java -cp m11.jar;confutil.jar;..\comp\Notifier.jar;..\comp\
        CommandFileRunner.jar PCNSUtilApp
      • If java is not in the system path, from the PowerChute\lib folder, type this command on one line:
        Java home dir\bin\java -cp m11.jar;confutil.jar;..comp\Notifier.jar;..\comp\
        CommandFileRunner.jar PCNSUtilApp

      Note: If there are spaces in the path to the java directory, enclose the path in quotation marks.

      Enter the IP address of the Management Card you wish to monitor, and click Save. Your configuration settings have been saved. Click OK. On the following screen, click Exit.

      In the Windows Control Panel, stop the PowerChute Network Shutdown service. Delete the m11.cfg file from the PowerChute directory. Move the modified m11.cfg file from the PowerChute/lib folder to the PowerChute directory. Start the PowerChute Network Shutdown service.

    • Configuration on Linux or Solaris

      Copy the m11.cfg file to the PowerChute/lib directory. The default installation directory is /usr/local/bin/PowerChute.

      • If java is in the path statement, from the PowerChute/lib directory, type this command on one line:
        java -cp m11.jar:confutil.jar:../comp/Notifier.jar:..comp/
        CommandFileRunner.jar PCNSUtilApp

      • If java is not in the path statement, type this command on one line:
        Java home dir\bin\java -cp m11.jar:confutil.jar:../comp/Notifier.jar:../comp/
        CommandFileRunner.jar PCNSUtilApp

      Enter the IP address of the Management Card you wish to monitor, and click Save. Your configuration settings have been saved. Click OK. On the following screen, click Exit.

      Stop the PowerChute Network Shutdown service.

      • In Linux, use the command /etc/rc.d/init.d/PowerChute stop.
      • In Solaris, use the command /etc/rc2.d/S99PowerChute stop.

      Delete the m11.cfg file from the PowerChute directory. Move the modified m11.cfg file from the PowerChute/lib directory to the PowerChute directory.

      Start the PowerChute Network Shutdown service.

      • In Linux, use the command /etc/rc.d/init.d/PowerChute start.
      • In Solaris, use the command /etc/rc2.d/S99PowerChute start.

      You can use the Configuration Utility to set up m11.cfg files to monitor multiple Management Cards by using the same PowerChute Network Shutdown configuration that you used for silent installations.

      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 installation. (See Silent Installation, step #4.)
     
    Using PowerChute Network Shutdown on Windows NT, Windows 2000, Windows XP or Windows 2003

    You must have Windows NT version 4.0, Windows 2000, Windows XP or Windows 2003 to use PowerChute Network Shutdown. Always use the latest available Service Pack.

    The PowerChute directory includes executable programs to shut down some common applications. See Run Command File in the Help file for information on setting up PowerChute Network Shutdown to run these programs.

    • shutnote.exe - To shut down Lotus Notes/Domino
    • shutback.exe - To shut down Microsoft BackOffice
    • shutiis.exe - To shut down Microsoft Internet Information Server
    • shutncs.exe - To shut down Netscape Enterprise Server

    To remove PowerChute Network Shutdown, uninstall the program from the control panel. If you do not intend to reinstall the software, remove the server IP address from the Management Card by using the PowerChute option on the Management Card's Web interface menu.

    Using PowerChute Network Shutdown on Solaris

    You must have Solaris version 5.8 or 5.9 (SPARC) to use PowerChute Network Shutdown. XWindows is required to install PowerChute Network Shutdown.

    PowerChute Network Shutdown requires Java Virtual Machine (JVM), version 1.4.1 or later, on your server. Obtain this JVM from the Sun Microsystems web site, or contact your Sun Microsystems service provider. PCNS installs JVM 1.4.1 if the most recent version found on the system is earlier than 1.4.1. If a JVM version later than 1.4.1 is found on the system, PCNS will use the later version. It is recommended that the location of the JVM executable (java.exe) be in the PATH environment variable prior to installing PowerChute Network Shutdown.

    When the daemon starts, the script adds 256 file handles; delete ulimit -n 256 from the PowerChute Network Shutdown startup script if you do not need them.

    To stop PowerChute Network Shutdown, type the following at the command line:

    /etc/rc2.d/S99PowerChute stop
    To start PowerChute Network Shutdown manually, type the following at the command line:
    /etc/rc2.d/S99PowerChute start

    To remove PowerChute Network Shutdown, run the uninstall script. If you do not intend to reinstall the software, remove the server IP address from the Management Card by using the PowerChute option on the Management Card's Web interface menu.

    Using PowerChute Network Shutdown on Linux

    You must have RedHat Linux version 8.0 to use PowerChute Network Shutdown. XWindows is required to install PowerChute Network Shutdown.

    PowerChute Network Shutdown requires Java Virtual Machine (JVM), version 1.4.1 or later, on your server. Obtain this JVM from http://java.sun.com, or contact your Linux vendor or service provider. PCNS installs JVM 1.4.1 if the most recent version found on the system is earlier than 1.4.1. If a JVM version later than 1.4.1 is found on the system, PCNS will use the later version. It is recommended that the location of the JVM executable (java.exe) be in the PATH environment variable prior to installing PowerChute Network Shutdown.

    To stop PowerChute Network Shutdown, type the following at the command line:

    /etc/rc.d/init.d/PowerChute stop
    To start PowerChute Network Shutdown manually, type the following at the command line:
    /etc/rc.d/init.d/PowerChute start

    To remove PowerChute Network Shutdown, run the uninstall script. If you do not intend to reinstall the software, remove the server IP address from the Management Card by using the PowerChute option on the Management Card's Web interface menu.