Terminal Commands
In the macOS Terminal application you can perform the following commands directly to your IBM Security macOS agent, using the pmagentctl utility.
To find this list, enter the following into Terminal:
pmagentctl
Commands returned for the pmagentctl Utility
Overview: PM Agent Control
Usage: pmagentctl < subcommand >
Options:
--version (show the version)
-h, --help (show help information)
Subcommands
| subcommand | description |
|---|---|
| agentid | Gets the Agent ID |
| dumpconfig | Gets Agent Configuration Data |
| register | Initiates an Agent registration (requires elevated privileges) |
| server | Set server URL and optional install code (requires elevated privileges) |
| isregistered | Gets the Agent registration status |
| updateclientitems | Update client items (requires elevated privileges) |
| listclientitems | List client items. By default, all categories of client items are included |
| runschedule | Policy ID to run (requires elevated privileges) |
| sendevents | Sends events (requires elevated privileges) |
| start | Starts the agent (requires elevated privileges) |
| stop | Stops the agent (requires elevated privileges) |
| restart | Restarts the agent (requires elevated privileges) |
See pmagentctl help < subcommand > for detailed help.
Command Usage
To perform a command, insert the name of the above command that you need to perform into this command string:
pmagentctl < InsertCommandHere >
The start, stop, and restart commands are required to be run via sudo. This will prompt for admin account password verification. The other commands that require elevated privileges can be run via sudo or credentials can be entered interactively.
For example, to register an agent immediately after updating the Verify Privilege Manager server location, type:
sudo pmagentctl register
Legacy Path and Scripts
Previously, you would use the utility with a path like:
sudo /usr/local/thycotic/agent/agentUtil.sh < InsertCommandHere >
The legacy scripts are still available and can be used, but they are now located in:
/usr/local/delinea/
The /usr/local/thycotic/ directory is a symlink to the /usr/local/ delinea/ directory.
These legacy scripts are deprecated and will be removed in future releases, so using the pmagentctl utility when possible is recommended.