Turbolinux Cluster LoadBalancer 10: User Guide
<<< Previous	Chapter 4. Configuration	Next >>>

4.2. Configuration Tool Overview

There are two ways to configure your cluster -- editing the configuration file by hand or using the configuration tools. It is recommended that you use the configuration tools to start with, until you are familiar with all the available options. The configuration tools provide a menu-driven interface that is easy to use and does a good job of explaining what each parameter is used for. The configuration tools take the information that you enter and create a configuration file. They can also parse the file to display the current settings. This chapter covers the configuration tools. The next chapter will cover the format of the configuration file.

There are two different ways to get into the cluster configuration tool. The direct route is to use the tlclbconfig program. It will take you directly to the configuration menu. The other way is through the turboclusteradmin program. This tool allows you to access the tlclbconfig program as well as the synchronization tools and some documentation files. Most people will probably use the turboclusteradmin program because it allows you to manage more aspects of the cluster.

When entering IP addresses and domain names in the configuration program, the addresses will need to be fully resolvable, in both forward and reverse directions. There are two ways to accomplish this -- you can either make sure that the addresses are configured in your DNS server, or you can enter the addresses in the /etc/hosts file. You should also make sure that 127.0.0.1 is not associated with the hostname of the system. The only name associated with 127.0.0.1 in the /etc/hosts file should be `localhost'. Here is a sample /etc/hosts file for a system named atm1.turbolinux.usa with an IP address of 192.168.0.1:

    127.0.0.1              localhost

    192.168.0.1            atm1.turbolinux.usa                  atm1

    192.168.0.2            atm2.turbolinux.usa                  atm2

    192.168.0.3            node1.turbolinux.usa                 node1

    192.168.0.4            node2.turbolinux.usa                 node2

    192.168.0.100          cluster.turbolinux.usa cluster

After you have completed the configuration of your cluster, you should use the tlclb_config_sync program to copy the configuration file to other systems within the cluster. You will also need to configure any cluster nodes that are not running Turbolinux Cluster LoadBalancer 10 software.

4.2.1. turboclusteradmin

To start the turboclusteradmin tool, execute the following command as root.

# turboclusteradmin

The first time you use turboclusteradmin, you will see an error that says "/etc/clusterserver.conf file does not exist". Click the `OK' button to proceed. The configuration file will be created automatically.

The turboclusteradmin program is the primary configuration tool used with Turbolinux Cluster LoadBalancer 10. It lets you access four important tools :

tlclbconfig
tlclb_content_sync
tlclb_config_sync
tlclb_certificate

These tools can also be accessed directly from the command line. The turboclusteradmin program provides an integrated configuration tool that lets you access these other tools, as well as some of the documentation files that come with the product.

4.2.2. tlclbconfig

The tlclbconfig program is where the actual configuration takes place. As we stated above, you can run it directly from the command line or select `Cluster Server Configuration' from the main menu in turboclusteradmin.

To execute it directly from the command line, execute the following command as root.

# tlclbconfig

The first time you use tlclbconfig, you will see an error that says "/etc/clusterserver.conf file does not exist". Click the `OK' button to proceed. The configuration file will be created automatically.

Once you get into the Turbolinux Cluster LoadBalancer 10 configuration utility, you will be presented with a menu of various subsystems that you can configure. These are shown in the picture below.

There are quite a few configuration settings that you will need to go through. The settings are divided into various menus in order to place related items together. You will see the following choice:

Clustered Services
Servers Configuration
Advanced Traffic Managers
Virtual Servers
Global Settings

We will cover each of these menu choices in the remainder of this chapter.