Connecting the Controller to the Clients

To start a distributed processing simulation from a Controller GoldSim executable, start GoldSim, load the model file which you wish to run, and select Run | Run on Network… from the main menu.  The following dialog will be displayed:

Graphical user interface, text, application, email

Description automatically generated

   Note: The option to Run | Run on Network… is only available if multiple realizations have been specified.  That is, a distributed processing simulation cannot be carried out on a single realization.

The next step is to specify the names of the machines that will host the Client processes.

   Note: The list of computer addresses for Client processes is saved to the Registry when you close the DP Controller dialog, so that the addresses you used the last time you ran a distributed processing run will be available the next time the Run on Network dialog is opened.

   Note: You can assign up to 32 Clients to one computer. The DP clients use ports 5563 through 5594.

If multiple Client processes will be run on a single PC, the name of that PC should appear as many times as the desired number of Client processes. You can add machine names manually, or by importing a list of Clients that you have previously entered and saved.

To add Clients, press the Add client button:

A picture containing text, screenshot

Description automatically generated

This will display the following dialog:

Graphical user interface, application

Description automatically generated

You can use the Browse… button to find a computer on your network, or you can enter a network ID or IP address directly.  The Instances control allows ypu to create multiple instances of the same computer/address (in order to use multple processors on that machine).  This number must be between 1 and 32, inclusive.

   Note: If a Client Process is to be run on the local machine, you can simply type localhost for the computer name. If you are running multiple Clients on your computer (i.e., using multiple processors) you should specify localhost as the client (e.g., if you wanted to use two local processros, you would specify localhost as the Address and set Instances to 2).

When you add a Client (and specify the Instances) and press the OK button, the Client is added to the list.  In this example, two local processors have been specified:

Graphical user interface, text, application, email

Description automatically generated

After adding Clients you can ativate them by pressing the  Update clients button:

Graphical user interface, application

Description automatically generated

 The Controller then does the following:

1.  Finds the specified computers on the network;

2.  Checks to see if a GoldSim Client process is running and available on the computers.

GoldSim then reports the status of the Clients in the dialog:

Graphical user interface, text, application, email

Description automatically generated

   Note: Unless you have licensed the Distributed Processing Plus (DP Plus) module, you will be limited to using four Client processes at a time.  If you have listed more than four Client processes, when you press the Update clients button, GoldSim will only activate four,and the other Client processes will be inactive.

The dialog for Client processes indicates when a connection with a Controller has been made (and that it is waiting for a request):

Graphical user interface, text, application, email

Description automatically generated

You can subsequently remove Client process entries from the list in the Controller dialog by selecting an address and pressing the Remove client button:

A picture containing text, parking, screenshot, electronic

Description automatically generated

If necessary, existing addresses in the Client process list can also be edited directly.

Related Topics…

Learn more about: