PowerChute Network Shutdown: |
||
Table of Contents |
Note: After clicking on a link directly below, press the Back button on your Web browser to return to these contents. Alternatively, press the Ctrl + Home keys. |
Software and Hardware Requirements |
Note: All references to UNIX® in this file include the Solaris™, HP-UX®, and AIX™ operating systems. |
To install PowerChute Network Shutdown (PCNS), you should have the following:
Operating System | Processor | Memory |
Windows® | 700 MHz | 256 MB |
UNIX | 360 MHz | 256 MB |
Linux® VMware® |
700 MHz | 256 MB |
Mac® OS X | 600 MHz | 256 MB |
Novell® NetWare® | 700 MHz | 512 MB |
Operating System | Processor | Memory |
Windows | 700 MHz | 512 MB |
UNIX | 440 MHz | 512 MB |
All Linux (except those versions mentioned in the following row) and VMware |
700 MHz | 512 MB |
Red Hat® Linux® 9, Red Hat® Enterprise Linux®, SUSE® | 2.4 GHz | 512 MB |
Mac OS X | 600 MHz | 512 MB |
In the list, host represents the IP address of the NMC.
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:
WARNING: Do not install and use PowerChute Network Shutdown on a computer system that uses PowerChute plus, PowerChute Business Edition, or PowerChute Server.
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:
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.
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).
For installation on NetWare, perform the following steps.
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.
java -cp SYS:\tempdirectory\pcns223net.jar;SYS:\tempdirectory\util.jar load
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.
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.
Using a Web browser, type either of the following URLs:
https://servername:6547For example, if your server was named COMP1 with an IP address of 117.14.53.59, you would use one the following URLs:
https://serverIPaddress:6547
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.
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).
WARNING: Do not install and use PCNS on a computer system that uses PowerChute plus, PowerChute Business Edition, or PowerChute Server.
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:
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.
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).For installation on NetWare, perform the following steps.
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.
java -cp SYS:\tempdirectory\pcns223net.jar;SYS:\tempdirectory\util.jar load
For installation on Mac OS X, perform the following steps.
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.
If you are using Multiple-UPS or a Parallel Silcon UPS configuration:
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.
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
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.
Using a Web browser, type either of the following URLs:
https://servername:6547For example, if your server was named COMP1 with an IP address of 117.14.53.59, you would use one the following URLs:
https://serverIPaddress:6547
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.
Silent Installation and Configuration |
You can perform a silent installation on systems with a single UPS only and with a single instance only. You must perform a normal installation on multiple Smart-UPS devices, multiple Symmetra devices or Parallel Silcon UPS systems (see Multiple-UPS configuration). In addition, each of your servers must have the same operating system. |
Windows and Mac OS X
You can install PowerChute Network Shutdown (PCNS) from a command line. To install PCNS silently, perform the following steps:
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.
JavaHomeDir\java -cp .;install.jar;util.jar load -s C:\tempdir\pcns223\silentInstall.ini
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.
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:
The steps above create the m11.cfg file. To replicate this configuration to other servers:
To remove existing IP addresses, select an address on the PowerChute Network Shutdown Clients page and click Delete Client.
On a Multiple-UPS configuration, you cannot change the user name and password, using the Configuration Utility. Also, the user name always displays as apc in the Configuration Utility for a Multiple-UPS configuration; please ignore this. To run the Configuration Utility, type the relevant commands listed in the
sections below for your operating system. Note:
The following instructions assume that you installed PowerChute Network
Shutdown to the default directory.
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:
Running the Configuration Utility on Windows | |||
Copy the m11.cfg file to the PowerChute\group1\lib directory. (The default installation directory is C:\Program Files\APC\PowerChute\group1\.) |
java -cp m11.jar;confutil.jar;..\comp\Notifier.jar;..\comp\
CommandFileRunner.jar;..\comp\ds.jar PCNSUtilApp
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.
Enter the IP address of the Network 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\group1\lib directory to the PowerChute directory. Start the PowerChute Network Shutdown service.
Running the Configuration Utility on Linux, VMware, or UNIX | |||
The X Window System is a requirement for running this utility on Linux, VMware, and UNIX. |
Copy the m11.cfg file to the PowerChute/group1/lib directory. The default installation directory is /opt/APC/PowerChute/group1.
java -cp m11.jar:confutil.jar:../comp/Notifier.jar:../comp/
CommandFileRunner.jar:../comp/ds.jar PCNSUtilApp
Java home dir/bin/java -cp m11.jar:confutil.jar:../comp/Notifier.jar:../comp/
CommandFileRunner.jar:../comp/ds.jar PCNSUtilApp
Type the IP address of the Network 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.
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.
You can use the Configuration Utility to set up m11.cfg files to monitor several Network Management Cards by using the same PowerChute Network Shutdown configuration that you used for silent installations.
Running the Configuration Utility on NetWare |
Running the Configuration Utility on Mac OS X |
Running on Windows® |
If you need to upgrade your Java Runtime Environment (JRE), it is possible to use the upgrade option. That is, you could, for example, "upgrade" from v2.2.3 to v2.2.3 simply in order to upgrade your JRE. See Upgrading the Software. |
In an upgrade on Windows, your current installation directory is always retained.
When the Java Virtual Machine (JVM) application that comes with the PCNS package is installed, it is placed in Program Files\APC\jre.
Some directories, including the PowerChute directory and the Java directory, can remain after an uninstall or an upgrade. You can remove them manually, but they won't affect your computer system or PowerChute Network Shutdown. For example, when you upgrade from v2.2.1 to 2.2.3, the JVM package installed in Program Files\jre will not be deleted automatically.
Always use the latest available Windows Service Pack.
The PowerChute directory includes DLL files to shut down some common applications. See the Run Command File section in the Online Help file for information on which applications and how to shut them down.
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 Network Management Card using the Network Management Card's Web interface menu. See Registering an IP Address with the Management Card.
For information on using the Configuration Utility, see Running the Configuration Utility on Windows.
Running on Linux, VMware, and UNIX |
It is NOT possible to use the upgrade option for the same version numbers. That is, you could not, for example, "upgrade" from v2.2.3 to v2.2.3 (simply in order to upgrade your JRE). |
To stop PowerChute Network Shutdown, type the following at the command line:
To start PowerChute Network Shutdown manually, type the following at the command line:
- In Linux and VMware, use the command /etc/rc.d/init.d/PowerChute stop
- In Solaris, use the command /etc/rc2.d/S99PowerChute stop
- In AIX, use the command /etc/rc.APCpcns stop
- In HP-UX, use the command /sbin/init.d/pcns stop
- In Linux and VMware, use the command /etc/rc.d/init.d/PowerChute start
- In Solaris, use the command /etc/rc2.d/S99PowerChute start
- In AIX, use the command /etc/rc.APCpcns start
- In HP-UX, use the command /sbin/init.d/pcns start
To uninstall in a conversational mode, run the uninstall script located
in the PowerChute directory. For example, type the following command:
/opt/APC/PowerChute/uninstall
If you do not intend to reinstall the software, remove the server IP address from the Network Management Card using the Network Management Card's Web interface menu. See Registering an IP Address with the Management Card.
The PowerChute directory sometimes remains after an uninstall. You can remove this manually, but it won't affect your computer system or PowerChute Network Shutdown.
To uninstall in a silent mode, run the uninstall script located in the PowerChute directory, with a "q" option. For example, type the following command:
/opt/APC/PowerChute/uninstall -q
It is possible to change the version of Java used by PCNS by editing the java.cfg file found in the PCNS installation directory (for example /opt/APC/PowerChute/group1 ). In the file, type the directory path of the Java location you want to use and save the file. Then stop and restart the daemon.
On UNIX, when the daemon starts, the script adds 256 file handles; delete ulimit -n 256 from the PowerChute Network Shutdown (PCNS) startup script if you do not need them.
For information on using the Configuration Utility, see Running the Configuration Utility on Linux, VMware, or UNIX.
Running on Novell NetWare |
To uninstall PowerChute Network Shutdown on NetWare, follow these steps: |
java -show
java -killxxx (where xxx is a process ID)
nwconfig
If you do not intend to reinstall the software, remove the server IP address from the Network Management Card using the Network Management Card's Web interface menu. See Registering an IP Address with the Management Card.
To restart the PowerChute Network Shutdown daemon, follow these steps:
java -show
java -killxxx (xxx is a process ID)
For information on using the Configuration Utility, see Running the Configuration Utility on NetWare.
Running on Mac OS X® |
To stop PowerChute Network Shutdown, type the following at the command line:sudo /Library/StartupItems/comapcpcns/comapcpcns stop |
sudo /Library/StartupItems/comapcpcns/comapcpcns start
To remove PowerChute Network Shutdown, run the uninstall script. If you do not intend to re-install the software, remove the server IP address from the Management Card using the PowerChute option on the Network Management Card user interface menu.
The PowerChute directory sometimes remains after an uninstall. You can remove this manually, but it won't affect your computer system or PowerChute Network Shutdown.
For information on using the Configuration Utility, see Running the Configuration Utility on Mac OS X.
Multiple-UPS configuration |
In a Multiple-UPS configuration, PowerChute Network Shutdown (PCNS) recognizes a group of two or more UPSs as a single UPS. |
Specifically, PCNS can manage up to three Smart-UPS or Symmetra units (of the same model type) providing redundant backup power to a single server. Each UPS in the system has its own Network Management Card (AP9617, 18, or 19).
Caution: In a Multiple-UPS configuration, each UPS must have enough capacity to carry all the electrical load of the computer system. So, for example, if you had two UPSs in a Multiple-UPS configuration, and one stops supplying power, the other UPS must have enough capacity to continue supplying power to protect the computer system.
Requirements: For a Multiple-UPS configuration, you must have PowerChute Network Shutdown 2.2 or greater. You can't upgrade to a Multiple-UPS configuration from a previous version of PCNS: you must uninstall, install the new version, and re-configure your options.
With a Multiple-UPS configuration, PCNS always recognizes and logs the events in the categories listed below (see the text on individual events in the List of Events section in the Online Help):
Multiple-UPS configuration and Critical Events
PCNS always
considers the following as critical events: a) a low battery condition, or b) a UPS off condition, or c) any event with the Shut Down System action enabled on the Configure Events page.
Please note the following for critical events in a Multiple-UPS configuration.
Multiple-PCNS Instances in a Multiple-UPS configuration | |||
You can have three instances of PowerChute Network Shutdown (PCNS) on one computer where each instance monitors a Multiple-UPS configuration. |
Requirements: This only functions with PCNS v2.2.2 or above and the UPS model Smart-UPS RT (3, 5, 7.5, 10, and 20 kVA) on Windows, UNIX, Linux, or VMware.
Limitations:
See Advanced Configuration of Multiple-UPS Configurations in the Online Help.
Entire contents copyright © 2007 by American Power Conversion Corporation. All rights reserved. Reproduction in whole or in part without permission is prohibited. All trademarks, product names, and corporate names are the property of their respective owners and are used for informational purposes only.
APC Part Number 990-2838B, PCNS v2.2.3