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