docs/en-US/source.xml

<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
%BOOK_ENTITIES;
]>

<!-- 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.
-->

<chapter id="sect-source">
    <title>Building from Source</title>
    <para>The official &PRODUCT; release is always in source code form. You will likely be able to find "convenience binaries," the source is the canonical release. In this section, we'll cover acquiring the source release and building that so that you can deploy it using Maven or create Debian packages or RPMs.</para>
    <para>Note that building and deploying directly from source is typically not the most efficient way to deploy an IaaS. However, we will cover that method as well as building RPMs or Debian packages for deploying &PRODUCT;.</para>
    <para>The instructions here are likely version-specific. That is, the method for building from source for the 4.0.x series is different from the 4.1.x series.</para>
    <para>If you are working with a unreleased version of &PRODUCT;, see the INSTALL.md file in the top-level directory of the release.</para>
    <xi:include href="getting-release.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 
    <xi:include href="verifying-source.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="source-prereqs.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="extracting-source.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="build-deb.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
    <xi:include href="build-rpm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />  
    <xi:include href="build-nonoss.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />  
</chapter>