BILLmanager Installation guide

From ISPWiki
Jump to: navigation, search

System requirements

Supported operating systems for BILLmanager

  • CentOS 7 Х64
  • Debian 8 Х64

We strongly recommend a clean install of BILLmanager. You should install a minimal version of the operating system, all the services that BILLmanager requires, will be installed automatically during software installation.

License policy

You may obtain a free version of BILLmanager that you can use for an unlimited period of time. This free version comes with the following resource limitation: in BILLmanager you can create and manage only 50 client accounts. The license will be activated automatically during installation.

If you have a "commercial license", it will be activated automatically, given that your server's public IP address matches the license IP. If your server is assigned a private IP address, execute the following command:

export ACTIVATION_KEY=<activation_key>

If you have a lifetime license, please pay attention to its updates expiration date. If updates for your lifetime license have already expired during setup, trying to install the latest version of the corresponding control panel will cause issues with license activation. In this case, you need to start the installation process with the --release 5.50 parameter, where 5.50 is the latest version available for a lifetime license.

Installation

BILLmanager is installed and updated from the OS repository.

Establish SSH connection as the root user and download the script to start the installation

 wget http://cdn.ispsystem.com/install.sh

and execute

 sh install.sh BILLmanager

In order to install a certain version of a control panel, run install.sh with the --release parameter. E.g.:

sh install.sh BILLmanager --release 5.50

Choose a required version - beta or stable. The installation script will connect required repositories (EPEL for CentOS), and update the package cache.

Select a BILLmanager version. The script will install BILLmanager and packages it requires.

Example on CentOs 7.1

BILLmanager installation


Once completed, you can login to BILLmanager using the following access details:

Url: https://<server IP address>:1500/billmgr

Login: root

Password: <root password>

Attention!!! If port 443 is already in use, the billing panel can be accessed at Url: https://<server ip address>:1500/billmgr

Update

In the System configuration module you can select the corresponding option if you want the control panel to automatically update.

In order to update the panel manually, use standard methods of your operating system.

Please note: every control panel's version is bound to a separate repository, which name matches its version. The beta5 and stable5 repositories contain all the versions of a software product. The product's version to which you can update, depends on the connected repository.

CentOS

 yum update

Debian

 apt-get update 
 apt-get dist-upgrade

Preliminary setup

For more information please refer to the article BILLmanager preliminary setup.

Upgrading to higher versions

If you want to upgrade, for example, from BILLmanager Standard to BILLmanager Advanced, execute the script /usr/local/mgr5/sbin/billmgr-upgrade.sh

Specify a name of a required version:

/usr/local/mgr5/sbin/billmgr-upgrade.sh advanced

Downgrade is not supported.