===== [V9] FAQ: How to migrate AhsayCBS onto a new server? ===== Article ID: 9307
Reviewed: 2022-01-10

Product Version:
AhsayCBS: 9.1 to 9.x
OS: Windows, Linux ===== Description ===== This article contains information on how to migrate your AhsayCBS application onto a new hardware (Windows to Windows, or Linux to Linux). Migration from/to different OS platform is not supported (AhsayUBS to Windows, Windows to Linux, etc), and may require configuring new settings. ===== Steps to setup new CBS host ===== To migrate your AhsayCBS application to a new server, refer to the following steps:

Value of %Applicaton Home% for various operating system:

(Windows) C:\Program Files\AhsayCBS
(Linux) /usr/local/cbs

Document all configuration settings of your current AhsayCBS server (e.g. email settings, policy settings, replication settings ... etc).
It is recommended you install the same CBS version as your current AhsayCBS server.
However, if you did not retain a copy of that version's installer, then Download the latest version of AhsayCBS (.exe or .tar.gz according to the new server's operating system platform) by Clicking Here. (It is recommended you first do an in-place upgrade of your current CBS with the new version you just downloaded, before continuing to migrate the CBS settings.)
Install AhsayCBS on the new server.

Note: For AhsayCBS installation on Windows, update the Windows Service's Log On setting if necessary.

Do not edit the Windows Log On setting of the NFS Service (Ahsay Systems Corporation) Service.
Shutdown the AhsayCBS service on the current production (original) AhsayCBS server.
- (Windows) Control Panel > Administrative Tools > Services > Ahsay Cloud Backup Suite
- (Linux) Run the script file at [ %Applicaton Home% / bin / shutdown.sh ]

CBS Configuration Migration

1. Copy the configuration files to, or manually re-configure the setting for the new AhsayCBS server.

For migration to a the same OS platform (e.g. Windows to Windows, or Linux to Linux) and, on exact same version (e.g. AhsayCBS version 9.1.0.50 to version 9.1.0.50) or different CBS Version (e.g. from AhsayCBS version 8.5.4.86 to new host running version 9.1.0.50), you can copy the configuration files over to the new server. This will preserve Sub-Admin ID#, Predefined Destination ID#, SSL Certificate, 2FA settings, User Profiles, etc.

(If different CBS Version, it is recommended you first do an in-place upgrade of your current CBS with the new version, before continuing to migrate the CBS settings.)
- a. Shutdown the AhsayCBS service on the new AhsayCBS server.
  - (Windows) Control Panel > Administrative Tools > Services > Ahsay Cloud Backup Suite
  - (Linux) Run the script file at [ %Applicaton Home% / bin / shutdown.sh ]
- b. Copy the following directories from the existing AhsayCBS to the new AhsayCBS server.
  
  %Applicaton Home%\conf
  
  Note: AhsayCBS migration procedure is only applicable when the current and new hardware run same OS platform (Windows to Windows, or Linux to Linux); we do not support cross-platform migration (Linux to Windows, AhsayUBS to Linux, etc).
  
  Also, if you have not shutdown the existing AhsayCBS server, you may be in violation of licensing terms by running two servers with the same license. Only one license key may be applied to any one active CBS server. From the CBS Web Console, access the License page to verify.
- c. To preserve existing Policies and User Groups, copy the following directories from the existing AhsayCBS to the new AhsayCBS server.
  
  %Applicaton Home%\system\obs\policies
- d. To preserve existing logs, copy the following directories from the existing AhsayCBS to the new AhsayCBS server.
  
  %Applicaton Home%\logs
  %Applicaton Home%\system
For migration to a different OS, you will need to manually re-configure the server settings. Warning: Your Sub-Admin ID and Predefined Destination settings may receive new ID# and break existing User Profile or Policy Group assignment.
- a. Login to the AhsayCBS web console of the new server.
- b. Manually re-configure all settings for the new AhsayCBS server, matching the settings found on your current AhsayCBS server.
  
  Important: Do not replace the configuration files from the old to new server directly, configuration files from a old CBS host platform (e.g. AhsayUBS) is not fully compatible with the new CBS host (e.g. Windows).
- c. After you have manually configured the new CBS to match, you can copy from the original CBS the "%Applicaton Home%\conf\users.xml" and the "%Applicaton Home%\system\obs\policies\*.*", to the new CBS server. Warning: Predefined Destination ID# and Sub-Admin ID# may be different; further manual reconfiguration may be required to successfully migrate your CBS to new platform.

2. Copy the System Home and User Home to the new AhsayCBS server. [AhsayCBS Service should be stopped]
- For System Home and User Home directories located on local volumes, you can copy the System Home and User Home over to the new server:
  - a. Copy the System Home folder from the existing server to the new AhsayCBS server.
  - b. Login to the AhsayCBS web console (of the new AhsayCBS).
  - c. (If necessary) Update the System Home setting under System Settings > Basic > General > System Home to where you have copied the System Home folder to.
  - d. With the AhsayCBS Service stopped on both servers, Copy the User Home folder from the existing server to the new AhsayCBS server.
    Note: Copy the entire User Home to the new server if the AhsayCBS will be migrated at once.
    
    Alternatively, copy each backup account one-by-one if the migration will be performed in stages:
  - e. (If necessary) Update the User Home setting under Backup / Restore > Basic > General > User Home to where you have copied the User Home folder to.
- For System Home and User Home directories located on a network volume, ensure that the network System Home and User Home are accessible on the new server:
  - a. Make sure that the network System Home and User Home are accessible by the new AhsayCBS server.
  - b. Login to the AhsayCBS web console of the new server, check on the System Home setting under System Settings > Basic > General > System Home, confirm if it is configured to the correct network volume.
  - c. Check on the User Home setting under Backup / Restore > Basic > General > User Home, confirm if it is configured to the correct network volume.
3. Check on the AhsayCBS settings afterward.
- Confirm if the License Details under the AhsayCBS web console at System Settings > License > General.
- Confirm if all backup users are displayed under the AhsayCBS web console at Backup / Restore > Users, Groups, Policies > Backup User.
- Re-configure the server settings if necessary.
- If branded, then Rebuild Clients

4. Change in CBS Backup Server FQDN?

Important: For cases where the backup server's FQDN is changed after the migration, and you cannot reuse the old FQDN, the client agents must be re-configured to point to the new CBS FQDN on each client manually. There is no method to push the change.

Show advanced option