|
|
@@ -0,0 +1,180 @@
|
|
|
+<?xml version="1.0" encoding="UTF-8"?>
|
|
|
+<!-- EN-Revision: 16389 -->
|
|
|
+<!-- 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 AMI, 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 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>
|
|
|
+ <para>
|
|
|
+ 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.
|
|
|
+ </para>
|
|
|
+ </note>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ Amazon EC2 currently provides the following Windows AMIs:
|
|
|
+ </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 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:
|
|
|
+ </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 AMI
|
|
|
+ launch. If you change the password, AMIs 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 AMI 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>
|
thomas