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 will be deployed.

...

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).

PathDescription
/opt/mz/persistent/3pp

This is where additional 3pp jar files needed for are stored. Additional information about how this works can be found below

/opt/mz/persistent/jniThis is where jni files are stored. Example: SAP RFC native library will be stored here.
/opt/mz/persistent/log

This is where the platform, ec and web desktop logs are stored.

Note
titleNote!

You will need to periodically archive EC and Web Desktop logs manually as the log4j mechanism to help automatically archive the files does not work for these two particular logs.


/opt/mz/persistent/backup

This is where the backup of your configuration will be stored in zip format.

/opt/mz/persistent/keysDisk based keystore is a deprecated feature. Please refer to Bootstrapping System Certificates and Secrets - AWS [hide]2.2[/hide] (2.2)  for information about how to do this in the preferred way.
/opt/mz/persistent/storageThis is where the mzdb storage for your deployment is stored when it is using Derby as platform database.


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 .

...