summaryrefslogtreecommitdiff
path: root/Deployment_Guide
diff options
context:
space:
mode:
authorJeroen van Meeuwen (Ergo Project) <jeroen.van.meeuwen@ergo-project.org>2011-01-05 23:42:56 (GMT)
committerJeroen van Meeuwen (Ergo Project) <jeroen.van.meeuwen@ergo-project.org>2011-01-05 23:42:56 (GMT)
commit4d849a6e64d30d8d1f29b8d82f87f692d617069b (patch)
treea827a49c142cd188f3677586d7f10941b24f9874 /Deployment_Guide
parent090f09897fa635c5b844fc7046fb1eaa6e181adb (diff)
downloadkolab-docs-4d849a6e64d30d8d1f29b8d82f87f692d617069b.tar.gz
Updates to the documentation
Diffstat (limited to 'Deployment_Guide')
-rw-r--r--Deployment_Guide/Makefile17
-rw-r--r--Deployment_Guide/en-US/Author_Group.xml6
-rw-r--r--Deployment_Guide/en-US/Book_Info.xml43
-rw-r--r--Deployment_Guide/en-US/Deployment_Guide.xml2
-rw-r--r--Deployment_Guide/en-US/Infrastructure.xml12
-rw-r--r--Deployment_Guide/en-US/Kolab_Preparations.xml12
-rw-r--r--Deployment_Guide/en-US/LDAP_Installation.xml16
-rw-r--r--Deployment_Guide/en-US/Preface.xml16
-rw-r--r--Deployment_Guide/en-US/Revision_History.xml44
9 files changed, 102 insertions, 66 deletions
diff --git a/Deployment_Guide/Makefile b/Deployment_Guide/Makefile
new file mode 100644
index 0000000..1ec237d
--- /dev/null
+++ b/Deployment_Guide/Makefile
@@ -0,0 +1,17 @@
+PACKAGE = "Deployment_Guide"
+
+all: clean clean_ids
+ @publican build --langs=en-US --formats=html,html-single,pdf
+ @rsync -aHvz tmp/en-US/{html,html-single,pdf} hosted.kolabsys.com:./public_html/kolab-2.3-docs/$(PACKAGE)/
+
+clean:
+ @publican clean
+
+clean_ids:
+ @cp -a ../Common_Content/en-US/*.xml en-US/.
+ @publican clean_ids
+ @sed -i -r \
+ -e 's/\t/ /g' \
+ -e 's/((\s{4})+)\s*/\1/g' \
+ -e 's/\s*$$//g' \
+ `find en-US/ -type f -name "*.xml"`
diff --git a/Deployment_Guide/en-US/Author_Group.xml b/Deployment_Guide/en-US/Author_Group.xml
index 104661b..52b14bd 100644
--- a/Deployment_Guide/en-US/Author_Group.xml
+++ b/Deployment_Guide/en-US/Author_Group.xml
@@ -7,11 +7,13 @@
<author>
<firstname>Jeroen</firstname>
<surname>van Meeuwen</surname>
- <affiliation>
+ <lineage>RHCE</lineage> <affiliation>
<orgname>Kolab Systems</orgname>
- <orgdiv>Senior Engineer</orgdiv>
+ <orgdiv>Engineering</orgdiv>
+
</affiliation>
<email>vanmeeuwen@kolabsys.com</email>
+
</author>
</authorgroup>
diff --git a/Deployment_Guide/en-US/Book_Info.xml b/Deployment_Guide/en-US/Book_Info.xml
index aee380c..013b1f0 100644
--- a/Deployment_Guide/en-US/Book_Info.xml
+++ b/Deployment_Guide/en-US/Book_Info.xml
@@ -4,25 +4,28 @@
%BOOK_ENTITIES;
]>
<bookinfo id="book-Deployment_Guide-Deployment_Guide">
- <title>Deployment Guide</title>
- <subtitle>short description</subtitle>
- <productname>Kolab</productname>
- <productnumber>2.3.0</productnumber>
- <edition>0</edition>
- <pubsnumber>0</pubsnumber>
- <abstract>
- <para>
- A short overview and summary of the book&#39;s subject and purpose, traditionally no more than one paragraph long. Note: the abstract will appear in the front matter of your book and will also be placed in the description field of the book&#39;s RPM spec file.
- </para>
- </abstract>
- <corpauthor>
- <inlinemediaobject>
- <imageobject>
- <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
- </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" />
+ <title>Deployment Guide</title>
+ <subtitle>short description</subtitle>
+ <productname>Kolab</productname>
+ <productnumber>2.3.0</productnumber>
+ <edition>0</edition>
+ <pubsnumber>0</pubsnumber>
+ <abstract>
+ <para>
+ A short overview and summary of the book's subject and purpose, traditionally no more than one paragraph long. Note: the abstract will appear in the front matter of your book and will also be placed in the description field of the book's RPM spec file.
+ </para>
+
+ </abstract>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
+ </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>
diff --git a/Deployment_Guide/en-US/Deployment_Guide.xml b/Deployment_Guide/en-US/Deployment_Guide.xml
index f0fedc7..ca47641 100644
--- a/Deployment_Guide/en-US/Deployment_Guide.xml
+++ b/Deployment_Guide/en-US/Deployment_Guide.xml
@@ -6,10 +6,8 @@
<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" />
-
<xi:include href="Infrastructure.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Kolab_Preparations.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>
diff --git a/Deployment_Guide/en-US/Infrastructure.xml b/Deployment_Guide/en-US/Infrastructure.xml
index 55fb43f..2fdd93f 100644
--- a/Deployment_Guide/en-US/Infrastructure.xml
+++ b/Deployment_Guide/en-US/Infrastructure.xml
@@ -1,18 +1,19 @@
<?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" [
+<!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 "Deployment_Guide.ent">
+%BOOK_ENTITIES;
]>
-
<chapter id="chap-Deployment_Guide-Infrastructure">
<title>Infrastructure</title>
<para>
With the implementation of groupware, several aspects in the infrastructure are worth considering prior to executing the actual implementation. This deployment guide addresses some of these aspects for your consideration.
</para>
-
<section id="sect-Deployment_Guide-Infrastructure-Authentication_and_Authorization">
<title>Authentication and Authorization</title>
<para>
The Kolab Groupware solution integrates with LDAP particularly well, but of course has certain prerequisites to the LDAP technology used, the exact LDAP schemas loaded and if you already have LDAP implemented, the way LDAP is used and maintained today.
</para>
+
</section>
<section id="sect-Deployment_Guide-Infrastructure-Domain_Name_System">
@@ -20,6 +21,7 @@
<para>
The Domain Name System, or DNS, is one essential part of any groupware environment. In terms of receiving and sending email, anti-spam, as well as scaling up your LDAP, mail exchangers, front-end load-balancers and anti-spam/anti-virus, DNS is one of those components that requires attention in detail.
</para>
+
</section>
<section id="sect-Deployment_Guide-Infrastructure-Scalability">
@@ -27,6 +29,7 @@
<para>
para
</para>
+
</section>
<section id="sect-Deployment_Guide-Infrastructure-Storage">
@@ -34,6 +37,9 @@
<para>
para
</para>
+
</section>
+
</chapter>
+
diff --git a/Deployment_Guide/en-US/Kolab_Preparations.xml b/Deployment_Guide/en-US/Kolab_Preparations.xml
index 6a4ba7b..74a14c0 100644
--- a/Deployment_Guide/en-US/Kolab_Preparations.xml
+++ b/Deployment_Guide/en-US/Kolab_Preparations.xml
@@ -1,18 +1,19 @@
<?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" [
+<!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 "Deployment_Guide.ent">
+%BOOK_ENTITIES;
]>
-
<chapter id="chap-Deployment_Guide-Kolab_Preparations">
<title>Kolab Preparations</title>
<para>
para
</para>
-
- <section id="sect-Deployment_Guide-Kolab_Preparations-LDAP_Schema">
+ <section id="sect-Deployment_Guide-Kolab_Preparations-Loading_the_LDAP_Schema">
<title>Loading the LDAP Schema</title>
<para>
para
</para>
+
</section>
<section id="sect-Deployment_Guide-Kolab_Preparations-System_Users">
@@ -20,6 +21,9 @@
<para>
para
</para>
+
</section>
+
</chapter>
+
diff --git a/Deployment_Guide/en-US/LDAP_Installation.xml b/Deployment_Guide/en-US/LDAP_Installation.xml
index cf1e040..df1b4be 100644
--- a/Deployment_Guide/en-US/LDAP_Installation.xml
+++ b/Deployment_Guide/en-US/LDAP_Installation.xml
@@ -1,13 +1,13 @@
<?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" [
+<!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 "Deployment_Guide.ent">
+%BOOK_ENTITIES;
]>
-
<chapter id="chap-Deployment_Guide-LDAP_Installation">
<title>LDAP Installation</title>
<para>
para
</para>
-
<procedure>
<step>
<para>
@@ -16,14 +16,18 @@
<para>
<command># yum install 389-ds</command>
</para>
+
</step>
<step>
<para>
Copy the schema file <filename>/usr/share/kolab/ldap/kolab.389ds.schema</filename> to the appropriate schema directory;
</para>
<para>
- <screen># <userinput>cp -a /usr/share/kolab/ldap/kolab.389ds-schema.ldif /etc/dirsrv/schema/66kolab.ldif</userinput></screen>
+
+<screen># <userinput>cp -a /usr/share/kolab/ldap/kolab.389ds-schema.ldif /etc/dirsrv/schema/66kolab.ldif</userinput></screen>
+
</para>
+
</step>
<step>
<para>
@@ -32,7 +36,11 @@
<para>
<command># setup-ds-admin.pl</command>
</para>
+
</step>
+
</procedure>
+
</chapter>
+
diff --git a/Deployment_Guide/en-US/Preface.xml b/Deployment_Guide/en-US/Preface.xml
index a69ff18..5a93c3f 100644
--- a/Deployment_Guide/en-US/Preface.xml
+++ b/Deployment_Guide/en-US/Preface.xml
@@ -5,25 +5,17 @@
]>
<preface id="pref-Deployment_Guide-Preface">
<title>Preface</title>
-
- <section id="pref-Deployment_Guide-Preface-Introduction">
+ <section id="sect-Deployment_Guide-Preface-Introduction">
<title>Introduction</title>
<para>
para
</para>
+
</section>
-<!--
<xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-//-->
-
-<!--
- <xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
- <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude">
- <xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- </xi:fallback>
- </xi:include>
-//-->
+ <xi:include href="sect-Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="sect-About_Kolab_Groupware.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
</preface>
diff --git a/Deployment_Guide/en-US/Revision_History.xml b/Deployment_Guide/en-US/Revision_History.xml
index 5fba8cc..965faf6 100644
--- a/Deployment_Guide/en-US/Revision_History.xml
+++ b/Deployment_Guide/en-US/Revision_History.xml
@@ -4,24 +4,30 @@
%BOOK_ENTITIES;
]>
<appendix id="appe-Deployment_Guide-Revision_History">
- <title>Revision History</title>
- <simpara>
- <revhistory>
- <revision>
- <revnumber>0</revnumber>
- <date>Sat Aug 7 2010</date>
- <author>
- <firstname>Dude</firstname>
- <surname>McPants</surname>
- <email>Dude.McPants@example.com</email>
- </author>
- <revdescription>
- <simplelist>
- <member>Initial creation of book by publican</member>
- </simplelist>
- </revdescription>
- </revision>
- </revhistory>
- </simpara>
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+ <revision>
+ <revnumber>0</revnumber>
+ <date>Sat Aug 7 2010</date>
+ <author>
+ <firstname>Dude</firstname>
+ <surname>McPants</surname>
+ <email>Dude.McPants@example.com</email>
+
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Initial creation of book by publican</member>
+
+ </simplelist>
+
+ </revdescription>
+
+ </revision>
+
+ </revhistory>
+
+ </simpara>
</appendix>