You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by bu...@apache.org on 2012/08/21 01:27:32 UTC
svn commit: r829517 - in /websites/staging/cloudstack/trunk/content: ./
cloudstack/ cloudstack/develop/
Author: buildbot
Date: Mon Aug 20 23:27:32 2012
New Revision: 829517
Log:
Staging update by buildbot for cloudstack
Added:
websites/staging/cloudstack/trunk/content/cloudstack/cloudstack-faq.html
websites/staging/cloudstack/trunk/content/cloudstack/develop/
websites/staging/cloudstack/trunk/content/cloudstack/develop/coding-conventions.html
websites/staging/cloudstack/trunk/content/cloudstack/develop/developer-faq.html
websites/staging/cloudstack/trunk/content/cloudstack/develop/environment.html
websites/staging/cloudstack/trunk/content/cloudstack/develop/non-contributors.html
websites/staging/cloudstack/trunk/content/cloudstack/downloads.html
websites/staging/cloudstack/trunk/content/cloudstack/mailing-lists.html
websites/staging/cloudstack/trunk/content/cloudstack/news.html
Modified:
websites/staging/cloudstack/trunk/content/ (props changed)
Propchange: websites/staging/cloudstack/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Aug 20 23:27:32 2012
@@ -1 +1 @@
-1375314
+1375315
Added: websites/staging/cloudstack/trunk/content/cloudstack/cloudstack-faq.html
==============================================================================
--- websites/staging/cloudstack/trunk/content/cloudstack/cloudstack-faq.html (added)
+++ websites/staging/cloudstack/trunk/content/cloudstack/cloudstack-faq.html Mon Aug 20 23:27:32 2012
@@ -0,0 +1,97 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <link href="/cloudstack/css/cloudstack.css" rel="stylesheet" type="text/css">
+ <title>Apache CloudStack (Incubating) FAQ</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE- 2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+</head>
+
+<body>
+ <div id="banner">
+ <img alt="Apache CloudStack (Incubating)" src="/cloudstack/images/title_logo.png" />
+ </div>
+
+ <div id="navigation">
+ <h1>About Apache CloudStack</h2>
+ <a href="/cloudstack/index.html">Home</a><br />
+ <a href="/cloudstack/news.html">News</a><br />
+ <a href="http://incubator.apache.org/projects/cloudstack.html">Incubator Status</a><br />
+ <a href="/cloudstack/downloads.html">Downloads</a><br />
+ <h1>Community</h1>
+ <a href="/cloudstack/develop/get-involved.html">Get Involved</a><br />
+ <a href="/cloudstack/cloudstack-faq.html">CloudStack FAQ</a><br />
+ <a href="/cloudstack/mailing-lists.html">Mailing Lists</a><br />
+ <a href="https://cwiki.apache.org/CLOUDSTACK/draft-cloudstack-community-events-plan.html">Community Events Plan</a><br />
+ <h1>Development</h1>
+ <!-- <a href="/cloudstack/develop/getting-started.html">Getting Started</a><br /> -->
+ <a href="/cloudstack/develop/environment.html">Setting Up an Apache CloudStack Development Environment</a><br />
+ <a href="/cloudstack/develop/non-contributors.html">Contributing for Non-Committers</a><br />
+ <a href="/cloudstack/develop/developer-faq.html">Developer's FAQ</a><br />
+ <a href="/cloudstack/develop/coding-conventions.html">Coding Conventions</a><br />
+ <!-- <a href="/cloudstack/develop/cloudstack-easy-tasks.html">Easy Bugs/Tasks</a><br /> -->
+ <h1>Documentation</h1>
+ <a href="http://docs.cloudstack.org/">CloudStack Documentation</a><br />
+ <a href="http://cwiki.apache.org/confluence/display/CLOUDSTACK/Index">Apache CloudStack Wiki</a><br />
+ <h1>Apache Software Foundation (ASF)</h1>
+ <a href="http://www.apache.org/">Apache Software Foundation</a><br />
+ <a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a><br />
+ <a href="http://www.apache.org/security/">Security</a><br />
+ <img alt="Apache Incubator" src="http://incubator.apache.org/images/egg-logo.png" width="165"/>
+ </div>
+
+ <div id="content">
+ <h1 id="frequently-asked-questions-faq-about-cloudstack">Frequently Asked Questions (FAQ) about CloudStack</h1>
+<p>This page is for Frequently Asked Questions (FAQ) having to do with Apache CloudStack as a project and its use. For questions specifically about development, see the <a href="developer's FAQ">/cloudstack/develop/developer-faq.html</a>. </p>
+<p>Have a question that's not answered here? You might want to ask on the <a href="/cloudstack/mailing-lists.html">cloudstack-users mailing list</a>. </p>
+<ul>
+<li><a href="/cloudstack/cloudstack-faq.html#what">What is CloudStack?</a></li>
+<li><a href="/cloudstack/cloudstack-faq.html#private">Can I create my own private templates?</a></li>
+<li><a href="/cloudstack/cloudstack-faq.html#users">How are users, accounts, and domains handled in CloudStack?</a></li>
+</ul>
+<h2 id="what-is-apache-cloudstack">What is Apache CloudStack?</h2>
+<p><a name="what">Apache CloudStack is a complete software suite</a> for creating Infrastructure as a Service (IaaS) clouds. Target environments include service providers and enterprises.</p>
+<ul>
+<li>The Apache CloudStack platform enables service providers to set up an on-demand, elastic cloud computing service. It enables a utility computing service by allowing service providers to offer self-service virtual machine instances, storage volumes, and networking configurations over the Internet.</li>
+<li>The Apache CloudStack platform enables enterprises to set up a private cloud for use by their own employees. The current generation of virtualization infrastructure targets enterprise IT departments who manage virtual machines the same way they would manage physical machines. The Apache CloudStack platform, on the other hand, enables self-service of virtual machines by users outside of the IT department. </li>
+<li>As an open source IaaS, Apache CloudStack is available to individuals and organizations that wish to study and implement an IaaS for personal, educational, and/or production use.</li>
+</ul>
+<p>The Cloud.com CloudStack platform includes the Management Server and extensions to industry-standard hypervisor software (<em>e.g.</em> XenServer, vSphere, KVM) installed on Hosts running in the cloud. The Management Server is deployed on a farm of management servers. The administrator provisions resources (Hosts, storage devices, IP addresses, etc.) into the Management Server and the Management Server manages those resources. The Management server presents web interfaces to end users and administrators that enable them to take actions on some or all of their instances in the IaaS cloud.</p>
+<h2 id="can-i-create-my-own-private-templates">Can I create my own private templates?</h2>
+<p><a name="private">Yes. Every template has a privacy level associated with it. Privacy levels include:</a></p>
+<ul>
+<li><strong>Public</strong>: The template is available to all users in the zone.</li>
+<li><strong>Private</strong>: The template is available only to its owner. A user can make her private templates available to specific users.</li>
+</ul>
+<p>Administrators and end users can add templates to the system. Users can see the template owner when viewing the template.</p>
+<p>(Templates define the base OS image that will be used when a guest is first booted. For example, a template might be a 64-bit version of CentOS 5.3.)</p>
+<h2 id="how-are-users-accounts-and-domains-handled-in-cloudstack">How are users, accounts, and domains handled in CloudStack?</h2>
+<p><a name="users">Apache CloudStack users are assigned</a> accounts. An account is typically a customer of the service provider or a department in a large organization. Accounts are the unit of isolation in the cloud. Accounts are grouped by domains. Domains usually contain accounts that have some logical relationship to each other and a set of delegated administrators with some authority over the domain and its subdomains. For example, a service provider with several resellers could create a domain for each reseller.</p>
+<p>Multiple users can exist in an account. Users are like aliases in the account. Users in the same account are not isolated from each other. Most installations need not surface the notion of users; they just have one user per account.</p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>Copyright © 2012 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+ <p>Apache and the Apache feather logos are trademarks of The Apache Software Foundation. </p>
+ </div>
+ </div>
+</body>
+</html>
Added: websites/staging/cloudstack/trunk/content/cloudstack/develop/coding-conventions.html
==============================================================================
--- websites/staging/cloudstack/trunk/content/cloudstack/develop/coding-conventions.html (added)
+++ websites/staging/cloudstack/trunk/content/cloudstack/develop/coding-conventions.html Mon Aug 20 23:27:32 2012
@@ -0,0 +1,205 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <link href="/cloudstack/css/cloudstack.css" rel="stylesheet" type="text/css">
+ <title>Coding Conventions for Apache CloudStack</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE- 2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+</head>
+
+<body>
+ <div id="banner">
+ <img alt="Apache CloudStack (Incubating)" src="/cloudstack/images/title_logo.png" />
+ </div>
+
+ <div id="navigation">
+ <h1>About Apache CloudStack</h2>
+ <a href="/cloudstack/index.html">Home</a><br />
+ <a href="/cloudstack/news.html">News</a><br />
+ <a href="http://incubator.apache.org/projects/cloudstack.html">Incubator Status</a><br />
+ <a href="/cloudstack/downloads.html">Downloads</a><br />
+ <h1>Community</h1>
+ <a href="/cloudstack/develop/get-involved.html">Get Involved</a><br />
+ <a href="/cloudstack/cloudstack-faq.html">CloudStack FAQ</a><br />
+ <a href="/cloudstack/mailing-lists.html">Mailing Lists</a><br />
+ <a href="https://cwiki.apache.org/CLOUDSTACK/draft-cloudstack-community-events-plan.html">Community Events Plan</a><br />
+ <h1>Development</h1>
+ <!-- <a href="/cloudstack/develop/getting-started.html">Getting Started</a><br /> -->
+ <a href="/cloudstack/develop/environment.html">Setting Up an Apache CloudStack Development Environment</a><br />
+ <a href="/cloudstack/develop/non-contributors.html">Contributing for Non-Committers</a><br />
+ <a href="/cloudstack/develop/developer-faq.html">Developer's FAQ</a><br />
+ <a href="/cloudstack/develop/coding-conventions.html">Coding Conventions</a><br />
+ <!-- <a href="/cloudstack/develop/cloudstack-easy-tasks.html">Easy Bugs/Tasks</a><br /> -->
+ <h1>Documentation</h1>
+ <a href="http://docs.cloudstack.org/">CloudStack Documentation</a><br />
+ <a href="http://cwiki.apache.org/confluence/display/CLOUDSTACK/Index">Apache CloudStack Wiki</a><br />
+ <h1>Apache Software Foundation (ASF)</h1>
+ <a href="http://www.apache.org/">Apache Software Foundation</a><br />
+ <a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a><br />
+ <a href="http://www.apache.org/security/">Security</a><br />
+ <img alt="Apache Incubator" src="http://incubator.apache.org/images/egg-logo.png" width="165"/>
+ </div>
+
+ <div id="content">
+ <h1 id="overview">Overview</h1>
+<p>This document covers coding style common in Cloudstack development. It covers coding in Java, shell script, Python and database naming conventions. It does not always cover coding best practices (although there will be some overlap).</p>
+<p>Although the document talks mostly about conventions, certain items are âmustâ while others are âshouldâ and âcanâ.</p>
+<p>In all cases, correctness of the code is paramount, followed by readability, followed by these conventions.</p>
+<p>It is also important to not introduce formatting changes in existing code in the attempt to conform to these conventions: this makes it hard to track logic changes vs. formatting changes in the code. If an existing code block is being rewritten extensively then it makes sense to adopt these conventions.</p>
+<h2 id="copyright-and-license">Copyright and License</h2>
+<p>The top of the code file should include the Apache License 2.0 boilerplate. The Copyright should also be asserted. </p>
+<h1 id="java-coding-conventions">Java Coding Conventions</h1>
+<p>These are mostly taken from the <a href="http://geosoft.no/development/javastyle.html">Java Programming Style Guidelines</a> with modifications to reflect current style in Cloudstack. That document is itself derived from Sunâs original Java Code Conventions document.</p>
+<h2 id="naming-conventions">Naming Conventions</h2>
+<ul>
+<li>Names representing types must be nouns and written in mixed case starting with upper case, <em>e.g.</em>, <code>StoragePool</code>.</li>
+<li>Variable names must be in mixed case starting with lower case, <em>e.g.</em>, <code>virtualRouter</code>.</li>
+<li>Names representing constants (final variables) must be all uppercase using underscore to separate words: <em>e.g.</em> <code>MAX_TEMPLATE_SIZE_MB</code></li>
+<li>Names representing methods must be verbs and written in mixed case starting with lower case: <em>e.g.</em> <code>copyTemplateToZone</code>.</li>
+<li>Abbreviations and acronyms should not be uppercase when used as name: <em>e.g.</em> <code>startElbVm</code></li>
+<li>Private class variables should have underscore prefix: *e.g., <code>_downloadTimer</code>. <strong>Exception</strong>: Transfer Objects (TOs), Database objects (VOs), Command objects:- private class variables in these classes have no underscores. The exception is justified since these are usually logged and are more readable without underscores.</li>
+<li>Static variables are prefixed with <code>s_</code>: <em>e.g.</em> <code>s_logger</code></li>
+<li>The <code>is</code> prefix should be used for boolean variables and methods: <em>e.g.</em> <code>isFinished</code>.</li>
+<li>Exception classes should be suffixed with <code>Exception</code>.</li>
+<li>Default interface implementations can be prefixed by Default or if intended to be subclassed, suffixed by Base: <em>e.g.</em>: <code>DefaultExternalNetworkElement</code> or <code>NetworkElementBase</code>.</li>
+<li>There are various naming conventions used to convey the design patterns common in Apache Cloudstack, listed in the Appendix.</li>
+</ul>
+<h2 id="files-layout-and-whitespace">Files, Layout and Whitespace</h2>
+<ul>
+<li>File content must be kept within 120 columns.</li>
+<li>Continuation of lines should be obvious:</li>
+</ul>
+<p><code>totalSum = a + b + c +</code></p>
+<p><code>d + e;</code></p>
+<ul>
+<li>Must indent with spaces, not tabs. Indentation = 4 spaces in place of a tab.</li>
+<li>Line endings must be LR (Unix/Linux/Mac format)</li>
+<li><strong>White Space Rules</strong><ul>
+<li>Operators should be surrounded by a space character.</li>
+<li>Java reserved words should be surrounded by a white space.</li>
+<li>Commas should be followed by a white space.</li>
+<li>Colons should be surrounded by white space.</li>
+<li>Semicolons in for statements should be followed by a space character.</li>
+</ul>
+</li>
+<li>Block layout should be similar to the example here. Class, interface, and method blocks should also use this layout:</li>
+</ul>
+<pre>
+while (!done) {
+ doSomething();
+ done = moreToDo();
+}
+</pre>
+
+<ul>
+<li>If-else clauses must use the following layout:</li>
+</ul>
+<pre>
+if (condition) {
+ statements;
+} else {
+ statements;
+}
+</pre>
+
+<ul>
+<li>The try-catch block follows the if-else example shown above.</li>
+</ul>
+<h2 id="statements">Statements</h2>
+<ul>
+<li>Imported classes should always be listed explicitly. No wildcards. The list of imports should be kept minimal and organized using your IDE</li>
+<li>Class and Interface declarations should be organized in the following manner:<ul>
+<li>Class/Interface documentation.</li>
+<li>class or interface statement.</li>
+<li>Class (static) variables in the order public, protected, package (no access modifier), private.</li>
+<li>Instance variables in the order public, protected, package (no access modifier), private.</li>
+<li>Constructors.</li>
+<li>Methods (no specific order).</li>
+</ul>
+</li>
+<li>Type conversions must always be done explicitly. Never rely on implicit type conversion.</li>
+<li>Variables should be initialized where they are declared and they should be declared in the smallest scope possible</li>
+<li>Class variables should never be declared public</li>
+<li>Loop variables should be initialized immediately before the loop.</li>
+<li>The conditional should be put on a separate line. This improves debuggability when there is a failure.</li>
+<li>The use of magic numbers in the code should be avoided. Numbers other than 0 and 1can be considered declared as named constants instead.</li>
+</ul>
+<h2 id="comments">Comments</h2>
+<ul>
+<li>Tricky code should not be commented but rewritten. Code should be self documenting</li>
+<li>Code that parses special input strings (e.g, comma delimited) should provide examples of valid strings in comments</li>
+<li>Use // for all non-JavaDoc comments, including multi-line comments</li>
+<li>Comments should be in English</li>
+<li>Comments should be indented relative to their position in the code</li>
+<li>All public classes and public and protected functions within public classes should be documented using the Java documentation (javadoc) conventions</li>
+</ul>
+<h1 id="database-conventions">Database Conventions</h1>
+<ul>
+<li>All SQL keywords are all-caps</li>
+<li>Naming:<ul>
+<li>Table and column names are lower case with underscore separating words</li>
+<li>Indices (including <code>UNIQUE</code>) are lower case of the form <code>i_<table name>_<column name></code></li>
+<li>Foreign key constraints are of the form <code>fk_<table name>__<foreign table name>_<foreign column_name></code></li>
+</ul>
+</li>
+<li>All <code>CREATE TABLEâ</code>s should have the corresponding <code>DROP TABLE IF EXISTS</code> at the top of the file.</li>
+<li>Database engine must always be InnoDB. Charset should always be UTf8</li>
+<li>Primary keys are always <code>bigint unsigned NOT NULL UNIQUE AUTO_INCREMENT</code></li>
+<li>Tables intended for operational purposes, usually transient data should be prefixed with <code>op_</code> (<em>e.g.</em>, <code>op_lock</code>)</li>
+<li>Columns should always be commented unless obvious</li>
+<li>Examine each column to choose your indexes. More indexes can mean more tablespace usage (but this is usually trivial) but better performance. More indexes also increase the possibility of deadlocks.</li>
+</ul>
+<h1 id="shell-script">Shell Script</h1>
+<p>The current state of shell scripts inside Apache CloudStack is fairly inconsistent. Will update later.</p>
+<h1 id="python">Python</h1>
+<ul>
+<li>All Python code must be <a href="http://www.python.org/dev/peps/pep-0008/">PEP-8</a> compliant.</li>
+</ul>
+<h1 id="appendix">Appendix</h1>
+<p>Includes naming conventions.</p>
+<h2 id="naming-conventions-for-design-patterns-used-in-apache-cloudstack-java-code">Naming Conventions for Design Patterns Used in Apache CloudStack Java Code</h2>
+<ul>
+<li>If an interface has only a single implementation, the implementing class has a suffix <code>Impl</code></li>
+<li>A class that maps to a database table is known as a Value Object and is suffixed with VO: <em>e.g.</em>, <code>NetworkVO</code>. This actually maps to the EJB DTO pattern rather than the EJB VO pattern.</li>
+<li>A class that transfers data from one tier to another (<em>e.g.</em>, from the business logic tier to the resource layer) is a Transfer Object and is suffixed with <code>TO</code>: <em>e.g.</em>, <code>LoadBalancerTO</code>.</li>
+<li>A utility class that encapsulates common utilities (e.g., conversion between ip address formats) is suffixed with <code>Utils</code>: <em>e.g.</em>, <code>NetUtils</code>. These classes do not hold state. Generally all methods are static.</li>
+<li>Services offered by the business tier to the API tier are declared as interfaces and are suffixed by Service. <em>e.g.</em>, <code>LoadBalancerService</code></li>
+<li>Singleton classes that implement lifecycle functions are called Managers: <em>e.g.</em> <code>AgentManager</code>.</li>
+<li>Data Access Objects (DAOs) implement the J2EE DAO pattern. They are generally declared as interfaces suffixed with DAO and then implemented as classes with the DaoImpl suffix: <em>e.g.</em>, <code>AccountDao</code> and <code>AccountDaoImpl</code>.</li>
+<li>The Cloudstack API layer implements the Command pattern. All API commands are suffixed with <code>Cmd</code>: <em>e.g.</em> <code>DeployVmCmd</code>.</li>
+<li>The internal API layer between the business tier and the resource layer also uses the Command pattern. These classes are suffixed with <code>Command</code>. Responses to these commands are suffixed with <code>Answer</code>: <em>e.g.</em> <code>ModifyStoragePoolCommand</code> and <code>ModifyStoragePoolAnswer</code>.</li>
+<li>Resources are managers that respond to the internal API commands: <em>e.g.</em> <code>XenServer56Resource</code>.</li>
+</ul>
+<h1 id="references">References</h1>
+<p>Additional References:</p>
+<ul>
+<li><a href="http://geosoft.no/development/javastyle.html">Java Programming Style Guidelines</a></li>
+<li><a href="http://www.oracle.com/technetwork/java/codeconvtoc-136057.html">Java Code Conventions</a></li>
+</ul>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>Copyright © 2012 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+ <p>Apache and the Apache feather logos are trademarks of The Apache Software Foundation. </p>
+ </div>
+ </div>
+</body>
+</html>
Added: websites/staging/cloudstack/trunk/content/cloudstack/develop/developer-faq.html
==============================================================================
--- websites/staging/cloudstack/trunk/content/cloudstack/develop/developer-faq.html (added)
+++ websites/staging/cloudstack/trunk/content/cloudstack/develop/developer-faq.html Mon Aug 20 23:27:32 2012
@@ -0,0 +1,93 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <link href="/cloudstack/css/cloudstack.css" rel="stylesheet" type="text/css">
+ <title>Apache CloudStack (Incubating) Developer's FAQ</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE- 2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+</head>
+
+<body>
+ <div id="banner">
+ <img alt="Apache CloudStack (Incubating)" src="/cloudstack/images/title_logo.png" />
+ </div>
+
+ <div id="navigation">
+ <h1>About Apache CloudStack</h2>
+ <a href="/cloudstack/index.html">Home</a><br />
+ <a href="/cloudstack/news.html">News</a><br />
+ <a href="http://incubator.apache.org/projects/cloudstack.html">Incubator Status</a><br />
+ <a href="/cloudstack/downloads.html">Downloads</a><br />
+ <h1>Community</h1>
+ <a href="/cloudstack/develop/get-involved.html">Get Involved</a><br />
+ <a href="/cloudstack/cloudstack-faq.html">CloudStack FAQ</a><br />
+ <a href="/cloudstack/mailing-lists.html">Mailing Lists</a><br />
+ <a href="https://cwiki.apache.org/CLOUDSTACK/draft-cloudstack-community-events-plan.html">Community Events Plan</a><br />
+ <h1>Development</h1>
+ <!-- <a href="/cloudstack/develop/getting-started.html">Getting Started</a><br /> -->
+ <a href="/cloudstack/develop/environment.html">Setting Up an Apache CloudStack Development Environment</a><br />
+ <a href="/cloudstack/develop/non-contributors.html">Contributing for Non-Committers</a><br />
+ <a href="/cloudstack/develop/developer-faq.html">Developer's FAQ</a><br />
+ <a href="/cloudstack/develop/coding-conventions.html">Coding Conventions</a><br />
+ <!-- <a href="/cloudstack/develop/cloudstack-easy-tasks.html">Easy Bugs/Tasks</a><br /> -->
+ <h1>Documentation</h1>
+ <a href="http://docs.cloudstack.org/">CloudStack Documentation</a><br />
+ <a href="http://cwiki.apache.org/confluence/display/CLOUDSTACK/Index">Apache CloudStack Wiki</a><br />
+ <h1>Apache Software Foundation (ASF)</h1>
+ <a href="http://www.apache.org/">Apache Software Foundation</a><br />
+ <a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a><br />
+ <a href="http://www.apache.org/security/">Security</a><br />
+ <img alt="Apache Incubator" src="http://incubator.apache.org/images/egg-logo.png" width="165"/>
+ </div>
+
+ <div id="content">
+ <h1 id="apache-cloudstack-incubating-developers-faq">Apache CloudStack (Incubating) Developer's FAQ</h1>
+<p>This page is for Frequently Asked Questions (FAQ) about developing Apache CloudStack. For questions about the project in general and its use, please see the <a href="/cloudstack/cloudstack-faq.html">CloudStack FAQ</a>. </p>
+<p>Have a question that's not answered here? You might want to ask on the <a href="/cloudstack/mailing-lists.html">cloudstack-dev mailing list</a>.</p>
+<ul>
+<li><a href="/cloudstack/develop/developer-faq.html#git">Where can I find the Apache CloudStack git repository?</a></li>
+<li><a href="/cloudstack/develop/developer-faq.html#coding">What are the coding conventions for Apache CloudStack?</a></li>
+<li><a href="/cloudstack/develop/developer-faq.html#devel">How can I set up a development environment?</a></li>
+<li><a href="/cloudstack/develop/developer-faq.html#noncommit">Can non-committers still submit patches?</a></li>
+<li><a href="/cloudstack/develop/developer-faq.html#myq">My question isn't answered here.</a></li>
+</ul>
+<h2 id="where-can-i-find-the-apache-cloudstack-git-repository">Where can I find the Apache CloudStack git repository?</h2>
+<p><a name="git"></a>The Apache CloudStack git repository is hosted here: <a href="https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git">https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git</a>. </p>
+<h2 id="what-are-the-coding-conventions-for-apache-cloudstack">What are the coding conventions for Apache CloudStack?</h2>
+<p><a name="coding"></a>Apache CloudStack has detailed coding conventions in our <a href="/cloudstack/develop/coding-conventions.html">developer's documentation</a>. Please do follow these. See also the <a href="http://geosoft.no/development/javastyle.html">Java Programming Style Guidelines</a> and <a href="http://www.oracle.com/technetwork/java/codeconvtoc-136057.html">Java Code Conventions</a>. </p>
+<p>If patches and submissions are not up to the coding conventions, you may be asked to fix them and re-submit. </p>
+<h2 id="how-can-i-set-up-a-development-environment">How can I set up a development environment?</h2>
+<p><a name="devel"></a>Setting up a development environment for Apache CloudStack is fairly easy. See the <a href="/cloudstack/develop/environment.html">Guide to Setting up an Apache CloudStack development environment</a> in our developer's documentation section.</p>
+<p>Note that you do <em>not</em> have to replicate the development environment that we suggest. This is provided as a convenience to help developers get up to speed quickly. If you already have a setup that works for you, please feel free to use that instead.</p>
+<h2 id="can-non-committers-still-submit-patches">Can non-committers still submit patches?</h2>
+<p><a name="noncommit"></a>Yes, of course. We welcome patches from non-committers. See the <a href="/cloudstack/develop/non-contributors.html">guide to committing to Apache CloudStack as a non-committer</a> for more information.</p>
+<h2 id="my-question-isnt-answered-here">My question isn't answered here.</h2>
+<p><a name="myq"></a>That's a statement, not a question. Seriously, though, we're happy to update the FAQ as we learn more about the questions developers have about working with Apache CloudStack.<br />
+</p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>Copyright © 2012 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+ <p>Apache and the Apache feather logos are trademarks of The Apache Software Foundation. </p>
+ </div>
+ </div>
+</body>
+</html>
Added: websites/staging/cloudstack/trunk/content/cloudstack/develop/environment.html
==============================================================================
--- websites/staging/cloudstack/trunk/content/cloudstack/develop/environment.html (added)
+++ websites/staging/cloudstack/trunk/content/cloudstack/develop/environment.html Mon Aug 20 23:27:32 2012
@@ -0,0 +1,135 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <link href="/cloudstack/css/cloudstack.css" rel="stylesheet" type="text/css">
+ <title>Setting Up an Apache CloudStack (Incubating) Development Environment</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE- 2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+</head>
+
+<body>
+ <div id="banner">
+ <img alt="Apache CloudStack (Incubating)" src="/cloudstack/images/title_logo.png" />
+ </div>
+
+ <div id="navigation">
+ <h1>About Apache CloudStack</h2>
+ <a href="/cloudstack/index.html">Home</a><br />
+ <a href="/cloudstack/news.html">News</a><br />
+ <a href="http://incubator.apache.org/projects/cloudstack.html">Incubator Status</a><br />
+ <a href="/cloudstack/downloads.html">Downloads</a><br />
+ <h1>Community</h1>
+ <a href="/cloudstack/develop/get-involved.html">Get Involved</a><br />
+ <a href="/cloudstack/cloudstack-faq.html">CloudStack FAQ</a><br />
+ <a href="/cloudstack/mailing-lists.html">Mailing Lists</a><br />
+ <a href="https://cwiki.apache.org/CLOUDSTACK/draft-cloudstack-community-events-plan.html">Community Events Plan</a><br />
+ <h1>Development</h1>
+ <!-- <a href="/cloudstack/develop/getting-started.html">Getting Started</a><br /> -->
+ <a href="/cloudstack/develop/environment.html">Setting Up an Apache CloudStack Development Environment</a><br />
+ <a href="/cloudstack/develop/non-contributors.html">Contributing for Non-Committers</a><br />
+ <a href="/cloudstack/develop/developer-faq.html">Developer's FAQ</a><br />
+ <a href="/cloudstack/develop/coding-conventions.html">Coding Conventions</a><br />
+ <!-- <a href="/cloudstack/develop/cloudstack-easy-tasks.html">Easy Bugs/Tasks</a><br /> -->
+ <h1>Documentation</h1>
+ <a href="http://docs.cloudstack.org/">CloudStack Documentation</a><br />
+ <a href="http://cwiki.apache.org/confluence/display/CLOUDSTACK/Index">Apache CloudStack Wiki</a><br />
+ <h1>Apache Software Foundation (ASF)</h1>
+ <a href="http://www.apache.org/">Apache Software Foundation</a><br />
+ <a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a><br />
+ <a href="http://www.apache.org/security/">Security</a><br />
+ <img alt="Apache Incubator" src="http://incubator.apache.org/images/egg-logo.png" width="165"/>
+ </div>
+
+ <div id="content">
+ <h1 id="setting-up-an-apache-cloudstack-development-environment">Setting Up an Apache CloudStack Development Environment</h1>
+<p>Want to set up an Apache CloudStack development environment? We'll show you how to set up a development environment under Linux with Eclipse as the IDE.</p>
+<h2 id="getting-source">Getting Source</h2>
+<p>CloudStack uses git for source version control, if you know little about git, http://book.git-scm.com/ is a good start. Once you have git setup on your machine, pull source with:</p>
+<div class="codehilite"><pre><span class="n">git</span> <span class="n">clone</span> <span class="n">https:</span><span class="sr">//gi</span><span class="n">t</span><span class="o">-</span><span class="n">wip</span><span class="o">-</span><span class="n">us</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="o">/</span><span class="n">incubator</span><span class="o">-</span><span class="n">cloudstack</span><span class="o">.</span><span class="n">git</span>
+</pre></div>
+
+
+<h2 id="importing-source-into-eclipse">Importing Source into Eclipse</h2>
+<p>Most Apache CloudStack developers use Eclipse as their primary IDE. CloudStack source code already includes Eclipse .project file in each project folder, you can import them to your Eclipse workspace by:</p>
+<ul>
+<li>Creating a new Eclipse workspace, right clicking package explorer and selecting <strong>Import</strong>.</li>
+<li>Selecting <strong>"Existing Projects into Workspace"</strong>.</li>
+<li>Browsing to the folder with CloudStack source code.</li>
+<li>Click <strong>Open</strong>, where you will see all Apache CloudStack projects listed in the dialog box. Click the <strong>Finish</strong> button. Now you have CloudStack registered with Eclipse.</li>
+</ul>
+<h2 id="installing-dependencies">Installing Dependencies</h2>
+<p>In this section we'll look at installing the dependencies you'll need for Apache CloudStack development.</p>
+<h3 id="installing-openjdk">Installing OpenJDK</h3>
+<p>Install <code>openjdk</code>. As we're using Linux, OpenJDK is our first choice. You can install it using Yum or APT, depending on which Linux distribution you use one of these commands:</p>
+<p><code>yum install package_name_of_openjdk</code></p>
+<p><code>apt-get install package_name_of_openjdk</code></p>
+<p>If you're unsure of the name for the OpenJDK package, use <code>yum search</code> or <code>apt-cache search</code>, or use your distribution's GUI-based tools for installing and managing packages.</p>
+<p>Note that you are free to install another JVM if you have special needs.</p>
+<h3 id="installing-apache-tomcat-6">Installing Apache Tomcat 6</h3>
+<p>Install <code>tomcat6</code>. Apache CloudStack developers use the tarball from the Tomcat 6 download page, as it's the easiest and fastest way.</p>
+<p>Here we'll download Apache Tomcat 6 and uncompress the tarball:</p>
+<p><code>wget http://archive.apache.org/dist/tomcat/tomcat-6/v6.0.33/bin/apache-tomcat-6.0.33.tar.gz</code></p>
+<p><code>tar xzf apache-tomcat-6.0.33.tar.gz</code></p>
+<p><strong>Note</strong> we specifically recommend Apache Tomcat version 6.0.33 at this time. The 6.0.35 release has some issues with Apache CloudStack at this time, thus we recommend avoiding it for CloudStack development.</p>
+<p>Now we set the environment variables:</p>
+<p><code>export CATALINA_HOME=/your_path/apache-tomcat-6.0.33/</code></p>
+<p><code>export CATALINA_BASE=/your_path/apache-tomcat-6.0.33/</code></p>
+<p><strong>Note</strong>: we usually set them in <code>~/.bashrc</code> for convenience.</p>
+<h3 id="install-ant">Install Ant</h3>
+<p>You don't need to install Ant yourself, but you do need to set up the copy of Ant that's included in Apache CloudStack source:</p>
+<p><code>export PATH=/cloudstack_source_dir/tools/ant/apache-ant-1.7.1/bin/:$PATH</code></p>
+<p><strong>Note</strong>: You should also add this to your <code>~/.bashrc</code>.</p>
+<h3 id="install-mysql">Install MySQL</h3>
+<p>Next, we'll install MySQL if it's not already present on the system. Again, use Yum or APT depending on the type of system you're doing development on.</p>
+<p><code>yum install mysql-server</code></p>
+<p><code>apt-get install mysql-server</code></p>
+<h2 id="compile-and-deploy">Compile and Deploy</h2>
+<p>To compile Apache CloudStack, go to the cloudstack source folder and run:</p>
+<p><code>ant clean-all build-all</code></p>
+<p>To deploy Apache CloudStack, run:</p>
+<p><code>ant deploy-server</code></p>
+<p>Deploy the database next:</p>
+<p><code>ant deploydb</code></p>
+<h2 id="run-apache-cloudstack">Run Apache CloudStack</h2>
+<p>To start CloudStack, run:</p>
+<p><code>ant debug</code></p>
+<p>Apache CloudStack should now be running. Its log file is called vmops.log, and it should be under the root source directory. You can monitor it with:</p>
+<p><code>tail -f vmops.log</code></p>
+<h2 id="run-with-suspend">Run with Suspend</h2>
+<p>If you're going to set a break point in Eclipse before CloudStack launches, you may want to suspend CloudStack until Eclipse debugger is connected. Do this with:</p>
+<p><code>ant debug-suspend</code></p>
+<p>Now CloudStack is running and listening on port 8787. You can use the remote debug feature of Eclipse to connect to this port and CloudStack will go on running.</p>
+<h2 id="log-into-apache-cloudstack">Log Into Apache CloudStack</h2>
+<p>Open your Web browser and use this URL to connect to CloudStack:</p>
+<p><code>http://localhost:8080/client/</code></p>
+<p>or</p>
+<p><code>http://ip_address_where_cloudstack_is_running:8080/client</code></p>
+<p><strong>Note</strong>: If you have iptables enabled, you may have to open the ports used by CloudStack. Specifically, ports 8080, 8250, and 9090.</p>
+<p>If you've run into any problems with this, please ask on the cloudstack-dev <a href="/cloudstack/mailing-lists.html">mailing list</a>.</p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>Copyright © 2012 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+ <p>Apache and the Apache feather logos are trademarks of The Apache Software Foundation. </p>
+ </div>
+ </div>
+</body>
+</html>
Added: websites/staging/cloudstack/trunk/content/cloudstack/develop/non-contributors.html
==============================================================================
--- websites/staging/cloudstack/trunk/content/cloudstack/develop/non-contributors.html (added)
+++ websites/staging/cloudstack/trunk/content/cloudstack/develop/non-contributors.html Mon Aug 20 23:27:32 2012
@@ -0,0 +1,121 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <link href="/cloudstack/css/cloudstack.css" rel="stylesheet" type="text/css">
+ <title>Contributing to Apache CloudStack as a Non-Committer</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE- 2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+</head>
+
+<body>
+ <div id="banner">
+ <img alt="Apache CloudStack (Incubating)" src="/cloudstack/images/title_logo.png" />
+ </div>
+
+ <div id="navigation">
+ <h1>About Apache CloudStack</h2>
+ <a href="/cloudstack/index.html">Home</a><br />
+ <a href="/cloudstack/news.html">News</a><br />
+ <a href="http://incubator.apache.org/projects/cloudstack.html">Incubator Status</a><br />
+ <a href="/cloudstack/downloads.html">Downloads</a><br />
+ <h1>Community</h1>
+ <a href="/cloudstack/develop/get-involved.html">Get Involved</a><br />
+ <a href="/cloudstack/cloudstack-faq.html">CloudStack FAQ</a><br />
+ <a href="/cloudstack/mailing-lists.html">Mailing Lists</a><br />
+ <a href="https://cwiki.apache.org/CLOUDSTACK/draft-cloudstack-community-events-plan.html">Community Events Plan</a><br />
+ <h1>Development</h1>
+ <!-- <a href="/cloudstack/develop/getting-started.html">Getting Started</a><br /> -->
+ <a href="/cloudstack/develop/environment.html">Setting Up an Apache CloudStack Development Environment</a><br />
+ <a href="/cloudstack/develop/non-contributors.html">Contributing for Non-Committers</a><br />
+ <a href="/cloudstack/develop/developer-faq.html">Developer's FAQ</a><br />
+ <a href="/cloudstack/develop/coding-conventions.html">Coding Conventions</a><br />
+ <!-- <a href="/cloudstack/develop/cloudstack-easy-tasks.html">Easy Bugs/Tasks</a><br /> -->
+ <h1>Documentation</h1>
+ <a href="http://docs.cloudstack.org/">CloudStack Documentation</a><br />
+ <a href="http://cwiki.apache.org/confluence/display/CLOUDSTACK/Index">Apache CloudStack Wiki</a><br />
+ <h1>Apache Software Foundation (ASF)</h1>
+ <a href="http://www.apache.org/">Apache Software Foundation</a><br />
+ <a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a><br />
+ <a href="http://www.apache.org/security/">Security</a><br />
+ <img alt="Apache Incubator" src="http://incubator.apache.org/images/egg-logo.png" width="165"/>
+ </div>
+
+ <div id="content">
+ <h1 id="contributing-to-apache-cloudstack-as-a-non-committer">Contributing to Apache CloudStack as a Non-Committer</h1>
+<p>If you're a contributor to an Apache project, it means that you can commit directly to the project's repository. For instance, with Apache CloudStack (incubating) contributors are allowed to directly push commits into the git repository. </p>
+<p>Non-committers, however, have to submit patches for review. Don't worry, it's not an onerous process at all. The first time you submit a patch, it will take a minute or two to create an account on <a href="http://reviews.apache.org/">Review Board</a>, but it's a piece of cake from start to finish.</p>
+<h2 id="assumptions">Assumptions</h2>
+<p>For the purpose of this post, we'll assume that you already have a system with <a href="http://git-scm.com/">Git</a> and have found a bug to fix or have a feature that you'd like to submit, and you're willing to contribute that code or documentation under the <a href="http://www.apache.org/licenses/LICENSE-2.0.html">Apache License 2.0</a>.</p>
+<p>Further, if you're fixing a bug we'll assume that you've either filed a bug report or are submitting a fix for a known bug. If you find a bug and would like to fix it, that's awesome! Please be sure to file the bug too, though. </p>
+<p>If you want to add a feature, you should bring it up for discussion on the cloudstack-dev mailing list before implementing it. This ensures that it meshes with the plans that other contributors have for Apache CloudStack, and that you're not doing redundant work. Other developers may also have ideas for the feature or suggestions that will help you land the feature without having to re-do the work.</p>
+<p>In short, communication is a vital part of making a contribution to an Apache project. </p>
+<h2 id="getting-started">Getting Started</h2>
+<p>First, lets make sure that you've added your name and email to your <code>~/.gitconfig</code>:</p>
+<p><code>git config --global user.name "Your Name"</code></p>
+<p><code>git config --global user.email you@domain.com</code></p>
+<p>You'll grab the CloudStack source with git:</p>
+<p><code>$ git clone https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git</code></p>
+<p>If you already have the source, make sure you're working with the most recent version. Do a <code>git pull</code> if you cloned the source more than a few hours ago. (Apache CloudStack development can move pretty fast!) </p>
+<p>Now that you have an up-to-date copy of the source, create a branch to do your work in:</p>
+<p><code>$ git checkout -b mybranch</code></p>
+<p>This does two things: One, it creates the branch <em>mybranch</em> and two, it changes your working branch to <em>mybranch</em>. Running <code>git branch</code> will show you which branch you're working on, with an asterisk next to the active branch, like so:</p>
+<pre>
+[user@localhost incubator-cloudstack]$ git branch
+ master
+* mybranch
+</pre>
+
+<p>Make whatever changes you're going to make, be sure to use <code>git add</code> to stage the changes, and then you're going to commit the changes to your working branch:</p>
+<p><code>git commit -m "Insert a meaningful summary of changes here."</code></p>
+<p>Finally, you're going to create a patch to upload to <a href="http://reviews.apache.org/">Review Board</a>:</p>
+<p><code>git format-patch master --stdout > ~/patch-name.patch</code></p>
+<h2 id="using-review-board">Using Review Board</h2>
+<p>Review Board is the approved method of sending patches to the Apache CloudStack project. That's not to say that a patch sent directly to the mailing list will be ignored, but the <em>strong preference</em> is that patches be submitted through Review Board. Don't worry, it's a very easy tool to use. </p>
+<p>If you haven't already, create an account with Review Board. Registering only requires an email address, first name, and last name. After you're registered, head to <a href="https://reviews.apache.org/r/new/">New Review Request</a> and select the repository (<strong>cloudstack-git</strong>) and upload the patch (diff) created with git. </p>
+<p>Click <strong>Create Review Request</strong> and then fill out the information required. Specifically:</p>
+<ul>
+<li>Summary</li>
+<li>Groups (choose cloudstack)</li>
+<li>People (only use if you need specific committers to review changes)</li>
+<li>Description</li>
+<li>Testing Done</li>
+</ul>
+<p>The <strong>Summary</strong> will be the subject that's sent to the cloudstack-dev mailing list. So if your summary is "fixed feature foo" the subject of the mail sent to the list will be "Review Request: fixed feature foo". Try to be descriptive with the Summary. If you're submitting a patch for a bug, please be sure to include the bug number in the summary. (Like "Bugfix CS-15942: Fixing problem with redundant routers.")</p>
+<p>The description should be a full description of what you've done. Please be specific, and include enough information that any reviewer will be able to look at your patch without asking for follow-up information.</p>
+<p>If you're submitting a patch that modifies code, adds features, etc. you should test before submitting. Please be sure to describe your tests here. </p>
+<p>Once you're sure everything is OK, go ahead and submit the patch. But that's <em>not</em> the end of the process. The work isn't done until the patch is committed!</p>
+<h2 id="review">Review</h2>
+<p>Once you've submitted your patch, you should receive a response within a few days. If you receive no response within a week, please ping the cloudstack-dev mailing list. One of the features of Review Board is that shows all of the requests and when they were posted, and the committers know that they should be responsible for reviewing patches in a timely fashion.</p>
+<p>When your patch is reviewed, it may be accepted as-is or you may be asked to make changes. If you're asked to make changes, please work with the committer to see the patch through to acceptance. </p>
+<p>If the patch is accepted and committed, you have one last task (don't worry, it's minor and kind of satisfying). </p>
+<p>Go back to Review Board, click <strong>My Dashboard</strong> and then <strong>Outgoing Reviews</strong>. Go to your submission, you should see a "Ship it!" message from the reviewer. Click the <strong>Close</strong> button and choose <strong>Submitted</strong>. The status has now changed from <em>pending</em> to <em>submitted</em>. </p>
+<p>That's it – you've helped make Apache CloudStack a better project. Thanks!</p>
+<h2 id="further-reading">Further Reading</h2>
+<p>You might want to peruse the <a href="http://www.apache.org/foundation/getinvolved.html">Get Involved</a> page on Apache.org, and the <a href="http://commons.apache.org/patches.html">On Contributing Patches</a> doc as well. Note that some of that does not apply to Apache CloudStack, as we're using git rather than Subversion. But do respect the original style of the CloudStack code, and ensure that you're using spaces rather than tabs, and your patches have Unix line endings (LF) rather than Windows-type line endings (CRLF).</p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>Copyright © 2012 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+ <p>Apache and the Apache feather logos are trademarks of The Apache Software Foundation. </p>
+ </div>
+ </div>
+</body>
+</html>
Added: websites/staging/cloudstack/trunk/content/cloudstack/downloads.html
==============================================================================
--- websites/staging/cloudstack/trunk/content/cloudstack/downloads.html (added)
+++ websites/staging/cloudstack/trunk/content/cloudstack/downloads.html Mon Aug 20 23:27:32 2012
@@ -0,0 +1,88 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <link href="/cloudstack/css/cloudstack.css" rel="stylesheet" type="text/css">
+ <title>Apache CloudStack (Incubating) Downloads</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE- 2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+</head>
+
+<body>
+ <div id="banner">
+ <img alt="Apache CloudStack (Incubating)" src="/cloudstack/images/title_logo.png" />
+ </div>
+
+ <div id="navigation">
+ <h1>About Apache CloudStack</h2>
+ <a href="/cloudstack/index.html">Home</a><br />
+ <a href="/cloudstack/news.html">News</a><br />
+ <a href="http://incubator.apache.org/projects/cloudstack.html">Incubator Status</a><br />
+ <a href="/cloudstack/downloads.html">Downloads</a><br />
+ <h1>Community</h1>
+ <a href="/cloudstack/develop/get-involved.html">Get Involved</a><br />
+ <a href="/cloudstack/cloudstack-faq.html">CloudStack FAQ</a><br />
+ <a href="/cloudstack/mailing-lists.html">Mailing Lists</a><br />
+ <a href="https://cwiki.apache.org/CLOUDSTACK/draft-cloudstack-community-events-plan.html">Community Events Plan</a><br />
+ <h1>Development</h1>
+ <!-- <a href="/cloudstack/develop/getting-started.html">Getting Started</a><br /> -->
+ <a href="/cloudstack/develop/environment.html">Setting Up an Apache CloudStack Development Environment</a><br />
+ <a href="/cloudstack/develop/non-contributors.html">Contributing for Non-Committers</a><br />
+ <a href="/cloudstack/develop/developer-faq.html">Developer's FAQ</a><br />
+ <a href="/cloudstack/develop/coding-conventions.html">Coding Conventions</a><br />
+ <!-- <a href="/cloudstack/develop/cloudstack-easy-tasks.html">Easy Bugs/Tasks</a><br /> -->
+ <h1>Documentation</h1>
+ <a href="http://docs.cloudstack.org/">CloudStack Documentation</a><br />
+ <a href="http://cwiki.apache.org/confluence/display/CLOUDSTACK/Index">Apache CloudStack Wiki</a><br />
+ <h1>Apache Software Foundation (ASF)</h1>
+ <a href="http://www.apache.org/">Apache Software Foundation</a><br />
+ <a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a><br />
+ <a href="http://www.apache.org/security/">Security</a><br />
+ <img alt="Apache Incubator" src="http://incubator.apache.org/images/egg-logo.png" width="165"/>
+ </div>
+
+ <div id="content">
+ <h1 id="how-to-get-apache-cloudstack">How to Get Apache CloudStack</h1>
+<p>Apache CloudStack has not yet made a release as an incubating project. Releases of CloudStack as a Citrix project prior to the project's acceptance into the incubator can be found on SourceForge.net:</p>
+<ul>
+<li><a href="http://sourceforge.net/projects/cloudstack/files/CloudStack%20Acton/3.0.2/CloudStack-oss-3.0.2-1-rhel6.2.tar.gz/download">Binaries for Red Hat Enterprise Linux 6.2 and CentOS 6.2</a></li>
+<li><a href="http://sourceforge.net/projects/cloudstack/files/CloudStack%20Acton/3.0.2/CloudStack-oss-3.0.2-1-ubuntu10.04.tar.gz/download">Binaries for Ubuntu 10.04 LTS</a></li>
+</ul>
+<p>Once Apache CloudStack has prepared a release, it will be linked here. Note that the official release is the source package, rather than binaries. Binaries will be provided as a convenience, but the canonical release is the source code.</p>
+<h1 id="apache-cloudstack-git-repository">Apache CloudStack Git Repository</h1>
+<p>The git repository is hosted on Apache infrastructure, and can be found here:</p>
+<ul>
+<li><a href="https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git">https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git</a></li>
+</ul>
+<p>To get the most recent source for Apache CloudStack, use:</p>
+<div class="codehilite"><pre><span class="n">git</span> <span class="n">clone</span> <span class="n">https:</span><span class="sr">//gi</span><span class="n">t</span><span class="o">-</span><span class="n">wip</span><span class="o">-</span><span class="n">us</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="o">/</span><span class="n">incubator</span><span class="o">-</span><span class="n">cloudstack</span><span class="o">.</span><span class="n">git</span>
+</pre></div>
+
+
+<p>For projects related to Apache CloudStack, see the <a href="https://github.com/cloudstack">GitHub repositories</a>.</p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>Copyright © 2012 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+ <p>Apache and the Apache feather logos are trademarks of The Apache Software Foundation. </p>
+ </div>
+ </div>
+</body>
+</html>
Added: websites/staging/cloudstack/trunk/content/cloudstack/mailing-lists.html
==============================================================================
--- websites/staging/cloudstack/trunk/content/cloudstack/mailing-lists.html (added)
+++ websites/staging/cloudstack/trunk/content/cloudstack/mailing-lists.html Mon Aug 20 23:27:32 2012
@@ -0,0 +1,90 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <link href="/cloudstack/css/cloudstack.css" rel="stylesheet" type="text/css">
+ <title>Apache CloudStack Mailing Lists</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE- 2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+</head>
+
+<body>
+ <div id="banner">
+ <img alt="Apache CloudStack (Incubating)" src="/cloudstack/images/title_logo.png" />
+ </div>
+
+ <div id="navigation">
+ <h1>About Apache CloudStack</h2>
+ <a href="/cloudstack/index.html">Home</a><br />
+ <a href="/cloudstack/news.html">News</a><br />
+ <a href="http://incubator.apache.org/projects/cloudstack.html">Incubator Status</a><br />
+ <a href="/cloudstack/downloads.html">Downloads</a><br />
+ <h1>Community</h1>
+ <a href="/cloudstack/develop/get-involved.html">Get Involved</a><br />
+ <a href="/cloudstack/cloudstack-faq.html">CloudStack FAQ</a><br />
+ <a href="/cloudstack/mailing-lists.html">Mailing Lists</a><br />
+ <a href="https://cwiki.apache.org/CLOUDSTACK/draft-cloudstack-community-events-plan.html">Community Events Plan</a><br />
+ <h1>Development</h1>
+ <!-- <a href="/cloudstack/develop/getting-started.html">Getting Started</a><br /> -->
+ <a href="/cloudstack/develop/environment.html">Setting Up an Apache CloudStack Development Environment</a><br />
+ <a href="/cloudstack/develop/non-contributors.html">Contributing for Non-Committers</a><br />
+ <a href="/cloudstack/develop/developer-faq.html">Developer's FAQ</a><br />
+ <a href="/cloudstack/develop/coding-conventions.html">Coding Conventions</a><br />
+ <!-- <a href="/cloudstack/develop/cloudstack-easy-tasks.html">Easy Bugs/Tasks</a><br /> -->
+ <h1>Documentation</h1>
+ <a href="http://docs.cloudstack.org/">CloudStack Documentation</a><br />
+ <a href="http://cwiki.apache.org/confluence/display/CLOUDSTACK/Index">Apache CloudStack Wiki</a><br />
+ <h1>Apache Software Foundation (ASF)</h1>
+ <a href="http://www.apache.org/">Apache Software Foundation</a><br />
+ <a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a><br />
+ <a href="http://www.apache.org/security/">Security</a><br />
+ <img alt="Apache Incubator" src="http://incubator.apache.org/images/egg-logo.png" width="165"/>
+ </div>
+
+ <div id="content">
+ <h1 id="apache-cloudstack-incubating-mailing-lists">Apache CloudStack (Incubating) Mailing Lists</h1>
+<p>If you're interested in learning more or participating in the Apache CloudStack project, the mailing lists are the best way to do that. While the project has several communications channels, the mailing lists are the most active and the official channels for making decisions about the project itself. <em><a href="http://community.apache.org/newbiefaq.html#NewbieFAQ-IsthereaCodeofConductforApacheprojects?"">"If it didn't happen on a mailing list, it didn't happen."</a></em></p>
+<p>The project currently has three lists:</p>
+<ul>
+<li>cloudstack-dev: Where discussions about development and the project itself happen. This is a high volume list.</li>
+<li>cloudstack-users: This list is for users of CloudStack to seek and provide support. This is a moderately high volume list.</li>
+<li>cloudstack-commits: This list is for commits to the CloudStack git repository. It's a high volume list with automated messages, probably of limited interest to anyone who is not actively developing Apache CloudStack.</li>
+</ul>
+<form action="http://markmail.org/search/list:org.apache.incubator.cloudstack-*">
+<strong>Search the CloudStack Mailing Lists on MarkMail</strong>: <input type="text" name="q" size="50"/>
+<input type="submit" value="Search"/>
+</form>
+
+<h2 id="to-subscribe-to-the-mailing-lists">To Subscribe to the Mailing Lists</h2>
+<p>If you want to subscribe to list, send an email to <em>listname</em>-subscribe@incubator.apache.org. For instance, to subscribe to the cloudstack-users list, use <code>cloudstack-users-subscribe@incubator.apache.org</code>. </p>
+<h2 id="to-unsubscribe-to-the-mailing-lists">To Unsubscribe to the Mailing Lists</h2>
+<p>Decided you're getting too much mail? To unsubscribe from one of the lists, send an email to <em>listname</em>-unsubscribe@incubator.apache.org from the same email you subscribed with.</p>
+<p><strong>Please do not send emails to the list asking for someone to unsubscribe you.</strong> </p>
+<h2 id="conduct-on-mailing-lists">Conduct on Mailing Lists</h2>
+<p>We expect all participants on the mailing list to treat one another professionally and politely. </p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>Copyright © 2012 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+ <p>Apache and the Apache feather logos are trademarks of The Apache Software Foundation. </p>
+ </div>
+ </div>
+</body>
+</html>
Added: websites/staging/cloudstack/trunk/content/cloudstack/news.html
==============================================================================
--- websites/staging/cloudstack/trunk/content/cloudstack/news.html (added)
+++ websites/staging/cloudstack/trunk/content/cloudstack/news.html Mon Aug 20 23:27:32 2012
@@ -0,0 +1,74 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <link href="/cloudstack/css/cloudstack.css" rel="stylesheet" type="text/css">
+ <title>Apache CloudStack (Incubating) News</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<!--
+
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE- 2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+</head>
+
+<body>
+ <div id="banner">
+ <img alt="Apache CloudStack (Incubating)" src="/cloudstack/images/title_logo.png" />
+ </div>
+
+ <div id="navigation">
+ <h1>About Apache CloudStack</h2>
+ <a href="/cloudstack/index.html">Home</a><br />
+ <a href="/cloudstack/news.html">News</a><br />
+ <a href="http://incubator.apache.org/projects/cloudstack.html">Incubator Status</a><br />
+ <a href="/cloudstack/downloads.html">Downloads</a><br />
+ <h1>Community</h1>
+ <a href="/cloudstack/develop/get-involved.html">Get Involved</a><br />
+ <a href="/cloudstack/cloudstack-faq.html">CloudStack FAQ</a><br />
+ <a href="/cloudstack/mailing-lists.html">Mailing Lists</a><br />
+ <a href="https://cwiki.apache.org/CLOUDSTACK/draft-cloudstack-community-events-plan.html">Community Events Plan</a><br />
+ <h1>Development</h1>
+ <!-- <a href="/cloudstack/develop/getting-started.html">Getting Started</a><br /> -->
+ <a href="/cloudstack/develop/environment.html">Setting Up an Apache CloudStack Development Environment</a><br />
+ <a href="/cloudstack/develop/non-contributors.html">Contributing for Non-Committers</a><br />
+ <a href="/cloudstack/develop/developer-faq.html">Developer's FAQ</a><br />
+ <a href="/cloudstack/develop/coding-conventions.html">Coding Conventions</a><br />
+ <!-- <a href="/cloudstack/develop/cloudstack-easy-tasks.html">Easy Bugs/Tasks</a><br /> -->
+ <h1>Documentation</h1>
+ <a href="http://docs.cloudstack.org/">CloudStack Documentation</a><br />
+ <a href="http://cwiki.apache.org/confluence/display/CLOUDSTACK/Index">Apache CloudStack Wiki</a><br />
+ <h1>Apache Software Foundation (ASF)</h1>
+ <a href="http://www.apache.org/">Apache Software Foundation</a><br />
+ <a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a><br />
+ <a href="http://www.apache.org/security/">Security</a><br />
+ <img alt="Apache Incubator" src="http://incubator.apache.org/images/egg-logo.png" width="165"/>
+ </div>
+
+ <div id="content">
+ <h2 id="apache-cloudstack-site-alpha-august-20-2012">Apache CloudStack Site Alpha (August 20, 2012)</h2>
+<p>You're looking at the second draft of the Apache CloudStack site, using the <a href="http://www.apache.org/dev/cms.html">Apache CMS</a> with CSS borrowed heavily from the <a href="http://incubator.apache.org/wookie/">Wookie Project</a> site. Unless noted otherwise, all content on this site is licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</a>.</p>
+<h2 id="release-date-pushed-back-august-19-2012">Release Date Pushed Back (August 19, 2012)</h2>
+<p>Based on discussion on the <a href="http://markmail.org/thread/xk5d6aafiioadgb5">cloudstack-dev</a> list, the tentative release date for Apache CloudStack (incubating) 4.0 will be pushed back to about September 26th. This is to include additional time for testing and resolving some of the licensing issues. </p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>Copyright © 2012 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+ <p>Apache and the Apache feather logos are trademarks of The Apache Software Foundation. </p>
+ </div>
+ </div>
+</body>
+</html>