Home Contact Download
LSC logo
Open source connector to synchronize identities to a LDAP directory from any data source including any database with a JDBC connector, another LDAP server or flat files ...
Download  |  Read more...  |  Get started!

Upgrading from 1.2.* to 2.0

The upgrade process needs:

  • binary software update
  • configuration

Differences between 1.2 and 2.0

The main difference is the configuration file format that has moved from properties to XML. Properties is still supported but will be deprecated soon.

LSC provides a way to convert properties configuration file to XML structure through the -x command line flag:

$ lsc -f etc -x

Please note the new LDAP connector requires that the full DN be provided, i.e.: the DN with naming context, whereas previous versions require that DN must be cut without naming context DN.

Troubleshooting

If you have any trouble upgrading, don't panic.

First, have a look at your output to see if you see any errors you can fix easily.

If not, change the log priority in etc/logback.xml to DEBUG on all applicable lines, and re-try the step that was failing. If this output doesn't help you solve the problem, keep it because it will be useful to get help.

For any questions, or to get help upgrading, subscribe to the users mailing list and ask for help there. Make sure to send your configuration, exact versions (old and new) and a description of your problem. Attaching the DEBUG output is always helpful.

Alternatively, you can ask for help on IRC. See the Community page for details.