Intel AMT Features > Agent Presence > Use Cases > Create an Agent Watchdog
CollapseAll image

Create an Agent Watchdog

The following step describes how to create an agent watchdog with a startup timeout of 1 hour and a heartbeat timeout of 1 minute. In this example, the agent’s GUID  is 03020100-0504-0706-0809-0A0B0C0D0E0F.

 Note:

   Do not define an agent watchdog with a GUID of zero. This can cause incompatibility with NAC postures and NAP statements of health.  Note: Beginning in Intel AMT Release 9.0 NAC is no longer supported.

   The value of the DeviceID before conversion to Base64 must be exactly 16 bytes.

1.  Create an instance of AMT_AgentPresenceWatchdog with the following mandatory properties:

Property

Value

CreationClassName

Enter any value (the value is overridden)

DeviceID

(Release 3.0 through Release 5.x)

The hexadecimal representation of the DeviceID GUID: 030201000504070608090A0B0C0D0E0F , packed into 16 bytes.

(Release 6.0 and later releases)

A string in Base64: “AAECAwQFBgcICQoLDA0ODw==” which is a Base64 conversion of the GUID: 03020100-0504-0706-0809-0A0B0C0D0E0F

StartupInterval

3600 (value in seconds)

SystemCreationClassName

Enter any value (the value is overridden)

SystemName

Enter any value (the value is overridden)

TimeoutInterval

60 (value in seconds)

 

Click here for a snippet demonstrating this step

You can execute this snippet by inserting it into the execution template found here.

  

$deviceID ="AAAAAAAAAAAAAAAAAAAAAA==" # The ID of the agent watchdog in Base64 format.

$agentPresenceWatchdogInstance =$wsmanConnectionObject.NewInstance("AMT_AgentPresenceWatchdog")

$agentPresenceWatchdogInstance.SetProperty("CreationClassName","AMT_AgentPresenceWatchdog")

$agentPresenceWatchdogInstance.SetProperty("DeviceID",$deviceID)

$agentPresenceWatchdogInstance.SetProperty("StartupInterval","60")

$agentPresenceWatchdogInstance.SetProperty("SystemCreationClassName","CIM_ComputerSystem")

$agentPresenceWatchdogInstance.SetProperty("SystemName","Intel(r) AMT")

$agentPresenceWatchdogInstance.SetProperty("TimeoutInterval","120")

$agentPresenceWatchdogInstance.Create()

 

 

Additional Information

When you create an agent watchdog object, a CIM_ConcreteDependency association is created that connects the agent watchdog to the agent presence service.

Instance Diagram

Classes Used in This Flow

SDK Sample

If there is a sample demonstrating this flow, it is included in the SDK installation file. See SDK Installation Layout for details.

 

See Also:

   Agent States

   Agent Watchdog Timers and Actions

Copyright © 2006-2022, Intel Corporation. All rights reserved.