Creating advanced storage devices for Content Platform Engine containers

You configure security and prepare the environment before using the Administration Console for Content Platform Engine to create the advanced storage device.

About this task

For an overview of advanced storage devices, see the topic Advanced storage devices.

Procedure

  1. If the advanced storage device will be configured for HTTPS certificate validation, you must obtain a client SSL certificate and import it into the truststore for the Content Platform Engine containers.
    1. For information about the client SSL certificate, see Obtaining a client SSL certificate.
    2. Create a custom keystore for the Content Platform Engine containers.
  2. Prepare the environment according to which type of advanced storage device you plan to use:
    • File System Storage device
      1. Prepare the file system using the persistent volume that was provided when the Content Platform Engine containers were deployed. See Preparing storage for FileNet P8 file storage areas and index areas for details on requirements for the storage.
      2. Create a folder to represent the advanced storage device under the location used for the persistent volume claim given to the Content Platform Engine deployment. For example, if the Content Platform Engine filestore volume claim is to /data/FMdomain_Marketing, you might create a folder for the file system advanced storage device at /data/FMdomain_Marketing/ASAD2.
      3. Use the chown command to ensure the folder representing the advanced storage device are accessible to the Content Platform Engine containers. For example:
        (V5.5.2)
        chown –Rf 50001:50000 /data/FMdomain_Marketing/ASAD2
        (V5.5.1)
        chown –Rf 501:500 /data/FMdomain_Marketing/ASAD2
      4. Determine the value for the Root Directory Path based on the mountPath from inside the container, /opt/ibm/asa. Using the example from the earlier step, your Root Directory Path would be /opt/ibm/asa/ASAD2.
    • S3 Storage device
      1. Refer to Creating an S3 storage device for detailed information.
      2. To supply JVM arguments, add them into a file named jvm.options and put that file in the persistent volume location provided for the Content Platform Engine Liberty configuration data directory, for example, /cpecfgstore/cpe/configDropins/overrides. JVM arguments referenced are prefixed with –Dcom.filenet. when placed into the jvm.options file. For example, the option Advanced.S3.DeleteSpecificVersion, if set to true, would be a line in a file named jvm.options appearing as:
        -Dcom.filenet.Advanced.S3.DeleteSpecificVersion=true
  3. Create the advanced storage device:
    1. Log in to the Administration Console for Content Platform Engine and navigate to Domain > Object stores > object_store > Administrative > Storage > Advanced storage > Advanced storage devices.
    2. Choose the S3 storage device type and click New.
    3. Complete the wizard to create the advanced storage device.