Starting the Piranha Configuration Tool Service

Red Hat Cluster Suite: Configuring and Managing a Cluster
Prev | Chapter 11. Initial LVS Configuration | Next

# 11.3. Starting the Piranha Configuration Tool Service

After you have set the password for the Piranha Configuration Tool, start or restart the `piranha-gui` service located in `/etc/rc.d/init.d/piranha-gui`. To do this, type the following command as root:

    /sbin/service piranha-gui start

or

    /sbin/service piranha-gui restart

Issuing this command starts a private session of the Apache HTTP Server by calling the symbolic link `/usr/sbin/piranha_gui -> /usr/sbin/httpd`. For security reasons, the `piranha-gui` version of `httpd` runs as the piranha user in a separate process. The fact that `piranha-gui` leverages the `httpd` service means that:

1. The Apache HTTP Server must be installed on the system.

2. Stopping or restarting the Apache HTTP Server via the `service` command stops the `piranha-gui` service.

| 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 an LVS cluster. However, if you are configuring the cluster 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 13.8 Starting the Cluster for information on starting the `pulse` service.

## 11.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 Configuration 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 cluster 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.

Prev | Home | Next
Setting a Password for the Piranha Configuration Tool | Up | Limiting Access To the Piranha Configuration Tool