2.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:
-
The Apache HTTP Server must be installed on the system.
-
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 Load Balancer Add-On. However, if you are configuring Load Balancer Add-On 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 the Load Balancer Add-On” 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 https://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 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.
