• Software and Hardware Requirements

 
• Upgrading the Software

 
• Installation

 
• Silent Installation and Configuration

 
• Registering an IP Address with the Management Card

 
• Using the PowerChute Network Shutdown Configuration Utility

 
• Running on Windows

 
• Running on Linux, VMware, and UNIX

 
• Running on Novell NetWare

 
• Running on Mac OS X

 
• Multiple-UPS configuration and Multiple-PCNS Instances in a Multiple-UPS configuration

 

To install PowerChute Network Shutdown (PCNS), you should have the following:

Note: See Running on Windows and Running on Linux, VMware, and UNIX for background information.

If any of the points below is true, upgrading is NOT possible and you should go to Installation:

• If your system is configured for Multiple-PCNS Instances in a Multiple-UPS configuration.
• If the computer you are installing on has several IP addresses (for example, several network interface cards) and you are NOT upgrading from version 2.2.3 of PCNS.
• If you are running Mac OS X or Novell NetWare.

WARNING: Do not install and use PowerChute Network Shutdown on a computer system that uses PowerChute plus, PowerChute Business Edition, or PowerChute Server.

1. The installation program must be run on the server console.

To start the PowerChute Network Shutdown installation, choose from the sections directly below specifying different OS systems and hardware.

For installation on an Itanium/ IA-64 edition of Windows, follow these steps:

1. Manually install the appropriate JRE version, or any supported Java version as listed in the Compatibility Chart on the APC Web site for PCNS.
    
2. Set the path to the Java file:
   JavaHomeDir\java -cp .;install.jar;util.jar load
    
   for example: "C:\Program Files\j2sdk\jre\bin\java -cp .;install.jar;util.jar load"
   Double quotation marks are used here because of the space in Program Files.
    
3. Use  install.jar and  util.jar included on the CD or up on the APC Web site, to commence the installation.

For installation on Windows, you can double-click the installation program icon or execute the file  setup.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 additional computers to have the same PowerChute Network Shutdown configuration.

When the Windows Firewall is enabled, you can allow the PCNS installation to configure the firewall automatically by choosing Yes when prompted: PowerChute Network Shutdown ports must be opened in the Windows Firewall to enable communication with the Network Management Card(s). Would you like this configuration to be performed automatically? See Software and Hardware Requirements for more information.

For installation on Linux, VMware, and UNIX, 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. Locate the file  pcns223_OS name.tar.gz  (e.g. pcns223_linux.tar.gz) on the APC Web site or on the CD and copy it to a temporary directory on the server.
    
2. Change your working directory to the temporary directory. Then type the following commands:
    
        gunzip pcns223_OS name.tar.gz
        tar -xf pcns223_OS name.tar
    
3. To install in a conversational mode, type the following command:
        ./install.sh

You cannot specify a directory name that contains a space, either for the installation or the Java directory.

If you do not type a Java directory when prompted, the Java bundled with the installer will be used when appropriate (see JRE version).

4. Once the execution of install.sh has been completed, you must configure your setup to complete the installation. Type the following command from the PowerChute directory:
        ./PCNSConfig.sh
    
   Note: PCNSConfig.sh should never be run twice.

For installation on NetWare, perform the following steps.

1. If you downloaded the file  pcns223net.exe  from the APC Web site, copy the file to a temporary directory on the SYS: volume of the NetWare file server; then execute the file to extract the installation files.

   If the software is on a CD, copy the installation files (pcns223net.jar and util.jar) from the NetWare directory on the CD to a temporary directory on the SYS: volume of your NetWare file server.

2. From the server's System Console command prompt, enter the following command (where tempdirectory represents the location of the installation files).

   java -cp SYS:\tempdirectory\pcns223net.jar;SYS:\tempdirectory\util.jar load

2. Complete the software installation.

   Note: The Temp directory might have some sub-directories remaining after the installation. You can remove these manually, but they won't affect your computer system or PowerChute Network Shutdown.

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

   The PowerChute Network Shutdown service (on Windows), the daemon (on Linux, VMware, UNIX, and Mac OS X), or the process (on NetWare) starts automatically when the installation is completed. You can then delete the installation files.

4. Open the PowerChute Network Shutdown user interface.

   Using a Web browser, type either of the following URLs:

   https://servername:6547
   https://serverIPaddress:6547

   For example, if your server was named COMP1 with an IP address of 117.14.53.59, you would use one the following URLs:

   https://COMP1:6547
   https://117.14.53.59:6547

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

Installation

To install and operate the PowerChute Network Shutdown software, perform the following steps. (If you are upgrading from PCNS v2.2 or higher, refer to Upgrading the Software).

Note: See Running on Windows for background information on Windows.

1. Install the Network 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-UPS or a Parallel Silcon UPS configuration, you will use one Network Management Card in each UPS in the system.

   Install the 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 Network Management Card (NMC).

