[software-collections-guide: 12/17] Add Troubleshooting_Software_Collections

[Petr Kovář]

commit 891097ee770a207e54c83afb94444df775390768
Author: Petr Kovar <pkovar at redhat.com>
Date:   Mon May 19 18:14:30 2014 +0200

    Add Troubleshooting_Software_Collections

 en-US/Extending_Red_Hat_Software_Collections.xml |    1 +
 en-US/Software_Collections_Guide.xml             |    2 +
 en-US/Troubleshooting_Software_Collections.xml   |   28 ++++++++++++++++++++++
 3 files changed, 31 insertions(+), 0 deletions(-)
---
diff --git a/en-US/Extending_Red_Hat_Software_Collections.xml b/en-US/Extending_Red_Hat_Software_Collections.xml
index db6bb65..911d219 100644
--- a/en-US/Extending_Red_Hat_Software_Collections.xml
+++ b/en-US/Extending_Red_Hat_Software_Collections.xml
@@ -2,6 +2,7 @@
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
 <chapter id="chap-Extending_Red_Hat_Software_Collections">
   <title>Extending Red Hat Software Collections 1.1</title>
+  <para>This chapter describes extending &DSCL;s that are part of the Red Hat Software Collections 1.1 offering.</para>
   <section id="sect-Providing_an_scldevel_Subpackage">
     <title>Providing an scldevel Subpackage</title>
     <para>Providing an <package>scldevel</package> subpackage in your &DSCL;'s metapackage can make it easier for users to create a dependent &DSCL;. This section describes creating an <package>scldevel</package> subpackage for Ruby-based &DSCL;s, ruby193 and ruby200.</para>
diff --git a/en-US/Software_Collections_Guide.xml b/en-US/Software_Collections_Guide.xml
index 26e7b5f..b46af21 100644
--- a/en-US/Software_Collections_Guide.xml
+++ b/en-US/Software_Collections_Guide.xml
@@ -14,6 +14,8 @@
       xmlns:xi="http://www.w3.org/2001/XInclude" />
     <xi:include href="Extending_Red_Hat_Software_Collections.xml"
       xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="Troubleshooting_Software_Collections.xml"
+      xmlns:xi="http://www.w3.org/2001/XInclude" />
     <xi:include href="Getting_More_Information.xml"
       xmlns:xi="http://www.w3.org/2001/XInclude" />
     <xi:include href="Revision_History.xml"
diff --git a/en-US/Troubleshooting_Software_Collections.xml b/en-US/Troubleshooting_Software_Collections.xml
new file mode 100644
index 0000000..f5154af
--- /dev/null
+++ b/en-US/Troubleshooting_Software_Collections.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+<chapter id="chap-Troubleshooting_Software_Collections">
+  <title>Troubleshooting &DSCL;s</title>
+  <para>This chapter helps you troubleshoot some of the common issues you can encounter when building your &DSCL;s.</para>
+  <section id="sect-Error_line_XX_Unknown_tag">
+    <title>Error: line <replaceable>XX</replaceable>: Unknown tag: %scl_package <replaceable>software_collection_name</replaceable></title>
+    <para>You can encounter this error message when building  a &DSCL; package. It is usually caused by a missing package <package>scl-utils-build</package>. To install the <package>scl-utils-build</package> package, run the following command:</para>
+    <screen><computeroutput># </computeroutput><userinput>yum install scl-utils-build</userinput></screen>
+    <para>For more information, see <xref linkend="sect-Enabling_Support_for_Software_Collections" />.</para>
+  </section>
+  <section id="sect-scl_command_does_not_exist">
+    <title>scl command does not exist</title>
+    <para>This error message is usually caused by a missing package <package>scl-utils</package>. To install the <package>scl-utils</package> package, run the following command:</para>
+    <screen><computeroutput># </computeroutput><userinput>yum install scl-utils</userinput></screen>
+    <para>For more information, see <xref linkend="sect-Enabling_Support_for_Software_Collections" />.</para>
+  </section>
+  <section id="sect-Unable_to_open_etc_scl_prefixes_software_collection_name">
+    <title>Unable to open /etc/scl/prefixes/<replaceable>software_collection_name</replaceable></title>
+    <para>This error message can be caused by using incorrect arguments with the <command>scl</command> command you are calling. Check the <command>scl</command> command is correct and that you have not mistyped any of the used arguments.</para>
+    <para>The same error message can be also caused by a missing &DSCL;. Ensure that the <replaceable>software_collection_name</replaceable> &DSCL; is properly installed on the system. For more information, see <xref linkend="sect-Listing_Installed_Software_Collections" />.</para>
+  </section>
+  <section id="sect-scl_source_command_not_found">
+    <title>scl_source: command not found</title>
+    <para>This error message is usually caused by having an old version of the <package>scl-utils</package> package installed. To update the <package>scl-utils</package> package, run the following command:</para>
+    <screen><computeroutput># </computeroutput><userinput>yum update scl-utils</userinput></screen>
+  </section>
+</chapter>