Upgrade to Confluence 3.5 with OSUser LDAP authentication fails
Confluence 3.5 cannot automatically upgrade instances that use OSUser LDAP authentication. The following appears in the
In Confluence 3.5.1 and above, the following appears in the
osuser.xml. You should see LDAP connection details, like:
Confluence 3.5 cannot automatically upgrade configurations using LDAP Authentication with OSUser.
This upgrade involves two steps outlined below.
- Shutdown your Confluence instance.
- Do not copy your old
osuser.xml. Instead, download the default
osuser.xmland put this in
- Place the provided atlassian-user.xml file in
- Start Confluence 3.5. It will migrate all your configured users and groups to the new user management system. However, LDAP authentication is not yet configured and should be configured in Step 2.
If using a version of Confluence older than 3.5.4, you will need to download and install the patch for CONF-22295. To install it, shut down Confluence, extract the zip file so the patch files look like below (create the missing folders manually):
- Start Confluence 3.5
- Log in to Confluence 3.5 using the administration username and password you used prior to configuring LDAP support in Confluence. (Confluence is not yet configured to point to LDAP, so your LDAP credentials will not work.)
- If you cannot remember or do not have a password which allows you to log in, reset the administrator's password in the database and restart Confluence to log in.
- Log in to Confluence, configure your LDAP directory via the User Directories option in the administration area. You will want to add a delegated LDAP authentication directory type ('Internal with LDAP Authentication'). You might want to enable 'Copy User on First Login' if necessary. This will create the user in Confluence if it doesn't already exist. This is useful if you intend to login as a user that was not present in your previous installation (and so will not be migrated) but is present on your LDAP server.
- Reorder the directories so the LDAP directory is first.
- Edit the address bar in the browser to go to http://<confluence url>/admin/migrateosuserldap.jsp and click on "start migration". This will migrate all the user information and properties from the old OS User user management.
- You can now log in as an LDAP user. As before, the authentication is performed in LDAP, but the user information is stored in Confluence.
Make sure to follow the additional steps in Upgrading Confluence once your user management system is working correctly.
Was this helpful?
Thanks for your feedback!