Troubleshooting
Version 3 (Bryan Heath, 06/08/2012 03:36 pm)
| 1 | 1 | h1. Troubleshooting |
|
|---|---|---|---|
| 2 | 1 | ||
| 3 | 1 | If you are having issues here are some steps to try and help you figure out what is going on. |
|
| 4 | 1 | ||
| 5 | 1 | +*Please remember to UNDO all the testing changes before going live!!!!!*+ |
|
| 6 | 1 | ||
| 7 | 1 | h2. First step |
|
| 8 | 1 | ||
| 9 | 1 | Read and check all the [[Installation]], [[Setup]] and [[Configure]] steps. Many of the issues people have is they didnt follow each step correctly. |
|
| 10 | 1 | ||
| 11 | 1 | h2. Enable logging |
|
| 12 | 1 | ||
| 13 | 1 | * First make sure that /ldap/log/ is writable |
|
| 14 | 1 | * Open the ldap/config.php file |
|
| 15 | 1 | * Find: |
|
| 16 | 1 | ** @define('KAYAKO_LDAP_LOG', false);@ |
|
| 17 | 1 | * Change to: |
|
| 18 | 1 | ** @define('KAYAKO_LDAP_LOG', true);@ |
|
| 19 | 1 | * Now logging is enabled. You can now try to login again, even if you know it will not work. However if you go to /ldap/log/ you should see log.txt file. In it there should be a log of what is going on. This should help you track down the problem. |
|
| 20 | 1 | ||
| 21 | 1 | h2. Enable testing |
|
| 22 | 1 | ||
| 23 | 1 | * Open the ldap/config.php file |
|
| 24 | 1 | * Find: |
|
| 25 | 1 | ** @define('KAYAKO_LDAP_USERNAME', 'username');@ |
|
| 26 | 1 | ** @define('KAYAKO_LDAP_PASSWORD', 'password');@ |
|
| 27 | 1 | * Change the username and password to know good LDAP account. So it should look like: |
|
| 28 | 1 | ** @define('KAYAKO_LDAP_USERNAME', 'administrator');@ |
|
| 29 | 1 | ** @define('KAYAKO_LDAP_PASSWORD', 'thepassword');@ |
|
| 30 | 1 | * Find: |
|
| 31 | 1 | ** @define('KAYAKO_LDAP_TEST', false);@ |
|
| 32 | 1 | * Change to: |
|
| 33 | 1 | ** @define('KAYAKO_LDAP_TEST', true);@ |
|
| 34 | 3 | Bryan Heath | * Now you are in testing mode. If you go to the ldap.php you can now test those credentials and see if they work. If they do you should get a [[Troubleshooting_XML|valid XML]] result. |
| 35 | 1 | ||
| 36 | 1 | h2. Try the ldap.html |
|
| 37 | 1 | ||
| 38 | 3 | Bryan Heath | In the tools folder you will find ldap.hml. If you upload it and go to it, it will allow you to test different ldap users and see if you get a [[Troubleshooting_XML|valid XML]]. |
| 39 | 1 | ||
| 40 | 1 | This is currently setup for testing users. If you want to test staff: |
|
| 41 | 1 | ||
| 42 | 1 | * Open ldap.html |
|
| 43 | 1 | * Find: |
|
| 44 | 1 | ** @<form action="ldap.php" method="post">@ |
|
| 45 | 1 | *Replace with: |
|
| 46 | 1 | ** @<form action="ldap.php?type=staff" method="post">@ |