Enhance Module by Blesta.Club - Installation Guide

This guide provides step-by-step instructions for installing the Enhance Module, allowing your clients to manage services through the Enhance API.

Prerequisites

1. Enhance access token: You will need an access token from your Enhance control panel.

Installation Steps

1. Get Your Enhance access token

1. Log in to your Enhance account.
2. Navigate to the /settings/access-tokens section.
3. Copy your access token, which will be needed during configuration.

2. Download the Module

1. Download the Enhance Module from Blesta Club.

3. Upload the Module to Blesta

1. Upload the module to your Blesta directory:

   /var/www/html/blesta/components/modules/enhance/

   4. Install the Module

2. Log into your Blesta admin account.

3. Navigate to Settings > Modules.

4. Find Enhance Module under the "Available" tab and click Install.

5. Configure the Module

1. After installation, navigate to Settings > Modules > Installed > Enhance > Manage.
2. Enter your Enhance access token.
3. Save the settings.

The Enhance Module is now installed and ready for use.

Contact Us

If you encounter any issues or have suggestions for improving the module, please get in touch with us. We are committed to providing robust updates and welcome customer feedback.

Enhance Module by Blesta.Club - Update Guide

To ensure you're always using the latest version of the Enhance Module, follow these steps to update the module in your Blesta installation.

Steps for Updating the Module

1. Download the Latest Version

• Visit the download section of my.blesta.club to obtain the latest version of the Enhance Module.

2. Upload the Updated Module

• Upload the updated files to your Blesta installation directory, replacing the existing files:

   /var/www/html/blesta/components/modules/enhance/

3. Update the Module in Blesta

• Log in to your Blesta admin account.
• Navigate to Settings > Modules.
• Locate the Enhance Module in the list and click the "Upgrade" or "Update" button if available.

4. Clear Cache

• Once the files are uploaded and the module is updated, clear the Blesta cache by navigating to Settings > System and selecting "Clear Cache."

Testing the Update

1. Test Mode:

   • Use a test service to verify that the module is functioning correctly after the update.

2. Service Management Testing:

   • Perform a test by managing a service to ensure the module is working as expected.

Troubleshooting Update Issues

1. Missing or Incorrect Files:

   • If you experience issues, ensure all files have been uploaded correctly and verify file permissions.

2. Access Token Issues:

   • If service management actions are failing, check that the correct Access Token is configured in the module settings.

3. Compatibility Issues:

   • Confirm that the updated version of the module is compatible with your current Blesta version. Check the changelog for any version-related notes.

Contact Us

If you encounter any issues during the update process or have suggestions for improving the module, please reach out to us. We are dedicated to providing robust updates and value customer feedback.

Enhance Module by Blesta.Club - Usage Guide

Welcome, and thank you for purchasing the Enhance Module! This guide will walk you through how to use the module to manage services via the Enhance API. If you're new to Blesta or encounter any issues, please don't hesitate to reach out for support.

Using the Enhance Module

Once installed and configured, the Enhance Module enables your clients to interact with their services through Blesta.

Setting Up the Enhance Module

Important Note:

Enhance automatically determines which server to provision, so you only need to add your master or main server to Blesta. All packages should be assigned to this server for provisioning.

Creating a Server:

1. Go to Server Settings:

   • Navigate to /admin/settings/company/modules/installed/ and click "Manage" on the "Enhance" module.

2. Add a New Server:

   • Click Add Server in the top right corner.

3. Fill Out Required Information:

   • Name: Choose a name for the server as it will appear in the admin panel (can be anything you prefer).
   • Hostname: Provide the full URL of your Enhance instance, including http(s)://. Example: https://web.mycompany.com.
   • Username (orgId): This is your organization ID. Refer to the "Quick Support" section below to find it. It is typically formatted like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
   • Access Hash: This is your Access Token. Refer to the "Quick Support" section below to learn how to find it. It is typically formatted like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

   Additional Notes

   1. Config options

      • The option name needs to be server_group_id and your values for each location can be found on the module tab of Blesta (/admin/packages/edit/XXX) your values will look similar to: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx and be listed below the Server Group ID's

   2. Subscription Only Mode

      • Located on the module tab of Blesta (/admin/packages/edit/XXX) You'll see a Subscription Only check box, this allows you to set a package which doesn't require a domain, The user can set all that up afterwards within Enhance!

Quick Support

Where to Find Your orgId and Access Token

1. Log In to Enhance:

   • Access your Enhance Panel with an admin account.

2. Find Your orgId:

   • Go to Settings > Access Tokens or navigate directly to /settings/access-tokens.
   • The orgId is located in the blue information box under "Access token usage" and is noted as "Org ID: {your_id}".

3. Create and Retrieve Access Token:

   • In the top right corner, click on Create Token.
   • Set an expiry date and choose the Super Admin role, then click on Create.
   • Copy the generated access token. This is your Access Hash in Blesta.

Troubleshooting Common Issues

1. API Connection Issues:
   • Ensure that the Enhance API key is correctly entered and that the account has sufficient permissions. Ensure both servers can communicate i.e no firewall!

Contact Us

If you encounter any issues or have suggestions for improving the module, please get in touch with us. We are committed to providing robust updates and welcome customer feedback.