← Back to branch summary

~ubuntu-cloud-archive/ubuntu/precise/nova/trunk

« back to all changes in this revision

Viewing changes to doc/source/runnova/managing.instances.rst

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2012-05-24 13:12:53 UTC
  • mfrom: (1.1.55)
  • Revision ID: package-import@ubuntu.com-20120524131253-ommql08fg1en06ut
Tags: 2012.2~f1-0ubuntu1
https://launchpad.net/bugs/907197
* New upstream release.
* Prepare for quantal:
  - Dropped debian/patches/upstream/0006-Use-project_id-in-ec2.cloud._format_image.patch
  - Dropped debian/patches/upstream/0005-Populate-image-properties-with-project_id-again.patch
  - Dropped debian/patches/upstream/0004-Fixed-bug-962840-added-a-test-case.patch
  - Dropped debian/patches/upstream/0003-Allow-unprivileged-RADOS-users-to-access-rbd-volumes.patch
  - Dropped debian/patches/upstream/0002-Stop-libvirt-test-from-deleting-instances-dir.patch
  - Dropped debian/patches/upstream/0001-fix-bug-where-nova-ignores-glance-host-in-imageref.patch 
  - Dropped debian/patches/0001-fix-useexisting-deprecation-warnings.patch
* debian/control: Add python-keystone as a dependency. (LP: #907197)
* debian/patches/kombu_tests_timeout.patch: Refreshed.
* debian/nova.conf, debian/nova-common.postinst: Convert to new ini
  file configuration
* debian/patches/nova-manage_flagfile_location.patch: Refreshed

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/source/runnova/managing.instances.rst
1
 
..
2
 
      Copyright 2010-2011 United States Government as represented by the
3
 
      Administrator of the National Aeronautics and Space Administration.
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
 
 
18
 
Managing Instances
19
 
==================
20
 
 
21
 
Keypairs
22
 
--------
23
 
 
24
 
Images can be shared by many users, so it is dangerous to put passwords into the images.  Nova therefore supports injecting ssh keys into instances before they are booted.  This allows a user to login to the instances that he or she creates securely.  Generally the first thing that a user does when using the system is create a keypair.  Nova generates a public and private key pair, and sends the private key to the user.  The public key is stored so that it can be injected into instances.
25
 
 
26
 
Keypairs are created through the api.  They can be created on the command line using the euca2ools script euca-add-keypair.  Refer to the man page for the available options. Example usage::
27
 
 
28
 
  euca-add-keypair test > test.pem
29
 
  chmod 600 test.pem
30
 
  euca-run-instances -k test -t m1.tiny ami-tiny
31
 
  # wait for boot
32
 
  ssh -i test.pem root@ip.of.instance
33
 
 
34
 
 
35
 
Basic Management
36
 
----------------
37
 
Instance management can be accomplished with euca commands:
38
 
 
39
 
 
40
 
To run an instance:
41
 
 
42
 
::
43
 
 
44
 
    euca-run-instances
45
 
 
46
 
 
47
 
To terminate an instance:
48
 
 
49
 
::
50
 
 
51
 
    euca-terminate-instances
52
 
 
53
 
To reboot an instance:
54
 
 
55
 
::
56
 
 
57
 
    euca-reboot-instances
58
 
 
59
 
See the euca2ools documentation for more information