How to move BILLmanager from one server to another

Migration of billing and licenses between servers may be required when changing equipment.

The following is required to migrate the billing:

Turn on the maintenance mode on the old server for the duration of migration.
Import user data from the old server to the new one.
Move custom XML files, addons and plugins to the new server.
Move the custom showroom.
Run installation of all missing software packages (service processing modules, payment systems, mail gateways).
Link the control panel license to the new server.
Disable maintenance mode.

Note:

After migrating BILLmanager, we recommend deleting the control panel from the old server. Identical settings of service processing modules in two billing latform lead to incorrect opening of services.

Step 1. Enable maintenance mode

Maintenance mode is a technical service (maintenance) mode in BILLmanager. As long as this mode is enabled, processing modules and mail gateways in BILLmanager will not perform any operations.

Enable the maintenance mode on the old server. Create the /usr/local/mgr5/etc/billmgr.DoNothing file.

Step 2. Import user data

Each server must have an active license at the time of migration. Install and activate the trial version of the product on the new server following the manual.

Note.

A trial license has a limit on the number of clients. After migrating BILLmanager, activate the commercial license on the new server.

Migration can be performed between servers with different operating systems. For example, you can migrate BILLmanager from Debian 8 to Centos 7.

Note:

The product versions on the servers must match. For example, if you have a BILLmanager Corporate version on your old server, the new server should also have BILLmanager Corporate.

The product version on the new server must not be lower than on the old server.

To migrate BILLmanager:

Go to BILLmanager on the old server and configure the backup: Tools → Backup .
Press Start to create a backup.
Select the backup you created and press Download to save the archive to your computer.
Go to BILLmanager on the CentOS 7 server and set up backup in Tools → Backup .
Press the Upload button and select the backup saved in step 3.
Select the uploaded backup and press Restore .
Wait until the recovery operation is complete.
To make the BILLmanager control panel available on the new server, specify the IP address of the server in the ihttpd configuration file /usr/local/mgr5/etc/ihttpd.conf .
Restart the control panel. In the server terminal, run the command below:
```
/usr/local/mgr5/sbin/mgrctl -m billmgr exit
```

Note:

Rates, templates of messages and documents created by you are stored in the BILLmanager database and will be transferred with it.

Step 3. Migrate custom XML files, addons and plugins

If you created custom XML files, addons and plugins, to migrate them to the new server:

On the new server, create the directory /usr/local/mgr5/backup/ if it does not already exist.
Move the contents of the directories from the old server to this directory:
- /usr/local/mgr5/etc/xml/ — directory with custom XML files;
- /usr/local/mgr5/addon/ — directory with custom addons;
- /usr/local/mgr5/src/ — directory with custom plugins.

Copy the contents of the directories, skipping the existing files:

cp -n /usr/local/mgr5/backup/xml/* /usr/local/mgr5/etc/xml/

cp -n /usr/local/mgr5/backup/addon/* /usr/local/mgr5/addon/

cp -n /usr/local/mgr5/backup/src/* /usr/local/mgr5/src/

Reassemble and install the necessary plugins. Read more in Lower-level interaction, C++ plug-ins .

Step 4. Move the custom showroom

To move your custom storefront from the old server to the new one, move the /usr/local/mgr5/skins/showroom directory to the new server.

Step 5. Run installation of missing packages

After moving the database, run installation of all missing packages of service processing modules, payment systems and mail gateways on the new server.

To install the missing packages, run the command:

/usr/local/mgr5/sbin/mgrctl -m billmgr fix.modules

Step 6. Assign the license to the new server

After migrating the panel to the new server, go to your client area, where you have ordered the license.
Delete the trial license from your client area.
In the paid license settings, enter the IP address of the new server.
If you change the product version, change the license plan in your client area. Check the conditions and cost of switching to the new tariff with the selling company.
Update the license file. Go to the control panel, open Help → About program , and press Update license . Alternatively, download the license manually with the command:
```
/usr/local/mgr5/sbin/licctl fetch billmgr
```

Step 7. Disable the maintenance mode

To disable the maintenance mode, delete the /usr/local/mgr5/etc/billmgr.DoNothing file.