File name: readme.txt **************************************************************** | | | Revision: 2.2.1 | | | | (C) Copyright International Business Machines Corporation | | 2005. All rights reserved. | | | | US Government Users Restricted Rights -- Use, duplication | | or disclosure restricted by GSA ADP Schedule Contract with | | IBM Corp. | | | | Note: Before using this information and the product it | | supports, read the general information under "NOTICES AND | | TRADEMARKS" in this document. | | | | Updated March 21, 2005. | | | **************************************************************** CONTENTS 1.0 About this readme file 1.1 Overview of this code 1.2 Known Issues on all supported operating systems 1.3 Known Issues with PowerChute Network Shutdown user interface on Netscape Navigator 1.4 Known Issues with PowerChute Network Shutdown user interface on Internet Explorer 1.5 Known Issues with PowerChute Network Shutdown and network configuration 1.6 Known issues with PowerChute Network Shutdown and event configuration and logging 1.7 Known issues with PowerChute Network Shutdown and Windows NT®, Windows 2000®, and Windows XP®. 1.8 Installation Requirements for all supported operating systems 2.0 Change history 3.0 Installation and Setup Instructions 3.1 Installation for all supported operating systems 3.2 Silent Installation for all supported operating systems (Except Netware®) 3.3 Registering an IP Address with an Embedded Network Module or Network Management Card 3.4 PowerChute Network Shutdown Configuration Utility 3.5 Using PowerCute Network Shutdown on Red Hat Linux® 3.6 Using PowerCute Network Shutdown on Netware 3.7 Using PowerCute Network Shutdown on Microsoft Windows NT, Windows 2000, and Windows XP 4.0 Web sites and phone support 4.1 Web sites 4.2 Software service and support 4.3 Hardware service and support 5.0 Notices and trademarks 6.0 Disclaimer 1.0 ABOUT THIS README FILE -------------------------- 1.1 Overview of this code The PowerChute Network Shutdown software works in conjunction With the UPS Network Management Card to provide graceful, unattended shutdown of multiple computer systems over a network. Its scalable architecture can support a virtually unlimited number of client systems. Easily configurable via a browser- based interface, customize command files can be run on each individual server in the event of an unattended shutdown 1.2 Known Issues on all supported operating systems (1) Issue: When several actions are selected for the same event, and the actions all have the same delay time, some actions do not occur. Solution: Threading issues in Java occasionally cause the actions to interfere with each other. Use different delay times for each action. (2) Issue: During the installation, you receive an error message that PowerChute Network Shutdown is unable to register with the Embedded Network Module. Solution: In some cases, the installation program registers PowerChute Network Shutdown with the Embedded Network Module, but is unable to confirm that it is registered. Check the IP address list on the Embedded Network Module by opening the Embedded Network Module user interface and selecting the PowerChute menu item. If your computer IP address does not appear on the list, add it manually using the following steps: 1. Type the IP address of the PowerChute network shutdown server in the Add Client IP Address field 2. Select the Add button. 1.3 Known Issues with PowerChute Network Shutdown user interface on Netscape Navigator® (1) Issue: Updates to PowerChute Network Shutdown configuration do not appear on the Configure Events page. Solution: Memory caching can cause old versions of the Configure Events page to be displayed instead of the updated version. Reload the page, or disable caching on the web browser. (2) Issue: There is a blank gray box at the top of the Configure Events page. Solution: This space is for a Java applet that calls a wizard for event configuration. This applet will not run if your web browser does not support Java, or if Java is disabled. Use Netscape Navigator version 4.5 and enable Java. Note: You can also configure events by selecting any of the green buttons on the Configure Events page. (3) Issue: When you are using Netscape Navigator on Red Hat Linux, the PowerChute Network Shutdown user interface is difficult to read. Solution: Change the default font in your browser's Java implementation. Edit the file: netscape directory/java/classes/font.properties, and change the font to the following: -adobe-times-medium-r-normal--12-120-75-75-p-64-iso8859-1 If you do not have that font available, run the xlsfonts command and select an appropriate 12 point font. The font size is the first number in the font name. 1.4 Known issues with PowerChute Network Shutdown user interface on Internet Explorer (1) Issue: Updates to the PowerChute Network Shutdown configuration do not appear on the Configure Events page. Solution: Memory caching can cause old versions of the Configure Events page to be displayed instead of the updated version. Refresh the frame, or disable caching on the web browser. (2) Issue: There is a blank gray box at the top of the Configure Events page. Solution: This space is for a Java applet that calls a wizard for event configuration. This applet will not run if your web browser does not support Java, or if Java is disabled. Use Explorer version 4.0 or later, with the Microsoft Virtual Machine installed (available at www.microsoft.com), and enable Java. Note: You can also configure events by selecting any of the green buttons on the Configure Events page. (3) Issue: Occasionally, after you enter the user name and password, the user interface does not respond. Solution: Select Stop and then Refresh. 1.5 Known issues with PowerChute Network Shutdown and network configuration (1) Issue: After you remove PowerChute Network Shutdown, the Embedded Network Module, or NMC, still has the server IP address. Solution: To remove IP addresses, select each address from the Configured Client IP Addresses list, and select Remove. (2) Issue: PowerChute Network Shutdown is already installed, and you want to monitor a different Embedded Network Module or NMC. Solution: Use the stand-alone configuration utility described in PowerChute Network Shutdown Configuration Utility in the Installation Guide.   1.6 Known issue with PowerChute Network Shutdown and Event Configuration and Logging (1) Issue: Updates to the PowerChute Network Shutdown configuration do not appear on the Configure Events page. Solution: Memory caching can cause old versions of the Configure Events page to be displayed instead of the updated version. Refresh the frame, or disable caching on the web browser.   1.7 Known issues with PowerChute Network Shutdown on Windows NT, Windows 2000, or Windows XP (1) Issue: Command files do not run properly when called by PowerChute Network Shutdown. The command file stops before all of the statements have executed. Solution: The command file must use the @START command to run executable programs, and use the full path name of the program. Path names that include spaces must be enclosed in quotes. Arguments for the executable must be outside the quotes.   For example, if you must run Hyperterminal and Backup in your command file, use the syntax: @START "c:\Program Files\Windows NT\hyperterm.exe" arguments @START c:\Winnt\system32\backup  arguments (2) Issue: After being shut down by PowerChute Network Shutdown, Windows NT will sometimes perform a Checkdisk procedure when it restarts. This intermittent behavior is caused by a problem in Windows NT. This problem does not exist on Windows 2000 or Windows XP. Solution: From the Microsoft Web site, download and install Windows NT Service Pack 6 or later. (3) Issue: A PowerChute Network Shutdown client that acquires its IP address through DHCP will lose communications with the Embedded Network Module, or NMC, when the client renews its DHCP address lease and acquires a different IP address. Solution: Do not use PowerChute Network Shutdown on systems running DHCP. Each system using PowerChute Network Shutdown must have a permanent IP address. (4) Issue: After installing PowerChute Network Shutdown, a folder called tmpjex01 (or a similar name) is in the Temp folder or at the root. Solution: Delete this folder. 1.8 Installation Requirements for all supported operating systems - An IBM UPS that has an Embedded Network Module, or a Network Management Card option. This currently includes the IBM UPS 3000XHV, the IBM UPS 3000XLV, the IBM UPS 7500XHV, and the IBM UPS 10000XHV. - For the Embedded Network Module and Network Management Card, a firmware revision of 2.5.4 or later. If necessary, you can update your firmware from the IBM Web site. - One of the following operating systems: Windows NT, Windows 2000, Windows XP, NetWare 6.0, or Red Hat Linux 7.3. - The IP address for the Embedded Network Module or Network Management Card. - A Java® Virtual Machine (JVM), version 1.2.2 or later, on your server for all operating systems except Windows NT, Windows 2000, or Windows XP. - A monitor with resolution of 800 x 600 or greater. Note: PowerChute Network Shutdown is compatible with PowerChute Business Edition, which is provided on a CD with your UPS. 2.0 CHANGE HISTORY ------------------ This is the updated release to support the IBM UPS 7500XHV and the IBM UPS 10000XHV. 3.0 Installation and Setup Instructions ----------------------------------------- 3.1 Installing and Setup Instructions for all supported operating systems (1) Configure the UPS's Embedded Network Module with an IP address, default gateway, and subnet mask before beginning the installation of PowerChute Network Shutdown. If you install PowerChute Network Shutdown first, additional steps will be required when configuring the Embedded Network Module or Network Management Card. See your UPS Quick Installation Guide for instructions on configuring the respective devices. (2) Use the Embedded Network Module's, Network Management Card's, user interface to configure the UPS. At a minimum, set 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 Embedded Network Module and Network Management Card use the same default User Name, Password and Authentication Phrase as PowerChute Network Shutdown. (3) Select the installation program for the operating system(s) that you require. The installation program must be run on the server console. You must remove any existing version of PowerChute Network Shutdown before starting the installation program. To start the PowerChute Network Shutdown installation program: - For installation on Windows NT, Windows 2000, or Windows XP, either double-click the installation program icon or execute the file pcns211.exe from a command line. After you complete the installation, you can use the Silent Installation to set up many computers to have the same PowerChute Network Shutdown configuration. - For Installation on NetWare: (1) If you downloaded the file pcns201.exe from the Web, 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 you are obtaining the software from a CD-ROM, copy the installation files from the NetWare directory on the CD-ROM 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 commands (where tempdirectory represents the location of the installation files). To install to a different volume, use the name of that volume instead of SYS: in the two envset commands. load Java envset CWD=SYS:\tempdirectory Note: Enter the following envset command all on one line, and the Java load command on the next. envset CLASSPATH=$CLASSPATH;SYS:\tempdirectory\pcns201.jar; SYS:\tempdirectory\util.jar;SYS:\tempdirectory\swingall.jar Java load - For installation on Linux, perform the following steps. After you finish the installation, you can use the Silent Installation to set up many servers to have the same PowerChute Network Shutdown configuration. (1) Make sure the location of the JVM executable (java.exe) is in the PATH environment variable. (2) If you downloaded the file pcns201.tar from the Web, copy the file to a temporary directory on the file server. Then extract the installation files using the following command: tar xvf pcns201.tar If you are obtaining the software from a CD-ROM, copy the installation files from the CD-ROM to a temporary directory on the file server. (3) Change your working directory to the directory containing the installation files. Then type the following command: java -cp .:pcns201.jar:swingall.jar:util.jar load (4) At the following prompt, choose "yes" to continue the installation: You are about to install a new application. Continue? Note: If you already have PowerChute Network Shutdown installed, you must first remove the old version in order to continue the installation process. (5) When the "About" box is displayed, select Next. (6) Select "I agree" to accept the terms of the PowerChute Network Shutdown license agreement and to continue with the installation. If you do not accept the agreement, you must select "Cancel" and will not be able to 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 (except on NetWare) use the Browse button. Select Next. (8) On Windows NT, Windows 2000, and Windows XP, do not change the setting that specifies whether you are using a Parallel Silcon UPS. Leave that setting at its default, and select Next. (9) Enter the Initial Configuration information: - Management Card IP: This is the network address of the Embedded Network Module or Network Management card attached to your UPS. - The http port number being used by the Embedded Network Module or Network Management Card. The default is 80; you do not need to change this number unless you changed the http port being used by your Embedded Network Module or Network Management Card. - The PowerChute Network Shutdown http port number. Do not change the port setting from the default value of 3052. Modifying the default http port number is not supported and will affect communication with the Embedded Network Module or the Network Management Card. Click Next to continue. (10) Enter the Security Configuration information. Always configure the same User Name, Authentication Phrase, and Password for both PowerChute Network Shutdown and the Embedded Network Module, or Network Management Card. The default settings are the same for both interfaces. If you have not changed the default settings of the Embedded Network Module, or Network Management Card, select Next; otherwise, enter the same values used by the Embedded Network Module or Network Management Card. The User Name and Authentication Phrase are used to authenticate the communication between PowerChute Network Shutdown and the Embedded Network Module or the Network Management Card. The User Name and Password are used to log into the user interface of PowerChute Network Shutdown and of the Embedded Network Module or Network Management Card. Note: You may see Java exceptions displayed during the installation of PowerChute Network Shutdown. These errors will not affect the successful completion of the installation or operation of PowerChute Network Shutdown. (11) Complete the PowerChute Network Shutdown Installation. After you complete the Security information and select Next, PowerChute Network Shutdown registers with the Embedded Network Module, or Network Management Card, so that PowerChute Network Shutdown and the Embedded Network Module, or Network Management Card can communicate. If PowerChute Network Shutdown cannot register with the Embedded Network Module, or the Network Management Card, you receive an error message. - To continue the installation, you must enter the server IP address manually at the Embedded Network Module or Network Management Card. - If you select the Cancel button 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, and Windows XP), process (on NetWare) or daemon (on Linux) starts 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. (13) 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 117.14.53.59, use one the following URLs: COMP1:3052 117.14.53.59:3052 If, during the installation of PowerChute Network Shutdown, you chose a web server port other than 3052 (the default), use that web server port in the URL. Note: PowerChute Network Shutdown can be used with the following browser versions: Microsoft Internet Explorer version 4.0 or later Netscape Navigator version 4.05 or later If you are using a browser version other than one of these, some functions may not be available 3.2 Silent Installation for all supported operating systems (Except Netware®) On Windows NT, Windows 2000, Windows XP, and Linux systems, you can install PowerChute Network Shutdown from a command line, which allows you to set up quickly many 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. When editing the silentInstall.ini file, do not enclose values in quotation marks. Also, preface all path separators ('\' for Windows and '/' for UNIX) with an escape character ('\'). - Edit the applicationDirectory parameter to specify the directory in which you want 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 Embedded Network Module or with the Network Management Card. - If you are installing 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 Embedded Network Module or Network Management Card that is in the UPS. (5) Put the m11.cfg file, the silentInstall.ini file, and the PowerChute Network Shutdown installation files in a temporary directory on the new server. (6) For an installation on Windows NT, Windows 2000, and Windows XP, type the following as the command line: C:\temp dir\pcns211.exe -q temp dir\silentInstall.ini where temp dir 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 with quotation marks. Otherwise, no quotation marks are required. For example: C:\pcinstall\pcns211.exe -q "C:\Program Files\InstallDir\silentInstall.ini" C:\pcinstall\pcns211.exe -q C:\InstallDir\silentInstall.ini For an installation on Linux, use the following command on one line: Java home dir/bin/java -cp .:pcns201.jar:swingall.jar:util.jar load -q tempdir/silentInstall.ini After you complete the installation, check the install.log and errors.log files for error conditions. 3.3 Registering an IP Address with an Embedded Network Module or Network Management Card If the installation program cannot communicate with the Embedded Network Module, or the Network 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 Embedded Network Module's, or Network Management Card's, web user interface by using the device's IP address as the URL. (2) From the user interface, click on the UPS model name displayed on the menu. (3) Select the PowerChute menu option. This will display a list of the IP addresses which are registered with this device. (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 select the Add button. To remove existing IP addresses, select each address from the Configured Client IP Addresses list, and select Remove. 3.4 PowerChute Network Shutdown Configuration Utility The stand-alone PowerChute Network Shutdown Configuration Utility is not part of the PowerChute Network Shutdown user interface. The Configuration Utility allows you to change the following PowerChute Network Shutdown settings after you install PowerChute Network Shutdown: - IP address of the Embedded Network Module or Network Management Card to monitor - Port number of the Embedded Network Module or Network Management Card to monitor - PowerChute Network Shutdown port number - Administrator User Account - Administrator Password - Security Phrase To run the Configuration Utility, type on one line the command listed below for your operating system. On Windows NT, Windows 2000, and Windows XP: Java home dir\bin\java -cp .;confutil.jar;swingall.jar;m11.jar;ds.jar; collections.jar;jsdk.jar PCNSUtilApp On NetWare: If you installed PowerChute Network Shutdown to a non-default directory, use the name of that directory instead of PowerChute in the envset commands below: envset CWD=SYS:\PowerChute envset CLASSPATH=$CLASSPATH;SYS:\PowerChute\confutil.jar;SYS:\PowerChute\m11.jar; SYS:\PowerChute\util.jar;SYS:\PowerChute\swingall.jar java -cp .;confutil.jar;swingall.jar;m11.jar;ds.jar;collections.jar; jsdk.jar PCNSUtilApp On Linux: Java home dir\bin\java -cp .:confutil.jar:swingall.jar:m11.jar:ds.jar: collections.jar:jsdk.jar PCNSUtilApp The Configuration Utility can also be used to set up m11.cfg files to use the same PowerChute Network Shutdown configuration for silent installations to monitor multiple Embedded Network Modules or Network Management Cards, as follows: (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 Embedded Network Module's IP address. (5) Use the modified m11.cfg file to perform a command line installation. (See Silent Installation, step #4) 3.5 Using PowerCute Network Shutdown on Red Hat Linux You must have RedHat Linux 7.3 to use PowerChute Network Shutdown. XWindows is required to install PowerChute Network Shutdown. PowerChute Network Shutdown requires Java Virtual Machine (JVM), version 1.2.2 or later, on your server. Obtain this JVM from http://www.blackdown.org, or contact your Linux vendor or service provider. 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 Embedded Network Module, or Network Management Card, using the PowerChute option on the device's user interface menu. 3.6 Using PowerCute Network Shutdown on Netware You must have NetWare 6.0 to use PowerChute Network Shutdown. PowerChute Network Shutdown requires Java Virtual Machine (JVM), version 1.2.2 or later, on your server. Obtain this JVM and the associated operating system patches from the Novell® web site, or contact your Novell service provider. Before installing PowerChute Network Shutdown, make sure that the file SYS:\ETC\HOSTS includes a line with your file server's IP address and server name. Installing PowerChute Network Shutdown on NetWare requires a screen resolution of 800 x 600 or 1024 x 768. To stop the PowerChute Network Shutdown process, do the following: (1) Enter this command at the server prompt to obtain the number of the PowerChute process: Java -sh (2) Enter this command to stop the PowerChute process: Java -killprocess number For example, if the PowerChute process number is 22, use this command: Java -kill22 To start the PowerChute process, execute the file APCpcns.ncf in the PowerChute directory. 3.7 Using PowerCute Network Shutdown on Microsoft Windows NT, Windows 2000, and Windows XP You must have Windows NT version 4.0, Windows 2000, or Windows XP to use PowerChute Network Shutdown. Always use the latest available Service Pack. 4.0 Web sites and phone support --------------------------------- Information and assistance is available through the IBM Web site and by phone. 4.1 Web sites IBM Support Web Site: http://www.ibm.com/pc/support/ IBM eServer Web site: http://www.ibm.com/eserver/xseries/ 4.2 Software service and support Through IBM Support Line, you can get telephone assistance, for a fee, with usage, configuration, and software problems with xSeries servers, IntelliStation workstations, and appliances. For information about which products are supported by Support Line in your country or region, go to http://www.ibm.com/services/sl/products/. For more information about Support Line and other IBM services, go to http://www.ibm.com/services/, or go to http://www.ibm.com/planetwide/ for support telephone numbers. In the U.S. and Canada, call 1-800-IBM-SERV (1-800-426-7378). 4.3 Hardware service and support You can receive hardware service through IBM Services or through your IBM reseller, if your reseller is authorized by IBM to provide warranty service. Go to http://www.ibm.com/planetwide/ for support telephone numbers, or in the U.S. and Canada, call 1-800-IBM-SERV (1-800-426-7378). In the U.S. and Canada, hardware service and support is available 24 hours a day, 7 days a week. In the U.K., these services are available Monday through Friday, from 9 a.m. to 6 p.m. 5.0 NOTICES AND TRADEMARKS ---------------------------- INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. IBM, the e-business logo, and eServer are trademarks of the IBM Corporation in the United States, other countries, or both. Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Red Hat, the Red Hat "Shadow Man" logo, and all Red Hat-based trademarks and logos are trademarks or registered trademarks of Red Hat, Inc., in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others. 6.0 Disclaimer ---------------- 6.1 THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. 6.2 Note to Government Users Include the following note after the disclaimer paragraph. Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.