Use Existing Licenses

Mount Existing Product License ¶

You can pass the license file to a container via mounting to the container's /opt/in directory.

Note: You do not need to do this if you are using your DevOps User/Key. If you have provided license files via the volume mount and a DevOps User/Key, it will ignore the DevOps User/Key.

The /opt/in directory overlays files onto the products runtime filesystem, the license needs to be named correctly and mounted in the exact location the product checks for valid licenses.

Example Mounts ¶

Product	File Name	Mount Path
PingFederate	pingfederate.lic	/opt/in/instance/server/default/conf/pingfederate.lic
PingAccess	pingaccess.lic	/opt/in/instance/conf/pingaccess.lic
PingDirectory	PingDirectory.lic	/opt/in/pd.profile/server-root/pre-setup/PingDirectory.lic
PingDataSync	PingDirectory.lic	/opt/in/instance/PingDirectory.lic
PingAuthorize	PingAuthorize.lic	/opt/in/instance/PingAuthorize.lic
PingAuthorize PAP	PingAuthorize.lic	/opt/in/instance/PingAuthorize.lic
PingCentral	pingcentral.lic	/opt/in/instance/conf/pingcentral.lic

Volume Mount Syntax ¶

Docker ¶

Sample docker run command with mounted license:

docker run \
  --name pingfederate \
  --volume <local/path/to/pingfederate.lic>:/opt/in/instance/server/default/conf/pingfederate.lic
  pingidentity/pingfederate:edge

Sample docker-compose.yaml with mounted license:

version: "2.4"
services:
  pingfederate:
    image: pingidentity/pingfederate:edge
    volumes:
      - path/to/pingfederate.lic:/opt/in/instance/server/default/conf/pingfederate.lic

Kubernetes ¶

Create a Kubernetes secret from the license file

kubectl create secret generic pingfederate-license \
  --from-file=./pingfederate.lic

Then mount it to the pod

spec:
  containers:
  - name: pingfederate
    image: pingidentity/pingfederate
    volumeMounts:
      - name: pingfederate-license-volume
        mountPath: "/opt/in/instance/server/default/conf/pingfederate.lic"
        subPath: pingfederate.lic
  volumes:
  - name: pingfederate-license-volume
    secret:
      secretName: pingfederate-license

Helm ¶

Create a Kubernetes secret from the license file

kubectl create secret generic pingfederate-license \
  --from-file=./pingfederate.lic

Add the secretVolumes within your values.yaml deployment file

pingfederate-admin:
  ...
  secretVolumes:
    pingfederate-license:
      items:
        pingfederate.lic: /opt/in/instance/server/default/conf/pingfederate.lic