Skip to content

Set Up Domain Nodes

Adding nodes to a Reflection X 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 domain, you'll install the Reflection X service on the computer you want to add as a node, then use the rxsconfig utility to add this computer to the Reflection X 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 domain), and the user name and password of the Reflection X domain administrator.

  • Have administrator (or root) credentials for the computer you want to add as a node.

To set up a domain node

  1. Log onto the computer you want to designate as a node using an administrator (or root) account.

  2. Run the Reflection X 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 on Windows or Install on Linux.)

  3. Open a Command Prompt window (Windows) or terminal window (Linux).


    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 Prompt and select Run As Administrator ).

  4. 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/microfocus/ReflectionX/rxsconfig join domainname

  5. You'll be prompted for Administrator credentials. Enter the user name and password of the Reflection X 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
     Created node for domain domainname.   
  6. On the computer on which you have installed the Reflection X 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.

  7. (Optional) Edit the Registration Details for this node.


    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.

  8. (Optional) If you are adding multiple nodes, select a Load balancing scheme.


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

More information

Back to top