Main Content

Set Up Resources

Add Hosts

To specify the hosts you want listed in Admin Center, click Add or Find in the Welcome dialog box, or if this is not a new session, click Add or Find in the Hosts module.

In the Add or Find Hosts dialog box, identify the hosts you want to add to the listing, by one of the following methods:

  • Select Enter Hostnames and provide short host names, fully qualified domain names, or individual IP addresses for the hosts.

  • Select Enter IP Range and provide the range of IP addresses for your hosts.

If one of the hosts you have specified is running a MATLAB® Job Scheduler, Admin Center automatically finds and lists all the hosts running workers registered with that MATLAB Job Scheduler. Similarly, if you specify a host that is running a worker, Admin Center finds and lists the host running that worker’s MATLAB Job Scheduler, and then also all hosts running other workers under that MATLAB Job Scheduler.

Screen shows top panel of Admin Center with a list of hosts

Start mjs Service

A host must be running the mjs service if a MATLAB Job Scheduler or worker is to run on that host. Normally, you set this up with Admin Center or command-line scripts during the installation of MATLAB Parallel Server™ on your cluster, as described in the installation instructions available at Install and Configure MATLAB Parallel Server for MATLAB Job Scheduler and Network License Manager.

If you want to add or remove hosts to your cluster, Admin Center allows you to start and stop the mjs service on those hosts. To start the mjs service on a group of hosts with the same platform, select all those hosts in the Hosts module, and click Start MJS Service in the left column of the panel.

Alternative methods for starting mjs include selecting the pull-down Hosts > Start MJS Service, or right-clicking a listed host and selecting, Start MJS Service.

A dialog box leads you through the procedure of starting the mjs service on the selected hosts. There are five steps to the procedure in which you provide or confirm information for the service:

  1. Specify remote platform — Windows or UNIX. You can start mjs on multiple hosts at the same time, but they all must be the same platform. If you have a mixed platform cluster, run the mjs startup separately for each type of platform.

  2. Specify remote communication — Choose the protocol for communication with the hosts.

  3. Specify locations — Specify the location of the MATLAB installation and the mjs_def file for the hosts.

  4. Confirm before starting — Review information before proceeding.

  5. Summary — Status about the startup attempt.

The dialog box looks like this for the first step:

Steps for starting mjs service on a host

At each step, you can click Help to read detailed information about that step.

Start a MATLAB Job Scheduler

To start a MATLAB Job Scheduler, click Start in the MATLAB Job Scheduler module.

In the New MATLAB Job Scheduler dialog box, provide a name for the MATLAB Job Scheduler, and select a host to run it on.

Start new MATLAB Job scheduler

Alternative methods for starting a MATLAB Job Scheduler include selecting the pull-down Scheduler > Start, or right-clicking a listed host and selecting, Start Scheduler.

With a MATLAB Job Scheduler running on your cluster, Admin Center might look like the following figure, with the MATLAB Job Scheduler listed in the MATLAB Job Scheduler module, as well as being listed by name in the Hosts module in the line for the host on which it is running.

Screen shows top panel of Admin Center with a list of hosts

Start Workers

To start MATLAB workers, click Start in the Workers module.

In the Start Workers dialog box, specify the numbers of workers to start on each host, and select the hosts to run them. From the list, select the MATLAB Job Scheduler for these workers. Click OK to start the workers. Admin center automatically provides names for the workers, based on the hosts running them.

Start worker on hosts

Alternative methods for starting workers include selecting the pull-down Workers > Start, or right-clicking a listed host or MATLAB Job Scheduler and selecting Start Workers.

With workers running on your cluster, Admin Center might look like the following figure, which shows the workers listed in the Workers module. Also, the number of workers running under the MATLAB Job Scheduler is listed in the MATLAB Job Scheduler module, and the number of workers for each MATLAB Job Scheduler is listed in the Hosts module.

Screen shows top panel of Admin Center with a list of hosts, middle panel with an MJS job manager and bottom panel with a list of workers.

To get more information on any host, MATLAB Job Scheduler, or worker listed in Admin Center, right-click its name in the display and select Properties. Alternatively, you can find the Properties option under the Hosts, Scheduler, and Workers drop-down menus.

Stop, Destroy, Resume, Restart Processes

You can Stop or Destroy the mjs service, MATLAB Job Schedulers, and workers. The primary difference is that stopping a process shuts it down but retains its data; destroying a process shuts it down and clears its data. Use Start MJS Service to have mjs continue with existing data. Use Resume to have a MATLAB Job Scheduler or worker continue with its existing data. When you use Restart, a dialog box requires you to confirm your intention of starting a new process while keeping or discarding data.

Move a Worker

To move a worker from one host to another, you must completely shut it down, than start a new worker on the desired host:

  1. Right-click the worker in the Workers module list.

  2. Select Destroy. This shuts down the worker process and removes all its data.

  3. If the old worker host is not running any other MATLAB Parallel Server processes (mjs service, MATLAB Job Scheduler, or workers), you might want to remove it from the Admin Center listing.

  4. If necessary, add the new host to the Admin Center host listing.

  5. In the Workers module, click Start. Select the desired host in the Start Workers dialog box, along with the appropriate number and MATLAB Job Scheduler name.

Use a similar process to move a MATLAB Job Scheduler from one host to another. Note, however, that all workers registered with the MATLAB Job Scheduler must be destroyed and started again, registering them with the new instance of the MATLAB Job Scheduler.

Update the Display

Admin Center updates its data automatically at regular intervals. To set the update rate, select an option from the Update list. Click Update Now to immediately update the display data.

Related Topics