Chapter 2. Preliminary BillMax Configuration

Chapter 2. Preliminary BillMax Configuration
	BillMax Installation and Configuration Guide

Starting and Stopping the BillMax Daemons

Using billmax-admin

billmax-admin must be run as the UNIX "root" superuser. Please become "root" before continuing.

Use billmax-admin to stop and start the Daemons related to BillMax. Please see /usr/local/billmax/local/billmax.conf for a complete description about which daemons billmax-admin starts and stops. If using either the BillMax supplied mysqld Daemon or the BillMax supplied httpd Daemon, execute "/usr/local/billmax/bin/billmax-admin start". As delivered, this will start the appropriate Billmax supplied Daemon(s). At this point, BillMax may be accessed via a web browser.

In order for BillMax to do daily processing, billmax-admin must be run daily. Edit the appropriate crontab file.

For RedHat:
1. Make a backup copy of /etc/crontab.
2. Edit the /etc/crontab and add the following line:
  
  0 0 * * * /usr/local/billmax/bin/billmax-admin nightly
For FreeBSD:
1. Make a backup copy of /etc/crontab.
2. Edit the /etc/crontab and add the following line:
  
  0 0 * * * root /usr/local/billmax/bin/billmax-admin nightly
For Solaris:
1. Execute "crontab -l > billmax.crontab".
2. Edit billmax.crontab and add the following line:
  
  0 0 * * * /usr/local/billmax/bin/billmax-admin nightly
3. Execute "crontab billmax.crontab".

The result of these steps is that "billmax-admin nightly" will be executed daily at midnight. Please see crontab(8) for more information about the crontab entries.

Please review /usr/local/billmax/local/billmax.conf. This file controls what processing will occur when "billmax-admin nightly" is executed by cron(5).

	Important
	As delivered, executing "billmax-admin `nightly`" DOES NOT result in the execution of closeofday. The result is that daily BillMax financial processing such as billing customers is not done. In addition, Electronic Funds Processing and Statement processing is not done.

Starting the BillMax Daemons on Reboot

When the BillMax server is rebooted, it is advantageous that the BillMax Daemons be started automatically. In order to do the following, you will need to gain access to the UNIX superuser account.

For RedHat, execute the following:
1. cp /usr/local/billmax/local/billmax.RedHat /etc/init.d
2. chkconfig --add billmax
3. chkconfig billmax on
For FreeBSD, execute the following:
1. cp /usr/local/billmax/local/billmax.FreeBSD /usr/local/etc/rc.d/billmax.sh
2. chmod +x /usr/local/etc/rc.d/billmax.sh
For Solaris, execute the following:
1. cp /usr/local/billmax/local/billmax.Solaris /etc/init.d/billmax
2. cd /etc/rc0.d
3. ln -s /etc/init.d/billmax K99billmax
4. cd /etc/rc1.d
5. ln -s /etc/init.d/billmax K99billmax
6. cd /etc/rcS.d
7. ln -s /etc/init.d/billmax K99billmax
8. cd /etc/rc2.d
9. ln -s /etc/init.d/billmax S99billmax


	BillMax Billing Solutions 877.245.5629 sales@billmax.com


Installing the BillMax Software Bundle		Accessing Configuration Options