The DynamoDB persistence is usually set up automatically for you and does not require any further options when running in AWS. Only in case of using different data location, e.g. locally, it may be required to add additional parameters:

# Default
inet_persistence="dynamodb:"
 
# Advanced
inet_persistence="dynamodb:Region=eu-west-1;Endpoint=http://localhost:8000;TablePrefix=my-table-prefix;accessKeyId=dummy-key;secretAccessKey=dummy-secret"

Note: The properties Region, Endpoint, TablePrefix, accessKeyId and secretAccessKey are optional. Properties are separated by a semicolon. Of no properties are set, the configuration is derived from the container environment, which is by default the case.

Note: The inet_persistence URI is not an ARN even though it may look similar.

Note: When using the DynamoDB persistence in a docker container, please also define the environment property DEFAULT_CONFIG=System/Default. A cloud-based persistence requires the configuration to be stored in a system scope.

The TablePrefix property allows to run multiple instances in the same account. The allowed characters are: a-z, A-Z, 0-9, ., - and _.

Note: before changing the prefix, you have to create a backup in the maintenance application and restore it after the change. Otherwise, you may suffer data loss for an always running instance.

Using the DynamoDB persistence requires additional components to be installed into the plugins/persistence subfolder of the installation. There are pre-made Docker containers in case of a containerized usage.

If the respective files do not yet exist, you have to download them from the public maven repository at:

• Persistence main jar: release version
• DynamoDB driver package: release version

The DynamoDB driver package has to be extracted into the plugins/persistence subfolder. The persistences main jar has to be saved into this directory without extracting it.

Note: You have to navigate and download the version matching your installation.

Note: In addition to the released version, there may be beta versions available: Persistence beta version, DynamoDB beta version package

The following numbers will allow getting an insight on how much memory is required: