UCS 4.2-4 Release Notes

Release notes for the installation and update of Univention Corporate Server (UCS) 4.2-4


Table of Contents

1. Release Highlights
2. Notes about the update
2.1. Recommended update order for environments with more than one UCS server
2.2. UCS installation DVD only available for 64 bit
3. Preparation of update
4. Postprocessing of the update
5. Further notes on selected packages
5.1. Collection of usage statistics
5.2. Scope of security support for WebKit, Konqueror and QtWebKit
5.3. Recommended browsers for the access to Univention Management Console
6. Changelog
6.1. General
6.2. Basic system services
6.2.1. Univention Configuration Registry
6.2.1.1. Changes to templates and modules
6.3. Domain services
6.3.1. OpenLDAP
6.3.1.1. Listener/Notifier domain replication
6.3.2. DNS server
6.4. Univention Management Console
6.4.1. Univention Management Console web interface
6.4.2. Univention Management Console server
6.4.3. Univention App Center
6.4.4. Modules for system settings / setup wizard
6.4.5. Domain join module
6.4.6. Users module
6.4.7. License module
6.4.8. System diagnostic module
6.4.9. Filesystem quota module
6.4.10. Other modules
6.5. Software deployment
6.5.1. Software monitor
6.6. System services
6.6.1. SAML
6.6.2. Univention self service
6.6.3. Mail services
6.6.4. Dovecot
6.6.5. Postfix
6.6.6. Nagios
6.6.7. DHCP server
6.6.8. Other services
6.7. Virtualization
6.7.1. Univention Virtual Machine Manager (UVMM)
6.8. Services for Windows
6.8.1. Samba
6.8.2. Univention S4 Connector

§Chapter 1. Release Highlights

With Univention Corporate Server 4.2-4, the fourth point release of Univention Corporate Server (UCS) 4.2 is now available. It provides several feature improvements and extensions, new properties as well as various improvements and bugfixes. An overview of the most important changes are:

  • Support for creating subfolders in shared folders was added to the Dovecot integration.

  • The package univention-ldap-overlay-memberof is now automatically installed during the system configuration of backup domain controller and slave domain controller systems if the memberOf overlay module is enabled on the master domain controller.

  • Individual changes to the Postfix configuration can now be added to the files main.cf.local and master.cf.local.

  • A confirmation dialog has been added which is shown after a user changed their password at the self-service module.

  • A new API for programming of Univention Directory Listener modules was added.

  • Various security updates have been integrated into UCS 4.2-4, e.g. OpenLDAP, the Linux kernel, Samba, MySQL and PostgreSQL. A complete list is available in Chapter 6.

§Chapter 2. Notes about the update

During the update some services in the domain may not be available temporarily, that is why the update should occur in a maintenance window. It is recommended to test the update in a separate test environment prior to the actual update. The test environment should be identical to the production environment. Depending on the system performance, network connection and the installed software the update will take between 20 minutes and several hours.

§2.1. Recommended update order for environments with more than one UCS server

In environments with more than one UCS system, the update order of the UCS systems must be borne in mind:

The authoritative version of the LDAP directory service is maintained on the master domain controller and replicated to all the remaining LDAP servers of the UCS domain. As changes to the LDAP schema can occur during release updates, the master domain controller must always be the first system to be updated during a release update.

§2.2. UCS installation DVD only available for 64 bit

Starting with UCS 4.0, installation DVD are only provided for the x86 64 bit architecture (amd64). Existing 32 bit UCS 3 systems can still be updated to UCS 4.0 through the online repository or by using update DVD. The 32 bit architecture will be supported over the entire UCS 4 maintenance period.

§Chapter 3. Preparation of update

It must be checked whether sufficient disk space is available. A standard installation requires a minimum of 6 GB of disk space. Depending on the scope of the existing installation, the update will require about another 1 GB of disk space for download and installation all packages.

For the update, a login should be performed on the system's local console as user root, and the update should be initiated there. Alternatively, the update can be conducted using Univention Management Console.

