docs/en-US/configure-package-repository.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.
-->

<section id="configure-package-repository">
    <title>Configure package repository</title>
    <para>&PRODUCT; is only distributed from source from the official mirrors. 
        However, members of the CloudStack community may build convenience binaries
        so that users can install Apache CloudStack without needing to build from 
        source.
    </para>
    <para>
        If you didn't follow the steps to build your own packages from source 
        in the sections for <xref linkend="sect-source-buildrpm" /> or
        <xref linkend="sect-source-builddebs" /> you may find pre-built
        DEB and RPM packages for your convience linked from the 
        <ulink url="http://incubator.apache.org/cloudstack/downloads.html">downloads</ulink>
        page.
    </para>
    <note>
        <para>These repositories contain both the Management Server and KVM Hypervisor packages.</para>
    </note>
    <section id="configure-package-repository-deb">
        <title>DEB package repository</title>
        <para>You can add a DEB package repository to your apt sources with the following commands. Please note that only packages for Ubuntu 12.04 LTS (precise) are being built at this time.</para>
        <para>Use your preferred editor and open (or create) <filename>/etc/apt/sources.list.d/cloudstack.list</filename>. Add the community provided repository to the file:</para>
<programlisting>deb http://cloudstack.apt-get.eu/ubuntu precise 4.0</programlisting>
        <para>We now have to add the public key to the trusted keys.</para>
        <programlisting language="Bash"><prompt>$</prompt> <command>wget</command> -O - http://cloudstack.apt-get.eu/release.asc|apt-key add -</programlisting>
        <para>Now update your local apt cache.</para>
        <programlisting language="Bash"><prompt>$</prompt> <command>apt-get</command> update</programlisting>
        <para>Your DEB package repository should now be configured and ready for use.</para>
    </section>
    <section id="configure-package-repository-rpm">
        <title>RPM package repository</title>
        <para>There is a RPM package repository for &PRODUCT; so you can easily install on RHEL based platforms.</para>
        <para>If you're using an RPM-based system, you'll want to add the Yum repository so that you can install &PRODUCT; with Yum.</para>
        <para>Yum repository information is found under <filename>/etc/yum.repos.d</filename>. You'll see several <filename>.repo</filename> files in this directory, each one denoting a specific repository.</para>
        <para>To add the &PRODUCT; repository, create <filename>/etc/yum.repos.d/cloudstack.repo</filename> and insert the following information.</para>
        <programlisting>
[cloudstack]
name=cloudstack
baseurl=<replaceable>http://cloudstack.apt-get.eu/rhel/4.0/</replaceable>
enabled=1
gpgcheck=0
        </programlisting>
        <para>Now you should be able to install CloudStack using Yum.</para>
    </section>
</section>