Using Pega Cloud File storage
Pega Cloud services provides your Pega Cloud with a default repository called Pega Cloud File storage.
Pega Cloud provides this file storage solution as a repository for your Pega applications' case attachments, Pega Cloud SFTP service transactions, archived cases , BIX extracts, and Exporting interactions and decision results.
Key benefits
- Integrated beginning with Pega Platform
7.3
Pega Cloud File storage is pre-configured to support your Pega Cloud applications. Disk space is pre-allocated with separate sub-folders for your cloud environments (development, staging, and production). Default paths are configured for each environment, and security settings used default to the credentials and keys in your Pega Cloud profile.
- Cost-effective cloud file storage
Pega Cloud File storage is a cost-effective solution for storing archived cases, case attachments, BIX data extracts, and data uploaded through the Pega Cloud SFTP service. Pega Cloud production subscription clients receive 500 GB of file storage to use across all environments in the subscription. Pega Cloud production subscribers can purchase additional Pega Cloud File storage in 500 GB increments. Pega Cloud File storage costs significantly less than our cloud database storage and is priced well below many of our competitors.
- No limits on file counts or total storage size
By not limiting the number or size of files stored, Pega Cloud File storage can scale to your business needs. Individual files can be up to 5 TB.
- Secure, private, and reliable solution
Pega Cloud File storage is highly reliable, private, and secure. Only your applications can access your storage space, and data is encrypted both in transit and at rest.
- The same support staff for both your application and your cloud
file storage
The Pega Cloud Support team provides support for Pega Platform, strategic application solutions, and Pega Cloud File storage. This breadth of knowledge results in faster and more effective responses, which third-party storage providers cannot match. Pega support services are available 24 hours a day, seven days a week.
- Soft limits on storage space
By providing soft limits on storage space, Pega Cloud File storage gives you time to clean up your storage space or purchase additional storage, averting an out-of-space crisis.
- Data retention policy
For archived case data, you can apply a data retention policy to delete archived files from Pega Cloud File storage. For more information, see Case archiving and purging overview.
After you delete a file in Pega Cloud File storage, such as by using a data retention policy or REST API, you can recover the file within 30 days of deletion. To review this Pega Cloud servicespolicy details, see Database backup and restore.
Pega Cloud services will not delete any data in your Pega Cloud File storage repository until Pega Cloud services decommissions an environment at your request. For more information about Pega Cloud File storage, contact you Pega Account Executive.
Overview of repository names Pega Cloud services provides by default
When Pega Cloud services provisions your environment, it creates two repositories in your Pega Cloud File storage for your environment, pegacloudfilestorage and for SFTP, a mapping from pegacloudrepository to pegacloudfilestorage/sftp. To see both of these destinations in the Storage Destinations view in Dev Studio, from the header of Dev Studio, click ConfigureSystemSettingsFile Storage.
Pega Platform structures the Pega Cloud File storage directory using the logic displayed in the following image.
You must select or reference the appropriate repository record for your Pega Cloud File storage repository and the associated sub-folder when using Pega Platform to perform the following actions:
Usingpegacloudfilestorage
(/attachments ,
/archive ) | Using pegacloudrepository
(/bix ) | ||
To select Pega Cloud File storage for your application content storage; for an overview, see File and content storage. | Select pegacloudfilestorage from the repository list, then browse for the /attachments sub-folder. | To use a REST API to add or delete SFTP files; for an overview, see Using repository APIs in your application. | Enter pegacloudrepository in the destination field. |
To select Pega Cloud File storage for your application case or pulse attachments; for an overview, see Sourcing attachments from external storage. | Select pegacloudfilestorage from the repository list, then browse for the /attachments sub-folder. | To obtain your BIX extract files using an activity; for an overview, see Configuring an activity to access BIX extract files. | Enter pegacloudrepository in the
repository name field. Pega Platform automatically creates the
/bix sub-folder after you run an initial extraction
process. |
To send file attachments from Pega Cloud File storage using a REST or SOAP API; for an overview, see Use case: Send file attachments from a repository. | Select from the pegacloudfilestorage repository list, then browse for the /attachments sub-folder. | When configuring your Pega Cloud SFTP service or BIX FTP listener to access your BIX extract files; for an overview, seeOverview of BIX extractions in Pega Cloud environments. | In the BIX/sharedpath DSS, enter the filespec file://pegacloudrepository:/bix. |
To process inbound file attachments for storage in Pega Cloud File storage using a REST or SOAP API; for an overview, see Use case: Process inbound file attachments for storage in a repository. | Enter pegacloudfilestorage in the repositoryName field, then /attachments in the folderPath field. | To create additional sub-folders in the /sftp directory. | For detailed steps, see Pega Cloud SFTP service FAQ. |
To configure a file listener to process storage in a repository; for an overview, see Using file listeners. This does not apply to extract files. | Enter filespec file://pegacloudfilestoragein the repositoryName field, then /attachments in the folderPath field. | ||
To obtain Pega Cloud File storage files using the Connect-FTP method, see Connect-FTP method. | Enter file spec file://pegacloudfilestorage:/attachments in the remoteFile field as an example. | To obtain BIX extract files from Pega Cloud File storage using the Connect-FTP method, see Connect-FTP method. | Enter file spec file://pegacloudrepository:/bix in the remoteFile field, as an example. |
To improve your application performance you can archive outdated case files and place them in your Pega Cloud File storage repository; for an overview, see Case archiving and purging overview. | Pega Platform automatically creates the pegacloudfilestorage/archive repository record sub-folder when you run the initial archival job. |
Accessing and managing files in your Pega Cloud File storage pegacloudfilestorage repository
For Pega Cloud services environments, Pega uses Pega Cloud File storage as the default repository, which appears as
pegacloudfilestorage
in the list of repositories in .
Pega Cloud services does not allow direct access to the filesystem in a Pega Cloud File storage repository; instead you manage your files in a Pega Cloud File storage repository with the following methods:
- Use a Pega Platform repository API to manage files in your repository; for an overview, see Using repository APIs in your application.
- Use an SFTP client to interact with the Pega Cloud File storage dedicated SFTP sub-folder through the Pega Cloud services SFTP service, for an overview; for an overview, see Using Pega Cloud SFTP service.
- Configure a file listener to process files in a repository; for an overview, see Using file listeners.
Using Pega Cloud File storage repository records and sub-folders
Pega Cloud File storage stores applicable files in different sub-folders depending on the feature Pega Cloud File storage utilizes.
Select the appropriate record for the following Pega Platform features and use cases:
- The pegacloudfilestorage record maps to the
sub-folders
/attachments
for case attachments and\archive
for archived case files.Caution: The pegacloudfilestorage record also contains the /sftp sub-folder, but do not select or use the /sftp sub-folder for case attachments and Pulse comments. - To configure the location for Pega application case attachments, use the
pegacloudfilestorage repository record
and the
/attachments
sub-folder. - To reference archived case data in Pega Cloud, use the pegacloudfilestorage/archive repository record sub-folder, which Pega Platform automatically creates when you run the initial archival job. For case archiving information, see Case archiving and purging overview.
- To create a temporary file storage location sub-folder in
pegacloudfilestorage, use the following method:
- In the navigation pane of Dev Studio, go to .
- In the Data Page instance list, filter the Page Name column for D_pxNewFolder and select it.
- In the Actions list, select Run.
- In the Run Data Page: New Folder
dialog window, specify your new sub-folder by entering the
following information:
- In the repositoryName field, enter pegacloudfilestorage.
- In the folderPath field, enter your new folder name. For example, enter new_folder to create pegacloudfilestorage\new_folder.
- To create the folder, in the Run Data Page: New
Folder dialog window, select
Run.
For more information about Pega repository APIs, see Using repository APIs in your application.
- To configure the location for Pega application case attachments, use the
pegacloudfilestorage repository record
and the
- The pegacloudrepository record maps to the
pegacloudfilestorage/sftp subfolder for files you export from Pega Platform using the SFTP Service and the
/bix
subfolder for extract files. To reference the location used by the Pega Cloud SFTP service, or BIX extract files, use pegacloudrepository.When you manage files using an SFTP client configured to use your Pega Cloud SFTP service URL, the pegacloudrepository record in Pega Platform automatically directs your connection to the pegacloudfilestorage/sftp sub-folder. From the client, your access to this folder originates at the filepath,
/
. For example:sftp> put test.txt Uploading test.txt to /test.txt test.txt 100% xxxKB xxMB/s 00:01 sftp> get test.txt Fetching /test.txt to test.txt /test.txt 100% xxxKB xxMB/s 00:01
- To reference, export, or delete BIX extract files using the Pega Cloud SFTP service, BIX FTP server, or an activity,
use pegacloudrepository/bix
sub-folder.
Pega Platform creates the
/bix
sub-folder after you run an initial extraction process. For more information, see Overview of BIX extractions in Pega Cloud environments.
- To send files to your FTP server through a Connect-FTP method, you can source
the file location using either pegacloudfilestorage
and pegacloudrepository with the file specification
format file://pegacloudfilestorage:/attachments or
file://pegacloudrepository:/bix.
For more information, see Connect-FTP method.
Previous topic File management options Next topic Using Pega Cloud SFTP service