How to migrate Cayosoft Guardian installation to a new server

This article describes how to migrate your Cayosoft Guardian installation to a new server. This article applies to a scenario where the Cayosoft Guardian history database is located on an external SQL server and a new installation will continue to use that same DB.

Migrating Change History and Configuration

1. Install Cayosoft Guardian on a new server following this article: Installing Cayosoft Guardian.
2. (For Forest Recovery only) On the old server, open web portal and go Forest Recovery > Agent Management.
3. (For Forest Recovery only) Select all agents and press Uninstall.
4. Stop the Cayosoft Guardian service on the source and target servers.
5. Copy files from C:\Program Files\Cayo Software\Guardian\keys on the source server to the same location on new server. The installation path might differ in your environment.
6. (Applicable if a configuration database is located on a built-in localDB SQL server.) Copy files from C:\ProgramData\Cayo Software\Guardian\database on the source server to the same location on new server.
7. Modify C:\Program Files\Cayo Software\Guardian\appsettings.json, if you have previously modified the appsettings.json file manually and need to keep these modifications.
8. Start the Cayosoft Guardian service on the target server.
9. (Applicable if both configuration and history database are located on an external SQL Server.) Login to Guardian Web UI and navigate to Settings > System Databases.
10. Select a configuration database and open Properties.
11. Click Switch to existing configuration.
12. In the opened dialog, specify parameters of the previously used Cayosoft Guardian database:
    • SQL Server name like Host\Instance
    • Database name
    • Select SQL Server authentication, if needed. If you created a machine SQL account, leave the checkbox unselected.
13. Select I confirm this database is not used by another Guardian Service if the target database was copied or moved from another installation of the Cayosoft Guardian. This Guardian Service would take ownership over this copy of the database even if it contains information about the previous owner.
14. In the Switch databases menu, select Configuration database and associated history database.
15. Click Yes to complete the operation.
16. Wait until the service restarts.

17. After the service restart, log into the Cayosoft Guardian web portaI and navigate to Settings > Service Settings > Network Settings.

18. In the Public Cayosoft Guardian Hostname, enter the new server’s hostname (or FQDN) that clients will use going forward.

19. Save changes and allow the service to reload settings.