You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cloudstack.apache.org by David Nalley <da...@gnsa.us> on 2012/10/17 22:21:41 UTC
Re: [2/2] git commit: Docs: Add the sections on building from code to
the Install Guide. The files were contributed, but never included in the
book. This caused a build error as well as missing information.
http://jenkins.cloudstack.org/view/master/job/build-docs-install-master/143/
This broke the install guide build.
On Wed, Oct 17, 2012 at 3:47 PM, <jt...@apache.org> wrote:
> Docs: Add the sections on building from code to the Install Guide. The files were contributed, but never included in the book. This caused a build error as well as missing information.
>
>
> Project: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/repo
> Commit: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/commit/c8e90158
> Tree: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/c8e90158
> Diff: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/c8e90158
>
> Branch: refs/heads/master
> Commit: c8e90158a08beba9b4f54c1acb38ff3f93914abf
> Parents: 78cf3b2
> Author: Jessica Tomechak <je...@gmail.com>
> Authored: Wed Oct 17 12:39:30 2012 -0700
> Committer: Jessica Tomechak <je...@gmail.com>
> Committed: Wed Oct 17 12:46:32 2012 -0700
>
> ----------------------------------------------------------------------
> docs/en-US/build-packages.xml | 31 ++++++++++++++++++++
> docs/en-US/configure-package-repository.xml | 22 ++++++-------
> docs/en-US/management-server-install-flow.xml | 1 +
> 3 files changed, 42 insertions(+), 12 deletions(-)
> ----------------------------------------------------------------------
>
>
> http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c8e90158/docs/en-US/build-packages.xml
> ----------------------------------------------------------------------
> diff --git a/docs/en-US/build-packages.xml b/docs/en-US/build-packages.xml
> new file mode 100644
> index 0000000..0e09267
> --- /dev/null
> +++ b/docs/en-US/build-packages.xml
> @@ -0,0 +1,31 @@
> +<?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="build-packages">
> + <title>Build Software Packages from Code</title>
> + <para>Follow these steps to build your own packages from source. Alternatively, you can find a pre-built package
> + provided by a third party and use the steps in <xref linkend="configure-package-repository"/>.</para>
> + <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"/>
> +</section>
>
> http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c8e90158/docs/en-US/configure-package-repository.xml
> ----------------------------------------------------------------------
> diff --git a/docs/en-US/configure-package-repository.xml b/docs/en-US/configure-package-repository.xml
> index 4907ce0..eee1b6f 100644
> --- a/docs/en-US/configure-package-repository.xml
> +++ b/docs/en-US/configure-package-repository.xml
> @@ -23,23 +23,21 @@
> -->
>
> <section id="configure-package-repository">
> - <title>Configure package repository</title>
> - <para>&PRODUCT; is only distributed from source from the official mirrors.
> - 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 can find pre-build
> - DEB and RPM packages for your convience by third-parties.
> - </para>
> - <para>
> - When installing &PRODUCT; it is recommended you use these package
> - repositories for easy installation.
> - </para>
> + <title>Configure the Package Repository</title>
> + <para>&PRODUCT; is only distributed from source from the official mirrors. 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 can find
> + pre-built DEB and RPM packages provided for your convience by third parties. </para>
> + <para>When installing &PRODUCT; it is recommended you use these package repositories for easy
> + installation. </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 currently only packages for Ubuntu 12.04 (precise) are being build.</para>
> + <para>You can add a DEB package repository to your apt sources with the following commands.
> + Please note that currently only packages for Ubuntu 12.04 (precise) are being
> + built.</para>
> <programlisting language="Bash">echo "deb http://cloudstack.apt-get.eu/ubuntu $(lsb_release -s -c) 4.0" > /etc/apt/sources.list.d/cloudstack.list</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>
>
> http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c8e90158/docs/en-US/management-server-install-flow.xml
> ----------------------------------------------------------------------
> diff --git a/docs/en-US/management-server-install-flow.xml b/docs/en-US/management-server-install-flow.xml
> index 33bcac9..5d9d663 100644
> --- a/docs/en-US/management-server-install-flow.xml
> +++ b/docs/en-US/management-server-install-flow.xml
> @@ -26,6 +26,7 @@
> <title>Management Server Installation</title>
> <xi:include href="management-server-install-overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
> <xi:include href="management-server-install-prepare-os.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
> + <xi:include href="build-packages.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
> <xi:include href="management-server-install-client.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
> <xi:include href="management-server-install-db.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
> <xi:include href="management-server-install-nfs-shares.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
>
RE: [2/2] git commit: Docs: Add the sections on building from code
to the Install Guide. The files were contributed, but never included in the
book. This caused a build error as well as missing information.
Posted by Jessica Tomechak <Je...@citrix.com>.
Maybe somebody else fixed it at the same time as me. I suppose it's time for me to learn how to revert a commit? :)
Jessica T.
CloudStack Tech Pubs
-----Original Message-----
From: David Nalley [mailto:david@gnsa.us]
Sent: Wednesday, October 17, 2012 1:40 PM
To: Jessica Tomechak
Cc: cloudstack-dev@incubator.apache.org
Subject: Re: [2/2] git commit: Docs: Add the sections on building from code to the Install Guide. The files were contributed, but never included in the book. This caused a build error as well as missing information.
On Wed, Oct 17, 2012 at 4:34 PM, Jessica Tomechak <Je...@citrix.com> wrote:
> Actually it was to fix the build...it worked for me locally. Before, the error was something like "can't find sect-source-buildrpm" and now it's "sect-source-buildrpm already defined." I'll check into it.
The build 5 minutes before the failure succeeded without issue.
http://jenkins.cloudstack.org/view/master/job/build-docs-install-master/142/
--David
Re: [2/2] git commit: Docs: Add the sections on building from code to
the Install Guide. The files were contributed, but never included in the
book. This caused a build error as well as missing information.
Posted by David Nalley <da...@gnsa.us>.
On Wed, Oct 17, 2012 at 4:34 PM, Jessica Tomechak
<Je...@citrix.com> wrote:
> Actually it was to fix the build...it worked for me locally. Before, the error was something like "can't find sect-source-buildrpm" and now it's "sect-source-buildrpm already defined." I'll check into it.
The build 5 minutes before the failure succeeded without issue.
http://jenkins.cloudstack.org/view/master/job/build-docs-install-master/142/
--David
RE: [2/2] git commit: Docs: Add the sections on building from code
to the Install Guide. The files were contributed, but never included in the
book. This caused a build error as well as missing information.
Posted by Jessica Tomechak <Je...@citrix.com>.
Actually it was to fix the build...it worked for me locally. Before, the error was something like "can't find sect-source-buildrpm" and now it's "sect-source-buildrpm already defined." I'll check into it.
Jessica T.
CloudStack Tech Pubs
-----Original Message-----
From: David Nalley [mailto:david@gnsa.us]
Sent: Wednesday, October 17, 2012 1:22 PM
To: cloudstack-dev@incubator.apache.org
Cc: Jessica Tomechak
Subject: Re: [2/2] git commit: Docs: Add the sections on building from code to the Install Guide. The files were contributed, but never included in the book. This caused a build error as well as missing information.
http://jenkins.cloudstack.org/view/master/job/build-docs-install-master/143/
This broke the install guide build.
On Wed, Oct 17, 2012 at 3:47 PM, <jt...@apache.org> wrote:
> Docs: Add the sections on building from code to the Install Guide. The files were contributed, but never included in the book. This caused a build error as well as missing information.
>
>
> Project:
> http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/repo
> Commit:
> http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/commit/c8e
> 90158
> Tree:
> http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/c8e90
> 158
> Diff:
> http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/c8e90
> 158
>
> Branch: refs/heads/master
> Commit: c8e90158a08beba9b4f54c1acb38ff3f93914abf
> Parents: 78cf3b2
> Author: Jessica Tomechak <je...@gmail.com>
> Authored: Wed Oct 17 12:39:30 2012 -0700
> Committer: Jessica Tomechak <je...@gmail.com>
> Committed: Wed Oct 17 12:46:32 2012 -0700
>
> ----------------------------------------------------------------------
> docs/en-US/build-packages.xml | 31 ++++++++++++++++++++
> docs/en-US/configure-package-repository.xml | 22 ++++++-------
> docs/en-US/management-server-install-flow.xml | 1 +
> 3 files changed, 42 insertions(+), 12 deletions(-)
> ----------------------------------------------------------------------
>
>
> http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c8e90
> 158/docs/en-US/build-packages.xml
> ----------------------------------------------------------------------
> diff --git a/docs/en-US/build-packages.xml
> b/docs/en-US/build-packages.xml new file mode 100644 index
> 0000000..0e09267
> --- /dev/null
> +++ b/docs/en-US/build-packages.xml
> @@ -0,0 +1,31 @@
> +<?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="build-packages">
> + <title>Build Software Packages from Code</title>
> + <para>Follow these steps to build your own packages from source. Alternatively, you can find a pre-built package
> + provided by a third party and use the steps in <xref linkend="configure-package-repository"/>.</para>
> + <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"/>
> +</section>
>
> http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c8e90
> 158/docs/en-US/configure-package-repository.xml
> ----------------------------------------------------------------------
> diff --git a/docs/en-US/configure-package-repository.xml
> b/docs/en-US/configure-package-repository.xml
> index 4907ce0..eee1b6f 100644
> --- a/docs/en-US/configure-package-repository.xml
> +++ b/docs/en-US/configure-package-repository.xml
> @@ -23,23 +23,21 @@
> -->
>
> <section id="configure-package-repository">
> - <title>Configure package repository</title>
> - <para>&PRODUCT; is only distributed from source from the official mirrors.
> - 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 can find pre-build
> - DEB and RPM packages for your convience by third-parties.
> - </para>
> - <para>
> - When installing &PRODUCT; it is recommended you use these package
> - repositories for easy installation.
> - </para>
> + <title>Configure the Package Repository</title>
> + <para>&PRODUCT; is only distributed from source from the official mirrors. 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 can find
> + pre-built DEB and RPM packages provided for your convience by third parties. </para>
> + <para>When installing &PRODUCT; it is recommended you use these package repositories for easy
> + installation. </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 currently only packages for Ubuntu 12.04 (precise) are being build.</para>
> + <para>You can add a DEB package repository to your apt sources with the following commands.
> + Please note that currently only packages for Ubuntu 12.04 (precise) are being
> + built.</para>
> <programlisting language="Bash">echo "deb http://cloudstack.apt-get.eu/ubuntu $(lsb_release -s -c) 4.0" > /etc/apt/sources.list.d/cloudstack.list</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>
>
> http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/c8e90
> 158/docs/en-US/management-server-install-flow.xml
> ----------------------------------------------------------------------
> diff --git a/docs/en-US/management-server-install-flow.xml
> b/docs/en-US/management-server-install-flow.xml
> index 33bcac9..5d9d663 100644
> --- a/docs/en-US/management-server-install-flow.xml
> +++ b/docs/en-US/management-server-install-flow.xml
> @@ -26,6 +26,7 @@
> <title>Management Server Installation</title>
> <xi:include href="management-server-install-overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
> <xi:include href="management-server-install-prepare-os.xml"
> xmlns:xi="http://www.w3.org/2001/XInclude" />
> + <xi:include href="build-packages.xml"
> + xmlns:xi="http://www.w3.org/2001/XInclude" />
> <xi:include href="management-server-install-client.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
> <xi:include href="management-server-install-db.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
> <xi:include href="management-server-install-nfs-shares.xml"
> xmlns:xi="http://www.w3.org/2001/XInclude" />
>