|
|
This chapter describes how to get started with the LocalDirector User Interface. It includes the following sections:
On Windows NT systems, the LocalDirector User Interface server is a system service, controlled through the Services Control Panel. If you completed the installation correctly, the LocalDirector User Interface server is configured to run at system startup. The server should already be running at the end of the installation. The IP address of the LocalDirector User Interface server is the host system where it is installed, and it uses port number 4800.
Follow this procedure to check the LocalDirector User Interface server service status:
Step 1 Under the Start menu, go to the Settings submenu and select Control Panel. The Control Panel displays.
Step 2 Select the Services item from the list in the Control Panel. The Services Control Panel displays.
Step 3 Scroll through the services in the Services Control Panel and locate the LocalDirector User Interface server service.
Check the status of the LocalDirector User Interface server service. If the component was configured to start automatically, then information in the Services Control Panel reflects that it is already running.
Step 4 If the server is not running, then as the administrator select the service and click Start. After a moment, the operating system indicates whether the service started successfully.
Once the LocalDirector User Interface server service is started, it waits for connection requests from the LocalDirector User Interface clients.
After the LocalDirector User Interface server is installed, it runs as a UNIX process. In UNIX, you start the LocalDirector User Interface server at the command line, although you can also enter it into a startup file such as /etc/rc.local.
The UNIX LocalDirector User Interface server command line invocation is:
gwserver [-v] [-h host address] [-p port] [-w] [-t tftp_server[:tftp_port]]![]() | Caution On UNIX systems, there may already be a TFTP server running on port 69. Use the -t option to change the TFTP server port number to one other than 69. |
On UNIX systems, start the LocalDirector User Interface server at the command line. Enter the following command on the host system of the LocalDirector User Interface server to start the LocalDirector User Interface server:
gwserver
To enable the LocalDirector User Interface to be accessed through the localhost interface, start the LocalDirector User Interface server as follows:
gwserver -h localhost
This command starts a LocalDirector User Interface server process on the local host system. The LocalDirector User Interface server listens for clients at port 4800 and has no password configured. To prompt for a password to be specified, you can enter the following command:
gwserver -w
The LocalDirector User Interface server then prompts you for the login password and confirmation:
Please enter the new server password: Please confirm the new server password:
The LocalDirector User Interface stores the password on disk. Subsequent invocations of the gwserver command do not require the -w flag.
User interaction with the LocalDirector User Interface server is controlled through the LocalDirector User Interface client. Before you start, you should have available the IP address of the LocalDirector User Interface server host and the port where the LocalDirector User Interface server is listening (by default, 4800).
Follow this procedure to access the LocalDirector User Interface server using a standard browser:
Step 1 On the LocalDirector User Interface client, start the browser and at the URL line, enter the address:
http://host_name_or_IP_address:port/LUI31.html
or
http://host_name_or_IP_address:port
or
http://host_name_or_IP_address:port/
or, if you start the LocalDirector User Interface server for localhost access:
Alternatively, on the LocalDirector User Interface server, if your server is a Windows server, click the Start button, go to Programs, then go to LocalDirector 3.1, and select LocalDirector User Interface 3.1.
Step 2 At the login window (illustrated in Figure 3-1), enter the password, if any, that you specified when starting the LocalDirector User Interface server.

Step 3 Click the Login button. The LocalDirector User Interface server checks whether any LocalDirector configurations exist from a previous version of the LocalDirector User Interface server. If a LocalDirector configuration is detected, the main LocalDirector User Interface window displays (see Figure 3-2).

Now that you have successfully logged in to the LocalDirector User Interface, you can perform one of the following tasks:
You can connect to LocalDirector by using either a serial cable (see "Setting Up a Connection") or with a Telnet connection (see "Using a Telnet Connection to LocalDirector").
Follow this procedure to establish a connection with a new LocalDirector in your network or to access an existing LocalDirector connection. (Establishing a connection with LocalDirector opens a new configuration for that LocalDirector.) While establishing a serial connection, you can also establish a Telnet connection. Once you establish a Telnet connection to LocalDirector, you can reuse the Telnet configuration to connect to that LocalDirector. See "Using a Telnet Connection to LocalDirector" later in this chapter for more information.
Step 1 If you want to add a new LocalDirector or access an existing LocalDirector not currently known to the LocalDirector User Interface, select Add LocalDirector from the toolbar to bring up the Connection Wizard. The wizard guides you through the steps to establish a connection to a new LocalDirector.

Step 2 Enter or select the required information in the top two areas (the information requested in the third area changes based on your answers):
(a) Type a name to be associated with the LocalDirector in the Name text field.
(b) Select Serial from the Type drop-down menu to indicate the connection with LocalDirector is through a serial cable.
(c) In the Connection Parameters area, use the radio button to determine how the port is selected.
Click Next when you have finished.
If the LocalDirector User Interface server detects LocalDirector on the specified port, the following window displays (see Figure 3-4).

