# Getting started

> Overview of the OneFuse XUI for CloudBolt CMP

---

Site [llms.txt](/llms.txt)

---

Easily integrate CloudBolt OneFuse with CloudBolt CMP to quickly automate and integrate into your business provisioning lifecycle of a CloudBolt Blueprint.

The CloudBolt OneFuse integration platform offers integrations to services like Naming, IPAM, DNS, Microsoft Active Directory, Scripting, Ansible Tower and more.

[Upstream providers](/docs/onefuse/consume/what-is-upstream-provider/) like VMware Aria Automation, Terraform, CloudBolt CMP, Ansible, ServiceNow and others are able to consume the same OneFuse integrations combined with organizational business logic for a standardized approach to automation across the enterprise.

## Prerequisites

1. [Learn](/docs/cmp/about/) about CloudBolt CMP.
1. [Deploy CloudBolt CMP](/docs/cmp/get-started/) and [follow Guided Setup](/docs/cmp/get-started/complete-initial-setup/) for the CloudBolt instance.
   - **Supported CloudBolt CMP versions**: [Releases](/docs/cmp/about/releases/)
1. Install and Setup OneFuse XUI

## Installation & setup

### Install OneFuse XUI

OneFuse XUI for CloudBolt CMP is distributed as a **UI Extension** in CloudBolt's [Content Library](/docs/cmp/use/catalog/content-library/).

1. **Log in** to CloudBolt
1. Select **Library** from the main menu
   - Optionally, select **UI Extensions** from the dropdown menu
1. **Find OneFuse Integration** using the searchbar and/or selecting the **UI Extensions** tab
1. **Click on OneFuse Integration** to get redirected to the OneFuse Integration UI Extension package page
1. **Click on the** [**Download**] button
1. Review the information and select the [**Import**] button
1. You will be redirected to the **Admin / Extensions Management** page
   - A successful message on the top-right will appear: The UI extension package has been created.
1. The OneFuse XUI package should be located at: `/var/opt/cloudbolt/proserv/xui/onefuse`
1. **Restart CloudBolt Web Services.**

   ```bash
   systemctl restart httpd
   ```

1. If the OneFuse XUI is not behaving as expected, or you see a **_'ModuleNotFoundError: No module named 'setuptools.command.build'_** error, run the following commands:

   ```bash
   pip install --upgrade setuptools
   pip install onefuse
   systemctl restart httpd
   ```

### Initial setup

Create a Connection Info per OneFuse Instance and run the Configure OneFuse configuration script.

1. Log on to CloudBolt, select **Admin** from the main menu.
1. Find and select **OneFuse Integration** under **Admin Extensions**.
1. **Create a Connection Info** per OneFuse Instance.
1. Fill in only the fields listed below. Leave all other fields of the Connection Field dialog as default.
   - The Connection Info needs to have `OneFuse` as a **Label**.

   | Field Name | Value |
   | --- | --- |
   | Name | Connection Info Name for this OneFuse Instance. |
   | IP/Hostname | OneFuse Instance in FQDN or IP Address format. |
   | Port | Specify the port for the OneFuse Instance (for example, `443`). |
   | Protocol | Specify a protocol: `https`, `http`, or a non-standard protocol. |
   | Username | OneFuse username that has at least the [Workspace Member role](/docs/onefuse/getting-started/roles-and-permissions/#workspace-roles). |
   | Password | Password for the OneFuse user. |
   | Labels | Type in (or select) `OneFuse` into this field. |

   - The Connection Info for OneFuse will be used to make API calls and execute OneFuse Modules.

1. Select the [**Configure OneFuse**] button under **OneFuse XUI Documentation**, **4. Execute the Configuration script**
   1. Select [**Setup**] button to confirm OneFuse Setup.
   1. A link to a Job **OneFuse CloudBolt Plugin Configuration** will appear on the top-right corner.
   1. Verify successful configuration setup by selecting the Job link.

   <div class="alert alert-info" role="alert">


   The configuration script will create CloudBolt [Actions](/docs/cmp/use/orchestration/actions/) (CloudBolt Plugin and Orchestration) necessary for each OneFuse Module.
   </div>


## Resources

- Visit our **GitHub Repo**: [onefuse-examples](https://github.com/CloudBoltSoftware/onefuse-examples).

## Troubleshooting

Refer to CloudBolt CMP Troubleshooting Resources:

- [Help us help you](/docs/cmp/support/help-us-help-you/)
- [Troubleshooting](/docs/cmp/support/troubleshooting/)
  - Contact our Customer Success team at [support.cloudbolt.io](https://support.cloudbolt.io)

## Next steps

Start integrating with [OneFuse Modules](/docs/onefuse/consume/onefuse-xui/modules/).