doc changes

Author: harikrishna-patnala

source/_static/images/CloudStack-shared-network.png

@@ -285,6 +285,18 @@ Existing `MAAS consumer` token can be used or a new API key can be generated by
 
 Note down the **key** value.
 
+Install required Python libraries
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The MAAS Orchestrator Extension uses OAuth1 for API authentication.
+
+Ensure the required Python libraries are installed on the CloudStack Management Server before using this extension.
+The following command is provided as an example, package installation steps may vary depending on the host operating system:
+
+.. code-block:: bash
+
+    pip3 install requests requests_oauthlib
+
 Adding MaaS to CloudStack
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -331,6 +343,70 @@ To set up the MaaS Extension, follow these steps in CloudStack:
 
    Operations **Start**, **Stop**, **Reboot**, and **Delete** can be performed on the Instance from CloudStack.
 
+Additional Notes and Tested Scenarios
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The MaaS scenarios have been tested and verified with a Shared Network setup in CloudStack, using the MAAS Orchestrator Extension.
+Please find some additional notes with respect to the networking and access related configuration as below,
+
+#. **Using CloudStack Virtual Router (VR) as an External DHCP Server**
+
+   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.
+
+   **In CloudStack**
+
+   1. Navigate to **Networks → Add Shared Network**.
+   2. Create a Shared Network using the **DefaultSharedNetworkOffering**, and define an appropriate **Guest IP range**.
+
+   |CloudStack-shared-network.png|
+
+   **In MAAS**
+
+   1. Navigate to **Networking → Subnets → Add Subnet** and create a subnet corresponding to the same IP range used in CloudStack.
+
+      |MaaS-add-subnet-1.png|
+      |MaaS-add-subnet-2.png|
+
+   2. Once the subnet is added:
+      - Ensure **Managed allocation** is **disabled**.
+      - Ensure **Active discovery** is **enabled**.
+
+      |MaaS-subnet-configuration.png|
+
+   3. Add a **Reserved IP range** that matches the CloudStack Guest range (optional, for clarity).
+
+      |MaaS-add-reserve-iprange.png|
+
+   4. Disable the DHCP service in MAAS:
+      - Navigate to **Subnets → VLAN → Edit VLAN**.
+      - Ensure the **DHCP service** is **disabled**.
+
+      |MaaS-disable-dhcp.png|
+
+   This configuration allows the CloudStack Virtual Router (VR) to provide IP address allocation and DHCP services for the baremetal instances managed through MAAS.
+
+#. **Using CloudStack-Generated SSH Keys for Baremetal Access**
+
+   If the user wants to use the **SSH key pair generated in CloudStack** to log into the baremetal server provisioned by MAAS, perform the following steps.
+
+   **In CloudStack**
+
+   1. Navigate to **Compute → SSH Keypairs → Create SSH Keypair**.
+   2. Save the generated **private key** for later use (CloudStack stores only the public key).
+
+   |Cloudstack-create-sshkeypair.png|
+
+   **In MAAS**
+
+   1. Navigate to **Admin → SSH Keys → Import**.
+   2. Paste the **public key** from the CloudStack-generated SSH key pair.
+   3. Save the changes.
+
+   |MaaS-add-sshkeypair.png|
+
+
+   After these steps, any baremetal node deployed via the MAAS Extension can be accessed using the **private key** from CloudStack.
+
 .. Images
 
 
@@ -351,3 +427,11 @@ To set up the MaaS Extension, follow these steps in CloudStack:
 .. |MaaS-add-host.png| image:: /_static/images/MaaS-add-host.png
 .. |MaaS-add-template.png| image:: /_static/images/MaaS-add-template.png
 .. |MaaS-deploy-instance.png| image:: /_static/images/MaaS-deploy-instance.png
+.. |CloudStack-shared-network.png| image:: /_static/images/CloudStack-shared-network.png
+.. |MaaS-add-subnet-1.png| image:: /_static/images/MaaS-add-subnet-1.png
+.. |MaaS-add-subnet-2.png| image:: /_static/images/MaaS-add-subnet-2.png
+.. |MaaS-subnet-configuration.png| image:: /_static/images/MaaS-subnet-configuration.png
+.. |MaaS-add-reserve-iprange.png| image:: /_static/images/MaaS-add-reserve-iprange.png
+.. |MaaS-disable-dhcp.png| image:: /_static/images/MaaS-disable-dhcp.png
+.. |Cloudstack-create-sshkeypair.png| image:: /_static/images/Cloudstack-create-sshkeypair.png
+.. |MaaS-add-sshkeypair.png| image:: /_static/images/MaaS-add-sshkeypair.png