2. Using the Network Management Card user interface, configure the UPS and the Network Management Card. At a minimum, perform these tasks:
   • Under the UPS tag, on the Configuration-shutdown page, set the Low Battery Duration field value to at least five minutes.
   • Under the UPS tag, on the PowerChute-configuration page, you can set the authentication phrase for the administrator. While under the Administration tag, on the Local Users-administrator page, you can set the user name and password.
      
     The administrator user name and authentication phrase authenticate the communication between PowerChute Network Shutdown and the NMC. Because of this you must set the values in PCNS to be the same as those for the NMC. (Note that it is allowable to set a password for PCNS that is different from the password for the NMC.)
      
     In the NMC, the default administrator user name and password are both apc, while the default setting for the authentication phrase is admin user phrase.
      
3. Remove any existing version of PowerChute Network Shutdown (PCNS) before starting the installation program.

   WARNING: Do not install and use PCNS on a computer system that uses PowerChute plus, PowerChute Business Edition, or PowerChute Server.

4. The installation program must be run on the server console. Note that multiple-byte characters (Chinese for example) are not allowed in the installation path.

To start the PowerChute Network Shutdown installation, choose from the sections directly below specifying different OS systems and hardware.

For installation on an Itanium/ IA-64 edition of Windows, follow these steps:

1. Manually install the appropriate JRE version, or any supported Java version as listed in the Compatibility Chart on the APC Web site for PCNS.
    
2. Set the path to the Java file:
   JavaHomeDir\java -cp .;install.jar;util.jar load
    
   for example: C:\Program Files\j2sdk\jre\bin\java -cp .;install.jar;util.jar load
    
3. Use  install.jar and  util.jar included on the CD or up on the APC Web site, to commence the installation.

For installation on Windows, you can double-click the installation program icon or execute the file  setup.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 additional computers to have the same PowerChute Network Shutdown configuration.

When the Windows Firewall is enabled, you can allow the PCNS installation to configure the firewall automatically by choosing Yes when prompted: PowerChute Network Shutdown ports must be opened in the Windows Firewall to enable communication with the Network Management Card(s). Would you like this configuration to be performed automatically? See Software and Hardware Requirements for more information.

For installation on Linux, VMware, and UNIX, 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. Locate the file  pcns223_os name.tar.gz  (e.g. pcns223_linux.tar.gz) on the APC Web site or on the CD and copy it to a temporary directory on the server.
    
2. Change your working directory to the temporary directory. Then type the following commands:
    
        gunzip pcns223_OS name.tar.gz
        tar -xf pcns223_OS name.tar
    
3. Please see JRE version before proceeding.

To install in a conversational mode, type the following command:
     ./install.sh

The installer will prompt for the directory to install to and the directory of the system-installed Java. You cannot specify a directory name that contains a space, for either directory.

If you do not specify an installation directory, it will be installed to /opt/APC (the default). If you do not specify a Java directory, the Java bundled with the installer will be used when appropriate (see JRE version).
4. Once the execution of install.sh has been completed, you must configure PCNS for logon and the NMC information. Type the following command from the PCNS directory to configure your setup in a conversational mode:
        ./PCNSConfig.sh
    
   Note: PCNSConfig.sh should never be run twice.

For installation on NetWare, perform the following steps.

1. If you downloaded the file  pcns223net.exe  from the APC Web site, copy the file to a temporary directory on the SYS: volume of the NetWare file server; then execute the file to extract the installation files.

   If the software is on a CD, copy the installation files (pcns223net.jar and util.jar) from the NetWare directory on the CD to a temporary directory on the SYS: volume of your NetWare file server.

2. From the server's System Console command prompt, enter the following command (where tempdirectory represents the location of the installation files).

   java -cp SYS:\tempdirectory\pcns223net.jar;SYS:\tempdirectory\util.jar load

For installation on Mac OS X, perform the following steps.

1. Go to the folder where the PowerChute Network installation files are located.
2. Double click on the file install.command
3. A terminal window opens, prompting you for your password.
4. Enter your password.
5. Proceed with the installation.

5. Note that if the computer you are installing on has several IP addresses, you will be prompted during the installation to select an IP address and enter its subnet mask.
   Continue with the installation until you are asked to choose the installation type on a GUI installer:
    
   •  Select Custom Install if you have a Multiple-UPS or a Parallel Silcon UPS configuration. Then select the appropriate setting for your UPS system, and select Next if installing on Windows.
   •  Select Typical Install otherwise.

   Different VA models are supported if they are in the same UPS device family. The Symmetra Tower and the Symmetra RM are considered a family. The Symmetra PX is not however in the same family and can't be used in combination with them.

   The IP address of the PowerChute Network Shutdown computer is registered with the Network Management Card if a UPS fails to register. You should manually remove it in this circumstance: Registering an IP Address with the Network Management Card.

