# runai mpi exec

execute a command in a mpi training workload

```
runai mpi exec [WORKLOAD_NAME] [flags]
```

## Examples

```
# Execute bash in the workload's main worker
runai training mpi exec <workload-name> --tty --stdin -- /bin/bash 

# Execute ls command in the workload's main worker
runai training mpi exec <workload-name> -- ls

# Execute a command in a specific worker of the workload
runai training mpi exec <workload-name> --pod <pod-name> -- nvidia-smi
```

## Options

```
  -c, --container string               The name of the container within the pod.
  -h, --help                           help for exec
      --pod string                     The pod ID. If not specified, the first pod will be used.
      --pod-running-timeout duration   Timeout for pod to reach running state (e.g. 5s, 2m, 3h).
  -p, --project string                 Specify the project for the command to use. Defaults to the project set in the context, if any. Use 'runai project set <project>' to set the default.
  -i, --stdin                          Pass stdin to the container
  -t, --tty                            Stdin is a TTY
      --wait-timeout duration          Timeout while waiting for the workload to become ready for log streaming (e.g., 5s, 2m, 3h).
```

## Options inherited from parent commands

```
      --config-file string   config file name; can be set by environment variable RUNAI_CLI_CONFIG_FILE (default "config.json")
      --config-path string   config path; can be set by environment variable RUNAI_CLI_CONFIG_PATH
  -d, --debug                enable debug mode
  -q, --quiet                enable quiet mode, suppress all output except error messages
      --verbose              enable verbose mode
```

## SEE ALSO

* [runai mpi](https://run-ai-docs.nvidia.com/saas/reference/cli/runai/runai_mpi) - alias for mpi management