← Back to branch summary

~rlane/nova/ldapimprovements

« back to all changes in this revision

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

  • Committer: Ryan Lane
  • Date: 2010-11-24 15:46:32 UTC
  • mfrom: (382.48.1 trunk)
  • Revision ID: laner@controller-20101124154632-zh7kwjuyyd02a2lh
Merge from trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/source/adminguide/managing.instances.rst
 
1
..
 
2
      Copyright 2010 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