Summary

A Grid DS-Client is a configuration of several DS-Client nodes working together with a common external PostgreSQL DS-Client database to balance the processing load in a high availability environment. From the DS-System perspective, the Grid DS-Client is a single DS-Client with the same registration information on each node. The private and account encryption keys are the same for all DS-Client nodes in a grid.

Issue

Upgrading a 13.3 or 14.0 Grid DS-Client configuration to 14.1 will break the grid configuration because the installation will automatically install an embedded PostgreSQL database on the main node in the grid and will not update the existing external PostgreSQL database. This issue affects manual and auto-upgrades.

The installation of the DS-Client software on the first DS-Client node will migrate (copy) the database from the external PostgreSQL host to an embedded PostgreSQL database on the node, which then becomes the MasterHostName. This means that the first node installed will host the Grid DS-Client database. Subsequent nodes must point to the main node configuration file (dsgridconfig.conf) that was generated by the standalone DS-Client installation

Note: When performing a new installation of the v14.1 Grid DS-Client, an embedded database will automatically be created on the first node. You must use the same workaround provided below to successfully configure the grid to an external database..

Workaround

To reconfigure a Grid DS-Client to use an external PostgreSQL database, you must perform the following manual upgrade procedure (don't perform an auto-upgrade) to get the 14.1 Grid DS-Client to use an external PostgreSQL database.
 

  1. Using the DS-User application, log on to each Grid DS-Client.
  2. On the Setup menu, click Configuration.
  3. Click the Advanced Tab.
  4. Select the Miscellaneous category.
  5. Select the AllowAutoUpgrade parameter and set the value to No.
  6. Stop DS-Client Service on all nodes.
  7. Run the v14.1 installation on the first node in the grid. When it completes don't start the DS-Client service or Launch the DS-User GUI.
  8. Connect to the external PostgreSQL database host and PostgreSQL database engine hosting the DS-Client database and manually apply the following database patches (found in the DS-Client Installation directory in the db folder):     
    • v13.3 HF 14 (327 - 331)
    • v14.0 HF 7 (328 - 331)    
  9. Open the Services window and stop and disable the DS-Client-PostgreSQL service.
  10. Run regedit to modify the following registry entry:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DS-Client\Parameters

  1. Modify the following parameters:
  • DatabaseHost - Change to the IP of external the database host.
  • DatabasePort - Change to the original external PostgreSQL database port 5432.
  • EmbeddedPgVersion - Change to the version of the external database.
  • DependOnService-Remove the entry DS-Client PostgresSQL
  1. Go to default installation path of the DS-Client (e.g. C:\Program Files\CloudBackup\DS-Client), locate the file dsgridconfig, and the following parameters using a text editor such as Notepad:
  • MasterHostName=
  • DBPort=5432
  1. Save the changes and copy this file to the second node or any other nodes you may have in the grid configuration.
  2. Run the v14.1 installation on the other nodes in the grid. When it comes to the database section use the Grid Configuration file (dsgridconfig).
  3. When finished, restart the DS-Client service.
  4. Start the DS-Client service on the first node in the grid. The grid will be fully functional with the external database using Asigra 14.1.
  5. Go to the Setup Menu, Configuration, Advanced Tab, Admin Category and define the DSCDBDumpPath point to a location on the External Database server, also define under the Miscellaneous Category the LogArchivePath to an external server as well, lastky on the  Setup Menu, Configuration, Parameters, Local Storage Path and point to an external server as well.