← Back to branch summary

~negronjl/+junk/orchestra-docs

« back to all changes in this revision

Viewing changes to buildtool/Apache.xml

  • Committer: Juan L. Negron
  • Date: 2011-05-26 05:32:54 UTC
  • Revision ID: juan.negron@canonical.com-20110526053254-fzcftjfzb1rd80k5
Finished updating the documentation for orchestra.  Ported from sitoolchain

Show diffs side-by-side

added added

removed removed

Lines of Context:
buildtool/Apache.xml
25
25
    <para>The Apache Web Server deployment is rather trivial once we have a
26
26
    properly configured puppetmaster node running.</para>
27
27
 
28
 
    <para>Download the necessary code and cloud-init scripts from
29
 
    lp:sitoolchain. The cloud-init-scripts can also be installed via the
30
 
    package cloud-init-scripts. The scripts will be located in
31
 
    /usr/share/doc/cloud-init-scripts</para>
32
 
 
33
28
    <para>It is assumed that there is a working puppetmaster node in the
34
29
    network that has been properly configured and contains all of the
35
30
    necessary recipes needed for this deployment.</para>
51
46
 
52
47
      <itemizedlist>
53
48
        <listitem>
54
 
          <para>Launch at least one instance with
55
 
          puppetclient-mcollective-multipart.txt:</para>
56
 
 
57
 
          <itemizedlist>
58
 
            <listitem>
59
 
              <para><screen>[ec2|uec|cloud]-run-instances -k [keypair] -g [security-group] \
60
 
-f puppetclient-mcollective-multipart.txt -t &lt;instance_type&gt; \
61
 
-n &lt;number_of_instances&gt; [image-ID]</screen></para>
62
 
            </listitem>
63
 
 
64
 
            <listitem>
65
 
              <para>[security_group] should point to a security group that
66
 
              provides access to the necessary ports for propper
67
 
              operations</para>
68
 
            </listitem>
69
 
 
70
 
            <listitem>
71
 
              <para>[keypair] is the ssh key that will be used with the
72
 
              instance.</para>
73
 
            </listitem>
74
 
 
75
 
            <listitem>
76
 
              <para>&lt;instance_type&gt; is dependent on the image id ( For
77
 
              Amazon's EC2: m1.large for 64 bit instances and m1.small for 32
78
 
              bit instances )</para>
79
 
            </listitem>
80
 
 
81
 
            <listitem>
82
 
              <para>&lt;number_of_instances&gt; is the number of instances
83
 
              that you want to deploy</para>
84
 
            </listitem>
85
 
 
86
 
            <listitem>
87
 
              <para>[ami_id] is the image id that will be used. For Amazon's
88
 
              EC2 cloud, this document has been tested with: AMI id:
89
 
              ami-08f40561 for 64-bit instances and AMI id: ami-a6f504cf for
90
 
              32-bit instances.</para>
91
 
            </listitem>
92
 
          </itemizedlist>
93
 
        </listitem>
94
 
 
95
 
        <listitem>
96
 
          <para>Once the instance is up and running, ssh into the
97
 
          provisioner:</para>
98
 
 
99
 
          <itemizedlist>
100
 
            <listitem>
101
 
              <para><screen>ssh -i &lt;path_to_ssh_key&gt; ubuntu@&lt;public_fqdn&gt;</screen></para>
102
 
            </listitem>
103
 
          </itemizedlist>
104
 
        </listitem>
105
 
 
106
 
        <listitem>
107
 
          <para>From the provisioner run the following commands as
 
49
          <para>From the orchestra-server run the following commands as
108
50
          root:</para>
109
51
 
110
52
          <itemizedlist>
124
66
                <listitem>
125
67
                  <para>&lt;clustername&gt; is an arbitrary but unique name
126
68
                  that will identify the members of this cluster. The
127
 
                  provisioner will use the cluster name to associate the
 
69
                  orchestra-server will use the cluster name to associate the
128
70
                  apache instances belonging to this cluster together so they
129
71
                  can be load balanced if desired.</para>
130
72
                </listitem>
149
91
                </listitem>
150
92
              </itemizedlist>
151
93
 
152
 
              <para>The above command tells the provisioner to look among the
153
 
              instances that have the fact provision-status as provisioned (
154
 
              -F provision-status=provisioned ) and the fact role as undefined
155
 
              ( -F role=undefined ), pick &lt;number_of_instances&gt; ( --ln
156
 
              &lt;number_of_instances&gt; ) and set it's role as described
157
 
              above.</para>
 
94
              <para>The above command tells the orchestra-server to look among
 
95
              the instances that have the fact provision-status as provisioned
 
96
              ( -F provision-status=provisioned ) and the fact role as
 
97
              undefined ( -F role=undefined ), pick
 
98
              &lt;number_of_instances&gt; ( --ln &lt;number_of_instances&gt; )
 
99
              and set it's role as described above.</para>
158
100
 
159
101
              <para>As of this writing, module names are dictated by the
160
102
              ubuntu packages currently available: ie: libapache2-mod-wsgi