~ubuntu-branches/ubuntu/saucy/keystone/saucy-proposed

« back to all changes in this revision

Viewing changes to doc/source/gettingstarted.rst

  • Committer: Bazaar Package Importer
  • Author(s): Chuck Short
  • Date: 2011-08-23 10:18:22 UTC
  • Revision ID: james.westby@ubuntu.com-20110823101822-enve6zceb3lqhuvj
Tags: upstream-1.0~d4~20110823.1078
ImportĀ upstreamĀ versionĀ 1.0~d4~20110823.1078

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
..
 
2
      Copyright 2011 OpenStack, LLC
 
3
      All Rights Reserved.
 
4
 
 
5
      Licensed under the Apache License, Version 2.0 (the "License"); you may
 
6
      not use this file except in compliance with the License. You may obtain
 
7
      a copy of the License at
 
8
 
 
9
          http://www.apache.org/licenses/LICENSE-2.0
 
10
 
 
11
      Unless required by applicable law or agreed to in writing, software
 
12
      distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 
13
      WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 
14
      License for the specific language governing permissions and limitations
 
15
      under the License.
 
16
 
 
17
Quick Guide to Getting Started with Keystone
 
18
============================================
 
19
 
 
20
 
 
21
Dependencies
 
22
---------------------------------
 
23
First, you will need to install keystone, if you haven't done so already
 
24
 
 
25
.. toctree::
 
26
   :maxdepth: 1
 
27
 
 
28
   installing  
 
29
   
 
30
Creating your first global admin
 
31
---------------------------------   
 
32
Change driectory to your install path
 
33
 
 
34
   
 
35
   
 
36
Creating your first tenant admin
 
37
---------------------------------   
 
38
Change directory to your install path. 
 
39
   
 
40
   
 
41
1. Run the following to create the first tennant::
 
42
 
 
43
   $>  bin/keystone-manage tenant add "MyTenant"
 
44
 
 
45
2. Run the following to create the first tenant admin::
 
46
   
 
47
   $>  bin/keystone-manage user add MyAdmin P@ssw0rd MyTenant
 
48
   
 
49
.. note::
 
50
   
 
51
   Some reserved roles are defined (and can be modified) through the keystone.conf in the /etc folder.
 
52
 
 
53
3. Associate your tenant admin with the Admin role::
 
54
 
 
55
   $> bin/keystone-manage role grant Admin MyAdmin
 
56
 
 
57
   
 
58
   
 
59
 
 
60
 
 
61
Curl examples
 
62
---------------------------------
 
63
.. toctree::
 
64
   :maxdepth: 1
 
65
 
 
66
   adminAPI_curl_examples
 
67
   serviceAPI_curl_examples