repo_zf1/documentation/manual/de/module_specs/Zend_Service_Amazon_Ec2-WindowsInstance.xml

<?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 Instanzen</title>

    <para>
        Die Verwendung von Amazon EC2 Instanzen auf denen Windows läuft ist ähnlich wie die
        Verwendung von Instanzen die Linux oder UNIX und Windows verwenden:
    </para>

    <itemizedlist>
        <listitem>
            <para>
                Remote Desktop—Um auf Windows Instanzen zuzugreifen muß Remote Desktop statt SSH
                verwendet werden.
            </para>
        </listitem>
        <listitem>
            <para>
                Administratives Passwort—Um auf Windows Instanzen das erste Mal zugreifen zu
                können muß man das administrative Passwort holen indem der ec2-get-password
                Befehl verwendet wird.
            </para>
        </listitem>
        <listitem>
            <para>
                Vereinfachtes Bündeln- Um eine Windows Instanz zu bündeln muß ein einzelnes
                Kommando verwendet werden, der die Instanz beendet, diese als AMI speichert, und
                Sie wieder startet.
            </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>