billmax documentation   BillMax Billing Solutions
  877.245.5629
  sales@billmax.com
 

Installing the BillMax Software Bundle

Pre-installation Tasks

Several UNIX commands are used by the install program. In addition, there are UNIX commands that BillMax uses that are not required for installation. The install program will attempt to determine where the programs are located. If it can't, the BillMax installer will be prompted for the location. The UNIX commands are:

  1. awk

  2. cp

  3. diff

  4. file

  5. find

  6. hostname

  7. grep

  8. ln

  9. ls

  10. find

  11. lpr

  12. more

  13. mkdir

  14. netstat

  15. sendmail

  16. rm

  17. sh

  18. tar

  19. uname

Prior to installing the software BillMax bundle, please answer the following:

1. General Information
1.1. Does the installer have UNIX superuser access to the system? If NO, then contact the system administrator to gain superuser access.
2. MYSQL mysqld Information
2.1.1. What is the username and password for the MYSQL administrator?
2.1.2. What is the username and password to be used for the BillMax database? This is the username/password that will be used to create and access the BillMax database.
2.1.3. What is the username and password to be used for the initial BillMax administration account? This a username/password that will be used to administer and configure the BillMax software.
2.2.1. Will the BillMax delivered MYSQL mysqld Daemon be used.
2.3.1. Are any non-BillMax mysqld Daemons running? If YES, stop them.
2.3.2. Will any non-BillMax mysqld Daemons start up on reboot? If YES, disable this from happening.
2.4.1. Is the non-BillMax mysqld Daemon running? If NO, start it.
2.4.2. What is the mysql installation directory?
2.4.3. What is the full path to mysqladmin?
2.4.4. If applicable, what is the hostname, port and/or socket? The install program may be able to determine this.
3. Apache httpd Information
3.1.1. Will the BillMax delivered Apache httpd Daemon be used?
3.2.1. Are any non-BillMax httpd Daemons running? If YES, stop them.
3.2.2. Will any non-BillMax httpd Daemons start up on reboot? If YES, disable this from happening.
3.3.1. Is the non-BillMax httpd Daemon running? If NO, stop it.
3.3.2. What is the directory name in which the non-Billmax httpd.conf is located?
1. General Information
1.1. Does the installer have UNIX superuser access to the system? If NO, then contact the system administrator to gain superuser access.
1.1.

Does the installer have UNIX superuser access to the system? If NO, then contact the system administrator to gain superuser access.

2. MYSQL mysqld Information
2.1.1. What is the username and password for the MYSQL administrator?
2.1.2. What is the username and password to be used for the BillMax database? This is the username/password that will be used to create and access the BillMax database.
2.1.3. What is the username and password to be used for the initial BillMax administration account? This a username/password that will be used to administer and configure the BillMax software.
2.2.1. Will the BillMax delivered MYSQL mysqld Daemon be used.
2.3.1. Are any non-BillMax mysqld Daemons running? If YES, stop them.
2.3.2. Will any non-BillMax mysqld Daemons start up on reboot? If YES, disable this from happening.
2.4.1. Is the non-BillMax mysqld Daemon running? If NO, start it.
2.4.2. What is the mysql installation directory?
2.4.3. What is the full path to mysqladmin?
2.4.4. If applicable, what is the hostname, port and/or socket? The install program may be able to determine this.
2.1.1. What is the username and password for the MYSQL administrator?
2.1.2. What is the username and password to be used for the BillMax database? This is the username/password that will be used to create and access the BillMax database.
2.1.3. What is the username and password to be used for the initial BillMax administration account? This a username/password that will be used to administer and configure the BillMax software.

There are three sets of usernames and passwords required. For security reasons, it is recommended that these not be written down and no space is given to do so.

2.1.1.

What is the username and password for the MYSQL administrator?

2.1.2.

What is the username and password to be used for the BillMax database? This is the username/password that will be used to create and access the BillMax database.

2.1.3.

What is the username and password to be used for the initial BillMax administration account? This a username/password that will be used to administer and configure the BillMax software.

2.2.1. Will the BillMax delivered MYSQL mysqld Daemon be used.
2.2.1.

Will the BillMax delivered MYSQL mysqld Daemon be used.

YES or NO (circle one)

2.3.1. Are any non-BillMax mysqld Daemons running? If YES, stop them.
2.3.2. Will any non-BillMax mysqld Daemons start up on reboot? If YES, disable this from happening.

If YES

2.3.1.

Are any non-BillMax mysqld Daemons running? If YES, stop them.

