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 account.

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."

5. Check Configuration

• After the update, review your Enhance Access Token to ensure it is correctly configured. Navigate to Settings > Modules > Enhance to verify the settings.

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.

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.

Admin View

1. Configuring the Enhance API:

   • Navigate to Settings > Modules > Enhance in the Blesta admin panel.
   • Enter your Enhance API Key (orgId and Access Token) to authenticate the module.

2. Managing Client Services:

   • Admins can configure which services are available to clients by managing the module’s settings in Blesta.
   • Ensure that the API credentials are correctly set up to enable service management.

Client View

• Service Management: Clients will have access to their services within Blesta, as configured by the admin.

Troubleshooting Common Issues

1. API Connection Issues:

   • Ensure that the Enhance API key is correctly entered and that the account has sufficient permissions.

2. Service Configuration:

   • Verify that the services are properly configured and aligned with what Enhance provides through the API.

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.