~0x44/nova/extdoc

468.2.2 by Anne Gentle
Minor spellchecking fixes
1
..
468.2.12 by Anne Gentle
Change all 2010 Copyright statements to 2010-2011 in doc source directory only
2
      Copyright 2010-2011 OpenStack LLC
468.2.2 by Anne Gentle
Minor spellchecking fixes
3
4
      All Rights Reserved.
5
6
      Licensed under the Apache License, Version 2.0 (the "License"); you may
7
      not use this file except in compliance with the License. You may obtain
8
      a copy of the License at
9
10
          http://www.apache.org/licenses/LICENSE-2.0
11
12
      Unless required by applicable law or agreed to in writing, software
13
      distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
14
      WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
15
      License for the specific language governing permissions and limitations
16
      under the License.
17
      
386.2.43 by root
modifications and additions based on doc sprint
18
Installing the Live CD
19
======================
446.1.1 by Anne Gentle
Added livecd instructions plus fixed references to .conf files
20
21
If you'd like to set up a sandbox installation of Nova, you can use one of these Live CD images. 
22
23
If you don't already have VirtualBox installed, you can download it from http://www.virtualbox.org/wiki/Downloads.
24
 
25
Download the zip or iso file and then follow these steps to try Nova in a virtual environment.
26
27
http://c0047913.cdn1.cloudfiles.rackspacecloud.com/OpenStackNova.x86_64-2010.1.2.iso (OpenSUSE image; root password is "linux" for this image)
28
29
http://c0028699.cdn1.cloudfiles.rackspacecloud.com/nova-vm.zip (~900 MB) (log in information is nova/nova)
30
31
Once a VM is configured and started, here are the basics:
32
33
 #. Login to Ubuntu using ID nova and Password nova.
34
35
 #. Switch to running as sudo (enter nova when prompted for the password)::
36
37
    sudo -s
38
39
 #. To run Nova for the first time, enter::
40
41
    cd /var/openstack/
42
43
 #. Now that you're in the correct directory, enter::
44
45
    ./nova.sh run
46
47
    .. image:: images/novashvirtually.png
48
49
If it's already running, use screen -ls, and when the nova screen is presented,then enter screen -d -r nova.
50
51
These are the steps to get an instance running (the image is already provided in this environment). Enter these commands in the "test" screen.
52
53
::
54
55
 euca-add-keypair test > test.pem
56
 chmod 600 test.pem
57
 euca-run-instances -k test -t m1.tiny ami-tiny
58
 euca-describe-instances
59
60
 ssh -i test.pem root@10.0.0.3
61
62
To see output from the various workers, switch screen windows with Ctrl+A " (quotation mark). 
63
64
    .. image:: images/novascreens.png 
65