Singlehop

From WHMCS Documentation

About this Module

In 2013, SingleHop replaced this functionality with a built-in function in LEAP3. Contact SingleHop directly for help to configure WHMCS and LEAP3.

The SingleHop module allows you to manage dedicated servers that WHMCS provisions through the Tandem Reseller Program. It can automate server reselling tasks through a completely white label solution. This includes suspensions, unsuspensions, rebooting, and viewing IP addresses and historical bandwidth usage.

Configuring a Product

To set up a SingleHop product:

  1. If you have not already created a Tandem user account, perform the following steps in the LEAP control panel:
    Tandemcreate.png
    1. Go to Leap > Tandem > Tandem Users and click Add New User.
    2. Enter a Name, Email, and Password.
    3. Click Submit.
  2. In the WHMCS Admin Area, go to Setup > Products/Services.
  3. Click Create a New Product.
  4. Select VPS/Dedicated Server for product type.
  5. Choose the appropriate product group and give the product a name.
  6. Click Continue.
    Tandemproductsetup.png
  7. In the Module Settings tab, select Singlehop.
  8. Make certain that the server group is None.
  9. Enter your LEAP username and password, the Tandem username and password, and the API key from the Accounts page in LEAP. Tendemmodsettings.png
  10. Configure all of the remaining product settings as normal.

The Order Process

Automated provisioning is not possible via the API. When a client orders a server, you must order the server via the LEAP control panel manually. Then, you must give the Tandem user permission to manage it:

  1. Go to Leap > Tandem > Tandem Users.
  2. Select the user in the left-side pane.
  3. Click Add Server Permissions.
  4. Check the checkbox for the new server.
  5. Click Apply Permissions.Tandempermission.png
  6. In WHMCS, go to the client's Products/Services tab.
  7. Select the dedicated server product.
  8. Select the new server from the SingleHop Servers List menu.
  9. Click Save Changes. The hostname and username will populate automatically.

Admin Area Management Options

The Admin Area allows you to perform suspensions, unsuspensions, and remote reboots. You can also click Get Server IP to view a list of IP addresses on the server.

Tandemadminmanagement.png

Client Area Management Options

The Client Area with this module provides clients with the ability to view their server username in real time along with historical bandwidth usage data.

Tandemclientarea.png

Tandemclientareabandwidthview.png

Troubleshooting

API Error: Authentication Error

This error message next to SingleHop Servers List on the client's products/services tab means the details entered under Module Settings when you edit a product at Setup > Products/Services are incorrect.

No Servers Listed

If no servers are listed in the SingleHop Servers List dropdown menu on the client's profile's Products/Services tab, this indicates your Tandem User doesn't have permission for any servers. For more information, see the instructions above.