How-to Install the Cohesity Helper App (Windows)
  • 22 Jun 2022
  • Dark
    Light

How-to Install the Cohesity Helper App (Windows)

  • Dark
    Light

Article Summary

Introduction

The Cloud Data Protection platform requires the installation of a Helper App to facilitate several backup configurations such as SQL Databases, Exchange Servers, and Physical Machines. This agent allows Cloud Data Protection to integrate natively with the previously mentioned software to ensure optimal backups are performed.

System Requirements

Please ensure the VM has up-to-date VMware Tools installed and network connectivity open on TCP Ports 111, 443, 445, 902, 2049, 3260, 5986, 50051, and 8080. Please contact Expedient to add a static route to the appropriate Cohesity cluster. By default, this external communication is blocked.

Procedure

Download the Cohesity Helper App

  1. Log in to the respective Cloud Data Protection system
  2. From the navigation bar at the top of the page, select the Protection → Sources tab
  3. Open the add sources menu and then select the Download Cohesity Agent button from the bottom of the menu.
  4. Select Windows via the blue arrow on the right
  5.  Move downloaded agent to the server requiring Cohesity Helper App

 Install via the Setup Wizard

  1. Login to the server to which you wish to install the agent software on
  2. Run the downloaded or copied executable
  3. Select Next
     
  4. If you are performing an upgrade, select Yes. Otherwise, you may skip this section.
  5. Select the appropriate Add-on Components
    1. If the server is a virtual machine, Do Not Check any Add-on Components and click Next.
        
    2. If the server is a physical machine without the need for MS SQL backups, Check the Volume CBT (Changed Block Tracker) option, ensure the File System CBT (Changed Block Tracker) option is Unchecked, and click Next.

    3. If the server is a physical machine needing MS SQL backups, Check both the Volume CBT (Changed Block Tracker) option and the File System CBT (Changed Block Tracker) option and click Next.

       
    4. The Volume CBT (Changed Block Tracker) option requires a reboot to activate; however, it will not force the operation.
  6. The default installation method will utilize the Local System account as the service account for the helper app.


    If desired, you may specify a different service account by selecting The following user account: and entering the applicable credentials. 

VSS Service Account Note

  • The VSS writer is used for SQL DB backups and will use NT Auth\System (Local Account)
  • The VSS writer is not used for SQL Log backups and will use the agent service account.

You may opt to change the VSS service account from local to the specified “Cohesity service account user” to achieve the desired results regarding backups reporting.

  1. Review and click Install when ready

  2. The Cohesity Agent will start automatically upon completion of the install

 Setting Permissions in SQL Server Management Studio (SSMS)

If this installation of the helper app is configured to protect SQL, ensure you grant permissions to the appropriate service account managing your Agent installation. By default, this will be NT AUTHORITY\SYSTEM. However, this can be changed during the app installation if desired.

  1. Launch SQL Server Management Studio and login to the appropriate instance
  2. Expand Security, Logins, and select NT AUTHORITY\SYSTEM
  3. Right Click and select Properties
  4. Select Server Roles, check the box next to sysadmin, and select OK.
     
  1. Exit SQL Server Management Studio
  2. Open the Task Manager and select the Services tab.
  3. Locate the CohesityAgent service, Right Click, and select Restart

 Silent Install via Powershell

Alternatively, you can install the Cohesity Helper App on Windows servers by using the following parameters:

<InstallerExeFile> [/type=onlyagent|allcbt|volcbt] [/verysilent] [/suppressmsgboxes] [/norestart]


Example Installation Commands

#Virtual server
.\Cohesity_Agent_6.6.0d_u1_Win_x64_Installer.exe /type=onlyagent /verysilent /suppressmsgboxes /norestart

#Physical server without the additional need for MS SQL backups
.\Cohesity_Agent_6.6.0d_u1_Win_x64_Installer.exe /type=volcbt /verysilent /suppressmsgboxes /norestart

#Physical server with the additional need for MS SQL backups
.\Cohesity_Agent_6.6.0d_u1_Win_x64_Installer.exe /type=allcbt /verysilent /suppressmsgboxes /norestart

The default name for <InstallerExeFile> is Cohesity_Agent_<Version>_Win_x64_Installer.exe.

The Cohesity Agent version is subject to change. Please, download a new Cohesity Agent file with each new set of installations.


 A full table of the parameters can be found below:

Parameter

Description

/type=<onlyagent|allcbt|volcbt>

Specifies the type of installation.

volcbt - Installs the Windows Agent Service and Volume CBT component. (For physical servers without the additional need for MS SQL backups; server restart is required)

allcbt - Installs the Windows Agent Service, Volume CBT, and File System CBT components. (For physical servers with the additional need for MS SQL backups; server restart is required)

onlyagent - Installs only the Windows Agent Service and not the Volume CBT or File System CBT components. (For virtual machines only)

Note: The /type parameter is supported only for a fresh installation. It is not supported for upgrades. You cannot add or remove components during an upgrade.

/verysilent

Suppresses the installation progress window.

/suppressmsgboxes

Suppresses any message boxes if /verysilent parameter is specified.

/norestart

Prevents the setup from restarting the system following a successful installation or after a Preparing to Install failure that requests a restart.

 


Was this article helpful?