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.
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:
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.
Specify remote communication — Choose the protocol for communication with the hosts.
Specify locations — Specify the location of the MATLAB installation and the
mjs_def
file for the hosts.Confirm before starting — Review information before proceeding.
Summary — Status about the startup attempt.
The dialog box looks like this for the first step:
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.
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.
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.
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.
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:
Right-click the worker in the Workers module list.
Select Destroy. This shuts down the worker process and removes all its data.
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.
If necessary, add the new host to the Admin Center host listing.
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.