Skip to content

The pingctl Utility

pingctl is our general DevOps command-line utility.

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.

  1. To install, enter:

    brew install pingidentity/tap/pingctl
    
  2. To upgrade, enter:

    brew upgrade pingidentity/tap/pingctl
    
  3. 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.

  1. To install or upgrade, enter:

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

  2. 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 interview allowing user to provide all the pingctl standard variables (i.e. PingOne and Ping DevOps) as well as custom variables

  • version

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

  • clean

    Cleans the cached pingctl work directory containing:

    • Latest PingOne Access Token