8.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


/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.


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 10.8 Starting the Cluster for information on starting the pulse service.

8.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.