2010-10-27 13:49:27 -04:00
|
|
|
..
|
|
|
|
|
Copyright 2010 United States Government as represented by the
|
|
|
|
|
Administrator of the National Aeronautics and Space Administration.
|
|
|
|
|
All Rights Reserved.
|
|
|
|
|
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
|
|
|
not use this file except in compliance with the License. You may obtain
|
|
|
|
|
a copy of the License at
|
|
|
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
|
|
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
|
|
|
License for the specific language governing permissions and limitations
|
|
|
|
|
under the License.
|
|
|
|
|
|
|
|
|
|
Nova Quickstart
|
2010-11-04 14:44:22 -04:00
|
|
|
===============
|
2010-10-27 13:49:27 -04:00
|
|
|
|
2010-11-04 14:44:22 -04:00
|
|
|
The `contrib/novascript.sh` file in the source distribution is a script that
|
|
|
|
|
will quickly set up nova to run on a single machine. It is tested against
|
|
|
|
|
Ubuntu only, but other distributions are forthcoming.
|
|
|
|
|
|
|
|
|
|
Usage
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
Unless you want to spend a lot of time fiddling with permissions and sudoers,
|
|
|
|
|
you should probably run nova as root.
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
sudo -i
|
|
|
|
|
|
|
|
|
|
If you are concerned about security, nova runs just fine inside a virtual
|
|
|
|
|
machine.
|
|
|
|
|
|
|
|
|
|
Use the script to install and run the current trunk. You can also specify a
|
|
|
|
|
specific branch by putting `lp:~someone/nova/some-branch` after the branch
|
|
|
|
|
command
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
./nova.sh branch
|
|
|
|
|
./nova.sh install
|
|
|
|
|
./nova.sh run
|
|
|
|
|
|
|
|
|
|
The run command will drop you into a screen session with all of the workers
|
|
|
|
|
running in different windows You can use eucatools to run commands against the
|
|
|
|
|
cloud.
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
euca-add-keypair test > test.pem
|
|
|
|
|
euca-run-instances -k test -t m1.tiny ami-tiny
|
|
|
|
|
euca-describe-instances
|
|
|
|
|
|
|
|
|
|
To see output from the various workers, switch screen windows
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
<ctrl-a> "
|
|
|
|
|
|
|
|
|
|
will give you a list of running windows.
|
|
|
|
|
|
|
|
|
|
When the instance is running, you should be able to ssh to it.
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
chmod 600 test.pem
|
|
|
|
|
ssh -i test.pem root@10.0.0.3
|
|
|
|
|
|
|
|
|
|
When you exit screen
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
<ctrl-a> <ctrl-d>
|
|
|
|
|
|
|
|
|
|
nova will terminate. It may take a while for nova to finish cleaning up. If
|
|
|
|
|
you exit the process before it is done because there were some problems in your
|
|
|
|
|
build, you may have to clean up the nova processes manually. If you had any
|
|
|
|
|
instances running, you can attempt to kill them through the api:
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
./nova.sh terminate
|
|
|
|
|
|
|
|
|
|
Then you can destroy the screen:
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
./nova.sh clean
|
|
|
|
|
|
|
|
|
|
If things get particularly messed up, you might need to do some more intense
|
|
|
|
|
cleanup. Be careful, the following command will manually destroy all runnning
|
|
|
|
|
virsh instances and attempt to delete all vlans and bridges.
|
