Configuring Remote EM Servers

The EM server is configured using the Em Server Settings pane of the Sonnet Administration dialog box. Select Admin > Setup > [Em Server Settings] to open this dialog box.

Starting the EM Server Process

From the Sonnet Session tab, Select Admin > Setup > [Em Server Settings].

Select Use this computer as an Em Server checkbox if it is not already checked.

Click the Start button.

If you receive a query from your firewall, asking if you wish to permit the EM server process to run, select yes.

See Firewall Settings.

After a few seconds, the EM server process should start. The status at the bottom of the window should indicate that the EM server process is running.

Click the OK button to close the Sonnet Administration dialog box.

This does not stop the EM server process; The program continues to run. If you ever wish to stop the EM server process, you may click the Stop button.

The Jobs Tab

By default, the Jobs tab will be selected. This tab allows you to monitor the status of jobs being run by the EM server. The list shows any jobs submitted to the EM server job queue. For more information about a particular job, select it in the list, then click on the Info button. To delete a job from the list, select it, then click the Delete button.

Performing maintenance

At some point you will want to perform maintenance on your EM server computer. This often involves shutting down or rebooting the computer. The following procedure is a recommended guideline:

In the Em Server Settings pane, check to see if there are any jobs running. If there are, press the Block button.

Pressing the Block button blocks the EM server from accepting new jobs from EM clients.

Once there are no jobs running, Press the Stop button and exit Sonnet.

Perform your maintenance.

Once you have completed your maintenance, return to the EM Server Settings pane and click the Start button.

Reboot and Logout Issues

By default, if you reboot your server, the EM server process will not restart automatically. This is a common scenario with Windows computers when automatic updates cause the computer to reboot. In addition, if you log out, the process could stop. Therefore, you may wish to have the EM server automatically start when your computer boots. The procedure for doing this is dependent on your operating system and is explained in the topic Running a Sonnet Program at Boot Up.

Advanced Settings

Click the Advanced tab in the Em Server Settings pane to access the advanced settings. The following describes each field in the Advanced settings tab:

Em Server Settings

The Em Server Settings section allows you to specify the hostname or IP address of the EM server. Normally, this is automatically filled in for you. It also allows you to specify a port number (default is 56150) and a comment. The end-user will see the server name and the comment when choosing an EM server from the client computer.

Data Folder

When the EM server is processing a job, it copies the submitted project file from the client to a temporary data directory. This data directory does not have to be on the server machine, but it is recommended that you use a local disk whenever possible for efficiency. Analysis data is returned to the client as it is produced, but a copy is maintained on the EM server in case the server and client become disconnected (either intentionally or unintentionally). Once the analysis is complete, the copy of the project is deleted from the EM server. The Data Folder section of the Em Server Settings pane allows you to specify the location of the temporary data directory on the EM server computer.

Log File Settings

The EM server process writes status messages to a log file. The log file contains time-stamped information such as starting time, jobs started, job completed, and stop time. This section allows you to specify the location of the log file. In addition, if New log file on startup is enabled, the log file is overwritten whenever the EM server process is started. Otherwise, the new information is appended to the end of the existing log file.

Firewall Settings

While setting up the EM server, you may need to set up your firewall to allow port 56150 (UDP and TCP incoming).

Configuring Multiple EM Servers

There are circumstances when you might want to run more than one Sonnet version of the EM server process on the EM server computer. A good example is when you are transitioning to a new version of Sonnet. To accomplish this, you must configure each version of the EM server process to use a different port from which to communicate to the client computer. See Em Server Settings for information on how to change the port number.

If you are managing multiple servers or have a large client base to set up, it may be useful to use an external file to define your EM servers. Please see Using an External File for details.

On your client computer, you will need to use the same port number you used for the EM server process.