Installing Agents Using A Manual Installation Script

Version 9

    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

    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
    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"

    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.

    Example:

    Agent Policy Name: My Agent Policy

    Script: /wi:"/qn /l*v install.log SERVERURI=https://consolename:3121 POLICY=My-Agent-Policy 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

                        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)

     

    Shavlik Protect 9.2.x

    Ivanti Patch for Windows Servers 9.3.x