documentation/manual/en/module_specs/Zend_Service_Amazon_Ec2-WindowsInstance.xml

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