Entire Contents copyright © 1999 by American Power Conversion All rights reserved; reproduction in whole or in part without permission is prohibited. September, 1999 ------------------------------------------------- This file explains how to use RPM to install, configure, and uninstall PowerChute plus version 4.5.1 for Linux on your machine. You can use RPM for these tasks ONLY on Red Hat version 6.0. To install PowerChute plus on any other version of Linux or to install PowerChute plus on Red Hat 6.0 without using RPM, see the file install.txt instead. See the following topics in this file: - For installation instructions, see HOW TO USE RPM TO INSTALL POWERCHUTE PLUS. - To configure PowerChute plus after the brief installation, see HOW TO CONFIGURE POWERCHUTE PLUS ********************************* NOTE: WHEN YOU INSTALL POWERCHUTE PLUS USING RPM, EITHER BY RUNNING THE RPM COMMAND ON THE COMMAND LINE OR BY RUNNING GnoRPM, YOU MUST THEN RUN THE Config.sh SCRIPT. IF YOU DO NOT RUN Config.sh, POWERCHUTE PLUS WILL BE UNABLE TO COMMUNICATE WITH THE UPS. ********************************* - To uninstall PowerChute plus, version 4.5.1, if it was installed using RPM, see HOW TO USE RPM TO REMOVE POWERCHUTE PLUS. HOW TO USE RPM TO INSTALL POWERCHUTE PLUS _________________________________________ Perform the following steps to install PowerChute plus: 1. Remove any existing version of PowerChute plus. - To remove version 4.5, run the script Remove.sh in the installation directory. - To remove version 4.5.1 in preparation for a reinstallation, do one of the following: if PowerChute plus was installed using RPM, use the instructions in HOW TO USE RPM TO REMOVE POWERCHUTE PLUS later in this file. if PowerChute plus was installed from a .tar file, run Remove.sh in the installation directory. 2. Download PowerchutePlus-4.5.1-1.i386.rpm from APC's web site. 3. Do either of the following: - In the directory to which you downloaded PowerChutePlus-4.5.1-1.i386.rpm, enter the rpm command as follows: rpm -i PowerChutePlus-4.5.1-1.i386.rpm - Use GnoRPM to perform the installation of the package PowerChutePlus-4.5.1-1. All components of PowerChute plus will be installed, including the HTML help files. You must have a web browser already installed. HOW TO CONFIGURE POWERCHUTE PLUS ________________________________ ********************************* NOTE: WHEN YOU INSTALL POWERCHUTE PLUS USING RPM, EITHER BY RUNNING THE RPM COMMAND ON THE COMMAND LINE OR BY RUNNING GnoRPM, YOU MUST RUN THE Config.sh SCRIPT. IF YOU DO NOT RUN Config.sh, POWERCHUTE PLUS WILL BE UNABLE TO COMMUNICATE WITH THE UPS. ********************************* Perform the following steps: 1. To configure PowerChute plus, run the configuration script as follows: /usr/lib/powerchute/Config.sh Through the following series of prompts, the installation script enables you to configure PowerChute plus for your system. a. Specify the type of UPS by typing 1, 2, 3, 4, 5 or 6. 1) Matrix-UPS 2) Smart-UPS 3) Back-UPS 4) Back-UPS Pro 5) Symmetra Power Array 6) Smart-UPS DP Which APC Hardware will PowerChute Plus for UNIX be running with? b. If you specified 1, 2, 4, or 5 (Matrix-UPS, Smart-UPS, Back-UPS Pro, or Symmetra Power Array) as the UPS type, you are asked if an APC Measure-UPS device is connected to your UPS. Do you currently have a Measure-UPS attached to the UPS [y/n] Type y for yes or n for no. c. Indicate whether you use TCP/IP (used by PowerChute to enable monitoring of other hosts): Do you currently have TCP/IP installed? [y/n] If TCP/IP is not installed or configured on your system, or your computer is not connected to a network, answer n for no. Answering n means that you cannot use your current workstation to monitor other workstations. d. Next, specify your monitor color setup. 1) Use Default Color Scheme 2) Use Monochrome Color Scheme Which color scheme do you wish to use [1]? Type 1 if you are using a color monitor or 2 if you are using a monochrome monitor. e. Specify a serial port: 1) /dev/ttyS0 2) /dev/ttyS1 3) Other Which serial device will be dedicated to PowerChute Plus for UNIX[?] Select the serial port that will be used to communicate with your UPS. You must have the correct cable attached to the serial port you specify (940-1524C for Symmetra Power Array, 940-0095A for Back-UPS Pro, 940-0024C for other smart-signalling UPSs, or 940-0023A for Back-UPS) f. If you selected 'Other' in the preceding step, the following prompt appears: Enter the full pathname of serial device [?] You must enter the device name, including the path, for the serial port that you want to use. g. Command files may be executed with root privileges or with the privileges you assign to the pwrchute account (allowing you to customize command file execution according to your system requirements). Do you want to execute command files as root [y/n] h. E-mail may be sent with root privileges or with the privileges you assign to the pwrchute account. Do you want to send e-mail as root? [y/n] i. The installation script now displays a screen showing the configuration choices you made. Following is an example from an Linux installation on the first internal serial port for a Smart-UPS: ---------------------------------------------------- PRODUCT : PowerChute Plus for Unix DEDICATED TTY : /dev/ttyS0 UPS TYPE : Smart-UPS Measure-UPS INSTALLED : FALSE INSTALLING AS ROOT : TRUE TCP/IP Installed : FALSE RUN COMMAND FILES AS ROOT : TRUE SEND EMAIL AS ROOT : TRUE ----------------------------------------------------- Are the above selections correct? [y/n] - If the selections shown are incorrect, select n. You will then need to run Config.sh again to configure PowerChute plus. - If the selections shown are correct, select y. The configuration script then verifies the communications port and verifies that the UPS is communicating. - If the UPS is communicating with PowerChute plus, the script updates the appropriate system files. - If the UPS is not communicating with PowerChute plus, you receive an error message indicating that the installation can not take place. Check your cable connection. j. If the UPS shutdown delay for your UPS is currently set to 20 seconds you are asked to increase it: Do you wish to increment the UpsTurnOffDelay to its next highest value (180) now? [y/n] A 20-second UPS Turn Off Delay (the default on some APC UPS models) may not provide sufficient time to shut down your Linux operating system. Therefore, ALWAYS TYPE y IN RESPONSE TO THIS PROMPT to allow enough time for Linux to shut down completely. With some UPS models, you may receive the following error message when you try to increase the UPS Turn Off Delay in this step: "Unable to modify the value of this EEPROM. If you are unable to change this value through the PC+ interface, refer to the UPS manual or contact APC Technical Support." For these models, continue and complete the installation despite the message. Then, on the PowerChute plus main screen, choose the UPS Shutdown Parameters option on the Configuration menu. In the "UPS Shutdown Parameters" dialog box, increase the UPS Turn Off Delay from 20 seconds to its next higher value. k. If you answered y to the prompt that asked "Do you currently have TCP/IP installed?" and if the pwrchute user account does not already exist, the configuration script creates the account and prompts you to designate the account's password: Please set the password for the pwrchute user account. You are then asked to confirm the password by typing it again. 2. After completing the installation and configuration, reboot your system. HOW TO USE RPM TO REMOVE POWERCHUTE PLUS ________________________________________ To remove PowerChute plus version 4.5.1, if it was installed using RPM, do either of the following: - Use the following command: rpm -e PowerChutePlus-4.5.1-1 - Use the Uninstall feature of GnoRPM to perform the removal. Under Packages, choose Utilities, then System to find the package PowerChutePlus-4.5.1-1 to remove. RPM does not remove files that have changed since installation. Therefore, if you used PowerChute plus after you installed it, and you now try to remove it, the removal will be incomplete, whether you are using the command line interface or GnoRPM. For example, the event log (powerchute.log) and a copy of the powerchute.ini file (powerchute.ini.rpmsave) will remain in the powerchute directory. In the case of an incomplete removal, the following error message is displayed in the command line interface. (If you are using GnoRPM, you see the error message only if you have the Terminal window open.) Cannot remove /usr/lib/powerchute - directory not empty Use the following command to remove the remaining components of PowerChute plus, including the powerchute directory and its contents. rm -rf /usr/lib/powerchute