Clean up a few more admin files.
[working/Evergreen.git] / 1.6 / admin / troubleshooting.xml
index a5e7aee..b354d99 100644 (file)
@@ -17,11 +17,13 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="troubleshooting">
                        <para>Stop OpenSRF:</para><indexterm><primary>OpenSRF</primary></indexterm>\r
                        <screen><userinput>osrf_ctl.sh -l -a stop_all</userinput></screen>\r
                        <para>You should get either output simlar to this:</para>\r
-                       <screen>Stopping OpenSRF C process 12515...</screen>\r
-                       <screen>Stopping OpenSRF C process 12520...</screen>\r
-                       <screen>Stopping OpenSRF C process 12526...</screen>\r
-                       <screen>Stopping OpenSRF Perl process 12471...</screen>\r
-                       <screen>Stopping OpenSRF Router process 12466...</screen>\r
+<screen>\r
+Stopping OpenSRF C process 12515...\r
+Stopping OpenSRF C process 12520...\r
+Stopping OpenSRF C process 12526...\r
+Stopping OpenSRF Perl process 12471...\r
+Stopping OpenSRF Router process 12466...\r
+</screen>\r
                        <para>Or, if services have already been stopped, output may look like this:</para>\r
                        <screen>OpenSRF C not running</screen>\r
                        <screen>OpenSRF Perl not running</screen>\r
@@ -65,18 +67,18 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="troubleshooting">
                <indexterm><primary>OpenSRF</primary><secondary>services</secondary><tertiery>perl</tertiery></indexterm>\r
                        <screen><userinput>/openils/bin/osrf_ctl.sh -l -a start_perl</userinput></screen>\r
                        <para>You should see the output similar to the following:</para>\r
-                       <screen>\r
-                       Starting OpenSRF Perl\r
-                       * starting all services for ...\r
-                       * starting service pid=7484 opensrf.settings\r
-                       * starting service pid=7493 open-ils.cat\r
-                       * starting service pid=7495 open-ils.supercat\r
-                       * starting service pid=7497 open-ils.search\r
-                       * starting service pid=7499 open-ils.circ\r
-                       * starting service pid=7501 open-ils.actor\r
-                       * starting service pid=7502 open-ils.storage\r
-                       ...\r
-                       </screen>\r
+<screen>\r
+Starting OpenSRF Perl\r
+* starting all services for ...\r
+* starting service pid=7484 opensrf.settings\r
+* starting service pid=7493 open-ils.cat\r
+* starting service pid=7495 open-ils.supercat\r
+* starting service pid=7497 open-ils.search\r
+* starting service pid=7499 open-ils.circ\r
+* starting service pid=7501 open-ils.actor\r
+* starting service pid=7502 open-ils.storage\r
+...\r
+</screen>\r
                        <para>If the <systemitem class="service">perl</systemitem> services do not start correctly or you receive errors, search for errors \r
                        in the following log files:</para>\r
                        <itemizedlist>  \r
@@ -110,18 +112,18 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="troubleshooting">
                        <para>As user <systemitem class="username">opensrf</systemitem>, you invoke <command>autogen</command> with the command:</para>\r
                        <screen><userinput>/openils/bin/autogen.sh -c /openils/conf/opensrf_core.xml -u</userinput></screen>\r
                        <para>If Autogen completes successfully, the output will be:</para>\r
-                       <screen>\r
-                       Updating fieldmapper\r
-                       Updating web_fieldmapper\r
-                       Updating OrgTree\r
-                       removing OrgTree from the cache...\r
-                       Updating OrgTree HTML\r
-                       Updating locales selection HTML\r
-                       Updating Search Groups\r
-                       Refreshing proximity of org units\r
-                       Successfully updated the organization proximity\r
-                       Done\r
-                       </screen>\r
+<screen>\r
+Updating fieldmapper\r
+Updating web_fieldmapper\r
+Updating OrgTree\r
+removing OrgTree from the cache...\r
+Updating OrgTree HTML\r
+Updating locales selection HTML\r
+Updating Search Groups\r
+Refreshing proximity of org units\r
+Successfully updated the organization proximity\r
+Done\r
+</screen>\r
                        <para>If Autogen does not complete its task and you receive errors, use \r
                        <command>grep</command> to find errors in the log files:</para>  \r
                        <screen><userinput>grep ERR /openils/var/log/*.log</userinput></screen>\r
@@ -139,31 +141,31 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="troubleshooting">
                        <para>At the srfsh prompt, enter this command:</para>\r
                        <screen><userinput>login admin open-ils</userinput></screen>\r
                        <para>You should the request verification:</para>\r
-                       <screen>\r
-                       Received Data: "6f63ff5542da1fead4431c6c280efc75"\r
-                       ------------------------------------\r
-                       Request Completed Successfully\r
-                       Request Time in seconds: 0.018414\r
-                       ------------------------------------\r
-                       \r
-                       Received Data: {\r
-                       "ilsevent":0,\r
-                       "textcode":"SUCCESS",\r
-                       "desc":" ",\r
-                       "pid":7793,\r
-                       "stacktrace":"oils_auth.c:312",\r
-                       "payload":{\r
-                       "authtoken":"28804ebf99508496e2a4d2593aaa930e",\r
                       "authtime":420.000000\r
-                       }\r
-                       }\r
-                       \r
-                       ------------------------------------\r
-                       Request Completed Successfully\r
-                       Request Time in seconds: 0.552430\r
-                       ------------------------------------\r
-                       Login Session: 28804.  Session timeout: 420.000\r
-                       srfsh#</screen>        \r
+<screen>\r
+Received Data: "6f63ff5542da1fead4431c6c280efc75"\r
+------------------------------------\r
+Request Completed Successfully\r
+Request Time in seconds: 0.018414\r
+------------------------------------\r
+\r
+Received Data: {\r
+"ilsevent":0,\r
+"textcode":"SUCCESS",\r
+"desc":" ",\r
+"pid":7793,\r
+"stacktrace":"oils_auth.c:312",\r
+"payload":{\r
+"authtoken":"28804ebf99508496e2a4d2593aaa930e",\r
+ "authtime":420.000000\r
+}\r
+}\r
+\r
+------------------------------------\r
+Request Completed Successfully\r
+Request Time in seconds: 0.552430\r
+------------------------------------\r
+Login Session: 28804.  Session timeout: 420.000\r
+srfsh#</screen>        \r
                        <para>If you encounter errors or if you are unable to connect, you should consult the \r
                        <filename>srfsh.log</filename> file. The location of this file is configured in your <indexterm><primary>logs</primary><secondary>srfsh.log</secondary></indexterm>\r
                        <filename>.srfsh.xml</filename> configuration file and is \r
@@ -182,10 +184,10 @@ xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="troubleshooting">
                        <para>or</para>\r
                        <screen>apache2ctl start</screen>\r
                        <para>You should see output:</para>\r
-                       <screen>\r
-                       * Starting web server apache2\r
-                       ...done.\r
-                       </screen>\r
+<screen>\r
+* Starting web server apache2\r
+...done.\r
+</screen>\r
                        <para>the Apache OpenSRF modules write to the \r
                        <filename>/openils/var/log/gateway.log</filename></para><indexterm><primary>logs</primary><secondary>gateway.log</secondary></indexterm>\r
                        <para>However, you should check all of the log files for errors:</para>\r