#Manual Installation for Windows Gateway

Before installation, note the following:

• For Azure VM and Azure Storage, the gateway must be installed on a VM within the same tenant as the protected VMs/blob containers/file shares configured in the backup scope.

• It’s recommended to install the gateway in the same zone/region as the protected instances configured in the backup scope for optimal performance.

• It is recommended that the instance where the gateway is installed runs Windows Server 2019 Datacenter-x64 Gen1 as its operating system, with a configuration of 4 CPU cores and 16 GB of memory.

• For better performance, you can use different gateways for different backup scopes and use multiple gateways for one backup scope as needed.

• For Azure PostgreSQL, the PostgreSQL client is required to enable PGDUMP to activate the gateway. For details , refer to Install PostgreSQL Client.

Follow the steps below to install the CAP Gateway:

1. Select a gateway and click Get package.

2. In the Get package panel, follow the steps below:

   1. In the Install PostgreSQL client step, download and install the PostgreSQL client to enable PGDUMP to activate the gateway. For details , refer to Install PostgreSQL Client.

   2. In the Get package step, copy the SAS URL for package to your clipboard.

   3. Locate the Azure VM/Azure Storage VM/Azure SQL database/Amazon EC2 instance/ SQL Server database/PostgreSQL server/Cosmos DB/Google VM instance/Google Cloud Storage buckets where the gateway will be installed, then execute the following command using Windows PowerShell to download the installation package to your instance/VM/database/bucket. Replace ‘CAPGateway.zip’ in the command with the actual downloaded package name and replace ‘sas url’ with the SAS URL copied in the Get package step.

      wget -O CAPGateway.zip "{package sas url}"
      NOTE

      The ‘O’ in the command is the uppercase letter 'O', not the number zero '0'.

   4. In the SAS URL for configuration file/Signed URL for configuration file step, copy the passphrase and URL for the configuration file to your clipboard.

      • To protect Microsoft Azure service, Amazon service, self-managed SQL Server, Azure PostgreSQL, or Cosmos DB, copy the SAS URL and passphrase to your clipboard.

        

      • To protect Google Cloud service, copy the Signed URL and passphrase to your clipboard.

        

3. After downloading, execute the following command line to extract the package contents to the ./capwin directory.

   Expand-Archive -Path "CAPGateway.zip" -DestinationPath ".\capwin" -Force
   NOTE

   • Before running the command, ensure the ./capwin directory exists. You can verify its existence with the following command:mkdir -p./capwin.
   • If the ./capwin directory does not exist, you can execute the following command line to create one:New-Item -ItemType Directory -Path ".\capwin" -Force.

4. Execute the following command line to run the install.sh script. Replace ‘passphrase’ and ‘url for configuration file’ in the command with actual values copied from the Get package panel.

   .\capwin\install_win.ps1 -p "{passphrase}" -s "{url for configuration file}"

   • To protect Microsoft Azure service, Amazon service, self-managed SQL Server, Azure PostgreSQL, or Cosmos DB, replace ‘url for configuration file’ with the SAS URL for configuration file copied from the Get package panel > SAS URL for configuration file step.

   • To protect Google Cloud service, replace ‘url for configuration file’ with the Signed URL for configuration file copied from the Get package panel > Signed URL for configuration file step.

#Update a CAP Gateway

If you need to update your CAP Gateway configurations, such as the passphrase and url for configuration file, follow the steps below:

1. Execute the following command line to download a new package.

   wget -O CAPGateway.zip "{package sas url}"

2. Execute the following command line to unzip the downloaded package.

3. Expand-Archive -Path "CAPGateway.zip" -DestinationPath ".\capwin" -Force

4. Execute the following command line to install the new package. Replace ‘passphrase’ and ‘url for configuration file’ in the command with actual values copied from the Get package panel.

   .\capwin\install_win.ps1 -p "{passphrase}" -s "{url for configuration file}"

   • To protect Microsoft Azure service, Amazon service, or self-managed SQL Server, Azure PostgreSQL, or Cosmos DB, replace ‘url for configuration file’ with the SAS URL for configuration file copied from the Get package panel.

     

   • To protect Google Cloud service, replace ‘url for configuration file’ with the Signed URL for configuration file copied from the Get package panel.

     

#Verify Checksum

After downloading the installation package, you can run the following command to verify its checksum. Compare the result with the hash value displayed in the Get package panel to ensure the checksum is correct. Replace ‘CAPGateway_SerialNumber.zip’ in the command with the actual downloaded package name

Get-FileHash -Path .\CAPGateway_SerialNumber.zip -Algorithm SHA256

#Uninstall a CAP Gateway

If you want to uninstall the CAP Gateway, locate the unzipped package folder, and execute the following command line:

.\capwin\uninstall_win.ps1

#Install PostgreSQL Client

To enable the gateway for Azure PostgreSQL, ensure that the PostgreSQL client is installed. Follow the steps below to download and install the PostgreSQL client.

1. Access the PostgreSQL download page.

2. Download the latest PostgreSQL version.

3. Follow the instructions in Installing PostgreSQL on Windows to complete installation. Note that in the Select Components step, only the Command Line Tools option is required.