Remote updating via SSH is not recommended as this may result in the update procedure being canceled, e.g., if the network connection is interrupted. In consequence, this can affect the system severely. If updating should occur over a network connection nevertheless, it must be verified that the update continues in case of disconnection from the network. This can be achieved, e.g., using the tools screen and at. These tools are installed on all UCS system roles by default.

§Chapter 4. Postprocessing of the update

Following the update, new or updated join scripts need to be executed. This can be done in two ways: Either using the UMC module Domain join or by running the command univention-run-join-scripts as user root.

Subsequently the UCS system needs to be restarted.

§Chapter 5. Further notes on selected packages

§5.1. Collection of usage statistics

Anonymous usage statistics on the use of Univention Management Console are collected when using the UCS Core Edition (which is generally used for evaluating UCS). The modules opened are logged in an instance of the web traffic analysis tool Piwik. This makes it possible for Univention to tailor the development of Univention Management Console better to customer needs and carry out usability improvements.

This logging is only performed when the UCS Core Edition license is used. The license status can be verified via the menu entry License -> License information of the user menu in the upper right corner of Univention Management Console. If UCS Core Edition is listed under License type, this version is in use. When a regular UCS license is used, no usage statistics are collected.

Independent of the license used, the statistics generation can be deactivated by setting the Univention Configuration Registry variable umc/web/piwik to false.

§5.2. Scope of security support for WebKit, Konqueror and QtWebKit

WebKit, Konqueror and QtWebKit are shipped in the maintained branch of the UCS repository, but not covered by security support. WebKit is primarily used for displaying HTML help pages etc. Firefox should be used as web browser.

§5.3. Recommended browsers for the access to Univention Management Console

Univention Management Console uses numerous JavaScript and CSS functions to display the web interface. Cookies need to be permitted in the browser. The following browsers are recommended:

  • Chrome as of version 37

  • Firefox as of version 38

  • Internet Explorer as of version 11

  • Safari and Safari Mobile as of version 9

Users with older browsers may experience display or performance issues.

§Chapter 6. Changelog

Listed are the changes since UCS 4.2-3:

§6.1. General

§6.2. Basic system services

§6.2.1. Univention Configuration Registry

§6.2.1.1. Changes to templates and modules

  • The SplitMode setting of systemd-journald can now be set with the Univention Configuration Registry variable systemd/journald/SplitMode (Bug 46750).

§6.3. Domain services

§6.3.1. OpenLDAP

§6.3.1.1. Listener/Notifier domain replication

  • A new API for programming of Univention Directory Listener modules was added (Bug 44786).
  • To prevent systemctl from reporting a wrong status for the univention-directory-listener service, the runsv timeout has been increased to 30 seconds (Bug 46313).
  • To prevent systemctl from reporting a wrong status for the univention-directory-notifier service, the runsv timeout has been increased to 30 seconds (Bug 46312).
  • Very large LDAP schema definitions could prevent the LDAP server on backup domain controller and slave domain controller from starting. The fix ensures that such schemas are handled correctly (Bug 46743).

§6.3.2. DNS server

  • To prevent systemctl from reporting a wrong status for the univention-bind service, the runsv timeout has been increased to 30 seconds (Bug 46310).
  • Logging in the joinscript has been improved (Bug 42110).

§6.4. Univention Management Console

§6.4.1. Univention Management Console web interface

  • The sorting performance for lists in Univention Management Console has been improved (Bug 45076).
  • Displaying of Python stack traces in Univention Management Console can now be prevented by setting the Univention Configuration Registry variable umc/http/show_tracebacks to false (Bug 45395).
  • A JavaScript error that prevented the execution of startup hooks causing the menu to be empty on the portal site (Bug 45836).
  • The Univention Management Console overview page now shows a banner that links to the Univention Summit website (Bug 45826).
  • A notification about the advantages of using the Enterprise Edition of UCS is displayed after the login on specific systems (Bug 45809).
  • The selection checkbox which have no possible actions have been removed from the pkgdb Univention Management Console module (Bug 44173).

