Methods of configuration for Site Selector

There are four methods you can use to configure Site Selector: the command line, scripts, the graphical user interface (GUI), and the configuration wizard. This topic assumes use of the command line.

There are four basic methods of configuring the Site Selector component:

Command line

The command line is the most direct means of configuring Site Selector. The command parameter values must be entered in English characters. The only exceptions are host names (used, for example, in site name and server commands) and file names.

To start the Site Selector from the command line:
  1. Start sserver:
    • [AIX][HP-UX][Linux][Solaris]Go to the <install_root>/ss/servers/bin directory and issue the following command from the command prompt:
      sserver
      To stop the service, type:
      sserver stop
    • [Windows] Click Start > Control Panel > Administrative Tools > Services. Right-click IBM Site Selector and select Start. To stop the service, follow the same steps and select Stop.
  2. Issue the Site Selector control commands you want to set up your configuration. The command is sscontrol.
You can use a minimized version of the sscontrol command parameters by typing the unique letters of the parameters. For example, to get help on the file save command, you can type
sscontrol he f
instead of
sscontrol help file

To start the command-line interface issue sscontrol to receive an sscontrol command prompt. To end the command-line interface issue the exit or quit commands.

Scripts

You can enter commands for configuring Site Selector into a configuration script file and run them together. See Sample Load Balancer configuration files. To quickly run the content of a script file (for example, myscript), use one of the following commands:
  • To update the current configuration, run the following executable commands from your script file:
    sscontrol file appendload myscript
  • To completely replace the current configuration, run the following executable commands from your script file:
    sscontrol file newload myscript
To save the current configuration into a script file (for example, savescript), run the following command:
sscontrol file save savescript

This command saves the configuration script file in the install_root/servers/configurations/ss directory.

GUI

Start the GUI, as follows:
  1. Ensure ssserver is running:
    • [AIX][HP-UX][Linux][Solaris]Run the following command as root user:
      ssserver
    • [Windows]ssserver runs as a service that starts automatically.
  2. Start the Site Selector GUI:
    • [AIX][HP-UX][Linux][Solaris]Run the following command:
      lbadmin
    • [Windows]Click Start > Programs > IBM WebSphere > Edge Components > IBM Load Balancer > Load Balancer

To configure the Site Selector component from the GUI, you must first select Site Selector in the tree structure. You can start the executor and manager after you connect to a Host. You can also create clusters that contain ports and servers, and start advisors for the manager.

You can use the GUI to do anything that you would do with the sscontrol command. For example, to define a cluster by using the command line, you would enter dscontrol cluster add cluster command. To define a cluster from the GUI, right-click Executor, then in the menu, left-click Add Cluster. Enter the cluster address in the window, then click OK.

You can load pre-existing Site Selector configuration files by using the Load New Configuration (for completely replacing the current configuration) and Append to Current Configuration (for updating the current configuration) options that are presented in the Host menu. Save your Site Selector configuration to a file periodically by using the Save Configuration File As option that is also presented in the Host menu. The File menu that is at the top of the GUI enables you to save your current host connections to a file or restore connections in existing files across all Load Balancer components.

Run a command from the GUI, as follows:
  1. Highlight the host node from the GUI tree and select Send command... from the host menu.
  2. In the command entry field, enter the command that you want to run, for example:
    executor report
    The results and history of the commands run in the current session and display in the window provided.
You can access help by clicking the question mark icon in the upper right corner of the Load Balancer window.
  • Help: Field level describes each field, default values
  • Help: How do I lists tasks that can be done from that screen
  • InfoCenter provides centralized access to product information

The configuration wizard

The wizard guides you step by step through the process of creating a basic configuration for the Site Selector component. You are asked questions about your network and you are guided through the setup of a cluster for Site Selector to load balance traffic between a group of servers.

If you are using the configuration wizard, follow these steps:
  1. Start the ssserver on Site Selector:
    • [AIX][HP-UX][Linux][Solaris]Run the following command as root user:
      ssserver
    • [Windows]ssserver runs as a service that starts automatically.
  2. Start the wizard function of Site Selector by issuing the following command:
    sswizard

Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: March 23, 2018 0:18
File name: ccfg_configmethss.html