Giters

Crivaledaz / Mattermost-LDAP

This module provides an external LDAP authentication in Mattermost for the Team Edition (free).

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Upgrade instructions

shollander opened this issue · comments

commented

Thank you for your work on this very helpful software. I am currently running version 1.0 of Mattermost-LDAP. I would like to upgrade to the newest version (2.0). What steps are needed to upgrade? We use the "bare-metal" setup. I only see scripts for creating the database from scratch. Is there any migration that needs to be done when upgrading from 1.0 to 2.0? Thank you.

commented

Hi,

Mattermost-LDAP is very light, only the table users in the Oauth database is important, because it stores the correspondence between username and id, which need to keep the same over the time for Mattermost. In fact, you can rebuild your Mattermost-LDAP server from only this table, since other tables are designed to store ephemeral tokens.

So, if you want to upgrade Mattermost-LDAP, the easier way is to move the old oauth directory to oauth.bak, in /var/www/html, just in case something gone wrong. You can also perform a database backup, for example a dump, just to be sure.

Then clone this repository on your server and copy the new oauth directory in /var/www/html.

Adapt the configuration files oauth/config_db.php and oauth/LDAP/config_ldap.php with your parameters. You can do the diff with your old configuration files, parameters are the same in V2.

Note : Configuration files have been renamed with suffix .example

The only breaking change is the LDAP filter argument, which need to be surrounded by parenthesis now. For example, if you have an LDAP filter objectClass=person now use the following notation (objectClass=person).

Thus, the new Mattermost-LDAP will connect to the database and continue where the old Oauth server was. Note that you do not need to restart Apache or PostgreSQL/MySQL services.

For more information about change in V2, please refer to the changelog

Let me know if you achieve the upgrade successfully,

Regards,

commented

Thank you for the detailed instructions. I followed the instructions and was able to successfully upgrade to V2. It went very smoothly without any issues.

I like the new login screen! Looks much nicer than the old one.

Thank you!

commented

Hello
I did according to your description. When trying to log in I have a white screen, in error.log it gets this:

[php7:error] [pid 5429] [client 10.0.4.167:49397] PHP Parse error: syntax error, unexpected '--' (T_DEC) in /var/www/html/oauth/config_db.php on line 3

My PHP version: PHP 7.3.19-1~deb10u1

Please help me. Thank you.

Sorry about my English

======

Problem solved. Sorry for the confusion