Skip to content

RPC CLI

On the managed device, a Remote Provisioning Client (RPC) communicates with the Remote Provision Server (RPS) in the process of activating or deactivating the device. In addition to activation and deactivation, the RPC provides informational and maintenance commands.

List Commands

On the managed device, open a Terminal (Linux) or Powershell/Command Prompt as Administrator (Windows).

Run the RPC application on the command line with no arguments to see supported commands:

sudo ./rpc 
.\rpc
COMMAND DESCRIPTION EXAMPLE
activate Activate this device with a specified profile ./rpc activate -u wss://server/activate --profile profilename
deactivate Deactivate this device. You will be prompted for the AMT password. ./rpc deactivate -u wss://server/activate
maintenance Synchronize the managed device's AMT clock with operating system time ./rpc maintenance -c -u wss://server/activate -n
amtinfo Display AMT status and configuration ./rpc amtinfo
version Display the current version of RPC and the RPC Protocol version ./rpc version

List Command Options

Run the application with a command to see available options for the command:

sudo ./rpc [COMMANDS][OPTIONS]
.\rpc [COMMANDS][OPTIONS]

activate

Activate this device with a specified profile:

sudo ./rpc activate -u wss://server/activate --profile profilename
.\rpc activate -u wss://server/activate --profile profilename
OPTION DESCRIPTION
-d string DNS suffix override
-h string Hostname override
-json JSON output
-n Skip WebSocket server certificate verification
-p string Proxy address and port
-profile string name of the profile to use
-u string WebSocket address of server to activate against
-v string Verbose output

For more information, see Build & Run RPC.

To learn how to use the rpc application to transition an already activated (provisioned) Intel vPro® Platform, see Transition Activated Device.

deactivate

Deactivate this device:

sudo ./rpc deactivate -u wss://server/activate
.\rpc deactivate -u wss://server/activate
OPTION DESCRIPTION
-d DNS suffix override
-json JSON output
-n Skip WebSocket server certificate verification
-p string Proxy address and port
-password string AMT password
-u string WebSocket address of server to activate against
-v string Verbose output

For more information, see Build & Run RPC.

maintenance

Synchronize the managed device's AMT clock with operating system time:

sudo ./rpc maintenance -u wss://server/activate
.\rpc maintenance -u wss://server/activate
OPTION DESCRIPTION
-c Synchronize the AMT clock with the operating system time
-json JSON output
-n Skip WebSocket server certificate verification
-p string Proxy address and port
-password string AMT password
-u string WebSocket address of server to activate against
-v string Verbose output

amtinfo

Display AMT status and configuration

sudo ./rpc amtinfo
.\rpc amtinfo

Command Without Options

Using amtinfo without any of the options below (or only -json) will return the info for all of the most common options

AMT INFO OPTION DESCRIPTION
-json JSON Output
Version -ver Intel AMT version.
Build Number -bld Intel AMT Build Number.
SKU -sku Product SKU
UUID -uuid Unique Universal Identifier of the device. Used when creating device-specific MPS API calls as part of the REST API's URL path.
Control Mode -mode Control Mode below indicates the managed device's state: a) pre-provisioning or deactivated (b) activated in client control mode (c) activated in admin control mode
DNS Suffix -dns DNS Suffix set according to PKI DNS Suffix in Intel MEBX or through DHCP Option 15. Requried for ACM activation.
DNS Suffix (OS) -dns
Hostname (OS) -hostname Device's hostname as set in the Operating System.
RAS Network -ras
RAS Remote Status -ras Unconnected or connected. State of connection to a management server.
RAS Trigger -ras User initiated or periodic. When activated, periodic signifies CIRA established. By default, CIRA sends a heartbeat to the server every 30 seconds to verify and maintain connection.
RAS MPS Hostname -ras IP Address or FQDN of the MPS server.

---Wired/Wireless Adapters---

WIRED/WIRELESS ADAPTER OPTION DESCRIPTION
DHCP Enabled -lan True/False. Whether or not the network is using DHCP or Static IPs.
DHCP Mode -lan
Link Status -lan Up/Down. Shows whether or not this adapter is being used by Intel AMT.
IP Address -lan If using CIRA or the device is unactivated, this field will show 0.0.0.0
MAC Address -lan Device's MAC Address

For more information, see Wireless Activation.

version

Display the current version of RPC and the RPC Protocol version:

sudo ./rpc version
.\rpc version
Back to top