Overview

This document provides steps for silent and automated installation of Cavisson agents on the Windows platform.

This includes the following agents:

1. Machine agent
2. Log agent
3. App agent

It contains prerequisites and the steps that need to be performed before the installation.

Platform Support

Note: Silent installer also supports all other versions later to 2012.

Prerequisites

For Silent Mode

1. PowerShell runtime environment is required to execute the script. The PowerShell version should be later than or equal to 5.
2. Administrator might have disabled the script execution. To allow the script to run, open PowerShell as administrator and run the command: Set-ExecutionPolicy UnRestricted.
3. PowerShell may temporarily block execution of scripts downloaded from the internet. To unblock, the following has to be done on the machine from where the installer will run.
4. Right-click on the install.ps1 script and click Properties. From there, click Unblock.
5. Open PowerShell as administrator and navigate to the directory containing the script. Run the command unblock-file ./install.ps1 to unblock it.

For GUI Mode

1. Admin permission is also required for the installation via GUI mode.

Additional Prerequisites for Remote Installation

1. WinRM (Windows remote) services should be running on the server.
2. Inbound Rule should enable the server for WinRM Service from where the installer is running.
3. List of trusted remote servers should be added in configuration of WinRM Client on the machine from where the installer will run.

Installation in Silent Mode

Silent Mode installation can be done either from the targeted server or remotely. User needs to create a hostfile.txt containing Username, Password and Hostname of the servers if installing remotely.

1. Create the CavissonAgentInstaller folder in <C:\Program Files (x86)\> . User can create somewhere else as per his choice.
2. Download Cavisson-Agent-Installer.*.zip file using Cavisson repository in <C:\Program Files (x86)\
3. Extract it into the folder <C:\Proer>gram Files (x86)\CavissonAgentInstaller>.
4. Open PowerShell on your system with administrative privilege.
5. Navigate to the extracted directory <C:\Program Files (x86)\CavissonAgentInstaller>.
6. Create hostfile.txt under <C:\Program Files (x86)\CavissonAgentInstaller> with the following format if installing remotely.

Username1:Password1:Hostname1
Username2:Password2:Hostname2
Username3:Password3:Hostname3

7. Run .\install.ps1 with required agent and its related args. Below parameters are supported in the script, you can pass with .\install.ps1.

Note: The folder needs to be copied at an appropriate place or select the folder during installation that does not have spaces in the file path.

Usage

Silent Mode Installation with All arguments

.\install.ps1 -installedPath “Provide installation dir Default <C:\Program Files (x86)\opt\cavisson\>” -appAgent “Provide Install Mode Install/Skip <1/0>” -machineAgent “Provide Install Mode Install/Skip <1/0>”> -logAgent “Provide Install Mode Install/Skip <1/0>” -tier “Provide Tier Name” -instance “Provide Instance Name” -poolName “Provide Pool Name <pool1,pool2>” -remoteinstall “Flag to enable remote install <0/1>” -dest “Provide Destination Folder <C:\Users\Administrator\Downloads>” -controller “Provide Cavisson server <hostname:443>” -protocol “Provide Protocol-Default: WSS” -msi “Provide msi name”-nfIndexPrefix “Provide Index Prefix” -nfServer “Provide Log Server <hostname:443>” -nfEnv “Provide Setup-name like Prod” -nfReloadPort “Provide ND Reload Port” -logFile “Log File Name” -server “Provide Server Name-Default: Hostname” -username “Provide Usernme to run Machine Agent with different user” -password “Provide password of above User” -installVCRuntime “Provide Flag to install bundled visual c++ runtime” -iisreset “Provide Flag to reset the IIS” -hostfile “Provide host file”

Note: All parameters are optional and if not provided on the command line are picked from the bundled configuration file in binary.

Case1: Silent mode installation from targeted server

.\install.ps1 -tier “Provide Tier Name” -controller “Provide Cavisson server <hostname:443>”

Case2: Silent mode installation on a targeted server remotely

.\install.ps1 -tier “Provide Tier Name” -controller “Provide Cavisson server <hostname:443>” -remoteinstall “Flag to enable remote install <1>” -hostfile “Provide host file”

Case 3: Install only Machine Agent and App Agent

.\install.ps1 -appAgent 1 -machineAgent 1 -tier “Provide Tier Name”  -controller “Provide Cavisson server <hostname:443>” -nfIndexPrefix “Provide Index Prefix” -nfServer “Provide Log Server <hostname:443>” -poolName “Provide Pool Name <pool1,pool2>”

Note: Create hostfile.txt and use -hostfile “Provide host file” and -remoteinstall “Flag to enable remote install <0/1>”  args if installing remotely.

Case 4: Install only Machine Agent, App Agent and Log Agent

.\install.ps1 -appAgent 1 -machineAgent 1 -logAgent 1 -tier “Provide Tier Name” -controller “Provide Cavisson server <hostname:443>” -nfIndexPrefix “Provide Index Prefix” -nfServer “Provide Log Server <hostname:443>” -poolName “Provide Pool Name <pool1,pool2>” -nfEnv “Provide Setup-name like Prod” -nfReloadPort “Provide ND Reload Port” -logFile “Log File Name”.

Note: Create hostfile.txt and use -hostfile “Provide host file” and -remoteinstall “Flag to enable remote install <1>” args if installing remotely.

Installation in GUI Mode

1. Download the provided Agent MSI file.

Example: Cavisson-Agent-Installer.4.5.0.77.x64.4.5.zip