The `pingctl` Utility ¶

pingctl is our general DevOps command-line utility.

Deprecated file name

The deprecated ping-devops utility used a configuration file located at ~/.pingidentity/devops. pingctl, however, uses ~/.pingidentity/config. While the files generated are compatible, be aware that some older utilities or documentation might refer to the older configuration name.

Dependent Utilities ¶

To perform all of its operations, pingctl has a dependency on the following utilities:

openssl
base64
kubectl
envsubst
jq
jwt

Installation and Upgrades ¶

Using Homebrew to install pingctl on MacOS, Windows via Windows Subsystem for Linux, or Linux.

To install, enter:
```
brew install pingidentity/tap/pingctl
```
To upgrade, enter:
```
brew upgrade pingidentity/tap/pingctl
```
To check for upgrades, run the following command.

Check regularly

Check for upgrades regularly.
```
pingctl version
```
The dependent utilities for pingctl are also installed or upgraded during this process.

Using sh to install pingctl on Linux and WSL.

To install or upgrade, enter:

curl -sL https://bit.ly/pingctl-install | sh

Ensure you have the dependent utilities for pingctl installed.

Usage ¶

pingctl <command> [options]

Available Commands:
    info            Print pingctl config
    config          Manage pingctl config
    version         Version Details and Check
    clean           Remove ~/.pingidentity/pingctl

    kubernetes      Kubernetes Tools
    license         Ping Identity Licensing Tools
    pingone         PingOne Tools

Use pingctl for info on available commands.

Use pingctl <command> for info on a specific command.

Options ¶

-h

Provide usage details.

Available Commands ¶

kubernetes
license
pingone
info

Provides a summary of variables defined with pingctl.
config

Provides an interactive process in which the user can provide all the pingctl standard variables (i.e. PingOne and Ping DevOps) as well as custom variables
version

Displays the current version of the tool, and checks to see if an update is available.
clean

Cleans the cached pingctl work directory containing the latest PingOne Access Token

The pingctl Utility ¶