summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2012-05-10 01:01:38 (GMT)
committerJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2012-05-10 01:01:38 (GMT)
commit0fceb4fad88b1c83de1162fa689ec9886a21212f (patch)
tree56844c673c1dd68b97ba0b5930fa801444c174da
parent950badd0d522a417e0d874eb91b98008870b045b (diff)
downloadkolab-docs-0fceb4fad88b1c83de1162fa689ec9886a21212f.tar.gz
Remove the separate chapter on bootstrapping, the documentation is in the Configuration chapter after Installation
-rwxr-xr-xInstallation_Guide/en-US/Kolab_Server_Bootstrapping.xml425
-rwxr-xr-xInstallation_Guide/en-US/Kolab_Server_Installation.xml1
-rwxr-xr-xInstallation_Guide/en-US/part-Kolab_Server.xml1
-rw-r--r--Installation_Guide/en-US/sect-Repository_Configuration-Installation_with_RPM_Packages.xml4
4 files changed, 3 insertions, 428 deletions
diff --git a/Installation_Guide/en-US/Kolab_Server_Bootstrapping.xml b/Installation_Guide/en-US/Kolab_Server_Bootstrapping.xml
deleted file mode 100755
index 7273007..0000000
--- a/Installation_Guide/en-US/Kolab_Server_Bootstrapping.xml
+++ /dev/null
@@ -1,425 +0,0 @@
-<?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 "Community_Installation_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<chapter id="chap-Community_Installation_Guide-Bootstrapping_the_Kolab_Installation">
- <title>Bootstrapping the Kolab Installation</title>
- <para>
- Various scenarios require various installation procedures.
- </para>
- <important>
- <title>Infrastructure Matters</title>
- <para>
- The infrastructure around the Kolab environment matters. The system's hostname, <emphasis>Fully Qualified Domain Name</emphasis> (FQDN) and other infrastructural aspects impact the installation procedure as well as the resulting runtime environment. The Deployment Guide has more details.
- </para>
-
- </important>
- <section id="sect-Community_Installation_Guide-Bootstrapping_the_Kolab_Installation-Preparing_the_System_for_Bootstrapping">
- <title>Preparing the System for Bootstrapping</title>
- <para>
- Preparing the system for bootstrapping it requires any services that the Kolab Groupware is going to create, maintain and/or manage need to be shut down prior to bootstrapping.
- </para>
- <para>
- The following ports are being checked for running services, in numeric order:
- </para>
- <para>
- <orderedlist>
- <listitem>
- <para>
- 24
- </para>
-
- </listitem>
- <listitem>
- <para>
- 25
- </para>
-
- </listitem>
- <listitem>
- <para>
- 80
- </para>
-
- </listitem>
- <listitem>
- <para>
- 110
- </para>
-
- </listitem>
- <listitem>
- <para>
- 143
- </para>
-
- </listitem>
- <listitem>
- <para>
- 443
- </para>
-
- </listitem>
- <listitem>
- <para>
- 389
- </para>
-
- </listitem>
- <listitem>
- <para>
- 465
- </para>
-
- </listitem>
- <listitem>
- <para>
- 587
- </para>
-
- </listitem>
- <listitem>
- <para>
- 636
- </para>
-
- </listitem>
- <listitem>
- <para>
- 993
- </para>
-
- </listitem>
- <listitem>
- <para>
- 995
- </para>
-
- </listitem>
- <listitem>
- <para>
- 2000
- </para>
-
- </listitem>
- <listitem>
- <para>
- 2003
- </para>
-
- </listitem>
- <listitem>
- <para>
- 9999
- </para>
-
- </listitem>
- <listitem>
- <para>
- 10024
- </para>
-
- </listitem>
- <listitem>
- <para>
- 10025
- </para>
-
- </listitem>
- <listitem>
- <para>
- 10026
- </para>
-
- </listitem>
-
- </orderedlist>
- <note>
- <title>Identifying blocked ports</title>
- <para>
- If the process fails due to running services and also
-<screen># <userinput>/usr/sbin/kolabsrv rc all stop</userinput></screen>
- does not help, the ports can be checked using:
-<screen># <userinput>lsof -Pnl +M -i4</userinput></screen>
- on an IPv4 network and
-<screen># <userinput>lsof -Pnl +M -i6</userinput></screen>
- for iPv6. Alternatively
-<screen># <userinput>netstat -tulpn</userinput></screen>
- should give you the same info. Stop all services running on one of the aforementioned ports:
-<screen># <userinput>/etc/rc.d/init.d/<replaceable>service</replaceable> stop</userinput></screen>
-
- </para>
-
- </note>
-
- </para>
-
- </section>
-
- <section id="sect-Community_Installation_Guide-Bootstrapping_the_Kolab_Installation-New_Kolab_Environment">
- <title>New Kolab Environment</title>
- <para>
- Issue the following command to bootstrap a new Kolab environment:
- </para>
- <para>
-
-<screen># <userinput>kolabctl start</userinput></screen>
-
- </para>
- <para>
- This will start all needed services and you kolab environemt is usable now.
- </para>
- <para>
- Congratulations! You have finished the installation of you kolab groupware server.
- </para>
-
- </section>
-
- <section id="sect-Community_Installation_Guide-Bootstrapping_the_Kolab_Installation-Manual_Bootstrap_process">
- <title>Manual Bootstrap process</title>
- <para>
- Instead of using the kolabctl utility, the services can also be started manually
- </para>
- <warning>
- <title>Ensure that ports are free</title>
- <para>
- Please ensure first that all aforementioned ports are free
- </para>
-
- </warning>
- <para>
- The following services need to be started in this order (the order is mandatory). If you did not use the default components (i.e. dovecot instead of cyrus), you will have to adjust the commands accordingly accordingly.
- </para>
- <itemizedlist id="item-Community_Installation_Guide-Manual_Bootstrap_process-Services_to_start">
- <title>Services to start</title>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Services_to_start-LDAP">
- <title><code>LDAP</code></title>
- <para>
-
-<screen># <userinput>/etc/init.d/ldap start</userinput></screen>
-
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Services_to_start-SASL">
- <title><code>SASL</code></title>
- <para>
-
-<screen># <userinput>/etc/init.d/saslauthd start</userinput></screen>
-
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Services_to_start-Amavis">
- <title><code>Amavis</code></title>
- <para>
-
-<screen># <userinput>/etc/rc.d/init.d/amavisd start</userinput></screen>
-
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Services_to_start-Clamav">
- <title><code>Clamav</code></title>
- <para>
-
-<screen># <userinput>/etc/rc.d/init.d/clamd.amavisd start</userinput></screen>
-
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Services_to_start-cyrus_IMAP">
- <title><code>cyrus-IMAP</code></title>
- <para>
-
-<screen># <userinput>/etc/rc.d/init.d/cyrus-imapd start</userinput></screen>
-
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Services_to_start-Postfix">
- <title><code>Postfix</code></title>
- <para>
-
-<screen># <userinput>/etc/rc.d/init.d/postfix start</userinput></screen>
-
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Services_to_start-Kolabd">
- <title><code>Kolabd</code></title>
- <para>
-
-<screen># <userinput>/etc/init.d/kolabd start</userinput></screen>
-
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Services_to_start-HTTP_Server">
- <title><code>HTTP Server</code></title>
- <para>
-
-<screen># <userinput>/etc/init.d/httpd start</userinput></screen>
-
- </para>
-
- </formalpara>
-
- </listitem>
-
- </itemizedlist>
-
- </section>
-
- <section condition="enterprise" id="sect-Community_Installation_Guide-Bootstrapping_the_Kolab_Installation-New_Kolab_Environment_with_Existing_LDAP">
- <title>New Kolab Environment with Existing LDAP</title>
- <para>
- TODO: update and move to another chapter or the admin guide When not using the OpenLDAP server &ndash;but instead using a new deployment of a different LDAP server technology or perhaps an existing LDAP Directory Server deployment, kolab_bootstrap is not to be used.
- </para>
- <para>
- Instead, the Kolab Groupware configuration file in <filename>/etc/kolab/kolab.conf</filename> can be manually supplied. A full reference of all settings available is in <filename>/etc/kolab/kolab.globals</filename>, most of which are settings for the platform. An overview of relevant settings to include in <filename>/etc/kolab/kolab.conf</filename> is in
- </para>
- <para>
- <itemizedlist id="item-Community_Installation_Guide-New_Kolab_Environment_with_Existing_LDAP-Basic_Settings_to_Include_in_etckolabkolab.conf">
- <title>Basic Settings to Include in <filename>/etc/kolab/kolab.conf</filename></title>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-fqdnhostname">
- <title><code>fqdnhostname</code></title>
- <para>
- The fully qualified hostname for this system.
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-_is_master">
- <title> <code> is_master</code></title>
- <para>
- Whether this server is a Kolab master server or not. When using a different LDAP technology than OpenLDAP, or when using a directory tree external to Kolab, set this to <code>false</code>.
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-base_dn">
- <title><code>base_dn</code></title>
- <para>
- The Base DN for the LDAP tree, for example <emphasis>dc=example,dc=org</emphasis>
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-bind_dn">
- <title><code>bind_dn</code></title>
- <para>
- The <emphasis>distinguished name</emphasis> Kolab should use binding to the LDAP server.
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-bind_pw">
- <title><code>bind_pw</code></title>
- <para>
- The password to use when binding.
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-ldap_uri">
- <title><code>ldap_uri</code></title>
- <para>
- The URI to the LDAP server to use.
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-php_dn">
- <title><code>php_dn</code></title>
- <para>
- The <emphasis>distinguished name</emphasis> to use to bind to the LDAP server, specifically for Kolab PHP process such as the Kolab mail filter.
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-php_pw">
- <title><code>php_pw</code></title>
- <para>
- The password to use with the <xref linkend="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-php_dn" />.
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-calendar_id">
- <title><code>calendar_id</code></title>
- <para>
- The ID for calendaring used with Resources. A user 'calendar@domain' will be created in LDAP and as a mailbox.
- </para>
-
- </formalpara>
-
- </listitem>
- <listitem>
- <formalpara id="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-calendar_pw">
- <title><code>calendar_pw</code></title>
- <para>
- The password to use for the <xref linkend="form-Community_Installation_Guide-Basic_Settings_to_Include_in_etckolabkolab.conf-calendar_id" />.
- </para>
-
- </formalpara>
-
- </listitem>
-
- </itemizedlist>
-
- </para>
-
- </section>
-
- <section condition="enterprise" id="sect-Community_Installation_Guide-Bootstrapping_the_Kolab_Installation-New_Slave_to_Existing_Kolab_Environment">
- <title>New Slave to Existing Kolab Environment</title>
- <para>
- TODO: move to another chapter or guide? Walk through adding the host information to the existing environment, ssh-key exchange (optional), bootstrapping
- </para>
-
- </section>
-
-
-</chapter>
-
diff --git a/Installation_Guide/en-US/Kolab_Server_Installation.xml b/Installation_Guide/en-US/Kolab_Server_Installation.xml
index 5e4d340..ceb216a 100755
--- a/Installation_Guide/en-US/Kolab_Server_Installation.xml
+++ b/Installation_Guide/en-US/Kolab_Server_Installation.xml
@@ -46,6 +46,7 @@
<para>
<screen># <userinput>yum install kolab</userinput></screen>
+
</para>
<para>
Installing this meta-package will install all needed software components.
diff --git a/Installation_Guide/en-US/part-Kolab_Server.xml b/Installation_Guide/en-US/part-Kolab_Server.xml
index 3026662..19c54a1 100755
--- a/Installation_Guide/en-US/part-Kolab_Server.xml
+++ b/Installation_Guide/en-US/part-Kolab_Server.xml
@@ -9,7 +9,6 @@
<xi:include href="Kolab_Server_Overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Kolab_Server_Installation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Kolab_Server_Configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Kolab_Server_Bootstrapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Kolab_Server_Appendix.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
</part>
diff --git a/Installation_Guide/en-US/sect-Repository_Configuration-Installation_with_RPM_Packages.xml b/Installation_Guide/en-US/sect-Repository_Configuration-Installation_with_RPM_Packages.xml
index 2cc6ce3..76f6f29 100644
--- a/Installation_Guide/en-US/sect-Repository_Configuration-Installation_with_RPM_Packages.xml
+++ b/Installation_Guide/en-US/sect-Repository_Configuration-Installation_with_RPM_Packages.xml
@@ -544,7 +544,7 @@
<step>
<title>Enterprise Linux 5</title>
<para>
- The <application>yum-priorities</application> is available from the <ulink url="http://fedoraproject.org/wiki/EPEL">package repository</ulink>. Please install it:
+ The <application>yum-priorities</application> is available from the <ulink url="http://fedoraproject.org/wiki/EPEL">EPEL package repository</ulink>. Please install it:
</para>
<para>
@@ -556,7 +556,7 @@
<step>
<title>Enterprise Linux 6</title>
<para>
- The <application>yum-plugin-priorities</application> is available from the <ulink url="http://fedoraproject.org/wiki/EPEL">package repository</ulink>. Please install it:
+ The <application>yum-plugin-priorities</application> is available from the <ulink url="http://fedoraproject.org/wiki/EPEL">EPEL package repository</ulink>. Please install it:
</para>
<para>