6. Enter the initial configuration information:
   • Management Card IP: This is the network address of the Network Management Card (NMC) attached to your UPS.

     If you are using Multiple-UPS or a Parallel Silcon UPS configuration:

     • For Windows: enter the IP address of the NMC in the first UPS device, select Add, and then continue adding IP addresses for all of the cards in this UPS system. (Up to 3 IP addresses for a Multiple-UPS configuration, and up to 9 IP addresses for a Parallel Silcon UPS configuration.)
        
       
     • For Linux, VMware, UNIX: you must specify all the IP addresses of your Network Management Cards in your multiple device configuration. You will be prompted to type one IP address at a time and you must type at least two IP addresses.
        
       
   • The http port being used by the NMC. The default is 80. Do not change this number unless you changed the http port being used by your Management Card. For a Multiple-UPS or a Parallel Silcon UPS configuration, all of the Network Management Cards must use the SAME http port.
      
   Click Next to continue if installing on Windows, Mac OS X, and NetWare.
    
7. Enter the security configuration information:

   The administrator user name and authentication phrase authenticate the communication between PowerChute Network Shutdown (PCNS) and the NMC. Because of this you must set the values in PCNS to be the same as those for the NMC. (Note that it is allowable to set a password for PCNS that is different from the password for the NMC.)
    
   In the NMC, the default administrator user name and password are both apc, while the default setting for the authentication phrase is admin user phrase.

   If you are using a Multiple-UPS or a Parallel Silcon UPS configuration, all of the Network 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.

