Skip to main content
Version: 2.5

Install license server

After installing the Portworx Central on-premises, follow the procedure in this topic to install the license server component.

Prerequisites

  • Deploy the Portworx Central chart, and ensure all components are in running state.

  • Ensure that only on two worker nodes, you set the value of the px/ls label to true:

    kubectl label node <NODE_NAME> px/ls=true
  • Enable SSH access on port 7070:

    • On the two nodes where you set the value of the px/ls label to true, add the following line to the /etc/sysconfig/iptables file:

      -A INPUT -p tcp -m state --state NEW -m tcp --dport 7070 -j ACCEPT
    • Restart the iptables service.

      systemctl restart iptables.service
  • If you run the Portworx Central on Openshift, then add a new service account to the privileged SCC. Enter the oc edit scc privileged command and add the following line to the users section, replacing <YOUR_NAMESPACE> with your namespace:

    system:serviceaccount:<YOUR_NAMESPACE>:pxcentral-license-server

Prepare air-gapped environments

If your cluster is internet-connected, skip this section. If your cluster is air-gapped, then pull the license server and related Docker images to either your Docker registry or directly onto your nodes.

  1. Create a kube_version environment variable, and assign your Kubernetes version to it:

    kube_version=`kubectl version --short | awk -Fv '/Server Version: / {print $3}'`
  2. Pull the following Docker image onto your air-gapped environment.

    • docker.io/portworx/px-els:2.3.2

To pull the above Docker image and push it to an internal registry:

  1. Download the pxcentral-ag-install-licenseserver.sh air-gapped bootstrap Portworx Central install script.

    curl -o pxcentral-ag-install-licenseserver.sh -L “https://install.portworx.com/pxcentral-air-gapped?px-license-server=true”

    You can also download the install script for a specific release by specifying a version query. For example:

    curl -o pxcentral-ag-install-licenseserver.sh -L “https://install.portworx.com/pxcentral-air-gapped?version=2.6.0&px-license-server=true”
  2. Pull the container images using the pxcentral-ag-install-licenseserver.sh script:

    ./pxcentral-ag-install-licenseserver.sh pull
  3. Push the images to a local registry server accessible by the air-gapped nodes. Replace <repo> with your registry location:

    ./pxcentral-ag-install-licenseserver.sh push <repo>

Install the license server

  1. Generate the install spec using the License Server and Monitoring spec generator.

    If you use Portworx to install Portworx Central, select the Use storage class checkbox under the Configuration section of the Spec Details tab. In the Storage Class Name text box, enter the name of the storage class you used to install Portworx Central.

    Select the License Server checkbox under Select Components section. Additionally, select the Air Gapped checkbox if your cluster is air-gapped.

    Select the Use custom registry checkbox under the Custom Registry section, and enter the following information:

    • Custom Registry: The hostname of your custom registry
    • Image Repository: The path to the required Docker images
    • Image Pull Secret(s) (Optional): A comma-separated list of your image pull secrets.

  2. Using Helm, add the Portworx Enterprise repository to your cluster and update it.

    helm repo add <repo-name> portworx http://charts.portworx.io/ && helm repo update
  3. Install the license server component using either the --set flag or the values.yml file provided in the Step 2 section of the Complete tab of the spec generator.