Changing the storage destination for the import data wizard, BIX, and file listeners

The storage destination is used by the import data wizard, BIX, and file listeners to store files. You can change the location to which the files are written using Dynamic System Settings. For example, for a multi-node system, you can set the destination to a shared location so that a user can access files from any node in the system.

  1. Click Create > SysAdmin > Dynamic System Settings.
  2. Enter a short description for the setting.
  3. In the Owning Ruleset field, enter Pega-ENGINE.
  4. In the Setting Purpose field, enter storage/class/defaultstore:/type.
  5. Click Create and open.
  6. In the Value field, enter the value for the setting. For example, filesystem, aws-s3, or azureblob.
    Note: filesystem is shared only when there is a network drive attached to each machine.
  7. If you are using aws-s3 or azureblob, configure the following additional settings:
    Option Description
    aws-s3
    • storage/class/defaultstore:/bucket – Required. Enter the AWS bucket name.
    • storage/class/defaultstore:/accesskeyid – Enter your AWS access key. The key is optional if you are using EC2 instances with attached IAM roles; otherwise, it is required.
    • storage/class/defaultstore:/secretaccesskey – Enter your AWS secret key. The key is optional if you are using EC2 instances with attached IAM roles; otherwise, it is required.
    • storage/class/defaultstore:/rootpath – Optional. Enter the root path under the bucket for this share.
    • storage/class/defaultstore:/kmsencryptionkeyid – Optional. To read or write encrypted files, enter the Amazon Key Management System (KMS) encryption key ID.
    azureblob
    • storage/class/defaultstore:/bucket – Required. Enter the Azure container name.
    • storage/class/defaultstore:/accesskeyid – Required. Enter your Azure user name.
    • storage/class/defaultstore:/secretaccesskey – Required. Enter your Azure secret access key.
    • storage/class/defaultstore:/rootpath – Optional. Enter the root path under the bucket for this share.
  8. Click Save.
    Note: You can also change the location using the prconfig.xml file or by updating the JVM arguments.
What to do next: For file listeners, you can view a list of storage destinations on the File Storage landing page. The landing page only displays storage destinations with a valid file specification and only repositories that are compatible with the file listener.