8. Complete the software installation.

   PowerChute Network Shutdown registers with the Network Management Card (NMC) automatically so that they can communicate.

   If you entered an invalid user name or authentication phrase at the previous step, the PCNS installer will fail to register with the NMC saying "Security information did not match at NMC IP address" in the status box. Click the Back button and type the correct user name, password, and authentication phrase.

   If you are doing a custom installation, and PowerChute Network Shutdown cannot register with the NMC, you receive another error message "Cannot communicate with the Management Card". You can continue the installation, but you must enter the server IP address manually at the Network Management Card.

   On NetWare, a pop-up message asks whether changes to the autoexec.ncf file can be made. You should select Yes (otherwise the service won't start when the OS starts).

   Notes

   • If you select Cancel to stop the installation, the C:\Program Files\APC\jvm and C:\Program Files\APC\jre\jre1.5.0_13 directories remain in Windows. They must be deleted manually before attempting another installation. (You should also delete the PowerChute directory before attempting another installation).
      
   • The Temp directory might have some sub-directories remaining after the installation. You can remove these manually, but they won't affect your computer system or PowerChute Network Shutdown.

9. Start PowerChute Network Shutdown.

   The PowerChute Network Shutdown service (on Windows) and the process (on NetWare) start automatically when the installation is completed. You have a choice whether to start the daemon (on Linux, VMware, UNIX, and Mac OS X). Afterwards, you can 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.

10. Open the PowerChute Network Shutdown user interface.

    Using a Web browser, type either of the following URLs:

    https://servername:6547
    https://serverIPaddress:6547

    For example, if your server was named COMP1 with an IP address of 117.14.53.59, you would use one the following URLs:

    https://COMP1:6547
    https://117.14.53.59:6547

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

1. Complete a normal installation on one server.
    
2. Configure PowerChute Network Shutdown to your requirements.
    
3. Edit the silentInstall.ini file to set new parameters, if required. Precede each path separator ('\' for Windows and '/' for the Mac) with an escape character ('\').
   • Specify the PCNS installation directory at  applicationDirectory.
      
     
   • Type the relevant values in the following fields: AdministratorUserName=, AuthenticationPassword=, AuthenticationPhrase=.
     The user name and authentication phrase must match the Network Management Card or the silent installation will not work.
      
     In the NMC, the default administrator user name and password are both apc, while the default setting for the authentication phrase is admin user phrase.
      
   • If you are installing PowerChute Network Shutdown for a UPS with a different IP address, uncomment the adapterIPAddress parameter and type the IP address of the Network Management Card that is in the UPS.
      
     
   • If you are installing PowerChute Network Shutdown on more than 50 computers for one Network Management Card, set the RegisterWithAdapter parameter to "yes" or "no" to indicate whether the installation should register this host's IP address with the Network Management Card.

     Note: 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.

4. Copy the  m11.cfg file, and the  silentInstall.ini file from the PowerChute installation directory, along with the PowerChute Network Shutdown installation files, to a temporary directory on the new server. (Log in as root to do this for the Mac OS X).
    
5. Use the commands specified below on the relevant system (where tempdir signifies your temporary directory).
   For all systems, if there are spaces in the path to the temporary directory, enclose the path in quotation marks. As examples, the first path below needs quotes (because of Program Files), the second does not:
        "C:\Program Files\InstallDir\silentInstall.ini"
       C:\InstallDir\silentInstall.ini
    
   • For an installation on an Itanium edition of Windows:

   JavaHomeDir\java -cp .;install.jar;util.jar load -s C:\tempdir\pcns223\silentInstall.ini

   • For an installation on Windows, navigate to the temporary directory on the new server, and type the following command on one line:
     

     C:\tempdir\setup.exe -s C:\tempdir\silentInstall.ini
      
     where tempdir is the location of the installation program and of the valid  m11.cfg  and  silentInstall.ini  files.

   • For an installation on Mac OS X, navigate to the temporary folder on the new server, and type the following command on one line:
     

     sudo java -cp .:install.jar:util.jar load -s /tempfolder/silentInstall.ini
      
     where tempfolder is the location of the installation program and of the valid  m11.cfg  and  silentInstall.ini  files.
      

   After you complete the installation, check the  pcnsinst.log  and  errors.log  files for error conditions (the latter will only exist when the installation has not been successful). On Windows, in a standard setup, pcnsinst.log can be found in C:\Documents and Settings\Administrator\Local Settings\Temp\ and error.log in a tmpjex0n directory under the Temp directory (n can be 1, 2, 3, etc.).

Linux, VMware, and UNIX

For an installation on Linux, VMware, or UNIX, edit  silentInstall.sample and type the install destination directory and the Java directory. If the install destination directory is not entered, it will be installed to /opt/APC. If a Java directory is not entered, the Java bundled with the installer will be used when appropriate (see JRE version).

Type the following command to start the installation:
 
 ./install.sh -f silentInstall.sample

To complete the configuration silently:

1. Change your working directory to the PowerChute/group1 directory.
2. Edit silentConfig.sample and enter appropriate values such as the IP address of the NMC, the User ID and the password.
3. Type:   ./PCNSConfig.sh -f silentConfig.sample

The steps above create the m11.cfg file. To replicate this configuration to other servers:

1. Change your working directory to the PowerChute/group1 directory.
2. Re-edit silentConfig.sample (to enter the different details related to the new server and UPS's) and copy m11.cfg file to the working directory.
3. Type:   ./PCNSConfig.sh -f silentConfig.sample

1. Access the Network Management Card's user interface by using the Network Management Card IP address as the URL.
2. Click on the UPS tab
3. Click the clients link under the PowerChute menu option to display a list of the IP addresses which are registered with this Network Management Card.
4. To add a new IP address, click the Add Client button, and type the IP address of the server on which PowerChute Network Shutdown is installed in the Add Client IP Address: field, and click Apply.

   To remove existing IP addresses, select an address on the PowerChute Network Shutdown Clients page and click Delete Client.

Using the PowerChute Network Shutdown Configuration Utility

The stand-alone PowerChute Network Shutdown Configuration Utility allows you to change the following PowerChute Network Shutdown (PCNS) settings:

• IP address of the Network Management Card to monitor
• Port number of the Network Management Card to monitor
• Administrator User Account
• Administrator Password
• Security Phrase

• If you have Java in the system path, from the PowerChute\group1\lib directory, type this command on one line:

  java -cp m11.jar;confutil.jar;..\comp\Notifier.jar;..\comp\
  CommandFileRunner.jar;..\comp\ds.jar PCNSUtilApp

• If java is not in the system path, from the PowerChute\group1\lib directory, type this command on one line:

  Java home dir\bin\java -cp m11.jar;confutil.jar;..\comp\Notifier.jar;..\comp\
  CommandFileRunner.jar;..\comp\ds.jar PCNSUtilApp

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

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\group1\lib directory to the PowerChute directory. Start the PowerChute Network Shutdown service.

Copy the m11.cfg file to the PowerChute/group1/lib directory. The default installation directory is /opt/APC/PowerChute/group1.

1. Perform a complete installation.
2. Copy the m11.cfg file to the /lib directory.
3. Run the Configuration Utility.
4. Use the Configuration Utility to change the Network Management Card IP address.
5. Use the modified m11.cfg file to perform a command line installation. (See Silent Installation, step #4.)

1. While the PowerChute NetWare Shutdown daemon is running, copy m11.cfg to the lib directory under the PowerChute installation directory. The default installation directory is SYS:\APC\PowerChute\group1.
    
2. On the System Console, type the following command on one line:
   
   java -cp SYS:\installation directory\lib\m11.jar;SYS:\installation directory\lib\confutil.jar;SYS:\
   installation directory\comp\Notifier.jar;SYS:\installation directory\comp\CommandFileRunner.jar;SYS:\install directory\comp\ds.jar PCNSUtilApp
    
3. Change the settings and save them.
    
4. Exit from the wizard.
    
5. Restart the daemon.