Help:Troubleshooting Anope/Installation
Contents |
Troubleshooting Installation Issues
Introduction
The Anope installer has been designed to be as flexible as possible, taking into account the wide variety of Operating Systems and Machines that exist in todays world.
The Anope installer uses Autoconf to dynamically assess a system before compiling. This allows it to enable or disable certain options, and thus causing it to be built specifically for that machine.
This being said, issues can sometimes arise, which cause the installer to exit abnormally, without it being able to complete it's assessment. If this happens, chances are you won't be able to compile Anope until it's fixed.
Library Issues
Many people have reported issues of the installer not finding required library files. The most common library error that occurs is the libmysqlclient one. When this error occurs, a message like the one below will be displayed:
/usr/bin/ld: cannot find -lmysqlclient
collect2: ld returned 1 exit status
If you receive this message, then you may want to check that the file 'libmysqlclient.so' exists in your Library folder (usually something like /usr/lib). If you have a file such as libmysqlclient.so.12, then you need to create a link from libmysqlclient.so that points to the other libmysqlclient.so file that you have.
Fatal Errors
This section is currently under review, and will be published shortly.
Warnings
During installation, you may be presented with messages from the compiler, marked as Warning. These messages usually indicate that something isn't right, but doesn't affect the compilation of the program.
It's usually safe to ignore most warnings, as a large majority of them do not interfere with the operation of the program. In rare instances, Warnings that occur during compilation may affect how the program behaves. If this is the case, your best bet would be to check the Anope Bugtracker for any similar reports. If none exist, then you will need to open a new bug, including all output from the compiler, and details of your system specification.
Chmod / File Permissions
This section is currently under review, and will be published shortly.
Other Installation Issues
If you have an issue that isn't listed in this document, then you may wish to visit our IRC Support Channel. Either Click Here or Connect to irc.anope.org channel #anope.
Note: This document is currently in the stages of being written. The information held may not be wholely accurate, and the authors cannnot be held responsible for any inaccuracies.
