|
|
@@ -2,119 +2,119 @@
|
|
|
<!-- 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/UNIX and Windows:
|
|
|
-
|
|
|
- <itemizedlist>
|
|
|
+
|
|
|
+ <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/UNIX and Windows:
|
|
|
+
|
|
|
+ <itemizedlist>
|
|
|
+ <listitem>
|
|
|
+ Remote Desktop—To access Windows instances, you use Remote
|
|
|
+ Desktop instead of SSH.
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ Administrative Password—To access Windows instances the first time,
|
|
|
+ you must obtain the administrative password using the ec2-get-password
|
|
|
+ command.
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ Simplified Bundling—To bundle a Windows instance, you use a single command
|
|
|
+ that shuts down the instance, saves it as an AMI, and restarts it.
|
|
|
+ </listitem>
|
|
|
+ </itemizedlist>
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <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 LDAP, 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>
|
|
|
+ To get started using Windows instances, we recommend using the AWS 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.
|
|
|
+ </note>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ Amazon EC2 currently provides the following Windows AMIs:
|
|
|
+
|
|
|
+ <itemizedlist>
|
|
|
+ <listitem>
|
|
|
+ Windows Authenticated (32-bit)
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ Windows Authenticated (64-bit)
|
|
|
+ </listitem>
|
|
|
<listitem>
|
|
|
- Remote Desktop—To access Windows instances, you use Remote
|
|
|
- Desktop instead of SSH.
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- Administrative Password—To access Windows instances the first time,
|
|
|
- you must obtain the administrative password using the ec2-get-password
|
|
|
- command.
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- Simplified Bundling—To bundle a Windows instance, you use a single command
|
|
|
- that shuts down the instance, saves it as an AMI, and restarts it.
|
|
|
- </listitem>
|
|
|
- </itemizedlist>
|
|
|
- </para>
|
|
|
-
|
|
|
- <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 LDAP, 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>
|
|
|
- To get started using Windows instances, we recommend using the AWS 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.
|
|
|
- </note>
|
|
|
-
|
|
|
- <para>
|
|
|
- Amazon EC2 currently provides the following Windows AMIs:
|
|
|
-
|
|
|
- <itemizedlist>
|
|
|
+ Windows Anonymous (32-bit)
|
|
|
+ </listitem>
|
|
|
<listitem>
|
|
|
- Windows Authenticated (32-bit)
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- Windows Authenticated (64-bit)
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- Windows Anonymous (32-bit)
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- Windows Anonymous (64-bit)
|
|
|
- </listitem>
|
|
|
- </itemizedlist>
|
|
|
- </para>
|
|
|
-
|
|
|
- <para>
|
|
|
- The Windows public AMIs 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:
|
|
|
-
|
|
|
- <itemizedlist>
|
|
|
+ Windows Anonymous (64-bit)
|
|
|
+ </listitem>
|
|
|
+ </itemizedlist>
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ The Windows public AMIs 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:
|
|
|
+
|
|
|
+ <itemizedlist>
|
|
|
+ <listitem>
|
|
|
+ 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 AMI
|
|
|
+ launch. If you change the password, AMIs that are created
|
|
|
+ from this instance use the new password.
|
|
|
+ </listitem>
|
|
|
<listitem>
|
|
|
- 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 AMI
|
|
|
- launch. If you change the password, AMIs that are created
|
|
|
- from this instance use the new password.
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- Configures the computer name to the internal DNS name. To
|
|
|
- determine the internal DNS name, see Using Instance Addressing.
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- 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.
|
|
|
- </listitem>
|
|
|
- </itemizedlist>
|
|
|
- </para>
|
|
|
+ Configures the computer name to the internal DNS name. To
|
|
|
+ determine the internal DNS name, see Using Instance Addressing.
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ 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.
|
|
|
+ </listitem>
|
|
|
+ </itemizedlist>
|
|
|
+ </para>
|
|
|
+
|
|
|
|
|
|
-
|
|
|
- <sect2 id="zend.service.amazon.ec2.windows.instance.operations">
|
|
|
- <title>Windows Instances Usage</title>
|
|
|
+ <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>
|
|
|
- <code>bundle</code> has three require paramters and one optional
|
|
|
- <itemizedlist>
|
|
|
- <listitem>
|
|
|
- <code>instanceId</code> The instance you want to bundle
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <code>s3Bucket</code> Where you want the ami to live on S3
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <code>s3Prefix</code> The prefix you want to assign to the AMI on S3
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <code>uploadExpiration</code> 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)
|
|
|
- </listitem>
|
|
|
- </itemizedlist>
|
|
|
- </para>
|
|
|
+ <para>
|
|
|
+ <code>bundle</code> has three require paramters and one optional
|
|
|
+ <itemizedlist>
|
|
|
+ <listitem>
|
|
|
+ <code>instanceId</code> The instance you want to bundle
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <code>s3Bucket</code> Where you want the ami to live on S3
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <code>s3Prefix</code> The prefix you want to assign to the AMI on S3
|
|
|
+ </listitem>
|
|
|
+ <listitem>
|
|
|
+ <code>uploadExpiration</code> 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)
|
|
|
+ </listitem>
|
|
|
+ </itemizedlist>
|
|
|
+ </para>
|
|
|
<para>
|
|
|
<code>bundle</code> returns a multi-demential array that contains
|
|
|
- instanceId, bundleId, state, startTime, updateTime, progress
|
|
|
- s3Bucket and s3Prefix.
|
|
|
+ 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',
|
|
|
@@ -131,8 +131,8 @@ $return = $ec2_instance->bundle('instanceId', 's3Bucket', 's3Prefix');
|
|
|
</para>
|
|
|
<para>
|
|
|
<code>describeBundle</code> returns a multi-demential array that contains
|
|
|
- instanceId, bundleId, state, startTime, updateTime, progress
|
|
|
- s3Bucket and s3Prefix.
|
|
|
+ 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',
|
|
|
@@ -140,17 +140,17 @@ $ec2_instance = new Zend_Service_Amazon_Ec2_Instance_Windows('aws_key',
|
|
|
$return = $ec2_instance->describeBundle('bundleId');
|
|
|
]]></programlisting>
|
|
|
</example>
|
|
|
-
|
|
|
- <example id="zend.service.amazon.ec2.windows.instance.operations.cancel">
|
|
|
+
|
|
|
+ <example id="zend.service.amazon.ec2.windows.instance.operations.cancel">
|
|
|
<title>Cancels an Amazon EC2 bundling operation</title>
|
|
|
<para>
|
|
|
<code>cancelBundle</code> Cancels an Amazon EC2 bundling operation
|
|
|
</para>
|
|
|
- <para>
|
|
|
- <code>cancelBundle</code> returns a multi-demential array that contains
|
|
|
- instanceId, bundleId, state, startTime, updateTime, progress
|
|
|
- s3Bucket and s3Prefix.
|
|
|
- </para>
|
|
|
+ <para>
|
|
|
+ <code>cancelBundle</code> 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');
|