Running SUMO X11 Workspaces

Submitting a SUMO X11 Workspace

Example 1. Explicit resources
$ ssh bhn20 (1)
$ runai-bgu submit sumo \ (2)
  -n my-workspace \ (3)
  -c 2 \ (4)
  -m 4Gi \ (5)
1 Configure SSH connection to bhn20
2 Specifies it is a SUMO X11.
3 Specifies the name of the job.
4 Allocates 2 CPU cores.
5 Allocates 4GiB of memory*.

You can also use a predefined resource template. Check out the guide for the template CLI Introduction.

Example 2. Using User Templates:
$ runai-bgu submit sumo \ (1)
  -n my-workspace (2)
  --ut workspace-user (3)
1 Submit a sumo workload
2 Specify the job name
3 Use the --ut specify the user template
Example 3. Using Group Templates:
$ runai-bgu submit sumo \ (1)
  -n my-workspace (2)
  --ug workspace-group  (3)
1 Submit a sumo workload
2 Specify the job name
3 Use the --ug specify the group template

Wait for Job to Start

The CLI will display messages about the job creation and port-forwarding status.

Example 4. Synopsis
Start job for X11 application
$ ssh bhn20 (1)
$ runai-bgu submit sumo -n my-workspace --ut workspace (2)
Waiting for workload to appear...
Waiting for workload to run...
SSH workspace sumo is running. Setting up port forwarding to port <port-number>... (3)
$ (Run:AI interactive job:my-workspace) skittel@bhn20:~-> sumo-gui (4)
1 Configure SSH connection to bhn20 manual.adoc[runai-bgu]
2 The port number is displayed in the terminal output after the SSH connection is established. Need to be set in the .
3 Connects to the SUMO X11 workspace is established.
4 Run the command to open the SUMO X11.

Ending or Pausing Your Session

When you are done with your work or need to step away: When using workspaces the user has two choices when leaving the computer:

  1. Disconnect and delete the workspace: Use this method when the workspace is not necessary anymore and can be deleted.

    Example 5. Disconnect and delete workspace.

    In the terminal session where runai-bgu is running, type:

    $ stopall

    This will halt the port-forwarding and delete your workspace

  2. Background execution: Use this method when there is code running in the background/you are planning to return soon.

CPU jobs like sumo DO NOT have idle time and will be counted as the department consumption. Make sure to close jobs if they are not in use.

The user is solely responsible for starting and stopping jobs.
Example 6. Disconnect without deleting the job

In the terminal session where runai-bgu is running, type:

$ stop

This halts port-forwarding but keeps the job running.

Jobs in this state will be counted in you monthly bill.

Resuming your workspace

To resume your workspace, if the job is still running, re-do the steps from the submission command including the submission command.

If the job was stopped, you can resume it by running:

$ runai-bgu resume {job-name}

Then, re-do the steps from the submission command including the submission command.