Table of Contents

[V7] FAQ: How to migrate AhsayCBS onto a new server?

This article only applies to Ahsay software version 7

Article ID: 5215
Reviewed: 2019-04-23

Product Version:
AhsayCBS: 7.3.0.0 to 7.x
OS: All platforms

ATTENTION 1st January, 2022: v7 officially End-of-Life [details]

Description

This article contains information on how to migrate your AhsayCBS application onto a new hardware (Windows to Windows, or Linux to Linux).

Steps

To migrate your AhsayCBS application to a new server, refer to the following steps:

Value of %Applicaton Home% for various operating system:

  1. Document all configuration settings of your current AhsayCBS server (e.g. email settings, policy settings, replication settings ... etc).


  2. Download the latest version of AhsayCBS (.exe or .tar.gz according to the new server's operating system platform) by Clicking Here.


  3. Install AhsayCBS on the new server.

    Note: For AhsayCBS installation on Windows, update the Windows service log on setting if necessary.


    Do not edit the log on setting of the Ahsay Cloud Backup Suite NFS Service (for AhsayCBS version 7.9.0.0 or above).



  4. Shutdown the AhsayCBS service on the original AhsayCBS server.

    • (Windows) Control Panel > Administrative Tools > Services > Ahsay Cloud Backup Suite
    • (Linux) Run the script file at [ %Applicaton Home% / bin / shutdown.sh ]

    Important: If you are performing the migration in multiple stages (e.g. migrating account-by-account to the new server), skip to the next step.


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

    • For migration to an exactly same version (e.g. AhsayCBS version 7.9.0.0 to version 7.9.0.0)

      • 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 ]

      • Copy the following directories from the existing AhsayCBS to the new AhsayCBS server.

        %Applicaton Home%\conf
        %Applicaton Home%\conf\Branding

        Note: 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.


      • To preserve existing logs, copy the following directories from the existing AhsayCBS to the new AhsayCBS server.

        %Applicaton Home%\logs
        %Applicaton Home%\system


      • 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


      • Startup the AhsayCBS service on the new AhsayCBS server.

        • (Windows) Control Panel > Administrative Tools > Services > Ahsay Cloud Backup Suite
        • (Linux) Run the script file at [ ${Install-Home} / bin / startup.sh ]


    • For migration to a different version (e.g. AhsayCBS version 7.7.0.0 to version 7.9.0.0)

      • Login to the AhsayCBS web console of the new server.

      • Manually re-configure all settings for the new AhsayCBS server, according the settings documented previously in Step 1.

        Important: Do not replace the configuration files from the old to new server directly, configuration files from a previous version is not fully compatible with a newer version of the software.


  6. Copy the System Home and User Home to the new AhsayCBS server.

    • For system home and user home located on local volumes:

      • Copy the system home folder from the existing server to the new AhsayCBS server.

      • Login to the AhsayCBS web console (of the new AhsayCBS).

      • (If necessary) Update the system home setting under System Settings > Basic > General > System Home to where you have copied the system home folder to.


      • 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.

        For example, copy:

        %Existing_Location%\UserHome\%username1%
        %Existing_Location%\UserHome\%username2%
        ...

        to

        %New_Location%\UserHome\%username1%
        %New_Location%\UserHome\%username2%
        ...


      • (If necessary) Update the User Home setting under Backup / Restore > Basic > General > System Home to where you have copied the User Home folder to.


    • For system home and user home located on a network volume:

      • Make sure that the network system home and user home are accessible by the new AhsayCBS server.

      • 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.

      • Check on the user home setting under Backup / Restore > Basic > General > System Home, confirm if it is configured to the correct network volume.


  7. 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.

Important: For cases where the backup server hostname is changed after the migration, the server hostname setting on the client agents must be re-configured on each client manually.

Open the AhsayOBM / ACB user interface, click Show advanced option, to update the Backup Server setting.

Keywords

obs, migration, move, relocate, re-locate, hardware