Skip to content

Commit 0c6b1db

Browse files
Jamie Hannafordycombinator
authored andcommitted
Clarify openstack setup; fixes #507
1 parent c9f0bf6 commit 0c6b1db

File tree

1 file changed

+15
-4
lines changed

1 file changed

+15
-4
lines changed

docs/getting-started-openstack.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -48,9 +48,20 @@ In this case, we want to use the Nova service:
4848
$compute = $client->computeService('nova', 'regionOne');
4949
```
5050

51-
The first argument is the __name__ of the service as it appears in the OpenStack service catalog. If in doubt, you can
52-
leave blank and it will revert to the default name for the service. The second argument is the region. The third and
53-
last argument is the type of URL; you may use either `publicURL` or `internalURL`.
51+
The first argument is the __name__ of the service as it appears in the OpenStack service catalog. For OpenStack users, this must be retrieved and entered in your code. If you are unsure how to retrieve the service name, follow these steps:
52+
53+
1. Setup the `$client` object, as above
54+
2. Copy and run this code:
55+
56+
```php
57+
$client->authenticate();
58+
59+
print_r($client->getCatalog()->getItems());
60+
```
61+
62+
3. This will output all the items in your service catalog. Go through the outputted list and find your service, making note of the "name" field. This is the name you will need to enter as the first argument. You will also be able to see the available regions.
63+
64+
The second argument is the region. The third and last argument is the type of URL; you may use either `publicURL` or `internalURL`.
5465

5566
### 3. Select your server image
5667

@@ -187,4 +198,4 @@ $server->delete();
187198
Consult our [documentation](https://github.com/rackspace/php-opencloud/tree/master/docs/userguide) about other services
188199
you can use, like [Keystone](https://github.com/rackspace/php-opencloud/tree/master/docs/userguide/Identity) or
189200
[Swift](https://github.com/rackspace/php-opencloud/tree/master/docs/userguide/ObjectStore). If you have any questions or
190-
troubles, feel free to e-mail [email protected] or open a Github issue with details.
201+
troubles, feel free to e-mail [email protected] or open a Github issue with details.

0 commit comments

Comments
 (0)