\documentclass{article}
\usepackage{ulem}
\usepackage{graphicx}
\usepackage{hyperref}
\pagestyle{headings}
\begin{document}
\part{<a href="https://wiki.horde.org/FAQ/Admin">Horde Administrator's FAQ</a>}
\section{<a href="https://wiki.horde.org/FAQ/Admin/Troubleshoot">Troubleshooting and Common Problems</a>}
\subsection{Troubleshooting Turba}
\subsubsection{Turba can't connect to Active Directory LDAP servers}
If your Turba install can't seem to talk to an Active Directory server on the standard LDAP port, you should try using port 3268 ("Global Catalog Service"). You may have an older LDAP library compiled in to PHP which simply doesn't get along well with AD 2003.

\subsubsection{After upgrading from Turba 1.x to Turba 2.x, all the contacts disappeared}
Your user names probably have changed. You now use realms (<a href="https://wiki.horde.org/mailto:user@domain.tld">user@domain.tld</a>) but you didn't use them (user) in your old Horde version, or vice versa. If you are using IMP for authentication, check the \texttt{'realms'} parameter in \texttt{imp/config/servers.php}.

\subsubsection{Why does Turba give the error "Undefined index: socket ..."}
This means you have a missing or misconfigured \textit{socket} and/or \textit{protocol} parameter value in the \textit{params} block(s) in \texttt{/horde/turba/config/sources.php}.

Unless you are trying to use unix sockets rather than tcp/ip connections, set the \textit{socket} value to '' (meaning no value), and/or set the \textit{protocol} value to 'tcp'.

\subsubsection{Added attribute names not working with LDAP}
When adding new attribute names in the \texttt{sources.php} map section for LDAP servers, make sure all the attribute names are completely lowercase. Also make sure that all attributes you add to \texttt{sources.php} are also added to \texttt{attributes.php}. Finally, make sure your LDAP ACL's are set correctly to allow them to be viewed.

\subsubsection{LDAP queries empty after upgrading to Turba 1.2}
The 'objectclass' entry for LDAP address book definitions in \texttt{turba/config/sources.php} is respected in Turba 1.2 but wasn't in earlier versions. Set it to use a correct value for your LDAP structure.

\subsubsection{"Notice: Undefined index: businesscategory" or similar error message}
Turba has a system of defining what is in a directory or address book which is necessarily complicated by reason that it is flexible enough to map to pretty much anything with no code changes, only configuration file tweaks.

In \texttt{turba/config/sources.php}, for every backend that you use in Turba, you configure a \textit{map}. The map defines a mapping between whatever fields exist in the backend directory and what Turba calls those fields and also what kind of data Turba treats them as containing. So if the \textit{contact\_email} field in a database table is an email address, you could tell Turba to map 'email' => 'contact\_email'.

However, Turba needs to then know what 'email' or 'name' are. They're defined in \texttt{turba/config/attributes.php}, which is the set of attributes that any given Turba installation understands. The \texttt{attributes.php} file defines the label for a field and also what kind of data it is - a string, an email address, an enumeration of several options, etc.

So, back to the problem: you have some attributes in your map that Turba doesn't know about. In \texttt{sources.php}, there's probably a line something like:

<pre><code class="language-php">
'businesscategory' => 'backend\_field\_bus\_cat',
</code></pre>
But there is no 'businesscategory' attribute in your attributes.php. You need to either add an attribute entry, or remove that field, or map it to something else that Turba already knows about.

In some versions of Turba, the default sources.php file included an example that used attributes that weren't in the default attributes.php file and hence could cause this error. This has since been fixed for newer releases.

\subsubsection{Turba is unusably slow.}
If Turba and other applications that interface with it (such as Imp) are running slow, verify that you have modified \texttt{config/sources.php} to fit your needs.  Be certain to remove or comment out all entries that you are not using.

\end{document}
