How to backup and restore SquaredUp DS for Azure

Backing up DS for Azure

You may need to connect to your SquaredUp server (How to connect to your SquaredUp server).

We recommend you stop the SquaredUp DS application pool (How to check and modify the application pool identity) and then backup the entire SquaredUp folder.

If you wish you can just backup the SquaredUpv[Version Number]\User folder, as this is where your specific dashboards and settings are located. Within the User folder the Packages folder contains your user-published dashboards and perspectives and Configuration folder contains your SquaredUp DS configuration settings.

Restoring SquaredUp DS

These steps are for restoring the whole of SquaredUp. For information about restoring individual dashboards and perspectives see Recycle Bin

1. If you wish to install the latest version of SquaredUp DS:
   Download the latest version of SquaredUp DS and run the installer.

   Get the latest version of SquaredUp DS for Azure

   How to install SquaredUp DS for Azure using the installer
   If you want to redeploy the same version of SquaredUp DS:
   Run the 'Deploy SquaredUp DS for Azure' tool on the Windows Start menu,
2. Log on to SquaredUp DS and complete the setup to configure SquaredUp DS, such as activating your license and Azure AD authorization. If you need an additional activation please contact SquaredUp Support
3. In IIS stop the SquaredUpv[Version Number] application pool.
4. Restore the SquaredUpv[Version Number]\User folder.
5. If your content and configuration is being restored to a server in a different domain, then the following steps will need to be taken:
   1. Run the PowerShell script below to identify the domain name string Dashboard Server is expecting:
      Copy

      $domainName = [System.DirectoryServices.ActiveDirectory.Domain]::GetComputerDomain().Name
      
      $domainNameParts = $domainName.Split('.')
      
      $part1 = $domainNameParts[0]
      
      Write-Output $part1

   2. In a text editor that is running as Administrator, open the restored cryptography.json file located in the User\Configuration folder.
   3. Add in a recovery-domain-key key and set its value to be the output of the PowerShell script. This value is case-sensitive, so it needs to match the casing from the PS Script output. For example:
      Copy

      {
      
        "recovery-domain-key": "contoso"
      
      }

   4. Save the file. If the target instance is configured for High Availability then stop the app pools of any other servers in the HA group, take a backup copy of the .index file in the shared folder and then delete it from the shared folder.
   5. Start the Dashboard Server app pool on the instance the files were restored to. Open the Dashboard Server instance in a browser. The WebAPI providers and other encrypted content from the original instance should be present and the recovery-domain-key configuration key will be automatically removed by DS once the restore and re-encryption of the encrypted content has been completed.
6. Restart the SquaredUpv[Version Number] application pool.

If your content and configuration is being restored to a server in the same domain as the original server and is in HA mode, then the only additional actions needed are to stop the app pools on any other servers in the HA group and to delete the shared .index file (see Backing up and restoring the HA share). A new shared .index file will be created in this location and populated with the content from the restored files.

If the target server is in the same domain as the original server and is not in HA mode then no additional action is needed. The restored, encrypted content will be available in Dashboard Server.

Backing up and restoring the HA share