Add an S3 repository to provide centralized storage resource. Your application can then use the S3 repository to store and source file attachments.
- To create a repository, your access group must have the PegaRULES:RepositoryAdministrator role. To use a repository, your access group must have the PegaRULES:RepositoryUser role.
- Ensure that you review the restrictions of adding a repository for case attachments in Requirements and restrictions for case attachments in a file storage repository. If you fail to observe restrictions while you implement a repository, you can experience system failures.
- In the header of Dev Studio, click .
- Enter a short description of the repository and the repository name and click Create and open.
- In the Definition tab, click Select and select the repository type.
- In the Bucket field, enter the S3 bucket location where
artifacts are stored.The value in this field should match the name of the bucket in your Amazon S3 account. For more information, see your Amazon Simple Storage Service documentation.
- In the Authentication profile field, enter the name of
the authentication profile to connect to the repository. To create an
authentication profile, click the target icon to the right of the
Authentication profile field.
Note: Do not select the Provide secret access key by reference in clear text check box when creating an authentication profile for a repository. This check box is only used when entering Global Resource Settings, and Global Resource Settings are not supported for repositories.
- To enable data encryption at its destination by the service that receives the data, select Server side data encryption with KMS managed keys.
- In the KMS key ID field, enter the customer master key
or data key that you generated to secure the data in your Amazon S3
bucket.For more information, refer to your Amazon Simple Storage Service documentation.
- In the Root path field, enter the location of the root folder in Amazon S3.
- Optional: In the Advanced settings section, the system automatically
populates the following fields with the corresponding AWS SDK values. You can
edit the field values, for example, if you are storing large files and need to
increase connection timeout or pool size.For more information, see the AWS developer documentation.
- The value in the Connection max idle time field indicates the default maximum idle time, in milliseconds, for a connection in the connection pool.
- The value in the Max connection pool size field indicates the default maximum size of the connection pool.
- The value in the New connection timeout field indicates the default timeout for creating new connections, in milliseconds.
- The value in the Expiration time for connections in the pool field indicates the default expiration time, in milliseconds, for a connection in the connection pool.
- The value in the Request timeout fields returns the amount of time to wait, in milliseconds, for the request to complete before timing out. If you enter a negative value, request timeout is disabled.
- To collect data on the health of your repository connection, select Enable metric collection.
- Click Test connectivity to verify whether your credentials are valid.
- Click Validate repository to test the connection to the Repository APIs and review the results in the Test Repository Connectivity window. The results include the total time to complete the test, the Repository APIs tested, and the status of the connection.
- Click Save.