All Collections
Using Perforce
Backing Up Perforce Depot to Amazon S3
Backing Up Perforce Depot to Amazon S3

Secure your Perforce depot content by backing it up and then exporting it to a selected Amazon S3 server.

Toshi Dávila avatar
Written by Toshi Dávila
Updated over a week ago

You can help secure your Perforce depot content by backing it up and then exporting it to a selected Amazon S3 server. This process maintains the depot structure at the same time as storing your data.

Note: Exporting your data may take up to a few hours depending on your Perforce depot size. When cloning the instance, the depot is locked for a few minutes, but then the depot is again available. Consider running this process when no users are accessing your Perforce depot.

Only one backup process may be in progress for each Perforce depot and the status displays accordingly when a user visits while a backup is processing. If a user attempts to start another backup while one is running, a warning message appears and prevents the user from continuing with the additional backup procedure.

You may cancel a backup process while it is running by simply clicking the Cancel backup button and confirming that you want to halt the current backup process.

  • Attention! When started (even if canceled), you will not be able to run another backup for this depot in the next 48 hours.

Accounts used to run this feature must have space owner and portfolio manager permissions. Before starting a backup, make sure you have an Access key and Secret key for your AWS account root user. See the process below if you need to create an access key.

To back up your Perforce depot, navigate to Your Space > Perforce Depot > Backups tab.

Complete the fields, and then click Start backup. While the backup is processing, status messages appear letting users know where in the process the backup is at any time.

When the backup is complete, the system sends an email notification to the address associated with the user account creating the backup.

If a backup fails, an error message appears indicating which step failed to complete. Try the backup again, verifying any information you entered before starting the backup process.

To create an Amazon S3 Bucket

  1. Sign in to the preview version of the AWS Management Console .

  2. Under Storage & Content Delivery, choose S3 to open the Amazon S3 console. ...

  3. From the Amazon S3 console dashboard, choose Create Bucket.

  4. In Create a Bucket, type a bucket name in Bucket Name. ...

  5. In Region, choose preferred option.

  6. Choose Create.
    When Amazon S3 successfully creates your bucket, the console displays your empty bucket in the Buckets pane.

Read more here.

To get your access key ID and secret access key

  1. Open the IAM console.

  2. On the navigation menu, choose Users.

  3. Choose your IAM user name (not the check box).

  4. Open the Security credentials tab, and then choose Create access key.

  5. To see the new access key, choose Show. Your credentials resemble the following:

    • Access key ID: AKIAIOSFODNN7EXAMPLE

    • Secret access key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

  6. To download the key pair, choose Download .csv file. Store the .csv file with keys in a secure location.

Read more here.

Notice: Please be aware this is a "Beta" functionality, if you will notice any issues please let us know in our support chat or send a message to support@assembla.com

This solution can not be used with our Perforce Enterprise Single Tenant solution.

Did this answer your question?