Running STATA Trainings

Submitting a STATA Training Job

Example 1. Explicit resources
$ ssh bhn20 (1)
$ runai-bgu submit stata \ (2)
  -n conv-2-64 \ (3)
  -c 2 \ (4)
  -m 4Gi \ (5)
  -- "cd ~/path/to/file && stata-mp -b do file.do" (6)
1 Configure SSH connection to bhn20
2 Specifies it is a STATA.
3 Specifies the name of the job.
4 Allocates 2 CPU cores.
5 Allocates 4GiB of memory*.
6 The command to run, here cd ~/path/to/file && stata-mp -b do.
The space ( ) between the two dashes (--) and the command is intentional. As are the quotes (") surrounding the command.
For more information on running STATA in batch mode: https://www.stata.com/support/faqs/unix/batch-mode/

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 stata \ (1)
  -n conv-2-64 (2)
  --ut train-over-quota-user (3)
  -- "cd ~/path/to/file && stata-mp -b do file.do" (4)
1 Submit a stata workload
2 Specify the job name
3 Use the --ut specify the user template
4 The command to run, here cd ~/path/to/file && stata-mp -b do.
The space ( ) between the two dashes (--) and the command is intentional. As are the quotes (") surrounding the command.
For more information on running STATA in batch mode: https://www.stata.com/support/faqs/unix/batch-mode/
Example 3. Using Group Templates:
$ runai-bgu submit stata \ (1)
  -n conv-2-64 (2)
  --ug train-over-quota-group  (3)
  -- "cd ~/path/to/file && stata-mp -b do file.do" (4)
1 Submit a stata workload
2 Specify the job name
3 Use the --ug specify the group template
4 The command to run, here cd ~/path/to/file && stata-mp -b do file.do.
The space ( ) between the two dashes (--) and the command is intentional. As are the quotes (") surrounding the command.
For more information on running STATA in batch mode: https://www.stata.com/support/faqs/unix/batch-mode/

Submitting Job

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

Example 4. Synopsis
Start job for training
$ ssh bhn20 (1)
$ runai-bgu submit stata -n conv-2-64 --ut train-over-quota -- "cd ~/path/to/file && stata-mp -b do file.do" (2)
Waiting for the job to be created...

Job conv-2-64 submitted successfully.
You can check the status of the job by running:
        runai describe job conv-2-64 -p myproj
1 Configure SSH connection to bhn20 manual.adoc[runai-bgu]