Trainings¶
The Trainings interface provides a wizard to make submitting workloads easy.
Prerequisites¶
You must have:
- Workspaces enabled.
- At least one Project configured.
Note
See your system administrator to ensure the prerequisites are enabled and configured.
Adding Trainings¶
Note
Where there is a card gallery, use the search bar to find specific cards based on title or field values.
To add a training:
- Press Tranings in the menu.
- In the Projects pane, select the destination project. Use the search box to find projects that are not listed. If you can't find the project, you can create your own, or see your system administrator.
- In the Multi-node pane, choose
Single node
for a single node training, orMulti-node (distributed)
for distributed training. When you chooseMulti-node
, select a framework that is listed, then select themulti-node
training configuration by selecting eitherWorkers & master
orWorkers only
. - In the Templates pane, select a template from the list. Use the search box to find templates that are not listed. If you can't find the specific template you need, see Creating a new template, or see your system administrator.
- In the Training name pane, enter a name for the Training, then press continue.
-
Select an environment from the tiles. If your environment is not listed, use the Search environments box to find it or press New environment to create a new environment. Press to create an environment if needed. In the Set the connection for your tool(s), enter the URL of the tool if a custom URL has been enabled in the selected environment. Use the Private toggle to lock access to the tool to only the creator of the environment.
In the Runtime Settings:
- Press Commands and Arguments to add special commands and arguments to your environment selection.
- Press Environment variable to add an environment variable. Press again if you need more environment variables.
-
In the Compute resource pane:
- Select the number of workers for your training.
- Select Compute resources for your training or create a new compute resource. Use the search box to find resources that are not listed. Press More settings to use Node Affinity to limit the resources to a specific node.
Note
The number of compute resources for the workers is based on the number of workers selected.
-
(Optional) Open the Volume pane, and press Volume to add a volume to your training.
- Select the Storage class from the dropdown.
- Select the Access mode from the dropdown.
- Enter a claim size, and select the units.
- Select a Volume system, mode from the dropdown.
- Enter the Container path for volume target location.
- Select a *Volume persistency.
-
(Optional) In the Data sources pane, press add a new data source. For more information, see Creating a new data source When complete press, Create Data Source.
-
(Optional) In the General pane, add special settings for your training (optional):
- Press Auto-deletion to delete the training automatically when it either completes or fails. You can configure the timeframe in days, hours, minutes, and seconds. If the timeframe is set to 0, the training will be deleted immediately after it completes or fails.
- Press Annotation to a name and value to annotate the training. Repeat this step to add multiple annotations.
- Press Label to a name and value to label the training. Repeat this step to add multiple labels.
-
If you if selected
Workers & master
Press Continue toConfigure the master
and go to the next step. If not, then press Create training. -
If you do not want a different setup for the master, press Create training. If you would like to have a different setup for the master, toggle the switch to enable to enable a different setup.
- In the Environment pane select or create a new environment. Use the search box to find environments that are not listed. Press More settings to add an
Environment variable
or to edit the Command and Arguments field for the environment you selected. - In the Compute resource pane, select a Compute resources for your training or create a new compute resource. Use the search box to find resources that are not listed. Press More settings to use Node Affinity to limit the resources to a specific node.
-
(Optional) Open the Volume pane, and press Volume to add a volume to your training.
- Select the Storage class from the dropdown.
- Select the Access mode from the dropdown.
- Enter a claim size, and select the units.
- Select a Volume system, mode from the dropdown.
- Enter the Container path for volume target location.
- Select a *Volume persistency.
-
(Optional) In the Data sources pane, press add a new data source. For more information, see Creating a new data source When complete press, Create Data Source.
-
(Optional) In the General pane, add special settings for your training (optional):
- Press Auto-deletion to delete the training automatically when it either completes or fails. You can configure the timeframe in days, hours, minutes, and seconds. If the timeframe is set to 0, the training will be deleted immediately after it completes or fails.
- Press Annotation to a name and value to annotate the training. Repeat this step to add multiple annotations.
- Press Label to a name and value to label the training. Repeat this step to add multiple labels.
- In the Environment pane select or create a new environment. Use the search box to find environments that are not listed. Press More settings to add an
-
When your training configuration is complete. press Create training.
Managing Trainings¶
The Trainings list contains a list of training jobs that you have created or have access to.
To manage your trainings:
- Press Tranings in the left menu.
- Select a Training from the list.
- Choose from the following actions:
- Activate—activates the selected training job.
- Stop—stops the selected training job.
- Connect—connects to the training job's configured environment.
- Copy & edit—copies the details of the selected training job to a new training job.
- Delete—deletes the current training session.
- Show details—displays details about the training job.
Training details¶
Training details are displayed using the Show details action. The details available per training job include;
- Event history—a graph of the job's status over time along with a list of events found in the log.
-
Metrics—a graph of available metrics for the job. Use the drop down select a date and a time slice. Metrics include:
-
GPU utilization
- GPU memory usage
- CPU usage
-
CPU memory usage
-
Logs—a log file of the current status. Use the download button to save the logs.
To hide the training details, press Hide details.
Download Trainings Table¶
You can download the Trainings table to a CSV file. Downloading a CSV can provide a snapshot history of your Trainings over the course of time, and help with compliance tracking. All the columns that are selected (displayed) in the table will be downloaded to the file.
To download the Trainings table to a CSV: 1. Open Trainings. 2. From the Columns icon, select the columns you would like to have displayed in the table. 3. Click on the ellipsis labeled More, and download the CSV.