~justin-fathomdb/nova/justinsb-openstack-api-volumes

« back to all changes in this revision

Viewing changes to doc/source/quickstart.rst

  • Committer: Todd Willey
  • Date: 2010-11-04 18:44:22 UTC
  • mto: (386.6.2 trunkdoc)
  • mto: This revision was merged to the branch mainline in revision 398.
  • Revision ID: todd@ansolabs.com-20101104184422-vfbqyjqgr4whg3wm
Nova quickstart: move vish's novascript into contrib, and convert reademe.md to a quickstart.rst

Show diffs side-by-side

added added

removed removed

Lines of Context:
16
16
      under the License.
17
17
 
18
18
Nova Quickstart
19
 
=========================
20
 
 
21
 
http://github.com/vishvananda/novascript
 
19
===============
 
20
 
 
21
The `contrib/novascript.sh` file in the source distribution is a script that
 
22
will quickly set up nova to run on a single machine.  It is tested against
 
23
Ubuntu only, but other distributions are forthcoming.
 
24
 
 
25
Usage
 
26
-----
 
27
 
 
28
Unless you want to spend a lot of time fiddling with permissions and sudoers,
 
29
you should probably run nova as root.
 
30
 
 
31
::
 
32
 
 
33
    sudo -i
 
34
 
 
35
If you are concerned about security, nova runs just fine inside a virtual
 
36
machine.
 
37
 
 
38
Use the script to install and run the current trunk. You can also specify a
 
39
specific branch by putting `lp:~someone/nova/some-branch` after the branch
 
40
command
 
41
 
 
42
::
 
43
 
 
44
    ./nova.sh branch
 
45
    ./nova.sh install
 
46
    ./nova.sh run
 
47
 
 
48
The run command will drop you into a screen session with all of the workers
 
49
running in different windows  You can use eucatools to run commands against the
 
50
cloud.
 
51
 
 
52
::
 
53
 
 
54
    euca-add-keypair test > test.pem
 
55
    euca-run-instances -k test -t m1.tiny ami-tiny
 
56
    euca-describe-instances
 
57
 
 
58
To see output from the various workers, switch screen windows
 
59
 
 
60
::
 
61
 
 
62
    <ctrl-a> "
 
63
 
 
64
will give you a list of running windows.
 
65
 
 
66
When the instance is running, you should be able to ssh to it.
 
67
 
 
68
::
 
69
 
 
70
    chmod 600 test.pem
 
71
    ssh -i test.pem root@10.0.0.3
 
72
 
 
73
When you exit screen
 
74
 
 
75
::
 
76
 
 
77
    <ctrl-a> <ctrl-d>
 
78
 
 
79
nova will terminate.  It may take a while for nova to finish cleaning up.  If
 
80
you exit the process before it is done because there were some problems in your
 
81
build, you may have to clean up the nova processes manually.  If you had any
 
82
instances running, you can attempt to kill them through the api:
 
83
 
 
84
::
 
85
 
 
86
    ./nova.sh terminate
 
87
 
 
88
Then you can destroy the screen:
 
89
 
 
90
::
 
91
 
 
92
    ./nova.sh clean
 
93
 
 
94
If things get particularly messed up, you might need to do some more intense
 
95
cleanup.  Be careful, the following command will manually destroy all runnning
 
96
virsh instances and attempt to delete all vlans and bridges.