summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2012-12-09 12:15:06 (GMT)
committerJeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>2012-12-09 12:15:06 (GMT)
commit2edb47fb27dc5a4b1766d0c9ec6039057a445d89 (patch)
tree0835299b49d65d9cc78b4be1f2ee46824a612c70
parente1318b4d8c88756ddd6daa30d89147c213aa4ff0 (diff)
downloadkolab-docs-2edb47fb27dc5a4b1766d0c9ec6039057a445d89.tar.gz
Update the installation instructions for RPM distributions to include importing GPG keys
-rw-r--r--Installation_Guide/Makefile38
-rw-r--r--Installation_Guide/en-US/sect-Repository_Configuration-Installation_with_RPM_Packages.xml92
2 files changed, 130 insertions, 0 deletions
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@kolabsys.com (0x28D0FD1C) from <literal>pgp.mit.edu</literal>:
+ </para>
+ <para>
+
+<screen># <userinput>gpg --keyserver pgp.mit.edu --search tikanga-packages@kolabsys.com</userinput>
+gpg: searching for "tikanga-packages@kolabsys.com" from hkp server pgp.mit.edu
+(1) Kolab Package Signing (Enterprise Linux 5) &lt;tikanga-packages@kolabsys.
+ 2048 bit RSA key 28D0FD1C, created: 2010-08-11
+Keys 1-1 of 1 for "tikanga-packages@kolabsys.com". Enter number(s), N)ext, or Q)uit &gt; <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 &gt; 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@kolabsys.com (0xD6A23807) from <literal>pgp.mit.edu</literal>:
+ </para>
+ <para>
+
+<screen># <userinput>gpg --keyserver pgp.mit.edu --search santiago-packages@kolabsys.com</userinput>
+gpg: searching for "santiago-packages@kolabsys.com" from hkp server pgp.mit.edu
+(1) Kolab Package Signing (Enterprise Linux 6) &lt;santiago-packages@kolabsys
+ 2048 bit RSA key D6A23807, created: 2011-01-21
+Keys 1-1 of 1 for "santiago-packages@kolabsys.com". Enter number(s), N)ext, or Q)uit &gt; <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 &gt; 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">