Purpose
The purpose of the document outlines how to install an agent using a installation script using Shared Passphrase, Windows Authentication or Cloud-Based Installation.
Overview
Agent Installation File
The Agent installer file is the STPlatformupdater.exe and can be found in the following location on your console machine:
C:\ProgramData\LANDesk\Shavlik Protect\Console\DataFiles\ STPlatformupdater.exe.
Authentication Type Examples
You will need to subsitiute your own information into the following scripts by replacing the default policy, authentication, console information etc with your own information. Also, if your agent policy name has spaces in between, you need to put hyphens in for the spaces for the script to correctly execute. You will also need to add hyphens in the Policy Name in the console UI.
Shared Passphrase
Before running this script, enable passphrase verification for manual agent installations by going to Tools > Options > Agents and enabling the feature and creating your passphrase.
STPlatformUpdater.exe /wi:"/qn /l*v install.log SERVERURI=https://consolename:3121 POLICY=policyname AUTHENTICATIONTYPE=PASSPHRASE PASSPHRASE=secret"
Windows Authentication
STPlatformUpdater.exe /wi:"/qn /l*v install.log SERVERURI=https://consolename:3121 POLICY=policyname AUTHENTICATIONTYPE=WINDOWS SERVERUSERNAME=domainname\Your.Name PASSWORD=secret"
Cloud-Based Installation
STPlatformUpdater.exe /wi:"/qn /l*v install.log ACTIVATIONKEY=12345abc-2abc-3abc-4abc-123456789abc"
Terms:
- STPlatformUpdater.exe is a bootstrap installer for the agent platform installation
- /wi
means pass this to Windows Installer - /qn
means no user interface activity from the installer - /l*v
means write a log for the installation attempt. It has one parameter that
specifies the log file name - SERVERURI
is the address, port, and scheme (e.g. https://) used to connect to the
console for registration and check-in - POLICY
is the name of the agent policy that will be assigned to the agent
The policy name should be one word with no spaces.
- AUTHENTICATIONTYPE
is either PASSPHRASE or WINDOWS (this is dictated by the Tools >
Options >Agents dialog) - PASSPHRASE
is the passphrase used to authenticate the agent to the console (used only
if AUTHENTICATIONTYPE=PASSPHRASE) - SERVERUSERNAME
is the name of a user who has rights to install an agent (used only if
AUTHENTICATIONTYPE=WINDOWS) - PASSWORD
is the password used to authenticate the user to the console (used only if
AUTHENTICATIONTYPE=WINDOWS) - USECURRENTCREDENTIALS=1 can be used in place of SERVERUSERNAME and PASSWORD if
you want to authenticate using the credentials of the person who logged on
to run the script - ACTIVATIONKEY
is the activation key that was created using the Protect Cloud Service
Additional Information
In some cases, the script will require additional quotes, even when not have spaces in the policy name or passphrase/password.
- 3 quotes around the Policy
- 9 quotes before the password/passphrase
- 10 quotes after the password/passphrase
STPlatformUpdater.exe /wi:"/qn /l*v install.log SERVERURI=https://consolename:3121 POLICY="""policyname""" AUTHENTICATIONTYPE=WINDOWS SERVERUSERNAME=domainname\Your.Name PASSWORD="""""""""secret""""""""""
Affected Product(s)
Ivanti Patch for Windows Servers 9.3.x
Shavlik Protect 9.2.x