Bug 1008053

Summary: Restore documentation doesn't reflect ability to specify filename
Product: OpenShift Online Reporter: Naveen Malik <nmalik>
Component: DocumentationAssignee: brice <bfallonf>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 2.xCC: jokerman, mmccomas, nmalik
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Build: CSProcessor Builder Version 1.12 Build Name: 18397, User Guide-null-1.0 Build Date: 29-08-2013 13:11:27 Topic ID: 18396-499812 [Latest]
Last Closed: 2013-10-17 13:28:47 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Naveen Malik 2013-09-14 00:44:31 UTC 
Title: Restoring Application Snapshots

Describe the issue:
Documentation states:

"Even though you can save your application using a different filename, you cannot restore that application to a different name. That is, if your application name is "MyApp", you can save it as OurApp.tar.gz, but when you restore it you must use the original application name. "

But the next section "8.3. Migrating an Application to Another Gear" shows an example where you can specify the filename on a restore:

"rhc snapshot restore phpapp -f phpapp.tar.gz"

Suggestions for improvement:
Update restore documentation to note ability of specifying any filename for restoration.


Additional information:
Usage: rhc snapshot-restore <application> [--filepath FILE]

Restores a previously saved snapshot


Options
  -n, --namespace NAME      Namespace of the application you are restoring a snapshot
  -f, --filepath FILE       Local path to restore tarball
  -a, --app NAME            Application of which you are restoring a snapshot

Global Options
  -l, --rhlogin LOGIN       OpenShift login
  -p, --password PASSWORD   OpenShift password
  --token TOKEN             An authorization token for accessing your account.
  --server NAME             An OpenShift server hostname (default: openshift.redhat.com)
  --timeout SECONDS         The timeout for operations

  See 'rhc help options' for a full list of global options.