Provisioner installation

Installation guide for PerfectScale Provisioner in a self-hosted Kubernetes environment

After completing all cluster prerequisites, you can proceed with executing the PerfectScale provisioner, which will install all PerfectScale's services and infrastructure elements in your Kubernetes cluster. Follow the steps below to install the Provisioner and start leveraging PerfectScale’s insights within your environment.

Installation

Step 1: Get installation files

To provision the self-hosted environment, you'll need the provisioner binary, helmfile.yaml, config.yaml, and tenant_id. To obtain the needed files, please contact us at [email protected].

Make sure to save both the provisioner binary, helmfile.yaml, and config.yaml in the same directory on your system.

Step 2: Create a dedicated namespace

Create a namespace for the on-premises installation:

kubectl create ns <namespace_name> # replace "namespace_name" with your namespace name

Step 3: Configure installation parameters

Create a config.yaml file in the same directory as your Binary installation file and Helmfile

access_key: 
secret_key: 
suffix_url: "DNS name"
tenant_id: "vendor_tenant_id" # provided by PerfectScale
namespace: <namespace_name>
kube_context: <k8s_cluster_context>
kube_config: <path_to_kubeconfig_file>
helmfile: "helmfile.yaml" # provided by PerfectScale

Other configuration provisioning options include:

• Installing the provisioner with FluxCD

• Installing the provisioner with Managed Postgres

Step 4: Run the Provisioner install sub-command

Navigate to the directory where your config.yaml, Binary installation file, and Helmfile are located, and execute the following installation command:

./provisioner install

After completing these steps, the installation process will begin in your terminal.

The process can take about half an hour. If there are any issues, environment provisioning will stop. Check the logs for the reason of failure and either resolve it or reach out to support at [email protected].

Accessing PerfectScale WebApp UI

In order to access PerfectScale WebApp, you need to get the WebApp URL. Run the following command to retrieve the WebApp URL and get the credentials:

./provisioner get-login

You now possess all the necessary data to access your PerfectScale account, including the ingress URL, username, password, etc.

Advanced configuration options

The following advanced configurations are available:

• SSO integration

• SMTP server configuration

Troubleshooting

If you encounter a 403 Forbidden error during installation, run the following command:

helm registry logout public.ecr.aws

Uninstall PerfectScale

There may be situations where you need to uninstall the PerfectScale provisioner. In order to remove all provisioned components, run the provisioner uninstall command using the same kubeconfig and kubecontext as the original cluster.

./provisioner uninstall