Installation guide

Warning
If the command /sbin/service httpd stop or /sbin/service httpd restart is issued
on an LVS router, you must start the piranha-gui service by issuing the following command:
/sbin/service piranha-gui start
The piranha-gui service is all that is necessary to begin configuring LVS. However, if you are
configuring LVS remotely, the sshd service is also required. You do not need to start the pulse service
until configuration using the Piranha Configuration Tool is complete. See Section 4.8, “Starting LVS”
for information on starting the pulse service.
2.3.1. Configuring the Piranha Configuration Tool Web Server Port
The Piranha Configuration Tool runs on port 3636 by default. To change this port number, change
the line Listen 3636 in Section 2 of the piranha-gui Web server configuration file
/etc/sysconfig/ha/conf/httpd.conf.
To use the Piranha Configuration Tool you need at minimum a text-only Web browser. If you start a
Web browser on the primary LVS router, open the location http://localhost:3636. You can reach
the Piranha Configurat ion Tool from anywhere via Web browser by replacing localhost with the
hostname or IP address of the primary LVS router.
When your browser connects to the Piranha Configuration Tool, you must login to access the
configuration services. Enter piranha in the Username field and the password set with piranha-
passwd in the Password field.
Now that the Piranha Configuration Tool is running, you may wish to consider limiting who has
access to the tool over the network. The next section reviews ways to accomplish this task.
2.4. Limiting Access To the Piranha Configuration Tool
The Piranha Configuration Tool prompts for a valid username and password combination. However,
because all of the data passed to the Piranha Configurat ion Tool is in plain text, it is recommended
that you restrict access only to trusted networks or to the local machine.
The easiest way to restrict access is to use the Apache HT T P Server's built in access control
mechanisms by editing /etc/sysconfig/ha/web/secure/.htaccess. After altering the file you do
not have to restart the piranha-gui service because the server checks the .htaccess file each time
it accesses the directory.
By default, the access controls for this directory allow anyone to view the contents of the directory. Here
is what the default access looks like:
Order deny,allow
Allow from all
To limit access of the Piranha Configuration Tool to only the localhost change the .htaccess file to
allow access from only the loopback device (127.0.0.1). For more information on the loopback device,
see the chapter titled Network Scripts in the Red Hat Enterprise Linux Reference Guide.
Red Hat Enterprise Linux 4 Virtual Server Administration
22