BILLmanager installation
From ISPWiki
Installing the BILLmanager software product
We would recommend that you use minimal configuration 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.
The following is a standard procedure that is used for all other ISPsystem software installation.
You need an active IP-address license and the Internet connection.
The article below provides step-by-step software installation guide:
Enter shell on your server as root and run any of the following commands:
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 the installation script and run it with the command:
sh install.sh
The install.sh installation script contains the following keys that you can use if the automatic parameters were incorrectly recognized:
--os OS Specify the operating system manually. --arch ARCH Specify the architecture manually (i386, i686). --ip IP Specify the license IP manually.
The installation script will list the 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 installation:
Then enter an administrator password (login: admin) to access BILLmanager:
The installer will define the list of packages for installation. It may take some time due to update of the packet manager cache or download/setting up of the ports tree (depending on the 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 the system repository allows it), but default installation is advisable. If you make installation on the server with MySQL-server that requires a root password, this password will be prompt for creation of a database.
Once you have selected the required type, the installation starts. You will get the installation process notification:
The installation may take some time, and after it is successfully completed, the Setup Wizard will inform you:
Follow the link https://server_ip-addrees/manager/billmgr to access and configure the system.
Login: admin
Password: specified when installing
Technical details (manual setup)
Some advanced users may install and customize the software manually, for example, when you install it on the operating system that is not supported.
BILLmanager uses the Apache web-sever that supports SSL (mod_ssl) to access via https and MySQL-server (version 5.0 and higher) with InnoDB support enabled for data storage. In this article we are not going to consider how to customize them.
- To make Apache run with BILLmanager you should add into the apache configuration file:
Include /usr/local/ispmgr/etc/ispmgr.inc
and add a mod_ispmgr.so link in the /usr/local/ispmgr/lib/apache folder to the module of the corresponding version. Besides, your Apache server should run via hhtps.
- To run MySQL, in the BILLmanager configuration (/usr/local/ispmgr/etc/billmgr.conf) you specify parameters to connect to the database:
DBHost <hostname> // localhost by default DBName <name> // database name, billmgr by default. // The database should be present or a user should have access privileges to create it DBUser <user> // Username to connect 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 specify an admin password for the user, execute the followings:
/usr/local/ispmgr/sbin/mgrctl -m billmgr usrparam passwd=<password> recordlimit=100 sok=ok
- Now you can continue customizing BILLmanager via Web-interface
https://<ip>/manager/billmgr User name: admin Password: <pass>
