Archive Files to S3-Compatible Object Storage

Yeastar P-Series PBX System supports archiving the system's call recordings and backup files to any S3-compatible object storage, either on a regular interval or at any time you want. This topic describes how to add S3-compatible object storage as an archive server and schedule tasks to archive the desired files.

Note: This topic describes the required configuration for archiving PBX files to S3-compatible object storage. For Amazon S3, we provide more detailed guidance, refer to Archive Files to Amazon S3.

Requirements

Service Provider Requirement
Yeastar PBX
  • Firmware: Version 37.21.0.66 or later
  • Plan: Enterprise Plan or Ultimate Plan
S3-compatible Storage Provider
  • Account: Full access to S3 resources for archiving PBX files.

Limitations

  • Archive server: 10
  • Archive task: 200

Step 1. Create an access key pair

Create an access key pair (including an access key ID and a secret access key) to authenticate file archiving requests from PBX.

For detailed instructions, refer to the storage provider's documentation.

Step 2. Create an S3 bucket

Create an S3 bucket to store archived PBX files.

For detailed instructions, refer to the storage provider's documentation.

Step 3. Add S3 bucket as archive server on PBX

  1. Log in to PBX web portal, go to System > Archive.
  2. Under the Archive Task tab, click Archive Server.

  3. Set up S3 bucket as an archive server.
    1. Click Add.
    2. In the pop-up window, complete the following settings.

      Setting Description
      Name Enter a name to help you identify the server.
      Server Type Select S3.
      Region & Endpoint

      Enter the region of your S3 bucket, and the corresponding S3 endpoint with the required protocol (e.g., https://).

      Tip: For supported regions and their standard S3 endpoints, refer to the storage provider's documentation.
      Access Key ID Enter the access key that you have obtained from the storage provider.
      Secret Access Key Enter the secret access key that you have obtained from the storage provider.
    3. Click Save.

      The S3 bucket is added as an archive server and displayed on the archive server list.

  4. Click to close the window.

Step 4. Create a task to archive files to S3 bucket on PBX

  1. Under Archive Task tab, click Add.
  2. Create a one-time or recurring archive task.

    Setting Description
    Name Enter a name to help you identify the task.
    File Type Select Recording Files or Backup Files as needed.
    Data Range Specify a time range of the files to be archived.
    Note: You can archive files for up to 31 days at a time.
    Sync Frequency Set how often to archive files to S3 bucket.
    Note: As large amounts of data will consume PBX's CPU resources, we recommend that you schedule archive tasks during off-peak hours.
    • Once: If you choose the option, the system will archive files immediately after you save the task.
    • Daily: If you choose the option, select a time from the drop-down list. The system will archive files at this time of the day.
    • Weekly: If you choose the option, choose a day of week and select a time from the drop-down list. The system will archive files at this time of the week.

    • Monthly: If you choose the option, choose a day and select a time from the drop-down list. The system will archive files on this day and time of the month.
    Recording File Format Select the download format for recording files.
    Note:
    • This option is available only when both of the following conditions are met:
      • The task is scheduled to archive recording files.
      • Stereo-separated recording is enabled (Path: Call Features > Recording > Support generating stereo-separated recording files).
    • All recording files in the system will be downloaded and archived in the selected format.
    Archive Server Select the S3 bucket that you have added.
    Select Folder/Path Select the bucket or the folder in which you want to store archived files.
    Skip archived files Optional. Specify whether to skip files that have already been archived.
    Note: This option is available only when you schedule to archive recording files.
    • If enabled, the system will NOT archive files that have already been archived.
    • If disabled, the system will archive files even if they have been previously archived. The file's storage location will be updated, but the previous copy will NOT be deleted from the third-party server.
    Delete local files after archiving Optional. Specify whether to delete local files after archiving.
    Note: This option is available only when you schedule to archive recording files.
    • If enabled, the local files will be deleted after archiving. They can still be played and downloaded from PBX admin portal and Linkus UC clients, but are NOT longer available for playback and download on third-party server or Dynamics 365.
    • If disabled, the local files are retained after archiving.
  3. Click Save.

Result

The specified files will be archived to the designated bucket or folder immediately or at the scheduled time.
Note: The system executes only one task at a time to avoid affecting system performance. If there are multiple tasks, they will be queued up one after another.
You can check the archive result in the following ways.
Check the archive result on PBX
On PBX web portal, go to System > Archive > Archival Logs. If the Result column of the task shows Succeeded, it indicates that the specified files have been successfully archived to S3 bucket.

Note: If the task is failed, the Failed to Archive File(s) event will be triggered; You can click to retry the task.

Check the archive result on storage provider
On storage provider's portal, go to the created S3 bucket. If the specified files appear in the list, it indicates that the archive is successful.