Github user bostko commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/98#discussion_r72747048
--- Diff: guide/ops/locations/_openstack.md ---
@@ -91,33 +143,95 @@ This is the same OpenStack location in a format that
can be added to your
brooklyn.location.named.My\
OpenStack.securityGroups=your-security-group
brooklyn.location.named.My\ OpenStack.keyPair=your-keypair
-Chose a value of `your-flavor-id` from one of the defaults, or create your
own flavor if
-you have administrator privileges.
-For for more information, see the
-[OpenStack flavors
guide](http://docs.openstack.org/admin-guide/cli_manage_flavors.html).
-The default flavors are:
+### Troubleshooting
- +-----+-----------+-----------+------+
- | ID | Name | Memory_MB | Disk |
- +-----+-----------+-----------+------+
- | 1 | m1.tiny | 512 | 1 |
- | 2 | m1.small | 2048 | 20 |
- | 3 | m1.medium | 4096 | 40 |
- | 4 | m1.large | 8192 | 80 |
- | 5 | m1.xlarge | 16384 | 160 |
- +-----+-----------+-----------+------+
+#### Cloud Credentials Failing
-For an even more detailed example location configuration, consult the
-[template properties
file](https://brooklyn.apache.org/v/latest/start/brooklyn.properties).
+If the cloud API calls return `401 Unauthorized` (e.g. in a
`org.jclouds.rest.AuthorizationException`),
+then this could be because the credentials are incorrect.
+A good way to check this is to try the same credentials with the
+[OpenStack nova command line
client](http://docs.openstack.org/user-guide/common/cli_install_openstack_command_line_clients.html).
-### Other features
-Consult jclouds' [Nova template
options](https://jclouds.apache.org/reference/javadoc/1.9.x/org/jclouds/openstack/nova/v2_0/compute/options/NovaTemplateOptions.html)
-for futher options when configuring Openstack locations.
+#### Unable to SSH: Wrong User
+
+If SSH authentication fails, it could be that the login user is incorrect.
For most clouds, this
+is inferred from the image metadata, but if no (or the wrong) login user
is specified then it will
+default to root. The correct login user can be specified using the
configuration option `loginUser`.
+For example, `loginUser: ubuntu`.
+
+The use of the wrong login user can also result in the obscure error shown
below, caused by
+an unexpected response saying to use a different user. For more technical
information, see
+this [sshj github issue](https://github.com/hierynomus/sshj/issues/75):
+
+ Received message too long 1349281121
+
+
+#### I Want to Use my Own KeyPair
+
+By default, jclouds will auto-generate a new [key
pair](http://docs.openstack.org/user-guide/cli_nova_configure_access_security_for_instances.html)
+for the VM. This key pair will be deleted automatically when the VM is
deleted.
+
+Alternatively, you can use a pre-existing key pair. If so, you must also
specify the corresponding
+private key (pem file, or data) to be used for the initial login. For
example:
+
+ location:
+ jclouds:clouds:openstack-nova:
+ ...
+ jclouds.openstack-nova.auto-generate-keypairs: false
+ keyPair: "my-keypair"
+ loginUser: ubuntu
+ loginUser.privateKeyFile: /path/to/my/privatekey.pem
+
+
+#### Error "docesn't contain ... -----BEGIN"
--- End diff --
typo "doesn't"
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
