# R1Soft Backups For WHMCS

R1Soft Backups For WHMCS has reached End of Support (EOS) and is no longer actively maintained. The module remains available for purchase in the Open Source version, along with License Upgrade option at a discounted price. Current license subscriptions continue and stay valid for future renewals.

# (opens new window) About R1Soft Backups For WHMCS (opens new window)

R1Soft Backups For WHMCS will let you sell and manage R1Soft Server Backup Manager accounts right in your WHMCS system.

Your customers will be able to use different configurable options in order to adjust their products to satisfy all their needs.
Moreover, they will be allowed to monitor the disk usage, choose its compression type and access the control panel with a single click.

  • Admin Area Features

    • Create/Terminate Account
    • Suspend/Unsuspend User
    • Change Package
    • Change Password
    • View Server Details
  • Client Area Features

    • View Server Details
    • View Disk Usage Statistics
    • View And Manage Account Credentials
    • Log In To Control Panel
  • Package Settings

    • Is Power-User
    • Agent Limit
    • Soft Quota
    • Hard Quota
    • Quota Type
    • Replication Frequency Limit
    • MySQL Addon Limit
    • Archive Point Limit
    • Recovery Point Limit
    • Allow Archiving
    • Allow Agents
    • Compression Type:
      • None
      • QuickLZ
      • ZLib (Three Levels Available: Low, Medium, High)
  • Configurable Options

    • Maximum Number Of Agents
    • Maximum Number Of MySQL Addons
    • Size (Total Or Divided Into 'Soft Quota' And 'Hard Quota')
    • Compression Type
    • Compression Level
    • Replication Frequency Limit
    • Quota Type
  • General Info

# Installation and Configuration

R1Soft Backups For WHMCS has reached End of Support (EOS) and is no longer actively maintained. The module remains available for purchase, including the Open Source version and License Upgrade at a discounted price. Current license subscriptions continue and stay valid for future renewals.

This tutorial will show you how to successfully install and configure R1Soft Backups For WHMCS. (opens new window)
We will guide you step by step through the whole installation and configuration process.

# Installation

  1. Log in to our client area and download the module.
R1Soft Backups For WHMCS: module download page in the client area with the Download button for the latest version
  1. In the downloaded file you might find one or two packages that support different PHP versions.
    In the most recent versions of the module, you will find only one package that supports PHP 7.2 and later.

    R1Soft Backups For WHMCS: downloaded archive listing a single package for PHP 7.2 to PHP 7.4

    Previous updates of the module may contain two packages dedicated to various PHP versions.
    The first one that supports PHP 5.6 up to PHP 7.1, and the second one addressed to PHP 7.2 up to PHP 7.4.
    Note: Keep in mind that PHP versions 5.6 up to 7.1 are no longer officially supported and their security issues are not fixed or released any more. Find more info here (opens new window).

    R1Soft Backups For WHMCS: downloaded archive listing packages for PHP 5.6 to 7.1 and PHP 7.2 to 7.4

    Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' → 'System' → 'PHP Info'.

  2. Extract the package and upload its content into the main WHMCS directory.
    The content of the package to upload should look like this.

    R1Soft Backups For WHMCS: file manager listing the extracted package with the modules folder to upload
  3. When you install R1Soft Backups For WHMCS for the first time you have to rename 'license_RENAME.php' file.
    File is located in 'modules/servers/R1SoftBackups/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

    R1Soft Backups For WHMCS: module folder with the licenseRENAME.php file being renamed to license.php
  4. In order to configure your license key, you have to edit a previously renamed 'license.php' file.
    Enter your license key between quotation marks as presented on the following screen.
    You can find your license key in our client area → 'My Products'.

R1Soft Backups For WHMCS: license.php file open in an editor with the license key variable between quotation marks

# Configuration of Server

  1. Now, we will show you how to configure a new product.
    Go to 'Setup' → 'Products/Services' → 'Servers' and press 'Add New Server'.

    R1Soft Backups For WHMCS: WHMCS admin Servers page with the Add New Server button and empty server list
  2. Next, enter your server name, IP address/hostname, username and password.
    Choose 'R1softbackup' from a dropdown menu and press 'Save Changes'.
    Note: Here you may also provide your custom port to connect with your server.

    R1Soft Backups For WHMCS: WHMCS Edit Server form with name, hostname, R1softbackup type, username, password and port
  3. It is time to create a server group. To do so, click on 'Create Server Group'.

R1Soft Backups For WHMCS: WHMCS Servers page with the R1Soft server listed and the Create New Group button
  1. Enter name, click on your previously created server, press 'Add' and afterwards 'Save Changes'.
R1Soft Backups For WHMCS: Create New Group form in WHMCS with a group name and the R1Soft server added to the group

# Configuration of Product

  1. In order to create and configure a product, go to 'Setup' → 'Products/Services' → 'Products/Services'.
    Click on 'Create a New Group'.

    R1Soft Backups For WHMCS: WHMCS Products/Services page with the Create a New Group button above the product list
  2. Enter product group name and press 'Save Changes'.