Step 3 Enter the password and the appropriate connection information in the above window:
(a) Enter the LocalDirector administrator password (or leave it blank if there is no password).
(b) Leave checked or uncheck the use Auto Configuration box. Enabling autoconfiguration loads the current LocalDirector configuration into the LocalDirector User Interface and creates a configuration for the LocalDirector with the same name as the LocalDirector. Disabling autoconfiguration requires you to open a configuration later with the File menu Open option.
If you add a LocalDirector that has the same name as an existing configuration, the LocalDirector User Interface automatically appends the string "(1)" to the end of the new LocalDirector configuration name.
(c) Click the checkbox to indicate if you would also like to configure a Telnet connection for this LocalDirector system. The bottom of the window changes to provide a Next button so you can continue.
Step 4 If you do not want to set up a Telnet connection, click Finish and return to the main window. The new LocalDirector entry displays in the LocalDirector area. You can now start adding server farms to this LocalDirector entry as described in the chapter "Configuring Server Farms."
If you want to set up a Telnet connection, click Next and the window in Figure 3-5 displays.

Step 5 Supply the following information in the top area, as requested:
(a) In the Host text field, type the IP address of the LocalDirector.
(b) In the Password text field, enter a new LocalDirector Telnet password.
(c) In the Active Connection area, specify whether you would like the default connection to be serial or Telnet. (Note that the default value here is Telnet.)
(d) Click Finish to return to the main LocalDirector User Interface window. The new LocalDirector entry displays in the LocalDirector area. You can now begin adding server farms as described in the chapter "Configuring Server Farms" later in this guide.
Once a Telnet connection has been set up, follow this procedure to connect to LocalDirector using the LocalDirector User Interface:
Step 1 Select Add LocalDirector from the toolbar to bring up the Connection Wizard.
Step 2 Provide the required information in the top two areas (the information requested in the third area changes based on your answers). (See Figure 3-6.)
(a) Type a name to be associated with LocalDirector in the Name field.
(b) Select Telnet from the Type drop-down menu to indicate the connection with LocalDirector is through a Telnet session.

Step 3 In the Connection Parameters area, provide the following information:
(a) Enter the IP address of the LocalDirector in the Host text field.
(b) Enter a predefined password, specified when the LocalDirector was first configured for Telnet connections.
(c) Click Next.
Step 4 Enter your LocalDirector administration password, or leave it blank if there is no password (see Figure 3-7).

Step 5 Leave checked or uncheck the Use Auto Configuration box. Enabling autoconfiguration loads the current LocalDirector configuration into the LocalDirector User Interface and creates a configuration for the LocalDirector with the same name as the LocalDirector. Disabling autoconfiguration requires you to open a configuration later with the File menu Open option.
If you add a LocalDirector that has the same name as an existing configuration, the LocalDirector User Interface automatically appends the string "(1)" to the end of the LocalDirector configuration name.
![]() | Caution If you are adding a LocalDirector that is configured for failover standby mode, disable the Auto Configuration option (uncheck the box). Using the Auto Configuration option may corrupt the failover configuration on the standby LocalDirector. |
Step 6 Click Finish (see Figure 3-7). An entry for the new LocalDirector configuration displays in the LocalDirector View on the left side of the main LocalDirector User Interface window.
From here, you can configure LocalDirector server farms. See the chapter "Configuring Server Farms." If you want to change the default configuration settings for the LocalDirector User Interface or LocalDirector, continue with the following sections.
Using the LocalDirector User Interface, you can set up the basic LocalDirector configuration information. Basic LocalDirector configuration involves defining the parameters required to bring up the LocalDirector and add it to the network. In particular, some of the decisions you might want to make before performing the basic LocalDirector configuration include:
During basic LocalDirector configuration, you will use the tabs in the LocalDirector Properties window (see Figure 3-8) to set up basic properties. These properties are fully described in the Cisco LocalDirector Installation and Configuration Guide.
The tabs in the LocalDirector Properties window are:

The LocalDirector User Interface does not support the following LocalDirector commands (although you can enter them through the Additional tab of the LocalDirector Properties window):
Follow this procedure to define the basic configuration of a new LocalDirector:
Step 1 Right-click on the desired LocalDirector entry in the LocalDirector view area.
A drop-down menu displays (see Figure 3-9).

