Azure-docs: Missing restore content?

Created on 4 Dec 2018  Ā·  4Comments  Ā·  Source: MicrosoftDocs/azure-docs

The title says "Backup and restore actors". However, I do not see anything about restoring actors.


Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com āžŸ GitHub issue linking.

assigned-to-author doc-bug service-fabrisvc triaged

All 4 comments

Thanks for the feedback! I have assigned the issue to the content author to investigate further and update the document as appropriate.

@AdamPliska
The referenced document's very first note at the top of the page links to:
https://docs.microsoft.com/azure/service-fabric/service-fabric-backuprestoreservice-quickstart-azurecluster

I.E. How to enable the Backup and Restore Service.

Further concepts on Backup and Restore are here:
https://docs.microsoft.com/azure/service-fabric/service-fabric-backup-restore-service-trigger-restore

@MicahMcKittrick-MSFT
If the user is satisfied with the linked and referenced documentation on Reliable Service State Restoration; please close this.

I respectfully disagree with the resolution of this ticket. The title of this document ā€œImplement Reliable Actors backup and restoreā€ suggests I will see implementation of backup AND restore functions within the framework. The simple help document offers a sample demonstration of backing up a custom actor service, which outlines the use of this.BackupAsync(new BackupDescription(PerformBackupAsync)); and will naturally lead me to learning more by looking up those methods. However, I see no similar example for the restore part of the title of the document in question, again that’s: document ā€œImplement Reliable Actors backup and restoreā€.

The URL given: https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-backuprestoreservice-quickstart-azurecluster also does not contain any information about restoring from a backup. After reviewing the page given, I can list my backups, but I see no information about how to use such a backup to affect a restore.

If this feature (the restore) is automatic, it is lost on me. In the event I have a service failure, I do not believe this information will adequately help me preform a restore, even if I follow the examples outlined in either page.

Thank you for your consideration

In the Next Steps of the document I provided, which is the first link in the document you referenced:
https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-backuprestoreservice-quickstart-azurecluster

Points to:
https://docs.microsoft.com/en-us/rest/api/servicefabric/sfclient-index-backuprestore

Which lists "SF backup and restore" Restore Partition Rest URI and parameters:
https://docs.microsoft.com/en-us/rest/api/servicefabric/sfclient-api-restorepartition

You should NOT TEST THIS IN PRODUCTION, and should be trying this out on your OneBox.

Please let us know if satisfies your ask, or provide additional clarity on how we can provide supportability content for how to invoke SF's Rest API.

@MicahMcKittrick-MSFT
Please close this.

Was this page helpful?
0 / 5 - 0 ratings