# Canonical MAAS

MAAS from Canonical is an open-source server orchestration tool. It’s designed to allow administrators to build a datacenter from on-premises, bare-metal servers where large networks of individual units can be discovered, deployed, and reconfigured.

## Integrating MAAS and HPE Morpheus Enterprise

### About this task

Integrating MAAS with HPE Morpheus Enterprise is a simple process requiring the MAAS API URL and API Key. We’ll start by gathering what we need from the MAAS UI, then move back into HPE Morpheus Enterprise to store the required details.

We can gather the API key by clicking on the username in the upper-right corner of the MAAS UI window. From this preferences page, click on “API keys” as shown in the screenshot:

![../../../_images/1prefPage.png](https://support.hpe.com/hpesc/public/api/document/sd00007621en_us/GUID-2CE6F9DA-2A53-497D-B397-89CE446156D7-high.png)

From the API keys page, select the displayed key and copy it. Alternatively, you can click the copy button in the UI to add the full key to your clipboard. Store this key in an accessible location for a later step.

![../../../_images/2maasApi.png](https://support.hpe.com/hpesc/public/api/document/sd00007621en_us/GUID-C7F62A15-E82D-479B-9D76-2A83365CD918-high.png)

In addition to the API key, we need the MAAS API URL. As entered in HPE Morpheus Enterprise, the value will be like the following example: `http://<maas-hostname-or-ip>:5240`. We’ll enter the API URL into HPE Morpheus Enterprise duriong the next step.

In HPE Morpheus Enterprise, navigate to the list of integrated Clouds and start a new MAAS Cloud integration:

### Procedure

1. Infrastructure > Clouds
2. Click + ADD
3. Select “MAAS”
4. Click NEXT

### Results

On the “CREATE CLOUD” modal, you must at least give a friendly name for the Cloud in HPE Morpheus Enterprise, MAAS API URL and API KEY. An example is shown below:

![../../../_images/3createCloud.png](https://support.hpe.com/hpesc/public/api/document/sd00007621en_us/GUID-AA9E6041-8181-4D62-8EC4-516C7234E0FF-high.png)

TIP

You’ll know the credentials are entered correctly when your list of MAAS resource pools is synced in as you can see in the example screenshot.

Click NEXT and add this new Cloud to an existing Group or create a new Group for it. Once you advanced past the end of the wizard, the Cloud is added and HPE Morpheus Enterprise begins to inventory (if you’ve opted to inventory when adding the Cloud).

![../../../_images/4cloudDetail.png](https://support.hpe.com/hpesc/public/api/document/sd00007621en_us/GUID-598C2A66-38D0-4401-B1C5-14CF91A97474-high.png)
