Difference between revisions of "SolusIO"

From WHMCS Documentation

(Activating SolusIO)
 
(4 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
Our SolusIO Integration is the '''official integration''' between WHMCS and the SolusIO Virtual Infrastructure Management Platform.
 
Our SolusIO Integration is the '''official integration''' between WHMCS and the SolusIO Virtual Infrastructure Management Platform.
  
This supports three methods of billing integration:
+
This supports '''Self-Service VM Provisioning with Post-Pay Billing''' as a billing mode. Post-Pay Billing allows customers to register for access to VM provisioning, manage virtual machines and provision on-demand via the SolusIO control panel, and have billing performed at set intervals by WHMCS in a post-pay (pay after use) model.
 
 
* '''Self-Service VM Provisioning with Post-Pay Billing''' - Available now - Allow customers to register for access to VM provisioning, manage virtual machines and provision on-demand via the SolusIO control panel, and have billing performed at set intervals by WHMCS in a post-pay (pay after use) model.
 
* '''Self-Service VM Provisioning with Pre-Pay Credits''' - Coming Soon! - Allow customers to register for access to VM provisioning, deposit funds in advance, and manage virtual machines and provision on-demand via the SolusIO control panel. Usage charges are assessed against the customers available balance in real-time.
 
* '''Retail VM Selling''' - Coming Soon! - Sell pre-configured VPS plans through your WHMCS online store. Offer traditional style VPS and virtual machines with a fixed monthly price, prepaid up front and billed on a regular fixed billing cycle. Customers will not need to use the SolusIO control panel.
 
 
 
For more information, see [[SolusIO FAQ]].
 
  
 
<table class="table" style="text-align:center;margin:1em 1em 1em 0;background:#F9F9F9;border:1px #AAA solid;border-collapse:collapse;width:100%;">
 
<table class="table" style="text-align:center;margin:1em 1em 1em 0;background:#F9F9F9;border:1px #AAA solid;border-collapse:collapse;width:100%;">
Line 36: Line 30:
 
# Download the latest version of the integration [https://marketplace.whmcs.com/product/5619-solusio-official-integration via the WHMCS Marketplace].
 
# Download the latest version of the integration [https://marketplace.whmcs.com/product/5619-solusio-official-integration via the WHMCS Marketplace].
 
# Extract the zip file.
 
# Extract the zip file.
# Upload the 'solusio' directory to the '/modules/addons' folder of your WHMCS installation.
+
# Upload the <tt>solusio</tt> directory to the <tt>/modules/addons</tt> folder of your WHMCS installation.
 
# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Addon Modules]]''' or, prior to WHMCS 8.0, '''Setup > Addon Modules'''.
 
# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Addon Modules]]''' or, prior to WHMCS 8.0, '''Setup > Addon Modules'''.
 
# Click '''Activate''' for '''SolusIO'''.
 
# Click '''Activate''' for '''SolusIO'''.
Line 49: Line 43:
 
===Connecting to SolusIO===
 
===Connecting to SolusIO===
  
Upon accessing the SolusIO module for the first time you will see a screen as follows.
+
To connect to SolusIO:
  
[[File:SolusIOConnect.png]]
+
# Access SolusIO. When you do this for the first time, you will see the following screen:[[File:SolusIOConnect.png]]
 
+
# Enter the URL to your SolusIO installation. This is the URL that you use to access the web interface.
Enter the URL to your SolusIO installation. This should be the url you use to access the web interface.
+
# Enter your API Key. You can find this at '''Account > API Tokens > Generate API Token''' in the SolusIO user area.
 
+
# Click '''Test Connection''' to verify that you can establish a connection with the SolusIO system.
Enter your API Key. This can be retrieved by navigating to ''Account > API Tokens > Generate API Token'' when logged into the SolusIO user area.
 
 
 
Click '''Test Connection''' to verify a connection can be established with the SolusIO system
 
 
 
Upon success, you will be redirected to management screen.
 
  
 
===Setup===
 
===Setup===
Line 65: Line 54:
 
====Post-Pay====
 
====Post-Pay====
  
Upon accessing the SolusIO module post connecting to SolusIO, you will be presented with the following screen which allows you to set settings related to Post-Pay billing.
+
When you access the SolusIO module after connecting to SolusIO, you can set your settings for Post-Pay billing.
  
 
[[File:SolusIOPostPaySetup.png]]
 
[[File:SolusIOPostPaySetup.png]]
Line 71: Line 60:
 
====Landing Page====
 
====Landing Page====
  
The WHMCS SolusIO Post-Pay functionality comes with a ready made landing page designed to make it quick and easy to get up and running with offering SolusIO servicesThe link is provided here for convenience.  This page can only be accessed when Post-Pay billing is enabled.
+
The WHMCS SolusIO Post-Pay functionality comes with a premade landing page.  You can only access this page after you have enabled Post-Pay billing.
  
 
[[File:SolusIOPostPayLandingPage.png]]
 
[[File:SolusIOPostPayLandingPage.png]]
  
Menu items are automatically added to the WHMCS client area when enabled. For logged out users, it can be accessed via a Cloud Hosting option in the main menu. For logged in users, it can be accessed via a Cloud Hosting menu option under the Website & Security dropdown menu.
+
This also automatically adds menu items to the Client Area if they are enabled.  
 +
 
 +
* Logged-out users can access this using the '''Cloud Hosting''' option in the main menu.  
 +
* Logged-in users can access this using the '''Cloud Hosting''' option in the '''Website & Security''' menu.
  
 
====Customising the Landing Page====
 
====Customising the Landing Page====
  
The landing page is controlled by templates and can be customized. To make changes, we recommend copying the file /modules/addons/solusio/templates/post-pay/landing-page.tpl into the active WHMCS client area template directory under the path /templates/{active_template}/modules/addons/solusio/post-pay/landing-page.tpl. All paths are relative to the WHMCS root installation directory. From there, you can make changes to the template within your WHMCS client area template directory and these customisations will be preserved during module updates.
+
Customizable templates control the landing page. To make changes, we recommend copying the <tt>/modules/addons/solusio/templates/post-pay/landing-page.tpl</tt> file into the active WHMCS Client Area template directory at <tt>/templates/{active_template}/modules/addons/solusio/post-pay/landing-page.tpl</tt>. Both of these paths are relative to the WHMCS root installation directory.  
 +
 
 +
After you copy the file, you can make changes to the template within your WHMCS Client Area template directory. The system will preserve these customizations during module updates.
  
 
====Configuration====
 
====Configuration====
Line 85: Line 79:
 
=====Post-Pay Limit Group=====
 
=====Post-Pay Limit Group=====
  
The limit group settings allow you to control settings related to limits imposed on new Post-Pay enabled users.
+
The Limit Group settings allow you to control settings for the limits on new Post-Pay enabled users.
  
 
<table class="table table-striped">
 
<table class="table table-striped">
 
<tr><th>Setting Name</th><th>Description</th></tr>
 
<tr><th>Setting Name</th><th>Description</th></tr>
<tr><td>New User Limit Group</td><td>Select the limit group you wish to be applied by default to all new Post-Pay users. (* Limit groups must be created and defined within the SolusIO control panel)</td></tr>
+
<tr><td>'''New User Limit Group'''</td><td>Select the limit group to apply by default to all new Post-Pay users. You must create and define limit groups within the SolusIO control panel.</td></tr>
 
</table>
 
</table>
  
 
=====Post-Pay General Settings=====
 
=====Post-Pay General Settings=====
  
The general settings allow you to control general settings.
+
The General Settings allow you to control basic SolusIO settings.
  
 
<table class="table table-striped">
 
<table class="table table-striped">
 
<tr><th>Setting Name</th><th>Description</th></tr>
 
<tr><th>Setting Name</th><th>Description</th></tr>
<tr><td>Post-Pay Terms & Conditions</td><td>An optional URL to Terms & Conditions for the Post-Pay Billing service for SolusIO. Use this to provide additional terms relating to the invoicing and payment of Post-Pay service usage.</td></tr>
+
<tr><td>'''Post-Pay Terms & Conditions'''</td><td>An optional URL to the terms and conditions for the Post-Pay Billing service for SolusIO. Use this to provide additional terms relating to the invoicing and payment of Post-Pay service usage.</td></tr>
 
</table>
 
</table>
  
 
=====Post-Pay Invoicing=====
 
=====Post-Pay Invoicing=====
  
The invoicing settings allow you to control settings related to invoices generated for Post-Pay usage.
+
The Invoicing settings allow you to control settings for invoices for Post-Pay usage.
  
 
<table class="table table-striped">
 
<table class="table table-striped">
Line 112: Line 106:
 
=====Post-Pay Suspension=====
 
=====Post-Pay Suspension=====
  
The suspension settings allow you to control settings related to service restrictions for non-payment of Post-Pay usage.
+
The Suspension settings allow you to control settings for service restrictions for non-payment of Post-Pay usage.
  
 
<table class="table table-striped">
 
<table class="table table-striped">
 
<tr><th>Setting Name</th><th>Description</th></tr>
 
<tr><th>Setting Name</th><th>Description</th></tr>
<tr><td>Lock Overdue Users</td><td>The number of days you want to allow before locking a user account in SolusIO. This is the number of days from the due date.</td></tr>
+
<tr><td>'''Lock Overdue Users'''</td><td>The number of days to allow before locking a user account in SolusIO. This is the number of days from the due date.</td></tr>
<tr><td>Suspend Overdue Users</td><td>The number of days you want to allow before suspending a user account in SolusIO. This is the number of days from the due date.</td></tr>
+
<tr><td>'''Suspend Overdue Users'''</td><td>The number of days to allow before suspending a user account in SolusIO. This is the number of days from the due date.</td></tr>
 
</table>
 
</table>
 
For more information regarding locking and suspension restrictions, please refer to the SolusIO documentation.
 
  
 
===Settings===
 
===Settings===
  
The settings tab allows you to modify connection and pricing settings.
+
The '''Settings''' tab allows you to modify connection and pricing settings.
  
 
====Post-Pay Token Pricing====
 
====Post-Pay Token Pricing====
  
Token Pricing must be set for each active currency within WHMCS.
+
You must set Token Pricing for each active currency within WHMCS.
 +
 
 +
* You can set Token Pricing with up to four decimal places.
 +
* Enter prices as the total price in each currency for one unit of token usage.
 +
 
 +
====API Connection====
 +
 
 +
The '''API Connection''' panel can modify and update the installation URL and API key at any time.
 +
 
 +
To make a change, enter the installation URL and an API key and then click '''Test Connection'''. If a connection is successful, WHMCS will update the URL and API key that it uses.
 +
 
 +
==WHMCS Billing Integration==
 +
 
 +
Within the SolusIO product, you can configure ''Billing Integration Settings''.
 +
 
 +
Billing integration allows SolusIO to retrieve token pricing information as well as perform single sign-on to the WHMCS billing portal.
  
Token Pricing can be set up to 4 decimal places.
+
WHMCS will auto-configure these values for you every time the WHMCS SolusIO module and SolusIO target instance establish a connection. You '''cannot''' generate and set these values manually.
  
The prices entered should be the monetary cost in each given current for 1 unit of token usage.
+
To reconfigure the connection, you must reestablish the API connection with the SolusIO target instance. To do this, use the '''API Connection''' panel in the '''Settings''' tab of the SolusIO WHMCS integration module.
  
====API Connection====
+
== FAQ ==
 +
 
 +
====How do users sign-up?====
 +
 
 +
With the Post-Pay Model of billing, there is no purchase or order necessary. Users can sign up or activate their SolusIO user account via the provided landing page.
 +
 
 +
The enrollment process requires that the user create a WHMCS client account, complete email verification, and agree to your '''Terms of Service''' and (optionally) Post-Pay specific '''Terms & Conditions'''.  This process uses the following workflow:
 +
 
 +
# The user requests creation of an account for VM provisioning.
 +
# The user enters their name, company, email address, and a desired password.
 +
# The user receives an email containing a link to complete the signup process.
 +
# After they click the link, the user must agree to your '''Terms of Service''' and Post-Pay '''Terms & Conditions'''.
 +
# SolusIO provisions the user account.
 +
 
 +
Users can then access SolusIO at any time via a provided SSO link in the Client Area homepage.
 +
 
 +
====How do users access the SolusIO system?====
 +
 
 +
With Post-Pay, customers use the SolusIO control panel to provision and manage virtual machines. The Client Area homepage will show one of the following panels, depending on the user's current SolusIO enrollment status:
 +
 
 +
[[File:SolusIOPanels2.png]]
 +
 
 +
Enrolled users can click '''Log in to SolusIO''' to access the SolusIO control panel via automated single sign-on.
 +
 
 +
Unenrolled users can use a shortcut to the provided landing page to learn more and sign up.
 +
 
 +
====How does invoicing work?====
 +
 
 +
The system generates invoices on the first of each month for all accrued usage in the immediately preceeding month. For example, on the 1st of August, it will generate invoices for usage by all users in the month of July.
 +
 
 +
====How does the system calculate usage?====
 +
 
 +
SolusIO tracks the uptime of every virtual machine. It bills uptime at the hourly rate of tokens that you define within the SolusIO software.
  
The API Connection panel can be used to modify and update the Installation URL and API Key at any time.
+
When it becomes time to generate an invoice, WHMCS will request the uptime totals for each user from the SolusIO system. It creates an invoice with an itemized list of resources (aka virtual machines) and the amount due. The amount due is the token usage value in the SolusIO system multiplied by the token pricing in WHMCS.
  
To make a change, enter both the Installation URL and an API Key and click the '''Test Connection''' button to validate the inputs.
+
====How is billing triggered?====
  
If a connection is successful, the URL and API Key used by WHMCS will be updated.
+
A cron task manages invoice generation and user management. The system executes the cron task automatically once per day, and you can trigger it manually using the following command:
  
==WHMCS Billing Integration==
+
php crons/cron.php do --SolusioAutomation -vvv
  
Within the SolusIO product, it is possible to configure ''Billing Integration Settings''.
+
Invoice generation only occurs on the first day of each month.
 +
== Troubleshooting ==
  
The billing integration allows SolusIO to retrieve token pricing information as well as perform single sign-on to the WHMCS billing portal.
+
''N/A''
  
WHMCS will auto-configure the WHMCS Billing Integration values for you every time a successful connection is established between the WHMCS SolusIO module and a SolusIO target instance. It is not possible to generate and set these values manually.
+
== Change Log ==
  
Should there be a need to re-configure or re-setup the connection at any time, you will need to re-establish the API Connection with the SolusIO target instance using the API Connection panel located within the Settings tab of the SolusIO WHMCS integration module.
+
''N/A''

Latest revision as of 16:32, 28 December 2022

About this Addon Module

Our SolusIO Integration is the official integration between WHMCS and the SolusIO Virtual Infrastructure Management Platform.

This supports Self-Service VM Provisioning with Post-Pay Billing as a billing mode. Post-Pay Billing allows customers to register for access to VM provisioning, manage virtual machines and provision on-demand via the SolusIO control panel, and have billing performed at set intervals by WHMCS in a post-pay (pay after use) model.

Addon Name Latest Release Current Version Compatible With Included in WHMCS
SolusIO N/A N/A WHMCS 7.8 and later No

Activating SolusIO

You will need to download and upload the module before you can activate the addon through the Admin Area.

To do this:

  1. Download the latest version of the integration via the WHMCS Marketplace.
  2. Extract the zip file.
  3. Upload the solusio directory to the /modules/addons folder of your WHMCS installation.
  4. Go to Configuration () > System Settings > Addon Modules or, prior to WHMCS 8.0, Setup > Addon Modules.
  5. Click Activate for SolusIO.
  6. Click Configure.
  7. Select the admin role groups who will have access to this addon.
  8. Click Save Changes.

Using the Addon

You can access the SolusIO module within WHMCS at any time by navigating to Configuration () > System Settings > Addon Modules or, prior to WHMCS 8.0, Setup > Addon Modules within the WHMCS admin area.

Connecting to SolusIO

To connect to SolusIO:

  1. Access SolusIO. When you do this for the first time, you will see the following screen:SolusIOConnect.png
  2. Enter the URL to your SolusIO installation. This is the URL that you use to access the web interface.
  3. Enter your API Key. You can find this at Account > API Tokens > Generate API Token in the SolusIO user area.
  4. Click Test Connection to verify that you can establish a connection with the SolusIO system.

Setup

Post-Pay

When you access the SolusIO module after connecting to SolusIO, you can set your settings for Post-Pay billing.

SolusIOPostPaySetup.png

Landing Page

The WHMCS SolusIO Post-Pay functionality comes with a premade landing page. You can only access this page after you have enabled Post-Pay billing.

SolusIOPostPayLandingPage.png

This also automatically adds menu items to the Client Area if they are enabled.

  • Logged-out users can access this using the Cloud Hosting option in the main menu.
  • Logged-in users can access this using the Cloud Hosting option in the Website & Security menu.

Customising the Landing Page

Customizable templates control the landing page. To make changes, we recommend copying the /modules/addons/solusio/templates/post-pay/landing-page.tpl file into the active WHMCS Client Area template directory at /templates/{active_template}/modules/addons/solusio/post-pay/landing-page.tpl. Both of these paths are relative to the WHMCS root installation directory.

After you copy the file, you can make changes to the template within your WHMCS Client Area template directory. The system will preserve these customizations during module updates.

Configuration

Post-Pay Limit Group

The Limit Group settings allow you to control settings for the limits on new Post-Pay enabled users.

Setting NameDescription
New User Limit GroupSelect the limit group to apply by default to all new Post-Pay users. You must create and define limit groups within the SolusIO control panel.
Post-Pay General Settings

The General Settings allow you to control basic SolusIO settings.

Setting NameDescription
Post-Pay Terms & ConditionsAn optional URL to the terms and conditions for the Post-Pay Billing service for SolusIO. Use this to provide additional terms relating to the invoicing and payment of Post-Pay service usage.
Post-Pay Invoicing

The Invoicing settings allow you to control settings for invoices for Post-Pay usage.

Setting NameDescription
Invoicing Grace PeriodThe number of days you want to allow after generation before an invoice is considered overdue.
Post-Pay Suspension

The Suspension settings allow you to control settings for service restrictions for non-payment of Post-Pay usage.

Setting NameDescription
Lock Overdue UsersThe number of days to allow before locking a user account in SolusIO. This is the number of days from the due date.
Suspend Overdue UsersThe number of days to allow before suspending a user account in SolusIO. This is the number of days from the due date.

Settings

The Settings tab allows you to modify connection and pricing settings.

Post-Pay Token Pricing

You must set Token Pricing for each active currency within WHMCS.

  • You can set Token Pricing with up to four decimal places.
  • Enter prices as the total price in each currency for one unit of token usage.

API Connection

The API Connection panel can modify and update the installation URL and API key at any time.

To make a change, enter the installation URL and an API key and then click Test Connection. If a connection is successful, WHMCS will update the URL and API key that it uses.

WHMCS Billing Integration

Within the SolusIO product, you can configure Billing Integration Settings.

Billing integration allows SolusIO to retrieve token pricing information as well as perform single sign-on to the WHMCS billing portal.

WHMCS will auto-configure these values for you every time the WHMCS SolusIO module and SolusIO target instance establish a connection. You cannot generate and set these values manually.

To reconfigure the connection, you must reestablish the API connection with the SolusIO target instance. To do this, use the API Connection panel in the Settings tab of the SolusIO WHMCS integration module.

FAQ

How do users sign-up?

With the Post-Pay Model of billing, there is no purchase or order necessary. Users can sign up or activate their SolusIO user account via the provided landing page.

The enrollment process requires that the user create a WHMCS client account, complete email verification, and agree to your Terms of Service and (optionally) Post-Pay specific Terms & Conditions. This process uses the following workflow:

  1. The user requests creation of an account for VM provisioning.
  2. The user enters their name, company, email address, and a desired password.
  3. The user receives an email containing a link to complete the signup process.
  4. After they click the link, the user must agree to your Terms of Service and Post-Pay Terms & Conditions.
  5. SolusIO provisions the user account.

Users can then access SolusIO at any time via a provided SSO link in the Client Area homepage.

How do users access the SolusIO system?

With Post-Pay, customers use the SolusIO control panel to provision and manage virtual machines. The Client Area homepage will show one of the following panels, depending on the user's current SolusIO enrollment status:

SolusIOPanels2.png

Enrolled users can click Log in to SolusIO to access the SolusIO control panel via automated single sign-on.

Unenrolled users can use a shortcut to the provided landing page to learn more and sign up.

How does invoicing work?

The system generates invoices on the first of each month for all accrued usage in the immediately preceeding month. For example, on the 1st of August, it will generate invoices for usage by all users in the month of July.

How does the system calculate usage?

SolusIO tracks the uptime of every virtual machine. It bills uptime at the hourly rate of tokens that you define within the SolusIO software.

When it becomes time to generate an invoice, WHMCS will request the uptime totals for each user from the SolusIO system. It creates an invoice with an itemized list of resources (aka virtual machines) and the amount due. The amount due is the token usage value in the SolusIO system multiplied by the token pricing in WHMCS.

How is billing triggered?

A cron task manages invoice generation and user management. The system executes the cron task automatically once per day, and you can trigger it manually using the following command:

php crons/cron.php do --SolusioAutomation -vvv

Invoice generation only occurs on the first day of each month.

Troubleshooting

N/A

Change Log

N/A