2.3.2.

Will any non-BillMax mysqld Daemons start up on reboot? If YES, disable this from happening.

2.4.1. Is the non-BillMax mysqld Daemon running? If NO, start it.
2.4.2. What is the mysql installation directory?
2.4.3. What is the full path to mysqladmin?
2.4.4. If applicable, what is the hostname, port and/or socket? The install program may be able to determine this.

If NO

2.4.1.

Is the non-BillMax mysqld Daemon running? If NO, start it.

2.4.2.

What is the mysql installation directory?

_______________________________________________________

2.4.3.

What is the full path to mysqladmin?

_______________________________________________________

2.4.4.

If applicable, what is the hostname, port and/or socket? The install program may be able to determine this.

_______________________________________________________

3. Apache httpd Information
3.1.1. Will the BillMax delivered Apache httpd Daemon be used?
3.2.1. Are any non-BillMax httpd Daemons running? If YES, stop them.
3.2.2. Will any non-BillMax httpd Daemons start up on reboot? If YES, disable this from happening.
3.3.1. Is the non-BillMax httpd Daemon running? If NO, stop it.
3.3.2. What is the directory name in which the non-Billmax httpd.conf is located?
3.1.1. Will the BillMax delivered Apache httpd Daemon be used?
3.1.1.

Will the BillMax delivered Apache httpd Daemon be used?

YES or NO (circle one)

3.2.1. Are any non-BillMax httpd Daemons running? If YES, stop them.
3.2.2. Will any non-BillMax httpd Daemons start up on reboot? If YES, disable this from happening.

If YES

3.2.1.

Are any non-BillMax httpd Daemons running? If YES, stop them.

3.2.2.

Will any non-BillMax httpd Daemons start up on reboot? If YES, disable this from happening.

3.3.1. Is the non-BillMax httpd Daemon running? If NO, stop it.
3.3.2. What is the directory name in which the non-Billmax httpd.conf is located?

If NO

3.3.1.

Is the non-BillMax httpd Daemon running? If NO, stop it.

3.3.2.

What is the directory name in which the non-Billmax httpd.conf is located?

_______________________________________________________

Installation Steps

  1. Login to the server.

  2. Gain superuser access.

  3. Change directory to /etc.

  4. Create backups of files by executing the following commands:

    1. cp  services  services.prebillmax

    2. cp  groups  groups.prebillmax

  5. If using a non-BillMax httpd server, change directory to where the httpd.conf is located and execute "cp httpd.conf httpd.conf.prebillmax.

  6. Change directory to /tmp.

  7. Execute one of the following two commands:

    1. gunzip  -c  BxPackage-OSversion-demo.2.2.0.tgz  |  tar xf  -

    2. tar  xzf  BxPackage-OSversion-demo.2.2.0.tgz

    where OSversion will be a string indicating the operating system chosen when downloading the BillMax software bundle and -demo will be present only if the demonstration copy of BillMax was downloaded.

  8. Execute "./BxInstall.pl".

  9. Answer the questions presented. If available, enter the BillMax license. If not available, the license may be entered at a later time.

All BillMax related software is installed in /usr/local/billmax. If a non-BillMax web server was chosen, the supplied httpd.conf will have been edited and the edits done should be reviewed.

Optional Steps for Purchased Versions of BillMax

The purchased version of BillMax comes with software to do automated Electronic Funds Processing. To enable this software, execute /usr/local/billmax/pkg/libwww_install.pl.

If upgrading from a demo version of BillMax, install the purchased version of BillMax by upgrading the demo version and then executing/usr/local/billmax/pkg/libwww_install.pl.


Document Revision A for BillMax 2.2.0   -   Copyright © 1997-2006 The iSpark Group, Inc.

All rights reserved. No part of this documentation may be reproduced or transmitted in any fashion without written permission by The iSpark Group, Inc. This documentation is for the sole use of licensees of the BillMax billing software created by The iSpark Group, Inc. Making the documentation available to a non-licensee of BillMax without written permission of The iSpark Group, Inc. is a violation of the use of this documentation.

While precautions have been taken in the preparation of this documentation, The iSpark Group, Inc. assumes neither liability nor responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.

All terms mentioned that are known to be trademarks have been appropriately capitalized. Use of the a trademark does not affect the validity of any trademark or service mark.

Links to third-party Web sites are provided for convenience. The iSpark Group, Inc. is not responsible for any content contained in the third-party Web sites.

Comments about this documentation may be sent to doc@billmax.com