Using an Agent on a Machine

The users of each agent machine can, if you permit, control many of the Security Controls Agent features on their machine.

Your Windows users can control the agent using the Security Controls Agent client program. They can access this program in two ways:

  • By selecting Start > Ivanti Security Controls Agent on the target machine.
  • By double-clicking the following executable file:

    • C:\Program Files\LANDESK\Shavlik Protect Agent\STUILauncher.exe

For information on how to use the client program, see About the Agent Client Program. This topic also provides information on how to control an agent using the stagentctl command-line utility.

Resetting Retry Counts within the Client Program

The Patch Engine tile includes a Reset retry counts button that resets all patch counters. A unique patch counter exists for every patch the program tries to download and for every patch the program tries to install. A patch counter will increment whenever a patch download or a patch installation fails. Failed download and installation attempts will be recorded in the patch log. If a Windows patch fails to download after 10 attempts or fails to install after three times in an individual patch cycle and five times in total for the endpoint, the client program will stop trying to deploy that particular patch. The only way to resume the deployment of that patch is to click Reset retry counts.

Your Linux users can control the agent on their machines using the stagentctl command-line utility. They can learn about the utility by displaying the built-in help information.

  1. Launch a Terminal.
  2. Change to the /opt/ivanti/isec/bin directory.

    3. cd /opt/ivanti/isec/bin

  3. Display help information for the stagentctl utility.

    4. ./stagentctl

Examples

View available tasks in the agent policy

Command

# ./stagentctl available-tasks

Sample Output

1. SampleLinuxPatchTask

2. Update asset data

3. Update agent binaries

4. Update patch data

5. Perform Agent check-in

For a description of the available tasks, see Managing Your Agents.

Start a check-in job

Command

# ./stagentctl dispatch --index 5

Sample Output

Task id: 96E17378-4833-BF52-4358-FC5CC14DF963