6.5.4 Set Up Domain Nodes

Adding nodes to a Reflection X Advantage domain is optional. Typically, nodes are added in order to support either or both of the following:

Run sessions on a node at or near a remote X client host to improve performance over a slow network.
Run sessions on multiple nodes to provide load balancing where Remote Session Services are required by many users.

To add a node to a Reflection X Advantage domain, you'll install the Reflection X Advantage service on the computer you want to add as a node, then use the rxsconfig utility to add this computer to the Reflection X Advantage domain. You can create a node on any supported platform.

Before you begin

Set Up the Domain Controller.
Know the name of the computer running the domain controller (this is the domain name for your Reflection X Advantage domain), and the user name and password of the Reflection X Advantage domain administrator.
Have administrator (or root) credentials for the computer you want to add as a node.

To set up a domain node

Log onto the computer you want to designate as a node using an administrator (or root) account.
Run the Reflection X Advantage installer and select the feature called Domain Services (without including the Domain Controller feature). If you are running on Windows, also confirm that Java Runtime Environment (JRE) is selected. (For information about downloading and launching the installer, see Install Reflection X Advantage on Windows or Install on Linux.)
Open a Command Prompt window (Windows) or terminal window (Linux).

NOTE:For newer Windows systems (starting with Windows Vista and Windows Server 2008), you need to open the command window as an administrator. (In the Start menu, under Accessories, right-click Command Promptand select Run As Administrator).
Run the following command, where "domainname" is the name of the computer running the domain controller.
```
rxsconfig join domainname
```
Note: On Linux systems, include full path information for rxsconfig. The default install location is shown in this example:
```
/opt/rxadvantage/rxsconfig join domainname
```
You'll be prompted for Administrator credentials. Enter the user name and password of the Reflection X Advantage domain administrator. You'll see a message saying that node was successfully created. In this example, the node uses the default port, 22001.
```
C:\>rxsconfig join domainname
Initializing crypto library...
Performing the join...
Administrative user for domain: joe
Password:
Created node 0.0.0.0:22001 for domain domainname.
```
On the computer on which you have installed the Reflection X Advantage Administrative Console, open the Console and log on using the domain administrator credentials. Click the Domain Composition side tab.

You should see the node you just created listed under Registered Nodes.
(Optional) Edit the Registration Details for this node.

NOTE:The Participate in domain setting is selected by default. This is required for domain participation. If you clear this setting, existing sessions can continue to run but new sessions won't be able to use this node.
(Optional) If you are adding multiple nodes, select a Load balancing scheme.

NOTE:You can configure the domain controller to act as a domain node. To do this, use the procedure above, omitting step 2.