Upgrade BillMax on a Debian Server

  1. Download the BillMax Debian package.
    1. Using a web browser, go to http://www.billmax.com.
    2. Click LOGIN. Contact support@billmax.com for the user name and password if you don't know it.
    3. Select Files in the Main menu and identify the appropriate DEB file.
    4. Alongside each file listing are two links. To download the file to your device (for eventual transfer to the BillMax host), click on the first link (it has a downwards pointed arrow).
    5. Otherwise, to get the file location used in a wget command that can be used on the BillMax host to download the file directly, click the second link (rectangular box). This action copies the command to the clipboard. Paste the command and execute it in the command line on the BillMax host as the root user. The command must be used within several minutes of the selection in the portal.
  2. Note: Example- systemctl stop apache2 bx_edge mariadb radiusd
    Login as root and stop all BillMax related services.
  3. Make backups. At a minimum /usr/local/billmax, /opt/billmax, /var/www/mysql must be backed up. See Backups, Redundancy and Archiving
  4. Making sure that no one is using the system, execute systemctl start mariadb apache2 to start the web server and database.
  5. Commit any local edits. As root execute:
    1. cd /usr/local/billmax
    2. svn commit -m "commit information"Update BillMax Debian package (the file must include a path)
  6. To update BillMax Debian package (the file must include a path), execute apt upgrade ./<file name of BillMax Deb package>
  7. Run the root upgrade scripts. As root execute:
    1. cd /opt/billmax/install
    2. ./BxInstall.pl
    3. Supply "n" if you see "Continue printing (Y/n)?
    4. Supply "F" if you see "Enter two indexes for each column to rename, (R)elist, or (F)inish:"
    5. Solve any inconsistencies. There should not be any if no customizations have been made. After resolving an inconsistency, you may need to issue the command resolved filename where filename is the name of the file that had the inconsistency.
    6. ./BxUroot-4.0.pl
  8. To run the billmax upgrade script, execute:
    1. cd /opt/billmax/install
    2. ./BxUpost-4.0.pl
  9. To verify the installation, execute
    1. Execute /usr/local/billmax/bin/dbck
    2. Login into the system and conduct various task to ensure the system is operational.
    3. If fall back is needed, restore the system from the backups in step 3.