Menu
▾
▴
[Oorexx-svn] SF.net SVN: oorexx-code-0:[8325] docs/trunk/publican
|
From: <wda...@us...> - 2012-08-30 20:00:59
|
Revision: 8325
http://sourceforge.net/p/oorexx/code-0/8325
Author: wdashley
Date: 2012-08-30 20:00:56 +0000 (Thu, 30 Aug 2012)
Log Message:
-----------
Add buildmachine to docs/trunk/ Conversion to Publican complete.
Added Paths:
-----------
docs/trunk/publican/buildmachine/
docs/trunk/publican/buildmachine/Makefile
docs/trunk/publican/buildmachine/en-US/
docs/trunk/publican/buildmachine/en-US/Author_Group.xml
docs/trunk/publican/buildmachine/en-US/Book_Info.xml
docs/trunk/publican/buildmachine/en-US/Preface.xml
docs/trunk/publican/buildmachine/en-US/Revision_History.xml
docs/trunk/publican/buildmachine/en-US/admin.xml
docs/trunk/publican/buildmachine/en-US/guestos.xml
docs/trunk/publican/buildmachine/en-US/kvm.xml
docs/trunk/publican/buildmachine/en-US/ooRexxBuild.ent
docs/trunk/publican/buildmachine/en-US/ooRexxBuild.xml
docs/trunk/publican/buildmachine/en-US/releases.xml
docs/trunk/publican/buildmachine/publican.cfg
Added: docs/trunk/publican/buildmachine/Makefile
===================================================================
--- docs/trunk/publican/buildmachine/Makefile (rev 0)
+++ docs/trunk/publican/buildmachine/Makefile 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,61 @@
+#----------------------------------------------------------------------------
+#
+# Description: Makefile for the ooRexx Build Machine Document
+#
+# Copyright (c) 2005-2012, Rexx Language Association. All rights reserved.
+#
+# This program and the accompanying materials are made available under
+# the terms of the Common Public License v1.0 which accompanies this
+# distribution. A copy is also available at the following address:
+# http://www.oorexx.org/license.html
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+# Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+# Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in
+# the documentation and/or other materials provided with the distribution.
+#
+# Neither the name of Rexx Language Association nor the names
+# of its contributors may be used to endorse or promote products
+# derived from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+# OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+# OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+#----------------------------------------------------------------------------
+
+
+PRODUCT = ooRexxBuild
+
+
+all: pdf html
+
+pdf:
+ - rm -r tmp/en-US/pdf
+ publican build --formats=pdf --langs=en-US
+ cd tmp/en-US/pdf; mv ooRexx*.pdf $(PRODUCT).pdf; cd ../../..
+
+html:
+ - rm -r tmp/en-US/html
+ publican build --formats=html --langs=en-US
+ cd tmp/en-US/html; zip -r $(PRODUCT)-html.zip *; cd ../../..
+
+
+
+
+clean:
+ rm -f tmp
+
Added: docs/trunk/publican/buildmachine/en-US/Author_Group.xml
===================================================================
--- docs/trunk/publican/buildmachine/en-US/Author_Group.xml (rev 0)
+++ docs/trunk/publican/buildmachine/en-US/Author_Group.xml 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,52 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ooRexxBuild.ent">
+%BOOK_ENTITIES;
+]>
+<!--#########################################################################
+ #
+ # Description: Open Object Rexx: Build Machine Document XML File
+ #
+ # Copyright (c) 2005-2012, Rexx Language Association. All rights reserved.
+ # Portions Copyright (c) 2004, IBM Corporation. All rights reserved.
+ #
+ # This program and the accompanying materials are made available under
+ # the terms of the Common Public License v1.0 which accompanies this
+ # distribution. A copy is also available at the following address:
+ # http://www.oorexx.org/license.html
+ #
+ # Redistribution and use in source and binary forms, with or
+ # without modification, are permitted provided that the following
+ # conditions are met:
+ #
+ # Redistributions of source code must retain the above copyright
+ # notice, this list of conditions and the following disclaimer.
+ # Redistributions in binary form must reproduce the above copyright
+ # notice, this list of conditions and the following disclaimer in
+ # the documentation and/or other materials provided with the distribution.
+ #
+ # Neither the name of Rexx Language Association nor the names
+ # of its contributors may be used to endorse or promote products
+ # derived from this software without specific prior written permission.
+ #
+ # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+ # TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+ # OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ #
+ #########################################################################
+-->
+<authorgroup>
+ <author>
+ <firstname>W. David</firstname>
+ <surname>Ashley</surname>
+ </author>
+</authorgroup>
+
Property changes on: docs/trunk/publican/buildmachine/en-US/Author_Group.xml
___________________________________________________________________
Added: svn:mime-type
+ text/
Added: svn:eol-style
+ native
Added: docs/trunk/publican/buildmachine/en-US/Book_Info.xml
===================================================================
--- docs/trunk/publican/buildmachine/en-US/Book_Info.xml (rev 0)
+++ docs/trunk/publican/buildmachine/en-US/Book_Info.xml 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,63 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ooRexxBuild.ent">
+%BOOK_ENTITIES;
+]>
+<!--#########################################################################
+ #
+ # Description: Open Object Rexx: Build Machine Document XML File
+ #
+ # Copyright (c) 2005-2012, Rexx Language Association. All rights reserved.
+ # Portions Copyright (c) 2004, IBM Corporation. All rights reserved.
+ #
+ # This program and the accompanying materials are made available under
+ # the terms of the Common Public License v1.0 which accompanies this
+ # distribution. A copy is also available at the following address:
+ # http://www.oorexx.org/license.html
+ #
+ # Redistribution and use in source and binary forms, with or
+ # without modification, are permitted provided that the following
+ # conditions are met:
+ #
+ # Redistributions of source code must retain the above copyright
+ # notice, this list of conditions and the following disclaimer.
+ # Redistributions in binary form must reproduce the above copyright
+ # notice, this list of conditions and the following disclaimer in
+ # the documentation and/or other materials provided with the distribution.
+ #
+ # Neither the name of Rexx Language Association nor the names
+ # of its contributors may be used to endorse or promote products
+ # derived from this software without specific prior written permission.
+ #
+ # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+ # TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+ # OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ #
+ #########################################################################
+-->
+<bookinfo id="book-rxsock-rxsock">
+ <title>Open Object Rexx™</title>
+ <subtitle>ooRexx Build Machine</subtitle>
+ <productname>ooRexx Documentation</productname>
+ <productnumber>&VERSION;</productnumber>
+ <edition>&EDITION;</edition>
+ <pubsnumber>0</pubsnumber>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="Common_Content/images/oorexx.jpg" align="center" role="cover" />
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</bookinfo>
+
Property changes on: docs/trunk/publican/buildmachine/en-US/Book_Info.xml
___________________________________________________________________
Added: svn:mime-type
+ text/
Added: svn:eol-style
+ native
Added: docs/trunk/publican/buildmachine/en-US/Preface.xml
===================================================================
--- docs/trunk/publican/buildmachine/en-US/Preface.xml (rev 0)
+++ docs/trunk/publican/buildmachine/en-US/Preface.xml 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,186 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ooRexxBuild.ent">
+%BOOK_ENTITIES;
+]>
+<!--#########################################################################
+ #
+ # Description: Open Object Rexx: Build Machine Document XML File
+ #
+ # Copyright (c) 2005-2012, Rexx Language Association. All rights reserved.
+ # Portions Copyright (c) 2004, IBM Corporation. All rights reserved.
+ #
+ # This program and the accompanying materials are made available under
+ # the terms of the Common Public License v1.0 which accompanies this
+ # distribution. A copy is also available at the following address:
+ # http://www.oorexx.org/license.html
+ #
+ # Redistribution and use in source and binary forms, with or
+ # without modification, are permitted provided that the following
+ # conditions are met:
+ #
+ # Redistributions of source code must retain the above copyright
+ # notice, this list of conditions and the following disclaimer.
+ # Redistributions in binary form must reproduce the above copyright
+ # notice, this list of conditions and the following disclaimer in
+ # the documentation and/or other materials provided with the distribution.
+ #
+ # Neither the name of Rexx Language Association nor the names
+ # of its contributors may be used to endorse or promote products
+ # derived from this software without specific prior written permission.
+ #
+ # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+ # TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+ # OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ #
+ #########################################################################
+-->
+<preface id="pref-rxsock-Preface">
+<title>Preface</title>
+
+<para>This book describes the Open Object Rexx release build machine
+environment.</para>
+<para>This book is intended to document the release and build environment for
+ooRexx. It is a complete description of the build machine environment as well
+as a user guide to building ooRexx releases using the build machine.</para>
+
+
+<xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+<section id="helpGettingHelp"><title>Getting Help and Submitting Feedback</title>
+<para>The Open Object Rexx Project has a number of methods to obtain help and submit feedback for ooRexx and the
+extension packages that are part of ooRexx. These methods, in no particular order of preference, are listed
+below.</para>
+
+<section><title>The Open Object Rexx SourceForge Site</title>
+<para>The <ulink url="http://www.oorexx.org/">Open Object Rexx Project</ulink> utilizes
+<ulink url="http://sourceforge.net/"><citetitle>SourceForge</citetitle></ulink>
+to house the
+<ulink url="http://sourceforge.net/projects/oorexx"><citetitle>ooRexx Project</citetitle></ulink>
+source repositories, mailing lists and other
+project features. Over time it has become apparent that the Developer and User mailing lists are better tools for
+carrying on discussions concerning ooRexx and that the Forums provided by SourceForge are cumbersome to use. The ooRexx
+user is most likely to get timely replies from one of the mailing lists.
+</para>
+<para>
+ Here is a list of some of the most useful facilities provided by SourceForge.
+</para>
+<variablelist>
+<varlistentry id="helpDevelList"><term>The Developer Mailing List</term>
+<listitem><para>You can subscribe to the oorexx-devel mailing list at
+<ulink url="http://sourceforge.net/mail/?group_id=119701">
+<citetitle>ooRexx Mailing List Subscriptions</citetitle></ulink> page.
+This list is for discussing ooRexx project development activities and future
+interpreter enhancements. It also supports a historical archive of past
+messages.
+</para></listitem>
+</varlistentry>
+<varlistentry id="helpUsersList"><term>The Users Mailing List</term>
+<listitem><para>You can subscribe to the oorexx-users mailing list at
+<ulink url="http://sourceforge.net/mail/?group_id=119701">
+<citetitle>ooRexx Mailing List Subscriptions</citetitle></ulink> page.
+This list is for discussing using ooRexx.
+It also supports a historical archive of past messages.</para></listitem>
+</varlistentry>
+<varlistentry><term>The Announcements Mailing List</term>
+<listitem><para>You can subscribe to the oorexx-announce mailing list at
+<ulink url="http://sourceforge.net/mail/?group_id=119701">
+<citetitle>ooRexx Mailing List Subscriptions</citetitle></ulink> page.
+This list is only used to
+announce significant ooRexx project events.</para></listitem>
+</varlistentry>
+<varlistentry><term>The Bug Mailing List</term>
+<listitem><para>You can subscribe to the oorexx-bugs mailing list at
+<ulink url="http://sourceforge.net/mail/?group_id=119701">
+<citetitle>ooRexx Mailing List Subscriptions</citetitle></ulink> page.
+This list is only used for
+monitoring changes to the ooRexx bug tracking system.</para></listitem>
+</varlistentry>
+<varlistentry><term>Bug Reports</term>
+<listitem><para>You can create a bug report at
+<ulink url="http://sourceforge.net/tracker/?group_id=119701&atid=684730">
+<citetitle>ooRexx Bug Report</citetitle></ulink> page.
+Please try to provide as much information in the bug report
+as possible so that the developers can determine the problem as quickly as
+possible. Sample programs that can reproduce your problem will make it easier to
+debug reported problems.
+</para></listitem>
+</varlistentry>
+<varlistentry><term>Documentation Feedback</term>
+<listitem><para>You can submit feedback for, or report errors in, the documentation at
+<ulink url="http://sourceforge.net/tracker/?group_id=119701&atid=1001880">
+<citetitle>ooRexx Documentation Report</citetitle></ulink> page.
+Please try to provide as much information in a documentation report as possible. In addition
+to listing the document and section the report concerns, direct quotes of the text will help the
+developers locate the text in the source code for the document. (Section numbers are generated
+when the document is produced and are not available in the source code itself.) Suggestions as
+to how to reword or fix the existing text should also be included.
+</para></listitem>
+</varlistentry>
+<varlistentry><term>Request For Enhancement</term>
+<listitem><para>You can suggest ooRexx features at the
+<ulink url="http://sourceforge.net/tracker/?group_id=119701&atid=684733">
+<citetitle>ooRexx Feature Requests</citetitle></ulink> page.
+</para></listitem>
+</varlistentry>
+<varlistentry><term>Patch Reports</term>
+<listitem><para>If you create an enhancement patch for ooRexx please
+post the patch using the
+<ulink url="http://sourceforge.net/tracker/?group_id=119701&atid=684732">
+<citetitle>ooRexx Patch Report</citetitle></ulink> page.
+Please provide as much information in the patch report
+as possible so that the developers can evaluate the enhancement
+as quickly as possible.</para>
+<para>Please do not post bug fix patches here, instead you should open a bug report
+and attach the patch to it.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>The ooRexx Forums</term>
+<listitem><para>The ooRexx project maintains a set of forums that anyone
+may contribute to or monitor. They are located on the
+<ulink url="http://sourceforge.net/forum/?group_id=119701">
+<citetitle>ooRexx Forums</citetitle></ulink> page.
+There are currently three forums available: Help, Developers and Open
+Discussion. In addition, you can monitor the forums via email.
+</para></listitem>
+</varlistentry>
+</variablelist>
+</section>
+
+<section><title>The Rexx Language Association Mailing List</title>
+<para>The <ulink url="http://www.rexxla.org/"><citetitle>Rexx Language Association</citetitle></ulink>
+maintains a mailing list for its members.
+This mailing list is only available to RexxLA members thus you will need to
+join RexxLA in order to get on the list. The dues for RexxLA membership are
+small and are charged on a yearly basis. For details on joining RexxLA please
+refer to the
+<ulink url="http://rexxla.org/"><citetitle>RexxLA Home Page</citetitle></ulink>
+or the
+<ulink url="http://www.rexxla.org/rexxla/join.html">
+<citetitle>RexxLA Membership Application</citetitle></ulink> page.</para>
+</section>
+
+<section><title>comp.lang.rexx Newsgroup</title>
+<para>The <ulink url="http://groups.google.com/group/comp.lang.rexx/topics?hl=en">comp.lang.rexx</ulink> newsgroup
+is a good place to obtain help from many
+individuals within the Rexx community. You can obtain help on Open Object
+Rexx or on any number of other Rexx interpreters and tools.</para>
+</section>
+
+</section>
+
+<section id="relinf"><title>Related Information</title>
+<para>See also:
+<citetitle pubwork="book">Open Object Rexx: Reference</citetitle></para>
+</section>
+
+</preface>
+
Property changes on: docs/trunk/publican/buildmachine/en-US/Preface.xml
___________________________________________________________________
Added: svn:mime-type
+ text/
Added: svn:eol-style
+ native
Added: docs/trunk/publican/buildmachine/en-US/Revision_History.xml
===================================================================
--- docs/trunk/publican/buildmachine/en-US/Revision_History.xml (rev 0)
+++ docs/trunk/publican/buildmachine/en-US/Revision_History.xml 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,66 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ooRexxBuild.ent">
+%BOOK_ENTITIES;
+]>
+<!--#########################################################################
+ #
+ # Description: Open Object Rexx: Build Machine Document XML File
+ #
+ # Copyright (c) 2005-2012, Rexx Language Association. All rights reserved.
+ # Portions Copyright (c) 2004, IBM Corporation. All rights reserved.
+ #
+ # This program and the accompanying materials are made available under
+ # the terms of the Common Public License v1.0 which accompanies this
+ # distribution. A copy is also available at the following address:
+ # http://www.oorexx.org/license.html
+ #
+ # Redistribution and use in source and binary forms, with or
+ # without modification, are permitted provided that the following
+ # conditions are met:
+ #
+ # Redistributions of source code must retain the above copyright
+ # notice, this list of conditions and the following disclaimer.
+ # Redistributions in binary form must reproduce the above copyright
+ # notice, this list of conditions and the following disclaimer in
+ # the documentation and/or other materials provided with the distribution.
+ #
+ # Neither the name of Rexx Language Association nor the names
+ # of its contributors may be used to endorse or promote products
+ # derived from this software without specific prior written permission.
+ #
+ # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+ # TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+ # OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ #
+ #########################################################################
+-->
+<appendix id="appe-rxsock-Revision_History">
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>0-0</revnumber>
+ <date>Tue Aug 7 2012</date>
+ <author>
+ <firstname>David</firstname>
+ <surname>Ashley</surname>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Initial creation of book by publican</member>
+ </simplelist>
+ </revdescription>
+ </revision>
+ </revhistory>
+ </simpara>
+</appendix>
+
Property changes on: docs/trunk/publican/buildmachine/en-US/Revision_History.xml
___________________________________________________________________
Added: svn:mime-type
+ text/
Added: svn:eol-style
+ native
Added: docs/trunk/publican/buildmachine/en-US/admin.xml
===================================================================
--- docs/trunk/publican/buildmachine/en-US/admin.xml (rev 0)
+++ docs/trunk/publican/buildmachine/en-US/admin.xml 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,51 @@
+<?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 "ooRexxBuild.ent">
+%BOOK_ENTITIES;
+]>
+<!--#########################################################################
+ #
+ # Description: Open Object Rexx: Build Machine Document XML File
+ #
+ # Copyright (c) 2005-2012, Rexx Language Association. All rights reserved.
+ # Portions Copyright (c) 2004, IBM Corporation. All rights reserved.
+ #
+ # This program and the accompanying materials are made available under
+ # the terms of the Common Public License v1.0 which accompanies this
+ # distribution. A copy is also available at the following address:
+ # http://www.oorexx.org/license.html
+ #
+ # Redistribution and use in source and binary forms, with or
+ # without modification, are permitted provided that the following
+ # conditions are met:
+ #
+ # Redistributions of source code must retain the above copyright
+ # notice, this list of conditions and the following disclaimer.
+ # Redistributions in binary form must reproduce the above copyright
+ # notice, this list of conditions and the following disclaimer in
+ # the documentation and/or other materials provided with the distribution.
+ #
+ # Neither the name of Rexx Language Association nor the names
+ # of its contributors may be used to endorse or promote products
+ # derived from this software without specific prior written permission.
+ #
+ # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+ # TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+ # OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ #
+ #########################################################################
+-->
+<chapter><title>Build Machine Administration</title>
+
+<para>
+ No content yet.
+</para>
+</chapter>
Property changes on: docs/trunk/publican/buildmachine/en-US/admin.xml
___________________________________________________________________
Added: svn:mime-type
+ text/
Added: svn:eol-style
+ native
Added: docs/trunk/publican/buildmachine/en-US/guestos.xml
===================================================================
--- docs/trunk/publican/buildmachine/en-US/guestos.xml (rev 0)
+++ docs/trunk/publican/buildmachine/en-US/guestos.xml 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,254 @@
+<?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 "ooRexxBuild.ent">
+%BOOK_ENTITIES;
+]>
+<!--#########################################################################
+ #
+ # Description: Open Object Rexx: Build Machine Document XML File
+ #
+ # Copyright (c) 2005-2012, Rexx Language Association. All rights reserved.
+ # Portions Copyright (c) 2004, IBM Corporation. All rights reserved.
+ #
+ # This program and the accompanying materials are made available under
+ # the terms of the Common Public License v1.0 which accompanies this
+ # distribution. A copy is also available at the following address:
+ # http://www.oorexx.org/license.html
+ #
+ # Redistribution and use in source and binary forms, with or
+ # without modification, are permitted provided that the following
+ # conditions are met:
+ #
+ # Redistributions of source code must retain the above copyright
+ # notice, this list of conditions and the following disclaimer.
+ # Redistributions in binary form must reproduce the above copyright
+ # notice, this list of conditions and the following disclaimer in
+ # the documentation and/or other materials provided with the distribution.
+ #
+ # Neither the name of Rexx Language Association nor the names
+ # of its contributors may be used to endorse or promote products
+ # derived from this software without specific prior written permission.
+ #
+ # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+ # TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+ # OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ #
+ #########################################################################
+-->
+<chapter><title>KVM Guest Operating Systems</title>
+
+<section><title>Windows XP Professional w/SP2</title>
+
+<para>The following are the virtual machine configuration settings for
+Windows XP Professional.
+</para>
+
+<itemizedlist>
+<listitem><para>Typical device settings
+</para></listitem>
+<listitem><para>Guest operating system - Microsoft Windows XP Professional
+</para></listitem>
+<listitem><para>Name - Windows XP Professional
+</para></listitem>
+<listitem><para>Network configuration - Bridged networking
+</para></listitem>
+<listitem><para>Disk size - 10GiB, do not pre-allocate space, use the QCOW2 type
+</para></listitem>
+<listitem><para>Memory - 512MiB
+</para></listitem>
+</itemizedlist>
+
+<para>The following are the settings used during the installation of
+Windows XP Professional.
+</para>
+
+<itemizedlist>
+<listitem><para>Format the disk using NTFS
+</para></listitem>
+<listitem><para>Computer name - ORXWINXP
+</para></listitem>
+<listitem><para>Workgroup - OOREXX
+</para></listitem>
+</itemizedlist>
+
+<para>The following are the post installation steps and settings for
+Windows XP Professional.
+</para>
+
+<itemizedlist>
+<listitem><para>Create the buildorx account and make it an administrator
+</para></listitem>
+<listitem><para>Map drive letter (P:) to host PUBLIC share
+</para></listitem>
+<listitem><para>Install Putty and pscp
+</para></listitem>
+<listitem><para>Install Subversion
+</para></listitem>
+<listitem><para>Install Visual Studio .NET (Visual C++ 7.0)
+</para></listitem>
+<listitem><para>Update the system PATH to point to the Xerces
+shared location (P: drive)
+</para></listitem>
+<listitem><para>Update the system PATH to point to the Xalan
+shared location (P: drive)
+</para></listitem>
+</itemizedlist>
+
+</section>
+
+<section><title>Fedora 17</title>
+
+<para>The following are the virtual machine configuration settings for
+Fedora.
+</para>
+
+<itemizedlist>
+<listitem><para>Typical device settings
+</para></listitem>
+<listitem><para>Guest operating system - Fedora
+</para></listitem>
+<listitem><para>Name - fedora17-i386
+</para></listitem>
+<listitem><para>Network configuration - Bridged networking
+</para></listitem>
+<listitem><para>Disk size - 10GB, do not pre-allocate space, use the QCOW2 type
+</para></listitem>
+<listitem><para>Memory - 512MiB
+</para></listitem>
+</itemizedlist>
+
+<para>The following are the settings used during the installation of
+Fedora.
+</para>
+
+<itemizedlist>
+<listitem><para>Create a standard disk layout
+</para></listitem>
+<listitem><para>Install all the development and Publishing tools
+</para></listitem>
+<listitem><para>Disable the firewall
+</para></listitem>
+<listitem><para>Disable SELinux
+</para></listitem>
+<listitem><para>Create the buildorx account
+</para></listitem>
+</itemizedlist>
+
+<para>The following are the post installation steps and settings for
+Fedora.
+</para>
+
+<itemizedlist>
+<listitem><para>Download and install the Fedora security updates.
+</para></listitem>
+<listitem><para>Next we need to generate the SSH public/private keys for the
+server.</para>
+<programlisting>
+# ssh-keygen
+</programlisting>
+<para>Be sure to just hit return for the passphrase prompt (we do NOT want
+a passphrase). Otherwise we cannot get true automation from our scripts.
+</para>
+<para>Copy the host's public key into our authorized keys file.</para>
+<programlisting>
+# scp bui...@bu...:/home/buildorx/.ssh/id_rsa.pub .ssh/authorized_keys
+</programlisting>
+<para>Now copy our public key to the host.</para>
+<programlisting>
+# scp .ssh/id_rsa.pub bui...@bu...:/home/buildorx/xxx
+</programlisting>
+<para>Now on the host (NOT the KVM guest!) copy that key to the authorized
+keys file.</para>
+<programlisting>
+# cat xxx >> .ssh/authorized_keys
+# rm xxx
+</programlisting>
+</listitem>
+</itemizedlist>
+
+</section>
+
+<section><title>Ubuntu 10.10</title>
+
+<para>The following are the virtual machine configuration settings for
+Ubuntu.
+</para>
+
+<itemizedlist>
+<listitem><para>Typical device settings
+</para></listitem>
+<listitem><para>Guest operating system - Ubuntu
+</para></listitem>
+<listitem><para>Name - ubuntu1010-i386
+</para></listitem>
+<listitem><para>Version - Ubuntu 10.10
+</para></listitem>
+<listitem><para>Network configuration - Bridged networking
+</para></listitem>
+<listitem><para>Disk size - 10GiB, do not pre-allocate space, use the QCOW2 type
+</para></listitem>
+<listitem><para>Memory - 512MiB
+</para></listitem>
+</itemizedlist>
+
+<para>The following are the settings used during the installation of
+Ubuntu.
+</para>
+
+<itemizedlist>
+<listitem><para>Create the buildorx account
+</para></listitem>
+<listitem><para>Create a standard disk layout
+</para></listitem>
+</itemizedlist>
+
+<para>The following are the post installation steps and settings for
+Ubuntu 10.10.
+</para>
+
+<itemizedlist>
+<listitem><para>Download and install the Ubuntu security updates.
+</para></listitem>
+<listitem><para>Next we need to generate the SSH public/private keys for the
+server.</para>
+<programlisting>
+# ssh-keygen
+</programlisting>
+<para>Be sure to just hit return for the passphrase prompt (we do NOT want
+a passphrase). Otherwise we cannot get true automation from our scripts.
+</para>
+<para>Copy the host's public key into our authorized keys file.</para>
+<programlisting>
+# scp bui...@bu...:/home/buildorx/.ssh/id_rsa.pub .ssh/authorized_keys
+</programlisting>
+<para>Now copy our public key to the host.</para>
+<programlisting>
+# scp .ssh/id_rsa.pub bui...@bu...:/home/buildorx/xxx
+</programlisting>
+<para>Now on the host (NOT the VMware guest!) copy that key to the authorized
+keys file.</para>
+<programlisting>
+# cat xxx >> .ssh/authorized_keys
+# rm xxx
+</programlisting>
+</listitem>
+<listitem><para>Use apt-get to install some additional tools.</para>
+<programlisting>
+# sudo apt-get install g++ gcc subversion autoconf automake1.9 debhelper \
+ fakeroot libtool sendmail mailutils bison
+</programlisting>
+</listitem>
+</itemizedlist>
+
+</section>
+
+</chapter>
+
Property changes on: docs/trunk/publican/buildmachine/en-US/guestos.xml
___________________________________________________________________
Added: svn:mime-type
+ text/
Added: svn:eol-style
+ native
Added: docs/trunk/publican/buildmachine/en-US/kvm.xml
===================================================================
--- docs/trunk/publican/buildmachine/en-US/kvm.xml (rev 0)
+++ docs/trunk/publican/buildmachine/en-US/kvm.xml 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,70 @@
+<?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 "ooRexxBuild.ent">
+%BOOK_ENTITIES;
+]>
+<!--#########################################################################
+ #
+ # Description: Open Object Rexx: Build Machine Document XML File
+ #
+ # Copyright (c) 2005-2012, Rexx Language Association. All rights reserved.
+ # Portions Copyright (c) 2004, IBM Corporation. All rights reserved.
+ #
+ # This program and the accompanying materials are made available under
+ # the terms of the Common Public License v1.0 which accompanies this
+ # distribution. A copy is also available at the following address:
+ # http://www.oorexx.org/license.html
+ #
+ # Redistribution and use in source and binary forms, with or
+ # without modification, are permitted provided that the following
+ # conditions are met:
+ #
+ # Redistributions of source code must retain the above copyright
+ # notice, this list of conditions and the following disclaimer.
+ # Redistributions in binary form must reproduce the above copyright
+ # notice, this list of conditions and the following disclaimer in
+ # the documentation and/or other materials provided with the distribution.
+ #
+ # Neither the name of Rexx Language Association nor the names
+ # of its contributors may be used to endorse or promote products
+ # derived from this software without specific prior written permission.
+ #
+ # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+ # TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+ # OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ #
+ #########################################################################
+-->
+<chapter><title>Kernel Virtual Machine Setup Guide</title>
+
+<section><title>KVM Installation</title>
+
+<para>KVM should be installed as an option during the installation of Fedora.
+If you forgot then you can add it later via the Add/Remove Software
+Administrative option.
+</para>
+
+</section>
+
+<section><title>KVM Setup</title>
+
+<para>There are only a few options to be concerned about in this area.
+The most interestting is the ability to specify a different logical
+volumn in which to place the guest OS images. It is usually a good idea
+not to use the default area as space in this area is usually limited.
+We chose to create a special partition (logical volumn) to hold all of our guest OS image
+files so we could better control the available space.
+</para>
+
+</section>
+
+</chapter>
+
Property changes on: docs/trunk/publican/buildmachine/en-US/kvm.xml
___________________________________________________________________
Added: svn:mime-type
+ text/
Added: svn:eol-style
+ native
Added: docs/trunk/publican/buildmachine/en-US/ooRexxBuild.ent
===================================================================
--- docs/trunk/publican/buildmachine/en-US/ooRexxBuild.ent (rev 0)
+++ docs/trunk/publican/buildmachine/en-US/ooRexxBuild.ent 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,6 @@
+<!ENTITY PRODUCT "Documentation">
+<!ENTITY BOOKID "ooRexxBuild">
+<!ENTITY YEAR "2005-2012">
+<!ENTITY HOLDER "Rexx Language Association. All rights reserved.">
+<!ENTITY VERSION "4.2">
+<!ENTITY EDITION "1">
Added: docs/trunk/publican/buildmachine/en-US/ooRexxBuild.xml
===================================================================
--- docs/trunk/publican/buildmachine/en-US/ooRexxBuild.xml (rev 0)
+++ docs/trunk/publican/buildmachine/en-US/ooRexxBuild.xml 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,274 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "ooRexxBuild.ent">
+%BOOK_ENTITIES;
+]>
+<!--#########################################################################
+ #
+ # Description: Open Object Rexx: Build Machine Document XML File
+ #
+ # Copyright (c) 2005-2012, Rexx Language Association. All rights reserved.
+ # Portions Copyright (c) 2004, IBM Corporation. All rights reserved.
+ #
+ # This program and the accompanying materials are made available under
+ # the terms of the Common Public License v1.0 which accompanies this
+ # distribution. A copy is also available at the following address:
+ # http://www.oorexx.org/license.html
+ #
+ # Redistribution and use in source and binary forms, with or
+ # without modification, are permitted provided that the following
+ # conditions are met:
+ #
+ # Redistributions of source code must retain the above copyright
+ # notice, this list of conditions and the following disclaimer.
+ # Redistributions in binary form must reproduce the above copyright
+ # notice, this list of conditions and the following disclaimer in
+ # the documentation and/or other materials provided with the distribution.
+ #
+ # Neither the name of Rexx Language Association nor the names
+ # of its contributors may be used to endorse or promote products
+ # derived from this software without specific prior written permission.
+ #
+ # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+ # TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+ # OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ #
+ #########################################################################
+-->
+<book>
+ <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+
+<chapter><title>Release Build Environment Description</title>
+
+<section><title>Requirements</title>
+
+<para>In early 2007 the Rexx Language Association and the Open Object Rexx
+Development Team determined that it was time to provide a build environment
+for the Open Object Rexx (ooRexx) application. An environment was needed that
+met the following requirements:
+</para>
+
+<itemizedlist>
+<listitem><para>Provide Internet access so that anyone could obtain an up-to-date
+build release of ooRexx.
+</para></listitem>
+<listitem><para>Provide a variety of software build environments for multiple
+operating systems.
+</para></listitem>
+<listitem><para>Provide an automated solution for each supported build
+environment so that a minimum of human interaction is needed to perform a
+build of ooRexx.
+</para></listitem>
+<listitem><para>Make all builds available to the Internet. Only keep 30 days
+of builds available.
+</para></listitem>
+<listitem><para>Support the Subversion (SVN) source repositories.
+</para></listitem>
+</itemizedlist>
+</section>
+
+<section><title>Solution</title>
+
+<para>From these requirements a plan was established to implement them. Several
+decisions were made early on that influenced the final design.
+</para>
+
+<itemizedlist>
+<listitem><para>Rather than purchasing individual servers for each operating
+system to be supported it was determined that a better solution would be to
+purchase one large server and use the Linux kernel Virtual Machine (KVM)
+environment to provide support for multiple operating systems.
+</para></listitem>
+<listitem><para>Since the ooRexx Project is an open source project it was
+determined anyone should be able to get access to a build.
+</para></listitem>
+<listitem><para>It was determined that we should use Fedora Linux to host the
+KVM environment. This would ease security concerns and provide the easiest setup.
+</para></listitem>
+</itemizedlist>
+</section>
+</chapter>
+
+<chapter><title>Build Machine Functional Description</title>
+
+<para>The following is the server hardware configuration chosen to support the
+ooRexx build environment.
+</para>
+
+<simplelist>
+<member>Dell T110 server
+</member>
+<member>Quad Core Intel<trademark class="registered"></trademark>
+Xeon<trademark class="registered"></trademark> CPU
+</member>
+<member>16GiB DDR2, 533 MHz, 4X4G Dual Ranked DIMMS Memory
+</member>
+<member>2TB, SATA II, 3.5-inch, 7.2K RPM Hard Drive
+</member>
+<member>CDROM/DVD R/W
+</member>
+</simplelist>
+
+<para>The following software was installed on the server.
+</para>
+
+<itemizedlist>
+<listitem><para>Fedora 17 with Virtualization enabled
+</para></listitem>
+<listitem><para>ooRexx version 4.1 for Linux
+</para></listitem>
+</itemizedlist>
+
+<section><title>Build Host User Accounts</title>
+
+<para>After Fedora was installed on the server one user account was extablished
+to own everything concerning the build process and administration of the server.
+The account name was <emphasis role="italic">buildorx</emphasis>.
+This account is very important because it will own the shared files for
+the guest operating systems.
+</para>
+
+<para>The <emphasis role="italic">buildorx</emphasis> account will also own the
+HTML pages used to control the server through the Apache web interface.
+</para>
+</section>
+
+<section><title>Disk Layout</title>
+
+<para>After considering a number of different partitioning schemes for the build
+server it was determined that the best alternative would be to keep the
+partitioning scheme as simple as possible and still provide for upgrades to
+the host system. The following scheme was applied to the server disk.
+</para>
+
+<itemizedlist>
+<listitem><para>100MB partition for /boot
+</para></listitem>
+<listitem><para>50GB partition for / root partition
+</para></listitem>
+<listitem><para>100GB partition for /home partition
+</para></listitem>
+<listitem><para>1000GB partition for /pub partition
+</para></listitem>
+<listitem><para>500GB partition for /virt partition
+</para></listitem>
+<listitem><para>16GB swap partition
+</para></listitem>
+</itemizedlist>
+
+</section>
+
+<section><title>Operating System Installation</title>
+
+<para>The following are the step-by-step instructions used for setting up the
+build machine environment. This does not include instructions on setting up
+VMware guest operating systems. Those instructions are described in the sections
+describing each individual guest OS.
+</para>
+
+<para>Hopefully you have installed the Fedora Linux distribution before so
+an extended step-by-step guide will not be needed. Only the essential steps
+are described below as well as the configuration steps for managing the
+server.
+</para>
+
+<orderedlist>
+ <listitem><para>Start the Fedora installation.
+ </para></listitem>
+ <listitem><para>Partition the hard drive per the description above.
+ </para></listitem>
+ <listitem><para>SELinux was disabled for our installation as that level of
+ security was not deemed necessary.
+ </para></listitem>
+ <listitem><para>The firewall was enabled for our installation because the
+ server is directly available on the Internet.
+ </para></listitem>
+ <listitem><para>Make sure that you install Apache, all the development tools,
+ CVS, Subversion, Samba (used by the Windows guest OSs), xinetd,
+ and any other required tools.
+ </para></listitem>
+ <listitem><para>After the reboot, create the
+ <emphasis role="italic">buildorx</emphasis> user account.
+ </para></listitem>
+ <listitem><para>On the initial login let the software updates be applied
+ to the system when prompted by the system.
+ <note><para>This will probably load a new Linux kernel onto the system.
+ </para></note>
+ </para></listitem>
+ <listitem><para>Naturally we will install a copy of Open Object Rexx. It will
+ be used as our primary scripting engine. The latest version at the time of this
+ publication was 4.1.
+ </para></listitem>
+ <listitem><para>Samba is used to store shared files used by the WMware Windows
+ guest operating systems. To set it up first edit the
+ <varname>/etc/samba/smb.conf</varname> and make the following changes.
+ <programlisting>
+ # Use whatever workgroup works for you but remember that all the guest
+ # Windows OSs must use the same value.
+ workgroup = OOREXX
+
+ # This should cover any virtual network defined by VMware
+ # It will also restrict the shares to the vitual network
+ interfaces = vmnet*
+
+ # Create the public share with exclusive access given to the buildox account
+ [public]
+ comment = Shared public stuff
+ path = /pub
+ public = yes
+ writable = yes
+ printable = no
+ write list = @users
+ force group = @users
+ create mask = 0664
+ directory mask = 0775
+ </programlisting>
+ </para>
+ <para>Next we need to create the SMB user account that will be used by the
+ guest Windows OS clients.
+ <programlisting>
+ # smbpasswd -a buildorx
+ </programlisting>
+ </para>
+ <para>Now start the Samba server and make it auto start at boot.
+ <programlisting>
+ # service smb start
+ # chkconfig --level 5 smb on
+ </programlisting>
+ </para>
+ </listitem>
+ <listitem><para>Next we need to generate the SSH public/private keys for the
+ server.</para>
+ <programlisting>
+ # ssh-keygen
+ </programlisting>
+ <para>Be sure to just hit return for the passphrase prompt (we do NOT want
+ a passphrase). Otherwise we cannot get true automation from our scripts.
+ </para>
+ </listitem>
+</orderedlist>
+</section>
+
+</chapter>
+
+
+<xi:include href="kvm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include href="guestos.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include href="admin.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include href="releases.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include href="Common_Content/Notices.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include href="Common_Content/CPLv1.0.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<index />
+
+</book>
Property changes on: docs/trunk/publican/buildmachine/en-US/ooRexxBuild.xml
___________________________________________________________________
Added: svn:mime-type
+ text/
Added: svn:eol-style
+ native
Added: docs/trunk/publican/buildmachine/en-US/releases.xml
===================================================================
--- docs/trunk/publican/buildmachine/en-US/releases.xml (rev 0)
+++ docs/trunk/publican/buildmachine/en-US/releases.xml 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,52 @@
+<?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 "ooRexxBuild.ent">
+%BOOK_ENTITIES;
+]>
+<!--#########################################################################
+ #
+ # Description: Open Object Rexx: Build Machine Document XML File
+ #
+ # Copyright (c) 2005-2012, Rexx Language Association. All rights reserved.
+ # Portions Copyright (c) 2004, IBM Corporation. All rights reserved.
+ #
+ # This program and the accompanying materials are made available under
+ # the terms of the Common Public License v1.0 which accompanies this
+ # distribution. A copy is also available at the following address:
+ # http://www.oorexx.org/license.html
+ #
+ # Redistribution and use in source and binary forms, with or
+ # without modification, are permitted provided that the following
+ # conditions are met:
+ #
+ # Redistributions of source code must retain the above copyright
+ # notice, this list of conditions and the following disclaimer.
+ # Redistributions in binary form must reproduce the above copyright
+ # notice, this list of conditions and the following disclaimer in
+ # the documentation and/or other materials provided with the distribution.
+ #
+ # Neither the name of Rexx Language Association nor the names
+ # of its contributors may be used to endorse or promote products
+ # derived from this software without specific prior written permission.
+ #
+ # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+ # TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+ # OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+ # OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ #
+ #########################################################################
+-->
+<chapter><title>Building ooRexx Releases Using the Build Machine</title>
+
+<para>
+ No content yet.
+</para>
+</chapter>
+
Property changes on: docs/trunk/publican/buildmachine/en-US/releases.xml
___________________________________________________________________
Added: svn:mime-type
+ text/
Added: svn:eol-style
+ native
Added: docs/trunk/publican/buildmachine/publican.cfg
===================================================================
--- docs/trunk/publican/buildmachine/publican.cfg (rev 0)
+++ docs/trunk/publican/buildmachine/publican.cfg 2012-08-30 20:00:56 UTC (rev 8325)
@@ -0,0 +1,9 @@
+# Config::Simple 4.59
+# Tue Aug 7 09:21:09 2012
+
+xml_lang: "en-US"
+type: Book
+brand: oorexx
+mainfile: ooRexxBuild
+prod_url: http://www.oorexx.org/
+
|