commit 891097ee770a207e54c83afb94444df775390768
Author: Petr Kovar <pkovar(a)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>