/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/developers/ec2.txt

  • Committer: Jelmer Vernooij
  • Date: 2009-03-28 14:24:46 UTC
  • mfrom: (4211 +trunk)
  • mto: This revision was merged to the branch mainline in revision 4212.
  • Revision ID: jelmer@samba.org-20090328142446-vqi0ksswdurga631
Merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
69
69
an administrator for ease of installing software.
70
70
 
71
71
You do need to have an RSA keypair to get the initial password for a
72
 
Windows machine, even though you can't use it to log in later.  As a quirk
73
 
of the tools(?) ``ec2-get-password`` needs the full path to the keypair
74
 
but ``ec2-add-keypair`` just wants part of the name.  I guess this is
75
 
distinct from the account identifier because the image is relatively
76
 
untrusted(?).  If the password is already set in the image, this shouldn't
77
 
be necessary.
 
72
Windows machine, even though you can't use it to log in later.
 
73
``ec2-get-password`` takes the full path to the private key to obtain the
 
74
password from Amazon, and ``ec2-add-keypair`` creates a named keypair at
 
75
Amazon and returns the private path. One keypair is all that is needed.
 
76
This is distinct from the account identifier - likely due to the different
 
77
toolchains in use (the keypairs are used for unix ssh keys, and I (Robert)
 
78
suspect a rather unix friendly core at Amazon).
 
79
Once a custom image is made with a saved password, you can skip using 
 
80
``ec2-get-password`` (which is only needed for Windows anyway).
78
81
 
79
82
It would be nice if rdesktop could use private key authentication but
80
83
apparently not.
95
98
* Install the
96
99
  `Amazon EC2 API tools`_ (needs-packaging `bug 330930`_)
97
100
 
 
101
* Create an Amazon Web Services account, sign up for S3 and EC2, and do
 
102
  the various steps to create authentication devices.
 
103
 
98
104
* Create a private key and certificate for yourself.
99
105
  Check these environment variables are set and exported, e.g. by setting
100
106
  them in the file ``~/.aws``.  Make sure the files are private.::
101
107
 
102
 
    EC2_PRIVATE_KEY=~/.ec2/pk-XXXXXX.pem
103
 
    EC2_CERT=~/.ec2/cert-XXXXXX.pem
104
 
    EC2_HOME=~/build/ec2-api-tools-1.3-30349
105
 
    AWS_SECRET_ACCESS_KEY=XXXXXXXXX
106
 
    AWS_ACCESS_KEY_ID=XXXXXXXXXXX
107
 
    PATH=$PATH:$EC2_HOME/bin
108
 
    JAVA_HOME=/usr/lib/jvm/java-6-openjdk
 
108
    export EC2_PRIVATE_KEY=~/.ec2/pk-XXXXXX.pem
 
109
    export EC2_CERT=~/.ec2/cert-XXXXXX.pem
 
110
    export EC2_HOME=~/build/ec2-api-tools-1.3-30349
 
111
    export AWS_SECRET_ACCESS_KEY=XXXXXXXXX
 
112
    export AWS_ACCESS_KEY_ID=XXXXXXXXXXX
 
113
    export EC2_KEYPAIR_NAME=XXXXXXXXX
 
114
    export PATH=$PATH:$EC2_HOME/bin
 
115
    export JAVA_HOME=/usr/lib/jvm/java-6-openjdk
 
116
    ssh-add ~/.ec2/id_rsa
 
117
 
 
118
  You can now '. ~/.aws' to get the ec2 commands available.
 
119
 
 
120
* (Unix images only) run ec2-add-keypair SOMENAME, e.g. 'bzr'. Put the
 
121
  result (minus the first line) somewhere like ~/.ec2/id_rsa and chmod go-rw.
 
122
 
 
123
* A useful Unix image is `ami-bdfe19d4`_, Eric Hammonds 64-bit Ubuntu image.
109
124
 
110
125
* Install the rdesktop client, to actually access the machine.
111
126
 
112
 
* Create an Amazon Web Services account, sign up for S3 and EC2, and do
113
 
  the various steps to create authentication devices 
114
 
 
115
127
* Possibly read some of the `EC2 documentation`_ for background.
116
128
   
117
129
.. _`bug 330930`: https://bugs.edge.launchpad.net/ubuntu/+bug/330930 
118
130
.. _`Amazon EC2 API tools`: 
119
131
     http://developer.amazonwebservices.com/connect/entry.jspa?externalID=368&categoryID=88
120
132
.. _`EC2 documentation`: http://aws.amazon.com/
 
133
.. _`ami-bdfe19d4`:
 
134
   http://developer.amazonwebservices.com/connect/entry.jspa?externalID=1762&categoryID=101
121
135
 
122
136
* Create a security group for your that allows rdesktop access and icmp with::
123
137
 
185
199
      ec2-modify-image-attributes $ami_id -l -a 123412341234
186
200
 
187
201
 
 
202
Management console (useful!)
 
203
----------------------------
 
204
 
 
205
https://console.aws.amazon.com/ec2/home
 
206
 
188
207
..
189
208
   vim: ft=rst tw=74 ai