Servers Tab (Magic xpi 4.9)

The Servers window displays detailed information about the servers in your project. You can filter this information using the Host, Status, and License Feature drop-down lists.

If you right-click on an individual server line, and then select Server Details, you will see a summary of the server’s details in the upper part of the dashboard. In the lower part, all the workers used by that server are listed, along with more detailed information about them. This information includes worker IDs and the total number of messages handled by a worker, amongst others. You can navigate back to the main server display by clicking the link.

In addition to the standard Magic Monitor context menu options, you can right-click on an individual server line to perform various server management operations. These options are:

• Shutdown: Shuts down the current server. This option is available only when the selected server is currently running. When you shut down a server, all workers are sent messages to continue until the timeout or if no messages are available. Each worker that finishes the flow will terminate and will not take new work.

• Start: Instructs the server to start, using the Magic server entity (ServerData object) settings that were added early for this server. This option is available only when the selected server has stopped or failed, or when the server's status is START_FAILED.

• Clear Entry: Deletes the server entity (ServerData object) settings from the Magic Space. This option is available only when the selected server has stopped or failed.

• Run New Instance: Runs another instance of this Magic xpi server according to the data defined in the server entity. This is useful if you need to add more workers to the pool. By default, this dialog box displays data from the current server, the one you are parked on. This option is available regardless of the current server state.

• Add Server: Adds another server to your project.

• Refresh License: If you shut down a server where one or more of its workers are using a fixed license thread, or such a server is inaccessible, the rest of the servers' workers retain the FLOATING license type. In this situation, you need to instruct the workers to recapture new fixed license threads.
  
  For example, if you set the Reserved License Threads setting to 3, this means that three workers will now have a fixed license and will not return it. Those three workers will usually be in the same engine (probably the first engine that was started). If the engine goes down, other engines of the same project will not try to reserve their three workers unless the Refresh License option is clicked or unless a new engine is started.

When you select Run New Instance or Add Server, the New Server Instance dialog box opens for you to enter the following details for the new server:

• Server Host: Enter the server host name for the new server instance.

• Alternate Hosts: Enter a comma delimited list of alternate hosts or IPs.

• Projects Directory: Enter the required location for the newly created projects.

• Number of Instances: Enter the number of server instances that you want to create.

• Load Triggers: Select this check box to load a trigger when you create a new server.

• Load Schedulers: Select this check box to load a scheduler when you create a new server.

• Load Auto-start: Select this check box to invoke a flow when the newly created server starts.

• Number of Workers: Enter the number of workers that will operate under the new server.