---
relatedlinks: "[Get started with LXD](https://documentation.ubuntu.com/lxd/en/latest/tutorial/first_steps/), [Get started with Juju](https://juju.is/docs/juju/tutorial), [Slurm website](https://slurm.schedmd.com/overview.html)"
---

(deploy-workload-manager)=
# How to deploy the workload manager

This how-to guide shows you how to deploy the workload manager of your Charmed HPC cluster.

```{note}
[Slurm](https://slurm.schedmd.com/overview.html) is currently the only supported
workload manager implementation for Charmed HPC.
```

## Prerequisites

To successfully deploy the workload manager of your Charmed HPC cluster, you
will at least need:

- A machine running a [currently supported Ubuntu LTS version](https://ubuntu.com/about/release-cycle).
- [An initialised LXD instance.](https://documentation.ubuntu.com/lxd/en/latest/howto/initialize/)
- The [Juju CLI client](https://juju.is/docs/juju/install-and-manage-the-client) installed on your machine.

## Initialise the machine cloud

To initialise the machine cloud that will provide the virtual machines for your cluster,
bootstrap a Juju controller on your LXD instance:

```shell
juju bootstrap localhost charmed-hpc-controller
```

## Create a model for the cluster

After initialising the machine cloud, create a model for your cluster:

```shell
juju add-model charmed-hpc
```

Now deploy the workload manager for your cluster!

## Deploy the workload manager

Slurm can be deployed in multiple ways using Juju.

```{important}
The instructions below pass `virt-type=virtual-machine` as a constraint to the Slurm charms
to instruct LXD to provide a virtual machine rather than a system container. Slurm does not
fully work within system containers unless some configuration modifications are applied to
the default LXD profile.
```

```````{tabs}

``````{group-tab} CLI

To deploy Slurm via the Juju CLI, use the following commands:

```shell
# Deploy Slurm services.
juju deploy slurmctld --constraints="virt-type=virtual-machine"
juju deploy slurmd --constraints="virt-type=virtual-machine"
juju deploy slurmdbd --constraints="virt-type=virtual-machine"
juju deploy slurmrestd --constraints="virt-type=virtual-machine"
juju deploy mysql --channel "8.0/stable"
juju deploy mysql-router slurmdbd-mysql-router --channel "dpe/beta"

# Integrate services together.
juju integrate slurmctld:slurmd slurmd:slurmctld
juju integrate slurmctld:slurmdbd slurmdbd:slurmctld
juju integrate slurmctld:slurmrestd slurmrestd:slurmctld
juju integrate slurmdbd-mysql-router:backend-database mysql:database
juju integrate slurmdbd:database slurmdbd-mysql-router:database
```

``````

``````{group-tab} Bundle

`````{tabs}

````{group-tab} Charmhub

To deploy Slurm via the Slurm bundle published on [Charmhub](https://charmhub.io/slurm),
use the following command:

```shell
juju deploy slurm
```

````

````{group-tab} bundle.yaml

To deploy Slurm via a Juju bundle file, first open a file named _bundle.yaml_ in
your favourite text editor, and enter the following YAML content:

```yaml
description: Deploy a ready-to-go Slurm cluster.
series: jammy
name: slurm
applications:
  slurmctld:
    charm: slurmctld
    constraints: virt-type=virtual-machine
  slurmd:
    charm: slurmd
    constraints: virt-type=virtual-machine
  slurmdbd:
    charm: slurmdbd
    constraints: virt-type=virtual-machine
  slurmrestd:
    charm: slurmrestd
    constraints: virt-type=virtual-machine
  mysql:
    charm: mysql
    channel: 8.0/stable
  slurmdbd-mysql-router:
    charm: mysql-router
    channel: dpe/beta
relations:
- - slurmctld:slurmd
  - slurmd:slurmctld
- - slurmctld:slurmdbd
  - slurmdbd:slurmctld
- - slurmctld:slurmrestd
  - slurmrestd:slurmctld
- - slurmdbd-mysql-router:backend-database
  - mysql:database
- - slurmdbd:database
  - slurmdbd-mysql-router:database
```

Save and close the file after entering the YAML content, and use the following
command to deploy Slurm using your custom _bundle.yaml_ file:

```shell
juju deploy ./bundle.yaml
```

````

`````

``````

```````