How to backup and restore SquaredUp DS Standalone

If you are using SquaredUp DS with high availability (HA) see Enabling High Availability.

Backing up DS Standalone

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

    How to install SquaredUp DS Standalone using the installer
    If you want to redeploy the same version of SquaredUp DS:
    Run the 'Deploy SquaredUp DS Standalone' 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. 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:
      $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:
      {
      
        "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

Backup SquaredUp DS on each server as normal (How to backup and restore SquaredUp DS Standalone). No additional actions are required: Any SquaredUp server can rebuild the content of the network share from its local disk data. So backing up individual SquaredUp DS instances (and not the network share) is sufficient.

If the share does have to be recreated, ensure you configure permissions on the share first:

To restore the files to a new or empty HA share run the HA configuration steps from any SquaredUp server, to copy the files from this server to the share. See Enabling High Availability

To restore to an existing share folder you must delete the file SquaredUp_ds_[version].index, if it exists, in order for the restore to proceed. Restoring will then recreate the SquaredUp_ds_[version].index file on the share.

Was this article helpful?


Have more questions or facing an issue?