Installation Guide: PowerChute plus version 4.5.3 für SuSE Linux Professional 7.2
##########################################################
Die tar-Files gibt es auf dem FTP von APC:
ftp.apcftp.com
Verzeichnis: /software/unix/linux/pcplus/453
-einfach das komplette Verzeichnis kopieren
-alternativ dazu auch auf der CD im Powerchute-Verzeichnis
##########################################################

Entire contents copyright (c) 2001 by American Power Conversion
All rights reserved; reproduction in whole or in part without permission is prohibited.
February, 2001

---

Use the instructions in this file to install PowerChute plus version 4.5.3 on any of the following UNIX platforms:
- Caldera Linux, version 2.3 or 2.4
- SuSE Linux, version 7.0
- Red Hat Linux, version 7.0
Note: On Red Hat Linux only, you can use Red Hat Package Manager (RPM) instead to perform the installation. See the file rpm453.txt.

---

Vor der eigentlichen Installation:

-überprüfen, ob das compat-Paket von SuSE DVD installiert ist, wenn nicht, über SuSE Control Center nachinstallieren
-aufgrund fehlerhafter Installationsskripte muss noch etwas Handarbeit angelegt werden:
-im /etc/rc.d Verzeichnis noch ein Verzeichnis init.d anlegen und in dieses die /etc/halt-Datei hineinkopieren
(Zur Erklärung: Von dieser Datei soll im Skript ein Backup gemacht werden und wenn diese nicht existiert, bricht die Installation mit Fehler ab.)
-zur Sicherheit ein Backup des /etc-Verzeichnis machen (um Neuinstallation aufgrund veraenderter Konfig-Dateien zu vermeiden)

---

Nach der Installation (die nach der Modifikation bei uns problemlos lief)

Dadurch, dass das Installationsskript die halt-Datei an der falschen Stelle findet und editiert, wird der Shutdown (egal ob administrativ, scheduled, oder durch Stromausfall) nicht ohne etwas Nacharbeit funktionieren.
Die USV erhält keine Befehle beim Shutdown des Rechners, weiss also nicht, was sie danach tun soll und bleibt somit angeschaltet
Dank des schnellen und ausführlichen Supports von APC (Problem war bereits bekannt) hier die Lösung:
Im Verzeichnis /etc/init.d existiert die vom System zum Shutdown verwendete halt-Datei. Diese ist noch im unveränderten Zustand (nicht von PowerChute verändert) und muss editiert werden.
Im Abschnitt, der mit "echo "Turning off swap" " beginnt, müssen folgende Zeilen eingefügt werden (in rot):
sync ; sync
rc_reset
swapoff -a

if [ -r /upsoff.cmd ] then . ./upsoff.cmd >/dev/null rm -f /upsoff.cmd fi

#POWERCHUTE #POWERCHUTE #POWERCHUTE #POWERCHUTE #POWERCHUTE

rc_status -v1 -r

Das #POWERCHUTE kann natürlich weggelassen werden.

Zur Beachtung: Die Befehlszeilen müssen genau so eingetragen werden, bitte genau lesen, evtl den Quelltext des HTML-Files (ohne das "br") verwenden. Wenn dort ein Leerzeichen an der falschen Stelle fehlt, fährt der Rechner nicht runter und die USV auch nicht. Das ist mir passiert und es hat einige Zeit gedauert, bis ich den Fehler gefunden hatte.
In der halt_suse7.txt steht auch nochmal alles drin.
Im Folgenden die bis auf einen rot markierten Punkt unveränderte Installationsanleitung von APC in Englisch, die aber auch beim Ausfüren des Installationsskripts angezeigt wird. Nur der Hinweis bei TCP/IP muss beachtet werden.

---

Installation Instructions:
__________________________

1. Download the .tar file to a temporary directory on your machine:

- For Red Hat Linux, the file is pcplus_453_redhat.tar

- For Caldera Linux, the file is pcplus_453_caldera.tar

- For SuSE Linux, the file is pcplus_453_suse.tar

2. Extract the installation files using the tar command:

# tar xvf pcplus_453_redhat.tar (for Red Hat Linux)

# tar xvf pcplus_453_caldera.tar (for Caldera Linux)

# tar xvf pcplus_453_suse.tar (for SuSE Linux)

3. Execute the INSTALL script:

# ./INSTALL.

4. Using the following series of prompts, the installation script enables you to configure PowerChute plus for your system.

a. In response to the following prompt, type 1 for CD-ROM even though you downloaded the .tar file from the APC web site:

1) CD-ROM
2) Floppy
3) Tape

Select the media type from which you will install.

b. Next, choose whether to see an overview.

Would you like to see an overview of the installation? [y/n,q]

If you choose y, press the Spacebar to advance a page at a time. Then, at the end of the preview, press Enter to continue the installation.

c. PowerChute plus for UNIX consists of two modules, as discussed in the User's Guide. On a network, you could install just the daemon module on many workstations (saving hard drive space) and use a single workstation for the User Interface Module. On a stand-alone workstation, i.e. a workstation not connected to a network, you need to install both modules of PowerChute plus.