Step 2 Select Properties to display the basic LocalDirector configurable properties (see Figure 3-10).
Step 3 Select the tab representing the configuration property you want to edit.
The window for changing the relevant information displays. The configuration of many of these properties is self-evident, with the exception of the TFTP tab, which is described in the following section, "Accessing and Booting from TFTP Servers."
Step 4 When you are finished editing properties, click OK.
Follow this procedure to set up a LocalDirector to communicate with a TFTP server. You need to set up a LocalDirector with TFTP information if you want to boot the LocalDirector from a TFTP server (refer to the Cisco LocalDirector Installation and Configuration Guide).
Step 1 At the LocalDirector Properties window, select the TFTP tab (see Figure 3-11). The TFTP server capability is enabled by default.

Step 2 Continue to the Boot Configuration area to configure LocalDirector to boot from a configuration obtained from the TFTP server you have just enabled. If you do not want to configure LocalDirector to boot from the TFTP server configuration, click OK.
Step 3 In the Boot Configuration area, click the Enable Boot from Configuration box. This action allows you to boot from a TFTP server configuration, as illustrated in Figure 3-12.

Step 4 Click OK.
The directions in this section assume that you have enabled the LocalDirector User Interface as a TFTP server and that you have configured LocalDirector to use the LocalDirector User Interface as a TFTP server (refer to the Cisco LocalDirector Installation and Configuration Guide).
configure net /Config/LocalDirector name
If LocalDirector is attached to a configuration, this command generates a full configuration with primary and server farm configurations. If the LocalDirector has no configuration attached to it, entering the configure net command as specified in the previous example causes the LocalDirector User Interface to send only the primary configuration to LocalDirector.
If LocalDirector does not have a configuration attached to it, entering the configure net command with a configuration name:
configure net /Config/Configuration name
saves the LocalDirector User Interface Configuration name to the LocalDirector as a secondary configuration. If the LocalDirector and the configuration have the same name, the result of this command is the same as if you had entered the configure net /Config/LocalDirector name command, described in the section "Saving Full and Primary Configurations" earlier in this chapter.
![]() | Caution If LocalDirector is attached to LocalDirector User Interface and you enter the configure net command to load a different configuration, the LocalDirector User Interface may not be aware of this change and assume that the old configuration is still in place. Be careful when entering the configure net command while LocalDirector is attached. |
To save a LocalDirector configuration to a LocalDirector User Interface configured as a TFTP server, connect to the LocalDirector and enter the following command at the LocalDirector prompt:
write net /configuration name
This command assumes a LocalDirector TFTP directory of "/" (set with the LocalDirector tftp-server command), and writes a copy of the configuration attached to LocalDirector to LocalDirector User Interface base directory/tftpfiles/configuration name for UNIX systems (LocalDirector User Interface base directory\tftpfiles\configuration name for Windows systems).
Alternatively, to save the configuration file attached to LocalDirector to a directory under the LocalDirector User Interface tftpfiles directory, follow this procedure:
Step 1 Create in the LocalDirector User Interface base directory, as necessary, the tftpfiles directory and directory name under it.
Step 2 Connect to the LocalDirector.
Step 3 At the LocalDirector prompt, enter a command like the following:
write net directory name/configuration name
The resulting configuration file appears in directory name (for example, LocalDirector User Interface base directory\tftpfiles\directory name\configuration name).
As a TFTP server, LocalDirector User Interface starts a search for the TFTP configuration information to send to its TFTP client based on the TFTP configuration filename:
You can change any of the LocalDirector User Interface general server properties, such as TFTP server properties and SNMP settings. To set up the LocalDirector User Interface for SNMP communications, refer to the chapter "Working with Messages" later in this guide.
Follow this procedure to change the LocalDirector User Interface general server properties:
Step 1 Select the File menu Server Properties option from the main LocalDirector User Interface window. The Server Properties window displays (see Figure 3-13).

Step 2 At the General tab, change the default values of following fields, as desired:

Step 3 Click OK on the Server Properties window to save server property changes.
The LocalDirector User Interface main window consists of a menu bar, toolbar, and five display areas (see Figure 3-15).
The menu bar contains four menu options: File, Edit, Add, and Help.
Beneath the menu bar is a toolbar with icons that are shortcuts for some of the menu options. Many of these shortcuts, such as Add Probe, Add Virtual Server, Add Real Server, and Add LocalDirector, are available in the Add menu. Others, such as Cut or Copy, are available in the Edit menu.

From the File menu you can:
From the Edit menu you can:
From the Add menu you can add the following objects:
From the Help menu you can access:
The Online Edit option allows you to configure LocalDirector in Online or Offline mode. In Online mode, the edits you make at the LocalDirector User Interface client are communicated immediately to the LocalDirector User Interface server and to LocalDirector, if it is connected. In Offline mode, edits are known only to the LocalDirector User Interface client. If you browse from or exit the LocalDirector User Interface while in Offline mode, the LocalDirector User Interface prompts you to save changes you made while in Offline mode.
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Wed Sep 22 20:43:51 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.