Convert from CentOS 6.x® to CentOS 7.x®
Converting from CentOS 6.x® to CentOS 7.x® is a manual process. It entails building a CentOS 7.x® machine and moving data from the old machine to the new machine.
-
Install BillMax on a CentOS 7.x® 64 bit machine. See Install CentOS 7.x for BillMax. It needs to be the same version of
BillMax as on the CentOS 6.x® machine Use the following
information from the old machine on the new machine:
- system username - typically billmax.
- software repository username/password - typically billmax/billmax.
- the same root password for the MariaDB® database as for the MySQL® database.
-
When running the BxConfigure.cgi process, use the following
information from the old machine on the new machine unless otherwise
noted:
- username/password for the BillMax database.
- The Admin password need only pass the requirements. It will be overwritten.
- The AES key will be overwritten.
- After requesting and entering a new license, make sure you keep a copy. The license will be overwritten and need to be re-entered later.
-
Important: From the second '/usr/local/billmax below through uploadedfiles)' there are no spaces or carriage returns.As root and in the /root directory, run the following command: diff -r /usr/local/billmax /opt/billmax/software | grep -v -E '\.svn$|\.o$|\.d$' | grep -v -E '/usr/local/billmax/(documents|efp|logs|tmp|uploadedfiles|cdrfiles|backups|prepaidcards|snapshots|importtools|uploadedfiles)' > upgradedifferences.dat
- Examine the results in upgradedifferences.dat. Any pertinent changes will have to be done on the new server.
-
Shut down httpd and mysqld on both
servers.
- /sbin/service mysqld stop on the old server.
- /sbin/service httpd stop on the old server.
- systemctl stop mariadb on the new server.
- systemctl stop httpd on the new server.
- Copy the files from the billmax and billmax_reports database on the old servers to the billmax and billmax_reports databases on the new server. Make sure you maintain ownership and permissions.
- Execute systemctl start mariadb on the new server.
- Execute mysql_upgrade -u root -p on the new server.
- Redo any local customizations that were noted in upgradeddifferences.dat.
-
Copy contents of the following directories located in
/usr/local/billmax on the old server to the comparable
locations on the server. Do not copy the ./svn
subdirectories, Make sure you maintain ownership and permissions.
- cdrfiles
- documents
- efp
- logs
- prepaidcards
- uploadedfiles
- A backup at this point is recommended.
- Execute systemctl start httpd on the new server.
- If the new server has a new name or IP address and these are significant to the customer portal configuration, remember to update the customer portal files and clear the PHP cache.
- Copy .fetchmailrec from BillMax system user to the new machine BillMax home directory.
- To reset the crontab entries on the new server, go to System Administration > Batch Processing. Change the nightly batch process from ACTIVE to DISABLE and SAVE. Set the nightly batch process back to ACTIVE.