1) User Interface Module Only
2) Daemon Module Required for UPS Monitoring Only
3) Both the User Interface and Daemon Modules

Which parts of PowerChute Plus do you wish to install?[?]

Type 1, 2, or 3.

d. Next, 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
7) PowerStack
Which APC Hardware will PowerChute Plus for UNIX be running with?

e. 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 the UPS -- either a stand-alone Measure-UPS or an Environmental Monitoring SmartSlot Card (formerly SmartSlot Measure-UPS II).

Do you currently have a Measure-UPS attached to the UPS [y/n,q]

Type y for yes or n for no.

f. Indicate whether you use TCP/IP (used by PowerChute to enable monitoring of other hosts):

---

wichtiger Hinweis: Hier bitte "no" auswählen, da sonst die Installation nicht funktioniert.

---

Do you currently have TCP/IP installed? [y/n,q]

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.

g. Next, specify your monitor color setup. If you previously selected 2 in step 4.c (to install the "Daemon Module Required for UPS Monitoring Only"), you will not be asked this question:

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.

h. 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 or 940-0024C for Symmetra Power Array or Smart-UPS 2U Rack Mount models, 940-0095B for Back-UPS Pro, 940-0024C for other smart-signaling UPSs, or 940-0023A for Back-UPS).

i. If you selected 'Other' at 'i' above, 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.

j. If the installation script finds an existing version of PowerChute plus, it queries whether to remove it. APC strongly recommends that you remove any existing version before you install a new version of the software.

Type y to remove.

k. Next, you specify where to install PowerChute plus:

Where do you wish to install PowerChute Plus for Unix? [/usr/lib/powerchute]

Press Enter to select the default, or type the full path name of the directory. If /usr is a separately mounted file system, you must specify a different directory, such as /etc. Files in the PowerChute plus directory need to be available to the operating system after all other file systems have been unmounted.

l. 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, q]

m. 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, q]

n. Next, choose whether to install online help:

Would you like to install HTML help? [y/n,q]

o. If you choose y, you are asked for the name of your web browser.

Please enter your web browser executable name. This value is case-sensitive and should not include the path.
[netscape]

The installation script uses the UNIX "which" command to search, in order, the directories defined by the $PATH environment variable. It uses the first executable file it finds that matches the name you entered. If the script finds no matching executable file -- for example if you entered the name incorrectly -- it prompts you to specify the full path as well as the name of the executable file.

p. 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
INSTALL USER INTERFACE : TRUE
INSTALL DAEMON : TRUE
OPERATING SYSTEM : Linux
INSTALL PATH : /usr/lib/powerchute
PATH TO MOUNTED CD ROM : /linuxAPC
DEDICATED TTY : /dev/ttyS0
UPS TYPE : Smart-UPS
Measure-UPS INSTALLED : FALSE
PREVIOUS VERSION FOUND : TRUE
REMOVE PREVIOUS VERSION? : TRUE
INSTALLING AS ROOT : TRUE
TCP/IP Installed : FALSE
RUN COMMAND FILES AS ROOT : TRUE
SEND EMAIL AS ROOT : TRUE
WEB BROWSER : /usr/bin/netscape
----------------------------------------------------

Are the above selections correct? [y/n,q]

- If the selections shown are correct, select y.
- If the selections shown are incorrect, select n. You will then
need to run the install script again to install PowerChute plus.
- To exit from the installation script without installing PowerChute plus, select q.

If a version of PowerChute plus for UNIX is already installed, you are asked to confirm that you want it removed. The install script then creates the install path, verifies the communications port, verifies that the UPS is communicating, copies the PowerChute plus files to the specified path, and updates the appropriate system files.

q. If the UPS shutdown delay for your UPS is currently set to 20 seconds or less, you are asked to increase it:

Do you wish to increment the UpsTurnOffDelay to its next highest value now? [y/n]

A 20-second UPS Turn Off Delay 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.

----------------------------------------------------------
Note:
To make sure the UPS Turn Off Delay is long enough for your system and is properly configured in relation to other delay periods, see Chapter 9 of the User's Guide. To reset the UPS Turn Off Delay after installation, select UPS Shutdown Parameters on the Configuration menu, and change the value in the dialog box.
----------------------------------------------------------

r. The installation will inform you of any errors. If there are no errors, it displays the message "Installation complete".

5. If your machine is on a network (i.e. you answered y to the earlier prompt "Do you currently have TCP/IP installed? [y/n,q]"), you MUST now create a pwrchute user account and designate a password for that account. This password restricts who has access to monitor and configure your machine over the network.

6. To start the PowerChute daemon, reboot your system, or type the following:

./upsd

7. To start the User Interface Module, type xpowerchute from the PowerChute plus installation directory and then type the password of the pwrchute user.
> Konfiguration abspeichern (dauert einen kurzen Moment)