Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This page describes how you configure your deployment for persistent storage.

Pre-requisites

Before your helm chart can be configured for persistent storage, the PersistentVolumeClaim resource that you are going to use must exist, and it must exist in the same namespace as where Usage Engine will be deployed.

Tip
titleHint!

If you are unfamiliar with how persistent storage works in Kubernetes, please check out the official Kubernetes documentation on this topic.

...

Applying the above yaml using kubectl will create a PersistentVolumeClaim called mz-pvc that you can refer to from the helm chart.

Configuring the Helm Chart

Now that the PersistentVolumentClaim resource exists, it is time to configure the helm chart to use it.

To do this, you set persistence.enabled=true and persistence.existingClaim=mz-pvc and then do a helm upgrade/install.

Runtime

Below is an explanation of how the persistent storage is being used in runtime. All the directories listed can be found within the /opt/mz/persistent directory in your platform, web desktop and EC pod(s).

...


You are free to create whatever additional files/directories under /opt/mz/persistent that your use case may require.

If you, for for example, need to share data between the platform and EC pod(s), you can create a directory /opt/mz/persistent/data and use that to exchange information. 

Adding 3PP or Java Native Library Files

You can take two different approaches when adding the 3pp jar files or any jni files needed for certain agents or functionalities in .

Anchor
add_3pp_jni
add_3pp_jni

Before Installation

Follow the steps below to add 3pp or jni files before you install . Perform these steps after the PersistentVolumeClaim has been set up.

  1. Create the following directories in your persistent volume. This example assumes that the NFS storage example in the Pre-requisites section has been used.

    Code Block
    titleExample - Creating directories
    mkdir /nfs_share/persistent/3pp
    mkdir /nfs_share/persistent/jni


  2. Add the 3pp jar files or the jni files into their respective folders.
  3. Proceed with the installation.   will detect the existence of the directories and the files. It will not overwrite or remove the folder.

Post Installation

Follow the steps below to add the 3pp or jni files any time after the installation of .

...