Installing Agents Using An Installation Script

Version 14

    Purpose

     

    This document outlines how to install an agent using an installation script using a Shared Passphrase, Windows Authentication or Cloud-Based Installation.

     

    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

     

    Overview

     

    Agent Installation File

     

    The Agent installer file is called "STPlatformUpdater.exe" and can be found in the following location on your console machine:

    C:\ProgramData\LANDESK\Shavlik Protect\Console\DataFiles\

    For these scripted methods of installation, you will need to first copy STPlatformUpdater.exe to your intended target, then run your desired script from the same location as STPlatformUpdater.exe.

     

    Authentication Type Examples

     

    You will need to configure the following scripts by replacing the default policy, authentication, console information, etc. with your own information. Also, if your agent policy name contains spaces, you'll need to substitute hyphens for the spaces for the script to correctly execute. It tends to be simpler to just edit your policy name in your console to eliminate the spaces, if possible.

    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 you don't 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