User Tools

Site Tools



Ahsay Backup Software

Backup Set Types

Supported Storage

Features in OBM / ACB

Features in CBS

Brand and Customize



Performance Testing

FAQs and Known Issues

Can't Find What You Need?


[V9] FAQ: How to start AhsayCBS (in replication mode) as a Backup Server?

Article ID: 9339
Reviewed: 2022-08-22

Product Version:
AhsayCBS: to 9.x
OS: All platforms


This article contains instruction on how to start an AhsayCBS Replication Receiver role as a Backup Server (e.g. AhsayCBS in Backup Server mode).


  • It is assumed that the first cycle of replication from the Sender to the Receiver had been completed successfully. Replication allows you to recover most of your Backup Server environment in the event your CBS Backup Server suffers disaster, allowing you to convert any replicated data on the Replication Receiver, to serve as the replacement Backup Server. Some data loss is expected if the Backup Server had not yet finished replicating new backup data to the Replication Server at time of disaster; as such Replication is not a substitute for proper CBS to CBS migration to a new host if both servers are still operational.
  • Cross platform conversion is not supported. Example, Windows CBS Backup Server replicating to AhsayUBS Replication Receiver.
  • It is assumed your CBS Backup Server and Replication Receiver both have identical installation paths. Example "C:\Program Files\AhsayCBS" for both servers. If any one server has different paths, this may fail your conversion.
  • Both CBS Backup Server and CBS Replication Receiver ran matching versions and hotfixes. The CBS Replication Server must not be running a lower CBS version than your Backup Server; if this is your environment you'll first upgrade to matching CBS version.
  • The procedures outlined below assume CBS Replication Receiver host is receiving replication from a single CBS Backup Server.
  • It is assumed your AhsayCBS Backup Server is offline and no longer operational, and will no long return to service in near future.
  • It is assumed you are familiar with AhsayCBS UI and experienced.

  • Steps

    Converting your CBS Replication Receiver into Backup Server role is relatively simple. You'll need to know where the replication is storing the replica, and from there the procedures are straightforward.

    Refer to the following steps to convert your AhsayCBS Replication Receiver mode to Backup Server role:
    (The instructions are demonstrated for Windows using Ahsay default installation path, but similar steps are used for Branded CBS or other platforms (e.g. Linux), substitute the example with your values.)

    1. Before you convert your CBS Replication server, check on the CBS Receiver's Setting.
      Make note of the Default Home Directory and Replication Home settings.

        1. On the AhsayCBS Replication Receiver server, login to the AhsayCBS web console.

        2. From CBS Main Menu under Replication, select Accepting Data.

        3. Document the Default Home Directory value, and the Replication Home value(s).

          Default Home Directory is where the Replication Sender's System Home, User settings, and Configuration settings are stored (in the app folder).

          Replication Home is the location where Users' replicated backup data and logs are stored (the User Home directory of the Backup Server).

          For example purpose used within this document, the following settings will be used:

              Default Home Directory is set to C:\Program Files\AhsayCBS\system\rps\rcvshome\receiver
              Replication Home is set to E:\Receiver Home
              AhsayCBS Installation directory is set to C:\Program Files\AhsayCBS\

    2. Prepare for the AhsayCBS Replication Receiver conversion.

        1. Shutdown the AhsayCBS service.

        2. Shutdown the AhsayCBS NFS service.

        3. Rename the CBS Receiver's conf, system, user directories from your CBS Receiver's Installation Home (e.g. "C:\Program Files\AhsayCBS\") to preserve.

          Example: rename from: "C:\Program Files\AhsayCBS\conf" , to "C:\Program Files\AhsayCBS\conf.rps"

          (Note: In later steps, the system directory was renamed, so adjust your notes accordingly.)

    3. Extract the replicated CBS config files to the corresponding location. (Note: Confirm timestamp is recent and not outdated, as this will be the active Backup Server configuration soon.)

      • Extract the content of the file from the Default Home Directory to the AhsayCBS installation conf folder.
        Note: The "" will contain the CBS Backup Server's setting at time of replication (including License). If users were newly added, modified, or other setting changes; consider those reverted back to time of replicated settings.

        Extract To
        %Default Home Directory%\app\conf\ %AhsayCBS Install Home%\conf\*
        C:\Program Files\AhsayCBS\system.rps\rps\rcvshome\receiver\app\conf\ C:\Program Files\AhsayCBS\conf\*

    4. Move the replicated System Home to the corresponding location. (Optional: Copy instead of Move)

      • Move the replicated System Home from the Default Home Directory to the AhsayCBS System Home path.

        Move To
        %Default Home Directory%\app\system\* %AhsayCBS System Home%\*
        C:\Program Files\AhsayCBS\system.rps\rps\rcvshome\receiver\app\system\* C:\Program Files\AhsayCBS\system\*

        Note: If you are planning to change the System Home location, copy the replicated System Home to the new System Home location instead.

    5. Prepare the replicated User Home to the matched location.

      • Depending on how you configured Replication, your procedure may vary to this step. If you have multiple Homes, you may need to repeat.
        If you had preplanned your initial setup of Replication and made your paths align, then this step may already completed.

        Referring to our example settings, we replicated to "E:\Receiver Home", but the CBS Backup Server settings point User Home path to "C:\Program Files\AhsayCBS\user", therefore we need to align the directory structure to match the CBS Backup Server's User Home path values. However, it is also possible to reconfigure AhsayCBS to point to "E:\Receiver Home" as the new User Home on this CBS server once converted; this is an option instead of transferring files around, but you'll need to remove the old path from settings if it no longer exist.

        Move the replicated User Home from the Replication Home to the expected AhsayCBS User Home folder path. (Optional: Copy instead of Move)

        Move To
        %Replication Home%\%username% %AhsayCBS User Home%\*
        Important: Do not copy over the folder in YYYY-MM-DD-hh-mm-ss format.
        E:\Receiver Home\* C:\Program Files\AhsayCBS\user

        Note: If you are planning to change the User Home location, move the replicated User Home to the new User Home location instead, then update the settings from CBS UI.
        Note: If you have User Home paths pointing to network shares, then they should be accessible too by this CBS, its User Home settings are inherited by the CBS Backup Server configuration.

    6. Complete the AhsayCBS conversion to Backup Server.

        1. Update your Network and/or DNS settings to reflect the changed server role.

        2. Startup the AhsayCBS service.

        3. Startup the AhsayCBS NFS service.

        4. Login to the AhsayCBS web console, confirm on the settings.

          • Confirm on the system settings. Under System Settings, select Basic or Advanced.

            If necessary, Modify the System Home setting under System Settings > Basic (e.g. if you had relocated the replicated System Home to a new location in the previous step).

          • Confirm on the user and policy settings. Under Backup / Restore, select Users, Groups & Policies.

            If necessary, Modify the User Home setting under Backup / Restore > Basic (e.g. if you had relocated the replicated User Home to a new location in the previous step).

          • Confirm the License settings. Under System Settings, select License.

            Your CBS Backup Server's Licensee Name and License Key should already be applied. Press Update button.

          • Disable Replication Sender. Under Replication, select Sending Data.

            Your CBS Replication Receiver no longer exists as it was converted to be Backup Server, therefore disable Replication Sender.

    7. Note: For AhsayCBS installation on Linux platforms, the conversion procedure contained above are the same except all directory paths are in the Linux convention.

    Additional Resources

    Video demonstration: How to Promote AhsayCBS Replication to Backup Server Role

    It is recommended you setup a lab, to practice the conversion, before disaster strikes. If you need assistance, Ahsay Professional Service is available to assist with the conversion, or to help setup you lab environment for your personal testing. Contact us!


    cbs, rps, replication, receiver, replicate, start, convert, change, converting, modifying, modify, roles

    public/version_9/cbs/9339_how_to_start_ahsaycbs_in_replication_mode_as_a_backup_server.txt · Last modified: 2022/08/24 13:42 by kirk.lim

    Page Tools