Installation guide

Chapter 10.
Configuring the LVS Routers with Piranha
Configuration Tool
The Piranha Configuration Tool provides a structured approach to creating the necessary
configuration file for a Piranha cluster — /etc/sysconfig/ha/lvs.cf. This chapter
describes the basic operation of the Piranha Configuration Tool and how to activate the
cluster once configuration is complete.
Important
The configuration file for the LVS cluster follows strict formatting rules. Using the Piranha
Configuration Tool is the best way to prevent syntax errors in the lvs.cf and therefore
prevent software failures.
10.1. Necessary Software
The piranha-gui service must be running on the primary LVS router to use the Pi-
ranha Configuration Tool. To configure the cluster, you minimally need a text-only Web
browser, such as links. If you are accessing the LVS router from another machine, you
also need an ssh connection to the primary LVS router as the root user.
While configuring the primary LVS router it is a good idea to keep a concurrent ssh con-
nection in a terminal window. This connection provides a secure way to restart pulse and
other services, configure network packet filters, and monitor /var/log/messages during
trouble shooting.
The next four sections walk through each of the configuration pages of the Piranha Con-
figuration Tool and give instructions on using it to set up the LVS cluster.
10.2. Logging Into the Piranha Configuration Tool
When configuring an LVS cluster, you should always begin by configuring the primary
router with the Piranha Configuration Tool. To do this,verify that the piranha-gui
service is running and an administrative password has been set, as described in
Section 8.2 Setting a Password for the Piranha Configuration Tool.
If you are accessing the machine locally, you can open http://localhost:3636 in a
Web browser to access the Piranha Configuration Tool. Otherwise, type in the hostname