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