Run Commands

Register a Cluster via PachCTL

Learn how to register a pachd cluster to your Enterprise Server using PachCTL.

Before You Start #

  • You must have an Enterprise license key
  • You must have an active Pachyderm cluster
  • You must have the Pachyderm Helm repo downloaded.

How to Register a Cluster #

  1. Open your terminal.
  2. Run the following command:
pachctl enterprise register --id <my-pachd-config-name> --enterprise-server-address <pach-enterprise-IP>:650 --pachd-address <pachd-IP>:650
AttributeDescription
--idthe name of the context pointing to your cluster in ~/.pachyderm/config.json.
--enterprise-server-addressthe host and port where pachd can reach the enterprise server.
--pachd-addressthe host and port where the enterprise server can reach pachd. This may be internal to the kubernetes cluster, or over the internet.
  1. View all registered clusters with your enterprise server:
pachctl license list-clusters

# Using enterprise context: my-enterprise-context-name
# id: john
# address: ae1ba915f8b5b477c98cd26c67d7563b-66539067.us-west-2.elb.amazonaws.com:650
# version: 2.0.0
# auth_enabled: true
# last_heartbeat: 2021-05-21 18:37:36.072156 +0000 UTC

# ---
# id: doe
# address: 34.71.247.191:650
# version: 2.0.0
# auth_enabled: true
# last_heartbeat: 2021-05-21 18:43:42.157027 +0000 UTC
# ---
  1. Activate Authentication:
pachctl auth activate --enterprise
  1. Set up your Identity Provider (IdP).