R1Soft Backups For WHMCS: WHMCS Create Group form with the product group name and Save Changes button
  1. When you have a product group, you can create your product.
    To create a product click on 'Create a New Product'.

    R1Soft Backups For WHMCS: WHMCS Products/Services page with the new group and the Create a New Product button
  2. Afterwards, choose your product group and type from dropdown menus, enter your product name and press 'Continue'.

R1Soft Backups For WHMCS: WHMCS Create a New Product form with product type, group and name fields and Continue button
  1. Now, go to 'Module Settings' section, choose both 'R1softbackups' and your previously created server group from dropdown menus.
    Save changes.

    R1Soft Backups For WHMCS: product Module Settings tab with the R1softbackup module and R1Soft Servers server group
  2. Take a moment to set up all the available module's options:
    First of all, you need to enable Power-User as only then you will be able to manage Module Settings fully.

  • enter volume path prefix
  • define the Maximum Number of Agents - can be overwritten by a configurable option
  • define the Maximum Number of MySQL Addons - can be replaced by a configurable option
  • Soft Quota - a warning level when users are informed that they are close to reach their effective limit
  • Hard Quota - maximum resources allowed to be occupied by data, its value should exceed the soft quota value
    • 'Soft Quota' and 'Hard Quota' can be overwritten by a configurable option 'Size' which defines the general range of usage
  • allow the user to create and Administer Agents
  • enable Archiving
  • define the Limit of Archive Points
  • define the Limit of Recovery Points
  • select Replication Frequency Limit: 'Hourly,' 'Daily,' 'Weekly,' or 'Monthly' - can be replaced by a configurable option
  • choose Quota Type: 'On Disk Size' or 'Deltas in Disk Safe' - can be replaced by a configurable option
  • enter WebLogin Server link, remember to use a whole http:// address - if left empty, the button will not be available
    • WebLogin With Server Hostname - if checked, server hostname will be used instead of the 'WebLogin Server' link
  • select Compression Type to save space: 'ZLib', QuickLZ' or set to 'None' to disable this option
    • if 'ZLib' has been selected, then choose Compression Level: 'Low', 'Medium' or 'High'
  • Default Port - define default port to communicate with Backup Server Agent - can be replaced by a custom field
  • R1Soft's SMB Version - choose the preferred version from the dropdown menu
    Remember to save the changes in the end.
    Use 'Generate' buttons to automatically generate custom fields and configurable options for the product.
    Note: It is recommended to edit configurable options to suit your needs, more about management of configurable options can be found here.
R1Soft Backups For WHMCS: filled product Module Settings tab with Generate links for custom fields and options

# Management

R1Soft Backups For WHMCS allows reselling and accessing an external backups management server directly from your WHMCS.
Read the below section to find out how contributing the product can be to your business.

# Ordering

R1Soft Backups For WHMCS is ordered by clients as any other product. However, there is one thing to pay attention to.
While completing the order for the product, a client needs to fill in Additional Required Information, which is:

  1. Server IP - this is an IP address of Backup Manager agent's server.
  2. Server Port - defined port number used to connect to server of Backup Manager agent - unless otherwise configured by the administrator.
    Additionally, depending on configurable option, client can define account limits.
R1Soft Backups For WHMCS: WHMCS order form Configure page with configurable options and Server IP and Server Port fields

From the admin area you can order actions such as:
'Create', 'Suspend', 'Unsuspend', 'Terminate', 'Change Package' and 'Change Password'.
Underneath the buttons, there are also 'Server IP' and 'Server Port' details available.

R1Soft Backups For WHMCS: WHMCS client profile product page with module command buttons and Server IP and Server Port

# Client Area

Your client can log in to the outside R1Soft account from your WHMCS client area.
Link to the server must have been entered in Module Settings (look at point 14 for more information).

R1Soft Backups For WHMCS: WHMCS client area Manage Product page with the Log In To Control Panel button

Apart from the direct login button, there are also 'Login Details'.
View your R1Soft server login and show/hide password.

R1Soft Backups For WHMCS: Manage Product page in the client area with login details and the password shown with Hide

Quick look at your product details, as stated while placing an order at Configurable Options section.

R1Soft Backups For WHMCS: client area Manage Product page with the Configurable Options tab listing the product limits

In Additional Information section, you may preview defined Server IP and Port.

R1Soft Backups For WHMCS: client area Manage Product page with the Additional Information tab showing Server IP and Port

Resource Usage includes a graph that displays information on the currently used disk space.
Note: Bandwitdh graph is a WHMCS option and is not managed by the module.

R1Soft Backups For WHMCS: client area Manage Product page with disk space and bandwidth usage graphs

# Tips

  1. If you do not want your clients to provide a backup agent port, then modify according custom field and define default port to communicate with agent in Module Settings.

# Update Instructions

An essential guidance through the process of updating the module is offered here.

Ensure successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues.
Additionally, you will find a current list of supplementary actions necessary for a smooth update process there.

# Upgrade Guide

Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability?
There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment.

Opt for the Open Source version (opens new window) of your R1Soft Backups For WHMCS module to unlock these benefits.
Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied.

Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.

# Common Problems

  1. When you have problems with connection, check whether your SELinux or firewall does not block ports.