1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191
|
<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<sect1 id="zend.service.amazon.ec2.windows.instance">
<title>Zend_Service_Amazon_Ec2: Windows Instances</title>
<para>
Using Amazon EC2 instances running Windows is similar to using instances
running Linux and UNIX. The following are the major differences between
instances that use Linux or UNIX and Windows:
</para>
<itemizedlist>
<listitem>
<para>
Remote Desktop—To access Windows instances, you use Remote
Desktop instead of SSH.
</para>
</listitem>
<listitem>
<para>
Administrative Password—To access Windows instances the first time,
you must obtain the administrative password using the ec2-get-password
command.
</para>
</listitem>
<listitem>
<para>
Simplified Bundling—To bundle a Windows instance, you use a single command that
shuts down the instance, saves it as an <acronym>AMI</acronym>, and restarts it.
</para>
</listitem>
</itemizedlist>
<para>
As part of this service, Amazon EC2 instances can now run Microsoft Windows Server
2003. Our base Windows image provides you with most of the common functionality associated
with Windows. However, if you require more than two concurrent Windows users or need to
leverage applications that require <acronym>LDAP</acronym>, Kerberos, RADIUS, or other
credential services, you must use Windows with Authentication Services. For example,
Microsoft Exchange Server and Microsoft SharePoint Server require Windows with
Authentication Services.
</para>
<note>
<para>
To get started using Windows instances, we recommend using the <acronym>AWS</acronym>
Management Console. There are differences in pricing between Windows and Windows with
Authentication Services instances. For information on pricing, go to the Amazon EC2
Product Page.
</para>
</note>
<para>
Amazon EC2 currently provides the following Windows <acronym>AMI</acronym>s:
</para>
<itemizedlist>
<listitem><para>Windows Authenticated (32-bit)</para></listitem>
<listitem><para>Windows Authenticated (64-bit)</para></listitem>
<listitem><para>Windows Anonymous (32-bit)</para></listitem>
<listitem><para>Windows Anonymous (64-bit)</para></listitem>
</itemizedlist>
<para>
The Windows public <acronym>AMI</acronym>s that Amazon provides are unmodified
versions of Windows with the following two exceptions: we added
drivers to improve the networking and disk I/O performance and
we created the Amazon EC2 configuration service. The Amazon EC2
configuration service performs the following functions:
</para>
<itemizedlist>
<listitem>
<para>
Randomly sets the Administrator password on initial launch,
encrypts the password with the user's SSH key, and reports
it to the console. This operation happens upon initial <acronym>AMI</acronym>
launch. If you change the password, <acronym>AMI</acronym>s that are created
from this instance use the new password.
</para>
</listitem>
<listitem>
<para>
Configures the computer name to the internal DNS name. To
determine the internal DNS name, see Using Instance Addressing.
</para>
</listitem>
<listitem>
<para>
Sends the last three system and application errors from the
event log to the console. This helps developers to identify
problems that caused an instance to crash or network connectivity
to be lost.
</para>
</listitem>
</itemizedlist>
<sect2 id="zend.service.amazon.ec2.windows.instance.operations">
<title>Windows Instances Usage</title>
<example id="zend.service.amazon.ec2.windows.instance.operations.bundle">
<title>Bundles an Amazon EC2 instance running Windows</title>
<para>
<methodname>bundle()</methodname> has three require paramters and one optional
</para>
<itemizedlist>
<listitem>
<para><emphasis>instanceId</emphasis> The instance you want to bundle</para>
</listitem>
<listitem>
<para><emphasis>s3Bucket</emphasis> Where you want the ami to live on S3</para>
</listitem>
<listitem>
<para>
<emphasis>s3Prefix</emphasis> The prefix you want to assign to the
<acronym>AMI</acronym> on S3
</para>
</listitem>
<listitem>
<para>
<emphasis>uploadExpiration</emphasis> The expiration of the upload policy.
Amazon recommends 12 hours or longer. This is based in nubmer of
minutes. Default is 1440 minutes (24 hours)
</para>
</listitem>
</itemizedlist>
<para>
<methodname>bundle()</methodname> returns a multi-demential array that contains
instanceId, bundleId, state, startTime, updateTime, progress
s3Bucket and s3Prefix.
</para>
<programlisting language="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance_Windows('aws_key',
'aws_secret_key');
$return = $ec2_instance->bundle('instanceId', 's3Bucket', 's3Prefix');
]]></programlisting>
</example>
<example id="zend.service.amazon.ec2.windows.instance.operations.describe">
<title>Describes current bundling tasks</title>
<para>
<methodname>describeBundle()</methodname> Describes current bundling tasks
</para>
<para>
<methodname>describeBundle()</methodname> returns a multi-demential array that
contains instanceId, bundleId, state, startTime, updateTime, progress
s3Bucket and s3Prefix.
</para>
<programlisting language="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance_Windows('aws_key',
'aws_secret_key');
$return = $ec2_instance->describeBundle('bundleId');
]]></programlisting>
</example>
<example id="zend.service.amazon.ec2.windows.instance.operations.cancel">
<title>Cancels an Amazon EC2 bundling operation</title>
<para>
<methodname>cancelBundle()</methodname> Cancels an Amazon EC2 bundling operation
</para>
<para>
<methodname>cancelBundle()</methodname> returns a multi-demential array that
contains instanceId, bundleId, state, startTime, updateTime, progress
s3Bucket and s3Prefix.
</para>
<programlisting language="php"><![CDATA[
$ec2_instance = new Zend_Service_Amazon_Ec2_Instance_Windows('aws_key',
'aws_secret_key');
$return = $ec2_instance->cancelBundle('bundleId');
]]></programlisting>
</example>
</sect2>
</sect1>
|