Installation_Guide/en-US Installation_Guide/Makefile
Jeroen van Meeuwen
vanmeeuwen at kolabsys.com
Sun Dec 9 13:15:31 CET 2012
Installation_Guide/Makefile | 38 ++++
Installation_Guide/en-US/sect-Repository_Configuration-Installation_with_RPM_Packages.xml | 92 ++++++++++
2 files changed, 130 insertions(+)
New commits:
commit 2edb47fb27dc5a4b1766d0c9ec6039057a445d89
Author: Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen at kolabsys.com>
Date: Sun Dec 9 12:15:06 2012 +0000
Update the installation instructions for RPM distributions to include importing GPG keys
diff --git a/Installation_Guide/Makefile b/Installation_Guide/Makefile
index 1cbf28d..7b74dd5 100644
--- a/Installation_Guide/Makefile
+++ b/Installation_Guide/Makefile
@@ -22,3 +22,41 @@ all: clean clean_ids update-language
done
sed -r -i -e 's/^condition:.*/condition: community/g' publican.cfg
+enterprise: clean clean_ids update-language
+ for audience in enterprise; do \
+ sed -r -i -e "s/^condition:.*/condition: $$audience/g" publican.cfg; \
+ sed -r -i -e "s/^docname:.*/docname: $$(echo $${audience:0:1} | tr '[:lower:]' '[:upper:]')$${audience:1}_$(PACKAGE)/g" publican.cfg; \
+ make clean clean_ids; \
+ if [ "$(SKIP_UPDATE_LANG)" == "1" ]; then \
+ publican build --embedtoc --publish --langs=en-US --formats=html,html-single,pdf; \
+ else \
+ publican build --embedtoc --publish --langs=all --formats=html,html-single,pdf; \
+ fi; \
+ if [ "$(SKIP_UPDATE_LANG)" == "1" ]; then \
+ publican install_book --site_config=../site.cfg --lang=en-US; \
+ else \
+ for lang in $$(ls -d *-* | grep -v en-US); do \
+ publican install_book --site_config=../site.cfg --lang=$$lang; \
+ done; \
+ fi; \
+ done
+
+community: clean clean_ids update-language
+ for audience in community; do \
+ sed -r -i -e "s/^condition:.*/condition: $$audience/g" publican.cfg; \
+ sed -r -i -e "s/^docname:.*/docname: $$(echo $${audience:0:1} | tr '[:lower:]' '[:upper:]')$${audience:1}_$(PACKAGE)/g" publican.cfg; \
+ make clean clean_ids; \
+ if [ "$(SKIP_UPDATE_LANG)" == "1" ]; then \
+ publican build --embedtoc --publish --langs=en-US --formats=html,html-single,pdf; \
+ else \
+ publican build --embedtoc --publish --langs=all --formats=html,html-single,pdf; \
+ fi; \
+ if [ "$(SKIP_UPDATE_LANG)" == "1" ]; then \
+ publican install_book --site_config=../site.cfg --lang=en-US; \
+ else \
+ for lang in $$(ls -d *-* | grep -v en-US); do \
+ publican install_book --site_config=../site.cfg --lang=$$lang; \
+ done; \
+ fi; \
+ done
+
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 3b1829c..8d68274 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
@@ -563,6 +563,98 @@
</section>
+ <section condition="enterprise" id="sect-Community_Installation_Guide-Installation_with_RPM_Packages-Importing_the_GPG_Public_Keys">
+ <title>Importing the GPG Public Keys</title>
+ <para>
+ To ensure the signature on the RPM packages can be verified, import the GPG public key for the GPG signatures on packages you are about to install. The following procedures explain how to do so for different platforms and GPG public keys.
+ </para>
+ <procedure id="proc-Community_Installation_Guide-Importing_the_GPG_Public_Keys-Import_GPG_Public_Key_for_Enterprise_Linux_5">
+ <title>Import GPG Public Key for Enterprise Linux 5</title>
+ <step>
+ <para>
+ Retrieve the GPG public key for tikanga-packages at kolabsys.com (0x28D0FD1C) from <literal>pgp.mit.edu</literal>:
+ </para>
+ <para>
+
+<screen># <userinput>gpg --keyserver pgp.mit.edu --search tikanga-packages at kolabsys.com</userinput>
+gpg: searching for "tikanga-packages at kolabsys.com" from hkp server pgp.mit.edu
+(1) Kolab Package Signing (Enterprise Linux 5) <tikanga-packages at kolabsys.
+ 2048 bit RSA key 28D0FD1C, created: 2010-08-11
+Keys 1-1 of 1 for "tikanga-packages at kolabsys.com". Enter number(s), N)ext, or Q)uit > <userinput>1</userinput></screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Export the GPG key to an ascii armored public key block:
+ </para>
+ <para>
+
+<screen># <userinput>gpg --export -a 0x28D0FD1C > tikanga.asc</userinput></screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Import the exported public key block in to RPM:
+ </para>
+ <para>
+
+<screen># <userinput>rpm --import tikanga.asc</userinput></screen>
+
+ </para>
+
+ </step>
+
+ </procedure>
+
+ <procedure id="proc-Community_Installation_Guide-Importing_the_GPG_Public_Keys-Import_GPG_Public_Key_for_Enterprise_Linux_6">
+ <title>Import GPG Public Key for Enterprise Linux 6</title>
+ <step>
+ <para>
+ Retrieve the GPG public key for santiago-packages at kolabsys.com (0xD6A23807) from <literal>pgp.mit.edu</literal>:
+ </para>
+ <para>
+
+<screen># <userinput>gpg --keyserver pgp.mit.edu --search santiago-packages at kolabsys.com</userinput>
+gpg: searching for "santiago-packages at kolabsys.com" from hkp server pgp.mit.edu
+(1) Kolab Package Signing (Enterprise Linux 6) <santiago-packages at kolabsys
+ 2048 bit RSA key D6A23807, created: 2011-01-21
+Keys 1-1 of 1 for "santiago-packages at kolabsys.com". Enter number(s), N)ext, or Q)uit > <userinput>1</userinput></screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Export the GPG key to an ascii armored public key block:
+ </para>
+ <para>
+
+<screen># <userinput>gpg --export -a 0xD6A23807 > santiago.asc</userinput></screen>
+
+ </para>
+
+ </step>
+ <step>
+ <para>
+ Import the exported public key block in to RPM:
+ </para>
+ <para>
+
+<screen># <userinput>rpm --import santiago.asc</userinput></screen>
+
+ </para>
+
+ </step>
+
+ </procedure>
+
+
+ </section>
+
<section id="sect-Community_Installation_Guide-Installation_with_RPM_Packages-Repository_Package_Stages">
<title>Repository Package Stages</title>
<formalpara id="form-Community_Installation_Guide-Repository_Package_Stages-Stable_Software">
More information about the commits
mailing list