Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1014849

Summary: How to create a keypair is missing in Chapter 7
Product: Red Hat OpenStack Reporter: Summer Long <slong>
Component: doc-Getting_Started_GuideAssignee: Bruce Reeler <breeler>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: high Docs Contact:
Priority: high    
Version: 4.0CC: alyoung, breeler, hateya, rlandman, yeylon
Target Milestone: ---Keywords: Documentation
Target Release: 4.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-01-06 03:42:40 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:
Bug Depends On:    
Bug Blocks: 1011085    

Description Summer Long 2013-10-02 22:51:52 UTC 
Document URL: 
https://access.redhat.com/site/documentation/en-US/Red_Hat_OpenStack/3/html-single/Getting_Started_Guide/index.html

Section Number and Name: 
7.2. Launching an Instance

Describe the issue: 
This section has the following command, and assumes the existence of a keypair:
$ nova boot --flavor 2 --key_name oskey --image 17a34b8e-c573-48d6-920c-b4b450172b41 rhel

If the chapters are being used as a procedure, this step is missing.

Suggestions for improvement: 
Add a section, 'Creating a Keypair' (analogous to the same chapter in the Dashboard section).

Additional information:
Comment 2 Summer Long 2013-10-18 00:14:12 UTC 
Bruce, here's the info from the old Compute Admin guide upstream:
 Adding a keypair

The Compute service can inject an SSH public key into an account on the instance, assuming the virtual machine image being used supports this. To add a keypair to the Compute service, use the nova keypair-add command. This command can be used to either generate a new keypair, or to upload an existing public key. The following example uploads an existing public key, located at ~/.ssh/id_rsa.pub, and gives the keypair the name mykey.

$ nova keypair-add --pub_key ~/.ssh/id_rsa.pub mykey
List the keypairs by doing:

$ nova keypair-list
+-------+-------------------------------------------------+
|  Name |                   Fingerprint                   |
| mykey | c3:d2:b5:d3:ec:4a:29:b0:22:32:6e:34:dd:91:f9:cf |
+-------+-------------------------------------------------+
Confirm that the uploaded keypair matches your local key by checking your key's fingerprint with the ssh-keygen command:

$ ssh-keygen -l -f ~/.ssh/id_rsa.pub
2048 c3:d2:b5:d3:ec:4a:29:b0:22:32:6e:34:dd:91:f9:cf /home/myaccount/.ssh/id_rsa.pub (RSA)
Comment 3 Bruce Reeler 2013-10-21 05:55:08 UTC 
Added commands on how to add a keypair to Nova using the CLI.
Comment 8 Bruce Reeler 2013-11-26 00:28:49 UTC 
Added section "8.2 Adding or creating a keypair" in command line interface chapter.