fix

Signed-off-by: Abhishek Kumar <[email protected]>

Author: shwstppr

source/adminguide/extensions.rst

@@ -24,7 +24,7 @@ In the UI, extensions can be managed under *Extensions* menu.
    |extensions.png|
 
 Overview
---------
+~~~~~~~~
 
 An extension in CloudStack is defined as an external binary (written in any programming language) that implements specific actions CloudStack can invoke. This allows operators to manage resource lifecycle operations outside CloudStack, such as provisioning VMs in third-party systems or triggering external automation pipelines.
 
@@ -33,7 +33,7 @@ Extensions are managed through the API and UI, with support for configuration, r
    |create-extension.png|
 
 Configuration
--------------
+~~~~~~~~~~~~~
 
 Administrators can define and manage the following components of an extension:
 
@@ -44,14 +44,14 @@ Administrators can define and manage the following components of an extension:
    - Resource Mappings: Association between extensions and CloudStack resources such as clusters, etc.
 
 Entry Point
------------
+~~~~~~~~~~~
 
 The entry point for an extension can be any binary or executable script. If no explicit entry point is provided, CloudStack uses a default base Bash script. The state of the entry point is validated across all management servers. In the UI, the Entry Point State is displayed as Not Ready if the file is missing, inaccessible, or differs across management servers.
 
 All extension entry point files are stored under a directory named after the extension within `/usr/share/cloudstack-management/extensions`.
 
 Payload
--------
+~~~~~~~
 
 CloudStack sends structured JSON payloads to the extension binary during each operation. These payloads are written to .json files stored under `/var/lib/cloudstack/management/extensions`. The extension binary is expected to read the file and return an appropriate result. CloudStack automatically attempts to clean up payload files older than one day.
 

source/adminguide/extensions/custom_actions.rst

@@ -15,7 +15,7 @@
    
 
 Custom Actions
-~~~~~~~~~~~~~~
+--------------
 
 In addition to standard instance operations, extensions support custom actions. These can be configured via UI in the extension details view or the addCustomAction API. The extension entry-point must implement handlers for these action names and process any provided parameters.
 
@@ -44,7 +44,7 @@ A single parameter can have the following details:
    - **valueoptions**: Options for the value of the parameter. This is allowed only for NUMBER and STRING type.
 
 Running Custom Action
----------------------
+~~~~~~~~~~~~~~~~~~~~~
 
 All enabled custom actions can then be triggered for a resource of the type the action is defined for or provided while running, using the **Run Action** view or runCustomAction API.
 

source/adminguide/extensions/troubleshooting.rst

@@ -15,10 +15,10 @@
    
 
 Troubleshooting Extensions
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+--------------------------
 
 Validate the Extension Entry Point
-----------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
    - Ensure that the entry point path is correctly defined and accessible on all management servers.
 
@@ -35,7 +35,7 @@ Validate the Extension Entry Point
    - The check interval can be configured using the cloudstack.extensions.entrypoint.check.interval property in global.properties. The default is 5 minutes.
 
 Verify Payload Handling
------------------------
+~~~~~~~~~~~~~~~~~~~~~~~
 
    - Ensure the extension binary can correctly read and parse the incoming JSON payload.
 
@@ -46,7 +46,7 @@ Verify Payload Handling
    - Improper parsing of the payload is a common cause of failure—log any parsing errors in your extension binary for debugging.
 
 Refer to Base Extension Scripts
--------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
    - For guidance on implementing supported actions, refer to the base scripts present for each extension type.
 
@@ -55,7 +55,7 @@ Refer to Base Extension Scripts
    - These scripts provide examples of how to handle standard actions like start, stop, status, etc.
 
 Check Logs for Errors
----------------------
+~~~~~~~~~~~~~~~~~~~~~
 
    - If the extension does not respond or returns an error, check the management server logs.
 
@@ -68,4 +68,3 @@ Check Logs for Errors
         3. Output parsing
 
    - Any exceptions or exit code issues.
-