~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/ec2-windows.txt

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2009-03-06 06:48:25 UTC
  • mfrom: (4070.8.6 debug-config)
  • Revision ID: pqm@pqm.ubuntu.com-20090306064825-kbpwggw21dygeix6
(mbp) debug_flags configuration option

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.
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).
 
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.
81
78
 
82
79
It would be nice if rdesktop could use private key authentication but
83
80
apparently not.
98
95
* Install the
99
96
  `Amazon EC2 API tools`_ (needs-packaging `bug 330930`_)
100
97
 
101
 
* Create an Amazon Web Services account, sign up for S3 and EC2, and do
102
 
  the various steps to create authentication devices.
103
 
 
104
98
* Create a private key and certificate for yourself.
105
99
  Check these environment variables are set and exported, e.g. by setting
106
100
  them in the file ``~/.aws``.  Make sure the files are private.::
107
101
 
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.
 
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
124
109
 
125
110
* Install the rdesktop client, to actually access the machine.
126
111
 
 
112
* Create an Amazon Web Services account, sign up for S3 and EC2, and do
 
113
  the various steps to create authentication devices 
 
114
 
127
115
* Possibly read some of the `EC2 documentation`_ for background.
128
116
   
129
117
.. _`bug 330930`: https://bugs.edge.launchpad.net/ubuntu/+bug/330930 
130
118
.. _`Amazon EC2 API tools`: 
131
119
     http://developer.amazonwebservices.com/connect/entry.jspa?externalID=368&categoryID=88
132
120
.. _`EC2 documentation`: http://aws.amazon.com/
133
 
.. _`ami-bdfe19d4`:
134
 
   http://developer.amazonwebservices.com/connect/entry.jspa?externalID=1762&categoryID=101
135
121
 
136
122
* Create a security group for your that allows rdesktop access and icmp with::
137
123
 
199
185
      ec2-modify-image-attributes $ami_id -l -a 123412341234
200
186
 
201
187
 
202
 
Management console (useful!)
203
 
----------------------------
204
 
 
205
 
https://console.aws.amazon.com/ec2/home
206
 
 
207
188
..
208
189
   vim: ft=rst tw=74 ai