Skip to content

Percona Everest installation and workflow

This section provides an overview of how Percona Everest is installed, the components involved, and the workflow, from operator installation to database provisioning, backups, and restores.

Percona Everest installation workflow

Starting from Percona Everest v1.4.0, the CLI installation is a wrapper around the helm charts (everest-core and everest-db-namespace){:target=”_blank”}. The installation flow is as follows:

  1. The everest-core helm chart is installed:

    This step deploys the core components required for Percona Everest:

    1. OLM Components** are deployed into the everest-olm namespace, which includes:

      • olm-operator
      • catalog-operator
      • package-server
      • everest-catalog
    2. Monitoring Stack is deployed into the everest-monitoring namespace, which includes:

      • vm-operator
      • kube-state-metrics
    3. Everest Components are deployed into the everest-system namespace, which includes:

      • everest-server
      • everest-operator
  2. The everest-db-namespace chart is installed in the everest namespace. This chart handles the deployment of database operators using the following workflow:

    1. Creates OLM subscriptions for each of the selected database operators (by default, all supported operators are selected).
    2. OLM reconciles the subscriptions and creates an install plan for each operator.
    3. A Helm hook creates the everest-operators-installer job that waits for the OLM install plan to be created and approves it once created.
    4. OLM reconciles the approved install plan and creates a cluster-service-version for each database operator. The CSV includes all the manifests needed to install the operator. OLM automatically applies these manifests, and the operator is installed.

Configurable options

The database operator namespaces and the operators that get installed can be configured as follows:

  • By default, the everest namespace is used, and all the database operators (PXC, PSMDB, and PG) are installed.
  • You can skip the database namespace creation step by using the --skip-db-namespace flag.
  • To specify one or more custom namespaces, use the --namespaces flag.

    You can provision multiple database namespaces simultaneously by providing a comma-separated list with the --namespaces flag. For example:

    everestctl install --namespaces n1,n2
    
  • If you want to skip the installation of certain operators, you can use the following flags:

    • --operator.mongodb=false
    • --operator.postgresql=false
    • --operator.xtradb-cluster=false

Manage namespaces

You can manage database namespaces after the initial installation using the following commands:

everestctl namespaces add [NAMESPACE]
everestctl namespaces update [NAMESPACE]
everestctl namespaces remove [NAMESPACE]

For detailed information on managing namespaces, see the Namespaces management section.

The helm installation method provides an identical flow to the one described above, with similar configuration options.

Refer to the helm chart documentation for a full list of available configuration options.

Percona Everest server and operator workflow

Database creation workflow

Here’s the database creation workflow in Percona Everest:

  1. The Percona Everest user is authenticated and logged in and a JWT Token is provided.
  2. The user creates a database, either through the frontend UI or everestctl or via the APl.
  3. The Percona Everest API is invoked to create a create a Custom Resource Definition (CRD). The Percona Everest server then creates a custom resource DatabaseCluster.
  4. In the everest-operator reconciliation loop, once the DatabaseCluster object is recognized, an appropriate custom resource for the database is created, for example if it’s PXC , PerconaXtraDBCluster is created.
  5. The database operator takes over the task of creating the database and the necessary objects to manage it.

    Note

    Other actions, such as creating backups, restores ,monitoring or deleting the objects follows a similar flow except the objects involved may differ.

    All the custom resources connected to Percona Everest follow a similar flow except the DatabaseEngine.

Database engine workflow

Here’s the workflow for the database engine in Percona Everest:

  1. The user installs the everest db namespace chart either as part of initial installation or as a separate step.
  2. Subscriptions are created for the operators chosen while installing the helm chart.
  3. OLM reconciles the Subscriptions and creates an InstallPlan.
  4. The helm chart creates a kubernetes job called everest-operators-installer that waits for the InstallPlan to be created and approves it.
  5. OLM detects that the InstallPlan has been approved and creates a ClusterServiceVersion, deploying all components that make up the database operator.
  6. The Percona Everest operator detects the deployment resource of the database operator and reconciles the DatabaseEngine CR of the corresponding type. During the reconciliation process, the everest operator detects the installed version and queries Percona’s Version Service.

Check Percona.com to get the engine versions supported by that operator. For example, mongod versions supported by PSMDBO v1.19.0.

Get expert help

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.