- 22 Jun 2022
- DarkLight
How-to Install the Cohesity Helper App (Windows)
- Updated on 22 Jun 2022
- DarkLight
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
- Log in to the respective Cloud Data Protection system
- From the navigation bar at the top of the page, select the Protection → Sources tab
- Open the add sources menu and then select the Download Cohesity Agent button from the bottom of the menu.
- Select Windows via the blue arrow on the right
- Move downloaded agent to the server requiring Cohesity Helper App
Install via the Setup Wizard
- Login to the server to which you wish to install the agent software on
- Run the downloaded or copied executable
- Select Next
- If you are performing an upgrade, select Yes. Otherwise, you may skip this section.
- Select the appropriate Add-on Components
- If the server is a virtual machine, Do Not Check any Add-on Components and click Next.
- 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.
- 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.
- The Volume CBT (Changed Block Tracker) option requires a reboot to activate; however, it will not force the operation.
- If the server is a virtual machine, Do Not Check any Add-on Components and click Next.
- 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.
- Review and click Install when ready
- 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.
- Launch SQL Server Management Studio and login to the appropriate instance
- Expand Security, Logins, and select NT AUTHORITY\SYSTEM
- Right Click and select Properties
- Select Server Roles, check the box next to sysadmin, and select OK.
- Exit SQL Server Management Studio
- Open the Task Manager and select the Services tab.
- 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:
|
Example Installation Commands
|
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 |
| Specifies the type of installation.
Note: The |
/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 |