Backup and Restore of object Attachments
You can backup and restore object attachments on Cloud or Server/DC for further migration into the cloud or on Server/DC.
Table of Contents
Licensing
To enable this feature for Cloud, Assets Attachments Backup & Migration should be installed on the source and target Cloud instances (in case of cloud-to-cloud migration). The app has no limitation in a trial mode.
For enabling this feature for Server/DC, Insight Assets Cloud Migration Assistant installed on the source instance is a prerequisite. In addition, to acquire attachments migration feature, please contact our Service Desk. Without acquiring the attachments migration feature, you will be able to migrate 50 objects in trial mode of the Insight Assets Cloud Migration Assistant app.
Therefore, to enable the full migration of the attachments:
Insight Assets Backup & Migration should be installed on a target Cloud instance.
Assets Attachments Backup & Migration should be installed on a target Cloud instance.
Insight Assets Cloud Migration Assistant should be installed on the source and target DC/Server instances.
The attachments feature must be acquired (20% of the price of the DC/Server app, please contact our Service Desk for more details).
DC/Server app * | DC/Server Attachments feature | Any Cloud app ** | Attachments Migration |
---|---|---|---|
Trial or subscription | Not acquired | Trial or subscription | 50 attachments |
Subscription | Acquired | Trial or subscription | Full migration |
Trial or subscription | Any status | Expired or unlicensed | Disabled |
Expired or unlicensed | Any status | Trial or subscription | Disabled |
* Insight Assets Cloud Migration Assistant
** Insight Assets Backup & Migration and Assets Attachments Backup & Migration
You can see the current status of the attachments restore/migration feature along the current connection and added DC/Server instance details:
Current Connection - Attachments status
Shows the status of the Assets Attachments Backup & Migration app on the cloud instance:
Not installed - the app is not installed on the cloud instance
Licensed - the app is installed in trial or a subscription is acquired
Unlicensed: Trial or the subscription is expired
Data Center / Server - Attachments migration
Not installed - Insight Assets Cloud Migration Assistant is not installed on the DC/Server instance
Limited
Insight Assets Cloud Migration Assistant is installed with a trial license
Insight Assets Cloud Migration Assistant is purchased, but the attachments feature is not enabled
Expired - Insight Assets Cloud Migration Assistant trial or license is expired
Addon Disabled - Insight Assets Cloud Migration Assistant is disabled
Licensed - Insight Assets Cloud Migration Assistant is purchased and the attachments feature is enabled
The status of the attachments feature is automatically refreshed every 3 hours. To check the status immediately, click Refresh () icon along the status for Cloud and DC/Server connections (several seconds might be needed for the status to be updated).
Backup
After the Assets Attachments Backup & Migration is installed in the cloud, you will be able to backup also attachments associated with the object schemas. To do so, switch the toggle either during manual backup or for the scheduled backups of the desired schema:
If the app is not installed or not licensed (e.g. trial or the subscription expired), you will see either NOT INSTALLED and UNLICENSED statuses respectively, and the toggle will be disabled.
When the backup is taken with the enabled backup of attachments, you will see the status and the number of the attachments in the available backups:
The app supports 10 parallel backup processes of the attributes. If more processes are started (app-wise), the status will be IN QUEUE and move to PENDING and IN PROGRESS, as soon as the previous attachment backups are completed. You don’t need additional action, the backup will starts as soon as the queue is available.
Restore / Migration
With the trial license of the DC/Server app, it is possible to restore 50 attachments of random objects for testing purposes.
To restore/migrate the attachments, initially, the schema containing the attachments must be restored/migrated. After the schema is restored, you will be able to restore the attachments. To do so, go to the Restores of the schema and click either the “Attachments” or “Restore Attachments“ buttons along the schema in the “Restores” grid:
After clicking the button, you see the confirmation popup:
After clicking the “Restore Attachments“ button, the restore will start and you will be able to monitor the progress in the Attachments box under the schema restore details:
From here you can:
Stop the process of the process restore
Termination may take some time (up to 2 minutes), therefore if the process is stopped by the end of the progress, restore still might have been completed! The “Restore ended” will show date/time when the restore was terminated. Additionally, if you click the STOP button more than once, until the process is stopped and start a new restore during this 2-minute period, the newly started process might also be stopped!
See the start and end time/dates of the restore
Check the restore status
Pending
In Progress
Terminated (if the restore was stopped by the user)
Error (you will see the error details)
Success (when the restore is completed successfully)
Restore result
When in progress, you will be able to check how many attachments are restored (e.g. “Processed: 300 from 28,374 restored”)
If for some reason the corresponding object does not exist in the schema, the Result message will be “Some of the attachments were not restored. Please see the log for more details.“
Full log
When the process is finished, you will be able to download the full restore log JSON with the following information
ObjectKey
Result
True (if the attachment is restored)
False (if the attachment is not restored)
Message
Name of the attachment
Real-time log
You can check the progress of the restoration during the process and see the errors for the specific object attachments.
- Real-time log of attachments restoreError in the real-time log
Additional Remarks
After the first full backup of the schema attachments, all the subsequent backups will be incremental, therefore taking less time.
The attachment backups are not stored in the database, therefore if you choose local database as storage of backups, the attachments will not be stored there. Attachments are stored in Amazon S3 cloud object storage (US West (N. California) us-west-1). The backups are stored for 4 months.
While restoring in the existing schema, if the object exists in the schema (an therefore skipped during the restore), but lacks the attachment, the attachment can be restored. The attachments already added to the objects, will be skipped (Full and real-time log will contain the information about this).
Due to the limit of the Atlassian Assets Cloud, maximum size of the attachments to be restored or migrated is 10MB.