From 4d87c5c2022c01dc171a276ca1aefde3e3fe43da Mon Sep 17 00:00:00 2001 From: Sol Jerome Date: Thu, 13 Oct 2011 15:10:51 -0500 Subject: Proxy: Provide proper error message for misconfigured CA (#1059) Signed-off-by: Sol Jerome --- doc/help/troubleshooting.txt | 192 +++++++++++++++++++++---------------------- 1 file changed, 96 insertions(+), 96 deletions(-) (limited to 'doc/help/troubleshooting.txt') diff --git a/doc/help/troubleshooting.txt b/doc/help/troubleshooting.txt index b964154e0..d32e2c063 100644 --- a/doc/help/troubleshooting.txt +++ b/doc/help/troubleshooting.txt @@ -89,41 +89,39 @@ be taken to remedy them. Client Errors ------------- -+------------------------------+----------+---------------------+--------------+ -| Error | Location | Meaning | Repair | -+==============================+==========+=====================+==============+ -| Incomplete information for | Client | The described entry | [c1]_ | -| entry : | | is not fully | | -| cannot verify | | specified by the | | -| | | server, so no | | -| | | verification can be | | -| | | performed. | | -+------------------------------+----------+---------------------+--------------+ -| Incomplete information for | Client | The described entry | [c1]_ | -| entry : | | is not fully | | -| cannot install | | specified by the | | -| | | server, so no | | -| | | verification can be | | -| | | performed. | | -+------------------------------+----------+---------------------+--------------+ -| The following entries are | Client | The client cannot | [c2]_ | -| not handled by any tool: | | figure out how to | | -| : | | handle this entry. | | -+------------------------------+----------+---------------------+--------------+ -| No ca is specified. Cannot | Client | The client is | [c3]_ | -| authenticate the server with | | unable to verify | | -| SSL. | | the server | | -+------------------------------+----------+---------------------+--------------+ -| GID normalization failed for | Client | The client is | [c4]_ | -| FILENAME. Does group GROUP | | unable to convert | | -| exist? | | the group GROUP to | | -| | | a usable GID | | -+------------------------------+----------+---------------------+--------------+ -| UID normalization failed for | Client | The client is | [c5]_ | -| FILENAME. Does owner OWNER | | unable to convert | | -| exist? | | the owner OWNER to | | -| | | a usable UID | | -+------------------------------+----------+---------------------+--------------+ ++------------------------------+----------------------------+--------------+ +| Error | Meaning | Repair | ++==============================+============================+==============+ +| Incomplete information for | The described entry is not | [c1]_ | +| entry : | fully specified by the | | +| cannot verify | server, so no verification | | +| | can be performed. | | ++------------------------------+----------------------------+--------------+ +| Incomplete information for | The described entry is not | [c1]_ | +| entry : | fully specified by the | | +| cannot install | server, so no verification | | +| | can be performed. | | ++------------------------------+----------------------------+--------------+ +| The following entries are | The client cannot figure | [c2]_ | +| not handled by any tool: | out how to handle this | | +| : | entry. | | ++------------------------------+----------------------------+--------------+ +| No ca is specified. Cannot | The client is unable to | [c3]_ | +| authenticate the server with | verify the server. | | +| SSL. | | | ++------------------------------+----------------------------+--------------+ +| GID normalization failed for | The client is unable to | [c4]_ | +| FILENAME. Does group GROUP | convert the group GROUP to | | +| exist? | a usable GID. | | ++------------------------------+----------------------------+--------------+ +| UID normalization failed for | The client is unable to | [c5]_ | +| FILENAME. Does owner OWNER | convert the owner OWNER to | | +| exist? | a usable UID. | | ++------------------------------+----------------------------+--------------+ +| SSL CA error | The CA certificate | [c6]_ | +| | specified in bcfg2.conf is | | +| | incorrect | | ++------------------------------+----------------------------+--------------+ .. [c1] This entry is not being bound. Ensure that a version of this @@ -140,71 +138,73 @@ Client Errors .. [c5] If the owner doesn't exist, you need to specify the correct one in an :ref:`info.xml ` file or set the default owner appropriately. +.. [c6] Check that the CA specified in bcfg2.conf is appropriate for the + server you are attempting to access. Server Errors ------------- -+------------------------------+----------+---------------------+--------------+ -| Error | Location | Meaning | Repair | -+==============================+==========+=====================+==============+ -| Failed to bind entry: | Server | The server was | [s1]_ | -| | | unable to find a | | -| | | suitable version of | | -| | | entry for client. | | -+------------------------------+----------+---------------------+--------------+ -| Failed to bind to socket | Server | The server was | [s2]_ | -| | | unable to bind to | | -| | | the tcp server | | -| | | socket. | | -+------------------------------+----------+---------------------+--------------+ -| Failed to load | Server | The server was | [s3]_ | -| ssl key | | unable to read and | | -| | | process the ssl key.| | -+------------------------------+----------+---------------------+--------------+ -| Failed to read file | Server | The server failed | [s4]_ | -| | | to read the | | -| | | specified file | | -+------------------------------+----------+---------------------+--------------+ -| Failed to parse file | Server | The server failed | [s5]_ | -| | | to parse the | | -| | | specified XML file | | -+------------------------------+----------+---------------------+--------------+ -| Client metadata resolution | Server | The server cannot | [s6]_ | -| error for | | resolve the client | | -| | | hostname or the | | -| | | client is | | -| | | associated with a | | -| | | non-profile group. | | -+------------------------------+----------+---------------------+--------------+ -| Failed to decode | Server | The encoding being | [s7]_ | -| Please verify you are using | | used is unable to | | -| the proper encoding | | decode the | | -| | | character present | | -| | | in this file. | | -+------------------------------+----------+---------------------+--------------+ -| Got unknown entries | Server | The Packages plugin | [s8]_ | -| [list of unknown entries] | | has no knowledge of | | -| | | the listed entries | | -+------------------------------+----------+---------------------+--------------+ -| Failed to import lxml | Server | The server cannot | [s9]_ | -| dependency. Shutting | | import lxml | | -| down server. | | | | -+------------------------------+----------+---------------------+--------------+ -| You need to specify base64 | Server | The server cannot | [s10]_ | -| encoding for | | send the file as | | -| | | ascii text | | -+------------------------------+----------+---------------------+--------------+ -| ERROR: Error reading file | Server | The server cannot | [s11]_ | -| '/path/to/schema': failed to | | find the schema | | -| load external entity | | file | | -| "/path/to/schema" | | | | -+------------------------------+----------+---------------------+--------------+ -| Packages: No matching | Server | None of the sources | [s12]_ | -| sources for client | | defined in the | | -| ; improper group | | Package plugin's | | -| memberships? | | ``sources.xml`` | | -| | | apply to the client | | -+------------------------------+----------+---------------------+--------------+ ++------------------------------+---------------------+--------------+ +| Error | Meaning | Repair | ++==============================+=====================+==============+ +| Failed to bind entry: | The server was | [s1]_ | +| | unable to find a | | +| | suitable version of | | +| | entry for client. | | ++------------------------------+---------------------+--------------+ +| Failed to bind to socket | The server was | [s2]_ | +| | unable to bind to | | +| | the tcp server | | +| | socket. | | ++------------------------------+---------------------+--------------+ +| Failed to load | The server was | [s3]_ | +| ssl key | unable to read and | | +| | process the ssl key.| | ++------------------------------+---------------------+--------------+ +| Failed to read file | The server failed | [s4]_ | +| | to read the | | +| | specified file | | ++------------------------------+---------------------+--------------+ +| Failed to parse file | The server failed | [s5]_ | +| | to parse the | | +| | specified XML file | | ++------------------------------+---------------------+--------------+ +| Client metadata resolution | The server cannot | [s6]_ | +| error for | resolve the client | | +| | hostname or the | | +| | client is | | +| | associated with a | | +| | non-profile group. | | ++------------------------------+---------------------+--------------+ +| Failed to decode | The encoding being | [s7]_ | +| Please verify you are using | used is unable to | | +| the proper encoding | decode the | | +| | character present | | +| | in this file. | | ++------------------------------+---------------------+--------------+ +| Got unknown entries | The Packages plugin | [s8]_ | +| [list of unknown entries] | has no knowledge of | | +| | the listed entries | | ++------------------------------+---------------------+--------------+ +| Failed to import lxml | The server cannot | [s9]_ | +| dependency. Shutting | import lxml | | +| down server. | | | ++------------------------------+---------------------+--------------+ +| You need to specify base64 | The server cannot | [s10]_ | +| encoding for | send the file as | | +| | ascii text | | ++------------------------------+---------------------+--------------+ +| ERROR: Error reading file | The server cannot | [s11]_ | +| '/path/to/schema': failed to | find the schema | | +| load external entity | file | | +| "/path/to/schema" | | | ++------------------------------+---------------------+--------------+ +| Packages: No matching | None of the sources | [s12]_ | +| sources for client | defined in the | | +| ; improper group | Package plugin's | | +| memberships? | ``sources.xml`` | | +| | apply to the client | | ++------------------------------+---------------------+--------------+ .. [s1] This entry is not being bound. Ensure that a version of this -- cgit v1.2.3-1-g7c22