Skip to content

Automatically relocate audio files to S3 bucket

The MiaRec admin portal offers a feature to automatically relocate files to an external storage target, in this case, an AWS S3 bucket. This function moves an audio file from a local file system to an S3 bucket and updates a file path in the database for each call. Note, that function moves the file rather than creating a copy of it. A redundancy for audio files is achieved by the nature of the Amazon S3 service that provides 99.999999999% durability and 99.99% availability. Optionally, an automatic replication in the S3 bucket can be enabled, that copies asynchronous objects across S3 buckets. To enable such a replication, check the Amazon S3 User Guide.

Create a Storage Target

  1. Navigate to Administration > Storage > Storage Target.

  2. Select Add.

  3. Populate the fields that are appropriate for your deployment.

    Add Storage Target

  4. Name Unique Identifier for this storage target.

  5. Type Amazon S3.
  6. S3 Bucket Bucket name defined earlier.
  7. AWS Access Key ID and AWS Secret Access Key Access keys created for IAM user earlier.
  8. Region bucket region defined earlier.

  9. Select Save and Test.

  10. Verify all tests pass.

Test Storage Target

Schedule Relocate Audio Files Job

  1. Navigate to Administration > Storage > Relocate Audio Files.

  2. Select Add.

  3. Define the Access Scope, Mode and Destination storage target (defined in the previous step)

    Job Access Scope

    • Access Scope In most cases this will be Unrestricted seperate relocation jobs can be scheduled for individual tenants if needed.

    • Mode Incremental, system will only target files it has not previously relocated.

    • Destination storage target Defined in the previous step, is where files will be moved.

  4. Apply any filter criteria (optional)

    Job Filter Criteria

  5. Select a Schedule to execute

    Job Schedule

  6. Select Save and Start


Calls will be relocated to the external storage target and the file path will be updated in the database.

Verify Relocation Job

See job run results at Administration > Storage > Relocate Audio Files.

Relocation Job Results

Verify File Path

File Path can be displayed in Full Call details.

  • Select a recording from the recording tab and select More Detail.

  • At the bottom of the page, select Full call details.

  • The Files section should display the path reflecting the external storage.

Verify File Path