BILLmanager installation

From ISPWiki

This article provides information on installing the control panel on your server, including pre-requisites and the stages you should pass, as well as instructions on how to start working in BILLmanager.

Follow the steps below to perform a successful installation of BILLmanager:

Installing BILLmanager

You should install a minimal version of the operating system. The software installer will automatically download and install the required software product from the repository/ports of the operating system distribution.

You need an active license bound to the server's IP-address and an active Internet connection.

Enter shell on your server as root and run any of the commands below:

fetch "http://download.ispsystem.com/install.sh"
wget "http://download.ispsystem.com/install.sh"
curl -o install.sh "http://download.ispsystem.com/install.sh"

Download and run the installation script:

sh install.sh

The install.sh installation script contains the keys you can use if the automatic parameters were incorrectly recognized:

--os OS Specify an operating system manually.
--arch ARCH Specify an architecture  manually (i386, i686).
--ip IP Specify the license IP-address manually.

The installation script will list licenses for your IP-address. Choose a software product by typing in a corresponding digit.

The Setup Wizard displays the operating system version and software information. Click Yes to proceed with the installation:

Enter the administrator password (login: admin) to be able to get access to BILLmanager:

A list of packages for installation will appear. It may take some time due to update of the packet manager cache or download/setting up of the ports tree (depending on your operating system):

The Setup Wizard will prompt you for the installation type. We recommend that you select default installation - "Install most popular software":

The installer allows you to select other installation types, such as Apache and MySQL versions (if applicable), however default installation is advisable. If you select MySQL-server, you will be required to enter the root password for creating a database.

Once you are done, the installation starts. You will get an installation process notification:

Once the installation is successfully complete, the Setup Wizard will inform you:

Follow the link https://server_ip-addrees/manager/billmgr to access and configure the system.

Login: admin

Password: enter the one specified during the installation process

Technical details (manual setup)

Advanced users may install and customize their software manually, for example, if they install the panel on a non-supported operating system.

BILLmanager uses the Apache web-sever that supports SSL (mod_ssl) to gain access via https and MySQL-server (version 5.0 and higher) with InnoDB support enabled for data storage. In this article we are not describing how to customize them.

• To configure Apache, add into the Apache configuration file:

Include /usr/local/ispmgr/etc/ispmgr.inc

and add the mod_ispmgr.so link in the /usr/local/ispmgr/lib/apache folder to the module of a corresponding version. Note, your Apache server must run via https.

• To run MySQL, specify the database access parameters in the BILLmanager configuration file (/usr/local/ispmgr/etc/billmgr.conf):

DBHost <hostname>  //  localhost by default
DBName <name>      // database name, billmgr by default.
// The database should be present, or a user should have enough access privileges to create it 
DBUser <user>      // username for connecting to the database, root by default
DBPassword <pass>  // <user> password
DBSocket <socket>  // path to mysql UNIX socket, blank by default

• Address for outgoing email (see also Message template)

• To provide the admin password, execute:

/usr/local/ispmgr/sbin/mgrctl -m billmgr usrparam passwd=<password> recordlimit=100 sok=ok

• You can proceed with BILLmanager configuration via the web-interface

https://<ip>/manager/billmgr
User name: admin
Password: <pass>