Cool Solution - Joomla
From Univention Wiki
Note: Cool Solutions are articles documenting additional functionality based on Univention products.
Not all of the shown steps in the article are covered by Univention Support. For questions about your support coverage contact your contact person at Univention before you want to implement one of the shown steps.
This article briefly describes how to install Joomla 3.x, and focuses on how to configure the included LDAP plugin against a UCS LDAP server.
Joomla can be installed on any Linux distribution meeting the requirements, like Debian or Ubuntu.
The Joomla version used to create this article is 3.4.5, and the full package was used (not an update archive).
Contents
Prerequisite
The following software must be installed in order to run Joomla:
| Software | Version |
|---|---|
| Apache | >=2.x |
| PHP | >=5.3.10 |
| MySQL | >=5.1 |
MySQL databse
To connect to the MySQL database using PHP, the following PHP extension must be available:
- MySQL
When Joomla is installed on a UCS system, all dependencies can be installed from the standard UCS repository:
univention-install mysql-server php5-mysql
User prerequisites
In order to log in as a user using the LDAP connection, the mapped attribute for e-mail (see LDAP connection table below) must contain a valid e-mail address.
Installation
In this article it is assumed that Joomla will be installed in /var/www/joomla, so the directory must be created first and the ownership must be corrected so the webserver can access the installation folder:
mkdir -p /var/www/joomla chown -R www-data:www-data /var/www/joomla
Download the latest Joomla version from the Joomla website, and extract it into the newly created directory:
unzip Joomla_3.4.5-Stable-Full_Package.zip -d /var/www/joomla
Configuration
The complete configuration of Joomla is managed through the web interface. Please refer to the Joomla manual for assistance.
Joomla configuration
Navigate to https://<SERVER>/joomla/administrator and follow the instructions in the web interface.
Hint: Please note that the administrative user, which is created as first user, is not to be confused with the default UCS administrative user "Administrator".
Hint: Please note that during the configuration, an FTP connection can be configured. The installation and configuration of an FTP is not part of this article.
LDAP configuration
Login is the Joomla administrative user and activate the LDAP plugin by navigating to "Extensions" -> "Manage". A list of available plugins is shown. Activate the LDAP plugin by simply clicking on the button next to "Authentication - LDAP".
Next, navigate to "Extensions" -> "Plugins" and click on "Authentication - LDAP" and configure the plugin accordingly:
| Key | Value |
|---|---|
| Host | <LDAP server FQDN or IP> |
| Port | 7389 |
| LDAP v3 | Yes |
| Negotiate TLS | Yes |
| Authorisation Method | Bind and Search |
| Base DN | <Base DN> |
| Search string | uid=[search] |
| User's DN | uid=[username],cn=users,<Base DN> |
| Connect Username | <Search user's DN> |
| Connect Password | <Search user's password> |
| Map: Full Name | displayName |
| Map: Email | mailPrimaryAddress |
| Map: User ID | uidNumber |
Hint: To obtain the base DN, run ucr get ldap/base on any UCS system in the domain.
Hint: It is advised to create a new user for connecting to the LDAP instead of the UCS Administrator user.
UCS overview
To add Joomla to the UCS overview site, set the following UCR variables:
ucr set \ ucs/web/overview/entries/service/joomla/description/de="Joomla CMS." \ ucs/web/overview/entries/service/joomla/description="Joomla CMS." \ ucs/web/overview/entries/service/joomla/label/de="Joomla" \ ucs/web/overview/entries/service/joomla/label="Joomla" \ ucs/web/overview/entries/service/joomla/link="/joomla"
Hint: When Joomla is not installed on the UCS system, change the UCR variable ucs/web/overview/entries/service/joomla/link accordingly.
