Purpose
The purpose of the document outlines how to install an agent using a manual installation script.
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
Or downloaded from here
9.0 version
http://xml.shavlik.com/data/Protect/v9/90/Protect/1182/STPlatformUpdater.exe
9.1 version
http://xml.shavlik.com/data/protect/v9/91/protect/4334/stplatformupdater.exe
Note: The following scripts are provided only as examples. Do not attempt to use these scripts in your organization without modifying the input values and performing adequate testing.
Authentication Types
- Shared passphrase
- Windows authentication
- Current Credentials
Note: To enable passphrase verification for manual agent installations, in Protect go to Tools > Options > Agents and enable the feature and create your passphrase.
Example script for passphrase authentication
STPlatformUpdater.exe
/wi:"/qn /l*v install.log SERVERURI=https://consolename:3121 POLICY=policyname AUTHENTICATIONTYPE=PASSPHRASE PASSPHRASE=secret"
Example script for Windows authentication
STPlatformUpdater.exe /wi:"/qn /l*v install.log SERVERURI=https://consolename:3121 POLICY=policyname AUTHENTICATIONTYPE=WINDOWS SERVERUSERNAME=domainname\Your.Name PASSWORD=secret"
Example script for cloud-based agent installation
STPlatformUpdater.exe /wi:"/qn /l*v install.log ACTIVATIONKEY=12345abc-2abc-3abc-4abc-123456789abc"
Where:
- STPlatformUpdater.exe is a bootstrap installer for the agent platform installatio
- /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 - 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
Affected Product(s)
Shavlik Protect All Versions