Both sides previous revisionPrevious revisionNext revision | Previous revision |
troubleshooting:checking_for_errors [2009/12/10 10:23] – IRC channel name phasefx | troubleshooting:checking_for_errors [2022/02/10 13:34] (current) – external edit 127.0.0.1 |
---|
If you have Evergreen installed and are encountering systematic errors, here is how you might go about troubleshooting and gathering logs for others to troubleshoot. These instructions assume standard locations and filenames for Evergreen installations, and may also include commands that assume a Debian or Ubuntu Linux operating system. | If you have Evergreen installed and are encountering systematic errors, here is how you might go about troubleshooting and gathering logs for others to troubleshoot. These instructions assume standard locations and filenames for Evergreen installations, and may also include commands that assume a Debian or Ubuntu Linux operating system. |
| |
| **NOTE:** This content is also available in the Evergreen documentation at http://docs.evergreen-ils.org/1.6/draft/html/. In github: http://github.com/rsoulliere/Evergreen-DocBook/blob/master/1.6/admin/troubleshooting.xml. |
| |
===== Step 1: Stop all the OpenSRF services, as well as Apache ===== | ===== Step 1: Stop all the OpenSRF services, as well as Apache ===== |
</code> | </code> |
| |
If you have trouble getting memcached and apache running, stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. There may also be tips available on this [[troubleshooting:checking_for_errors_step3|page]]. | If you have trouble getting memcached and apache running, stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. |
| |
| |
</code> | </code> |
| |
If you do not, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. There may also be tips available on this [[troubleshooting:checking_for_errors_step_5|page]]. We will want to see a copy of your router log and configuration files here: | If you do not, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. We will want to see a copy of your router log and configuration files here: |
<code> | <code> |
/openils/var/log/router.log | /openils/var/log/router.log |
</code> | </code> |
| |
If you do not, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. There may also be tips available on this [[troubleshooting:checking_for_errors_step_6|page]]. At a minimum, we will want to see a copy of your router log, osrfsys log and configuration files here: | If you do not, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. At a minimum, we will want to see a copy of your router log, osrfsys log and configuration files here: |
<code> | <code> |
/openils/var/log/router.log | /openils/var/log/router.log |
</code> | </code> |
| |
If you do not, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. There may also be tips available on this [[troubleshooting:checking_for_errors_step_7|page]]. At a minimum, we will want to see a copy of your router log, osrfsys log and configuration files here: | If you do not, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. At a minimum, we will want to see a copy of your router log, osrfsys log and configuration files here: |
<code> | <code> |
/openils/var/log/*router.log | /openils/var/log/*router.log |
</code> | </code> |
| |
If you encounter any issues with Autogen, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. There may also be tips available on this [[troubleshooting:checking_for_errors_step_8|page]]. We will be interested in the usual log and configuration files: | If you encounter any issues with Autogen, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. We will be interested in the usual log and configuration files: |
<code> | <code> |
/openils/var/log/*.log | /openils/var/log/*.log |
srfsh# | srfsh# |
</code> | </code> |
If it does not, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. There may also be tips available on this [[troubleshooting:checking_for_errors_step_9|page]]. At a minimum, we will want to see a copy of your router log, osrfsys log and configuration files here: | If it does not, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. At a minimum, we will want to see a copy of your router log, osrfsys log and configuration files here: |
<code> | <code> |
/openils/var/log/*router.log | /openils/var/log/*router.log |
~/.srfsh.xml | ~/.srfsh.xml |
</code> | </code> |
Assuming you have a srfsh prompt, enter this command: | Assuming you have a srfsh prompt, try logging in, **substituting the admin account credentials you created during the install process** into the following command: |
<code> | <code> |
login admin open-ils | login myAdminUsername myAdminPassword |
</code> | </code> |
You should see output similar to this: | You should see output similar to this: |
</code> | </code> |
| |
If you encounter any issues with Apache, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. There may also be tips available on this [[troubleshooting:checking_for_errors_step_10|page]]. In addition to your normal log and configuration files, we'll also want to see some pertinent Apache configuration files: | If you encounter any issues with Apache, then please stop here and ask for help on either [[http://open-ils.org/listserv.php|OPEN-ILS-DEV]] or [[http://open-ils.org/irc.php|#evergreen]]. In addition to your normal log and configuration files, we'll also want to see some pertinent Apache configuration files: |
<code> | <code> |
/etc/apache2/eg_vhost.conf | /etc/apache2/eg_vhost.conf |
===== Step 12: Try to authenticate with the OPAC ===== | ===== Step 12: Try to authenticate with the OPAC ===== |
| |
| ===== Bonus Step: Checking Ejabberd Account Credentials ===== |
| |
| You may have an ejabberd account problem, if you see an error like: |
| |
| <code> |
| Checking Jabber connection for user router, domain public.localhost |
| Use of uninitialized value $@ in concatenation (.) or string at /usr/local/share/perl/5.10.1/OpenSRF/Transport/SlimJabber/Client.pm line 147, <DATA> line 35. |
| * Error connecting to jabber: |
| SCALAR(0x1244e20) |
| </code> |
| |
| Verify that the username/password combinations are set correctly in opensrf_core.xml, but you can also check with ejabberd to make sure that they were setup correctly in the first place. |
| |
| As root: |
| |
| <code> |
| ejabberdctl check_password <user> <host> <password>; echo $? |
| </code> |
| |
| If the result is 0, then things are fine with that username/password on the given host. If the result is 1, then the credentials are not working. |
| |
| You can change your ejabberd password with: |
| |
| <code> |
| ejabberdctl change_password <user> <host> <new_password> |
| </code> |