Create a Tenancy with Command Line Tools#

Note

Tenants, tenancies, and other features are available if you have paid for multi-tenant support. Contact Penguin Computing to learn more.

Typically a tenancy is created automatically using a Terraform file. Penguin Computing Support may ask you to manually create a tenancy as part of troubleshooting. Tenants and tenancies are managed using the cw-clusterctl command line tool.

Prerequisite: Create a Tenant.

To create the tenancy and assign nodes:

Create the tenancy:
```
cw-clusterctl tenancies create name=<tenancy name>
```
Where <tenancy name> is a unique name used to identify the tenancy. Names must start with an alphabet character, not a number.
Identify available nodes to add to the tenancy:
```
cw-clusterctl tenancies -i Available ls -l
```
Assign nodes to the tenancy:
```
cw-clusterctl tenancies -i<tenancy name> assign <node list>
```
Where <node list> is a list of nodes that meet the owning tenant customer's requirements and are currently in the Available tenancy.
Assign the tenancy to the tenant:
```
cw-clusterctl tenants -i <tenant name> assign <tenancy name>
```
Where <tenant name> is the name of the owning tenant.

Example: Create Tenancy with Command Line Tools#

In this example, TenantA requested a tenancy with 10 compute nodes.

Create a tenancy:

cw-clusterctl tenancies create name=TenantA_Tenancy1

Identify available nodes to add to the tenancy:

[cw-admin]$ cw-clusterctl tenancies -i Available ls -l
Tenancies
  Available
    last_modified: 2025-09-10 17:14:15 UTC (0:56:36 ago)
    last_modified_by: admin
    last_modified_on: head9-rocky8
    name: Available
    nodes
      n[0-25,50-100]

Assign existing nodes to TenantA_Tenancy1:

cw-clusterctl tenancies -i TenantA_Tenancy1 assign n[0-9]

Assign TenantA_Tenancy1 to TenantA:

cw-clusterctl tenants -i TenantA assign TenantA_Tenancy1

TenantA now has TenantA_Tenancy1 assigned and 10 compute nodes available (n0-n9).