§6.4.2. Univention Management Console server

  • The password dialog that is shown upfront some functions in Univention Management Console when using a Single Sign On (SAML) session can now be submitted by pressing Enter (Bug 46882).
  • SAML session handling with LDAP connections is improved and should not throw server tracebacks anymore (Bug 44621).
  • Messages directed to the user are not displayed as an error anymore (Bug 46319).
  • Displaying of Python stack traces in Univention Management Console can now be prevented by setting the Univention Configuration Registry variable umc/http/show_tracebacks to false (Bug 45395).
  • A problem when using Internet Explorer 11 has been corrected which lead to broken redirections if the SAML identity provider is not resolvable during login (Bug 45424).
  • The Univention Summit Banner is now only shown on systems using the Core Editions (Bug 45940).
  • The Univention Management Console overview page now shows a banner that links to the Univention Summit website (Bug 45826).

§6.4.3. Univention App Center

  • File permissions for /etc/machine.secret in App containers have been fixed (Bug 46835).
  • Calling univention-upgrade non-interactively may have caused an error while upgrading Apps when run on a master domain controller (Bug 46703).
  • Filter UCS components is now more robust with respect to diverted caches (Bug 45796).
  • Show a rating's description when hovering over it (Bug 46060).
  • Improved caching lookups to reduce startup time of the module (Bug 44783).
  • Show the translated text for the license type of the App (Bug 45499).
  • Upgrading an App failed when required App Settings were used. This has been fixed (Bug 46222).
  • Customize environment variable name LDAP_HOSTDN (Bug 46223).
  • Limit the number of backups created when uninstalling Docker Apps (Bug 44480).
  • Univention now receives more detailed error messages when App installations fail (Bug 45808).
  • An upgrade path between a Docker image for UCS 4.1 and one for UCS 4.2 was added (Bug 45795).

§6.4.4. Modules for system settings / setup wizard

  • The package univention-ldap-overlay-memberof is now automatically installed during the system configuration of master domain controller and slave domain controller systems if the memberOf overlay module is enabled on the master domain controller (Bug 44448).

§6.4.5. Domain join module

  • The error return codes when joining computers have been improved (Bug 45263).
  • The logging of joinscript failures has been improved (Bug 42110).

§6.4.6. Users module

  • It is now prevented to set mail addresses without local part or without domain part (Bug 46021).
  • Kerberos authentication failed due to expired keys when the domain wide Samba maxPwdAge setting was is too large. Univention Directory Manager and Univention Management Console now restrict the values that can be set for sambaMaxPwdAge and sambaMinPwdAge (Bug 41865).

§6.4.7. License module

  • Add information about blocking browser add-ons to system activation error message (Bug 45899).

§6.4.8. System diagnostic module

  • The diagnostics module now correctly detects the file permissions of the Open-Xchange apps cache directory (Bug 46363).

§6.4.9. Filesystem quota module

  • The quota module now supports partitions mounted with the journaled quota option (Bug 45668).

§6.4.10. Other modules

  • The statistic graphics in the Univention Management Console module are now access protected (Bug 45192).

§6.5. Software deployment

  • The statistic graphics in the Univention Management Console module are now access protected (Bug 45192).
  • Links in the log view during installing software upgrades via the Univention Management Console module can now be clicked (Bug 45060).
  • A JavaScript error is prevented if receiving the maintenance status information is not possible (Bug 44080).

§6.5.1. Software monitor

  • Loading animations are now shown in the Univention Management Console module (Bug 45623).
  • The selection checkbox which have no possible actions have been removed from the Univention Management Console module pkgdb (Bug 44173).

§6.6. System services

§6.6.1. SAML

  • Restart the univention-saml daemon after an upgrade to prevent timeouts (Bug 46212).
  • On the single-sign on login page only the domainname instead of the servers hostname is now shown (Bug 44121).
  • The access permissions for the SAML Identify Provider certificate have been corrected (Bug 44704).

§6.6.2. Univention self service

  • Changing a password of an expired user account is possible again and a confirmation dialog has been added which is shown after changing the password (Bug 45813).
  • The creation of postgresql database and users has been moved from the post installation script into the joinscript (Bug 44393).
  • Notifications about successful password changes are shown again (Bug 45457).
  • Users from an Active Directory domain now can reset their password via the Self Service. To enable the feature, the Univention Configuration Registry variables ad/reset/username and ad/reset/password need to be set (Bug 44867).

