GreenRADIUS version 4.X is equipped with a tool to migrate users, tokens, and settings from v22.214.171.124. This document describes how to use the migration tool, detailing the steps to perform. It also covers how to deal with certain configurations not covered by the migration tool.
The following configuration is migrated with this tool:
- Database tables containing general configuration, user-token assignments, user information, domain information, directory server information, RADIUS clients, token states, token secrets, etc.
- License file
- RADIUS configuration
Additionally, the following configuration can optionally be migrated as well:
- Onboard firewall configuration
- Onboard OpenLDAP server configurations
- Network configuration migration, including DHCP settings and (if applicable) static IP address
- Time zone
- The GreenRADIUS instance to migrate from must be running GreenRADIUS v126.96.36.199
- A fresh GreenRADIUS v4.X must be deployed as the migration
- Make sure temporary network settings are configured. Follow our network configuration guide.
- The v4.X instance must be able to reach the v188.8.131.52 instance
- The Docker containers auto-start on boot. If the containers have been stopped manually, they need to be restarted before beginning the migration.
- For on-board OpenLDAP server configuration migration, a resolvable hostname/FQDN
must be configured in GreenRADIUS v4.X as follows:
- Log in to GreenRADIUS.
- Navigate to Global Configuration→Certificate
- Set the value in the Server Hostname/FQDN field.
- Under the Create Certificate tab, enter a common name matching the hostname/FQDN configured in the above step. Click the Create and Install button.
Once the Docker containers are running, invoke the migration script from the command line:
$ cd /home/gradmin/GRS-Migration-Tool/ $ sudo python migration.py
This will produce a dialog of migration options like this:
The migration tool prompts for the hostname or IP address of a v184.108.40.206 instance.
It will then request an administrator username and password of a command-line user on the v220.127.116.11 instance.
You will be prompted as to whether you wish to migrate on-board firewall configuration, on-board LDAP configuration, hostname, network, and timezone settings.
The migration process may take some time. When it is finished, a completion message will be displayed:
If your v18.104.22.168 instance was configured not to use DHCP, then the v4.X instance will try to use its IP address the next time it starts (if you selected to migrate the network configuration.) To prevent the GreenRADIUS instances from colliding over the IP address, you should shut both down and then reboot only the v4.0 instance without rebooting the v22.214.171.124 one.
After reboot, you will find that most settings from your v126.96.36.199 instance have been migrated.
IMPORTANT NOTE: If there are multiple servers configured in synchronization, one GreenRADIUS v4.X instance should be deployed for each v188.8.131.52 instance and migration from each v184.108.40.206 instance should be done to the corresponding v4.X server instance. Once the migration is done, the server entries in the synchronization configuration should be deleted and re-added on each of the v4.X server instances.
Additionally, in some cases, the network configuration is not migrated.
In such cases, manually configure the network by following our network configuration guide.
Not all settings are migrated. Please be sure to check the following settings and make changes as necessary:
- YubiKey OATH-HOTP OTP length (in case YubiKeys programmed in OATH-HOTP mode are being used, this setting is found under Global Configuration→General)
- User portal OATH algorithm for soft tokens
(in case Google Authenticator or similar soft tokens are being used, a
TOTPis recommended, this setting is found under Global Configuration→User Portal)
- Temporary tokens must be re-established for those users assigned temporary tokens
- LDAP server certificates (in the Directory Server tab of the GreenRADIUS domain) if you are using secure connection (over port 636)
- Local web admin console user accounts and settings
© 2021 Green Rocket Security Inc. All rights reserved.