Purpose

The purpose of this article is to show how an agent can be installed on a target machine with no policy using a manual installation script. This can be useful to make sure that the agents are installed on target machines prior to an image being cloned and installed on multiple targets. Agents with pre-existing policies cannot be cloned due to certificate and name resolution issues.

Prerequisites

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

Description

This is a three-step process:

1. Agent Installation: (blank-slate agent install)

To do that you can run the STPlatformUpdater.exe on the machine you will create your base image on. When the agent install completes and prompts you to register (either through the cloud or to a console) you can cancel the wizard. You now have the base agent installed. You can clone the image now.

2. Agent Registration: (performed after the machine is created)

The agent must register with the console once each machine has been imaged. This should occur after the machine name changes, the SSID changes, etc. (i.e. the target machine should be a unique machine at this point before proceeding forward). You can run this command (with proper information):

STAgentManagement.exe -register -p silent=true -p serverUri=https://consolename:3121 -p policy=policyname -p AuthType=SharedPassphrase -p passphrase="passphrase"

You can verify success by looking at the RegistrationLog.txt on the agent machine. This is what you should see in the log:

Agent Registration Operation Log.

Created DayOfTheWeek, MM DD, YYYY HH:MM:SS 

Stopping agent services for configuration changes.

Stopping STAgent.

STAgent stopped.

Stopping STDispatch.

STDispatch stopped.

Agent Id is 'StringOfLettersAndNumbers'.

Checking for compatibility with existing software.

The environment is compatible with agent operation.

Registering agent.

Registering agent with authentication type SharedPassphrase.

Registering agent with host 'https://consolename:3121'.

Received an immediate registration response. Completing registration now.

Configuration changes complete.

Restarting agent services after configuration changes.

Restarting STDispatch.

Updating agent proxy configuration.

Restarting STDispatch.

3. Agent Check-in: (performed after the agent has been registered)

The agent must check-in to complete the agent registration. You can either wait for the scheduled check-in interval or you can kick it off from the CMD prompt. You can run this command:

STAgentManagement.exe -checkin -noconsole

Additional Information

You can get a full list of switches for STAgentManagement.exe by using /? from the command line.

Related articles:

Installing Agents Using A Manual Installation Script

Scripted Agent Install May Fail During Registration Due To NetBIOS Resolution Failure

Affected Product(s)

Shavlik Protect 9.x