§6.6.3. Mail services

  • The service status of some mail related services has been fixed and is now shown correctly in Univention Management Console (Bug 43555).

§6.6.4. Dovecot

  • When moving a user's mailbox to a different filesystem, set owner and group for all files on the target filesystem (Bug 46893).
  • The creation of ACLs for shared folders with ACLs including users or groups with a space character has been fixed (Bug 45921).
  • Support for creating subfolders in shared folders was added. Please note that during the update, ACLs specified in LDAP will be forcefully written to Dovecot's shared folders to fix possible missing access rights (Bug 41138).

§6.6.5. Postfix

  • Postfix' service postscreen has been integrated and can be configured via the Univention Configuration Registry variables prefixed by mail/postfix/postscreen/. The service performs lightweight checks on incoming SMTP connections to reject e.g. spam early (Bug 45607).
  • If Univention Configuration Registry variable mail/postfix/policy/listfilter/use_sasl_username was set to yes, the listfilter policy service rejected all mail unexpectedly. The listfilter policy service has been fixed and now handles Cyrus SASL authentication correctly (Bug 45422).
  • The content of the files main.cf.local and master.cf.local will now be appended to /etc/postfix/main.cf and /etc/postfix/master.cf respectively. After editing the *.local files, ucr commit /etc/postfix/*.cf must be called (Bug 44922).
  • The listfilter policy service can now write debugging information to the mail log, when the Univention Configuration Registry variable mail/postfix/policy/listfilter/debug is set to yes (Bug 44473).
  • The service status is now correctly detected and shown in Univention Management Console (Bug 43555).

§6.6.6. Nagios

  • A Nagios check for the LDAP database maximum size has been added. With the LDAP MDB database backend, a maximum size is configured for the database (Univention Configuration Registry variable ldap/database/mdb/maxsize). If the maximum size is reached, write requests are no longer possible. The new plugin checks the effective size of the database and returns a warning if 75%, or critical if 90% are in use. The plugin is activated for all domain controllers upon the installation of the Nagios packages. For updates, the plugin has to be activated manually. This can be done by executing the following commands on the Nagios server and the client. univention-run-join-scripts --force --run-scripts 26univention-nagios-common.inst 30univention-nagios-client.inst (Bug 45685).

§6.6.7. DHCP server

  • To prevent systemctl from reporting a wrong status for the univention-dhcp service, the runsv timeout has been increased to 30 seconds (Bug 46311).

§6.6.8. Other services

  • The iptables chains will not be erased anymore when univention-firewall is stopped, if the Univention Configuration Registry variable security/packetfilter/disabled is set (Bug 45541).

§6.7. Virtualization

§6.7.1. Univention Virtual Machine Manager (UVMM)

  • It is now possible to limit the target hosts a VM can be migrated to. The setting can be configured in the virtual machine detail view (Bug 45846).
  • This update provides an updated version of OpenBIOS, which is required for the new version of QEMU only for emulating the SPARC architecture.(Bug 46217).
  • This is an update for the BIOS a virtual machine in UCS Virtual Machine Manager uses. On reset the original BIOS code was not copied back completely, which could result in virtual machines getting stuck after reboots. In order for virtual machines to load the updated BIOS, the virtual machine has to be shutdown and started again. A reboot does not suffice (Bug 44084).

§6.8. Services for Windows

§6.8.1. Samba

  • Added a more detailed error message for the domain join (Bug 46762).
  • Ignore unsupported Kerberos encryption types (Bug 46301).
  • Fixed a segmentation fault of the rpc_server process when replicating as a non administrator with GUID_DRS_GET_CHANGES (Bug 45800).

§6.8.2. Univention S4 Connector

  • connector-tracebacks.log is not written any longer (Bug 38140).
  • Ignore unsupported Kerberos encryption types (Bug 46301).
  • Rejects for DNs containing non-ASCII characters could not be saved, because python-sqlite3 doesn't accept UTF-8, causing rejects not to be visible but keeping the S4-Connector retrying endlessly, flooding the logs with rejects (Bug 44369).