Skip to content

Commit d670342

Browse files
Doc and image changes
1 parent 5f1054e commit d670342

File tree

4 files changed

+23
-12
lines changed

4 files changed

+23
-12
lines changed
22.7 KB
Loading
93.8 KB
Loading
92.8 KB
Loading

source/adminguide/extensions/inbuilt_extensions.rst

Lines changed: 23 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -364,6 +364,7 @@ To set up the MaaS Extension, follow these steps in CloudStack:
364364
#. **Deploy Instance**
365365

366366
Deploy an Instance using the Template created above. The Instance will be provisioned on a randomly selected MaaS machine.
367+
**maas_system_id** value can be provided in the external details to deploy the instance on specific server.
367368

368369
|MaaS-deploy-instance.png|
369370

@@ -377,40 +378,49 @@ Configuring Networking and additional details
377378
The MaaS scenarios have been tested and verified with a Shared Network setup in CloudStack, using the MAAS Orchestrator Extension.
378379
Please find some additional notes with respect to the networking and access related configuration as below,
379380

381+
#. **Configuring TFTP to point to MAAS**
382+
383+
Ensure that the TFTP or PXE boot configuration (for example, in pfSense or your network’s DHCP server) is set to point to the MAAS server as the TFTP source.
384+
This ensures that VMs retrieve boot images directly from MAAS during PXE boot.
385+
380386
#. **Using CloudStack Virtual Router (VR) as an External DHCP Server**
381387

382388
If the end user wants the **CloudStack Virtual Router (VR)** to act as the external DHCP server for instances provisioned through MAAS, the following configuration steps must be performed.
383389

384390
**In CloudStack**
385391

386-
1. Navigate to **Networks → Add Shared Network**.
387-
2. Create a Shared Network using the **DefaultSharedNetworkOffering**, and define an appropriate **Guest IP range**.
392+
a. Navigate to **Networks → Add Shared Network**.
393+
b. Create a Shared Network using the **DefaultSharedNetworkOffering**, and define an appropriate **Guest IP range**.
388394

389395
|CloudStack-shared-network.png|
390396

391397
**In MAAS**
392398

393-
1. Navigate to **Networking → Subnets → Add Subnet** and create a subnet corresponding to the same IP range used in CloudStack.
399+
a. Navigate to **Networking → Subnets → Add Subnet** and create a subnet corresponding to the same IP range used in CloudStack.
394400

395401
|MaaS-add-subnet-1.png|
396402
|MaaS-add-subnet-2.png|
397403

398-
2. Once the subnet is added:
404+
b. Once the subnet is added:
399405
- Ensure **Managed allocation** is **disabled**.
400406
- Ensure **Active discovery** is **enabled**.
401407

402408
|MaaS-subnet-configuration.png|
403409

404-
3. Add a **Reserved IP range** that matches the CloudStack Guest range (optional, for clarity).
410+
c. Add a **Reserved IP range** that matches the CloudStack Guest range (optional, for clarity).
405411

406412
|MaaS-add-reserve-iprange.png|
407413

408-
4. Disable the DHCP service in MAAS:
414+
d. Disable the DHCP service in MAAS:
409415
- Navigate to **Subnets → VLAN → Edit VLAN**.
410416
- Ensure the **DHCP service** is **disabled**.
411417

412418
|MaaS-disable-dhcp.png|
413419

420+
e. For all the servers in MAAS, navigate to each server in the Ready state, go to Network → Server Interface → Edit Physical, and set the IP mode to DHCP.
421+
422+
|MaaS-enable-dhcp-on-servers.png|
423+
414424
This configuration allows the CloudStack Virtual Router (VR) to provide IP address allocation and DHCP services for the baremetal instances managed through MAAS.
415425

416426
#. **Using CloudStack-Generated SSH Keys for Baremetal Access**
@@ -419,14 +429,14 @@ Please find some additional notes with respect to the networking and access rela
419429

420430
**In CloudStack**
421431

422-
1. Navigate to **Compute → SSH Keypairs → Create SSH Keypair**.
423-
2. Save the generated **private key** for later use (CloudStack stores only the public key).
432+
a. Navigate to **Compute → SSH Keypairs → Create SSH Keypair**.
433+
b. Save the generated **private key** for later use (CloudStack stores only the public key).
424434

425435
**In MAAS**
426436

427-
1. Navigate to **Admin → SSH Keys → Import**.
428-
2. Paste the **public key** from the CloudStack-generated SSH key pair.
429-
3. Save the changes.
437+
a. Navigate to **Admin → SSH Keys → Import**.
438+
b. Paste the **public key** from the CloudStack-generated SSH key pair.
439+
c. Save the changes.
430440

431441
|MaaS-add-sshkeypair.png|
432442

@@ -459,4 +469,5 @@ Please find some additional notes with respect to the networking and access rela
459469
.. |MaaS-subnet-configuration.png| image:: /_static/images/MaaS-subnet-configuration.png
460470
.. |MaaS-add-reserve-iprange.png| image:: /_static/images/MaaS-add-reserve-iprange.png
461471
.. |MaaS-disable-dhcp.png| image:: /_static/images/MaaS-disable-dhcp.png
462-
.. |MaaS-add-sshkeypair.png| image:: /_static/images/MaaS-add-sshkeypair.png
472+
.. |MaaS-add-sshkeypair.png| image:: /_static/images/MaaS-add-sshkeypair.png
473+
.. |MaaS-enable-dhcp-on-servers.png| image:: /_static/images/MaaS-enable-dhcp-on-servers.png

0 commit comments

Comments
 (0)