Creating a Director - trillium_quality - 17.2

You can create a Director process on any host you are monitoring. Consider creating redundant Directors to implement a failover strategy.

To create a Director

1. On the Realtime View tab, right-click the root node (My Director Network) and select Create a Director. The Create Director window opens.

   Figure 1. Create Director Form

2. Director Host: From the drop-down list, select the host on which the Director process will be created. Only hosts that have been identified through the Setup process, described in Setting Up Hosts, are listed.

3. Passphrase: For Linux hosts, enter the Passphrase.

4. Director Port: Enter a port number on which the Director will communicate with client applications. The Director requires two consecutive ports; ensure that the next consecutive port number, on which the Director will listen for broadcast messages, is also available. Both ports must be reserved for the Director’s exclusive use. No other applications should attempt to use these ports.

5. Service Name: Enter a service name. On Windows systems, this is the service name displayed in the registry. On Linux systems, this is the name of the script that will be generated.

6. Display Name: Enter a display name. On Windows systems, this is the name displayed in the Windows Services list. On Linux systems, this is a specific comment ID generated within the script.

7. Trace File: Enter or browse to select a location for the Director’s trace file and click Open. If you do not enter a trace file name, a trace file cannot be created.When choosing trace files over the network, the Director does not require drive mapping from the GUI client to the remote service’s platform. File system access and security is handled using a platform-neutral dialog that performs file location using shares (for Windows) and SSH-based listing of files (for Linux) for secure access to files.Refer to Using Trace Files for more information on trace files.

8. Log File: For Linux systems, enter or browse to select a location for the Director’s log file. This option is inactive for Windows systems; use the Windows Event Viewer to view messages.

9. Load Balancing: Select whether the Director should route requests to servers based on the number of requests currently being handled by each server (Current Load) or rotate requests among servers (Round Robin). The default is Current Load.

10. Click Create. The Director process is created and started. To update the list, click Refresh. The host/port combination is automatically added to the hostandport.ini file and will be listed in the Setup window.

    Note: If Director, cleanser, or matcher servers residing on a Windows machine will be accessed by remote clients, add the servers to the list of firewall exceptions. To add a firewall exception, use the Control Panel’s Windows Firewall option, and add TSQCleanser.exe, TSQMatcher.exe, and TSQDirector.exe to the Exception list. This will allow requests from remote machines to be handled by these services.

    Alternatively, you can add a port through the Windows Firewall. It is advisable to use the port number in the descriptive name to aid in identifying this port in the future.