Standard IWDS upgrade procedure

  1. Stop any IWDS synchronizations that may be running as cron jobs or as Windows scheduled tasks.

  2. Save your IWDS working folder and configuration items:

    1. First of all you must save your working directory → this is the parent directory that contains the configuration, log and synchronization files located themselves in the following 3 directories: ./conf; ./log; ./out. To locate your working directory, go to the top left hand side of the IWDS application ("File" menu > "Change working directory")

    2. Retrieve the certificate and its passphrase / for security (if necessary also take screenshots of LDAP accesses and group mapping) in case there is an incident during the update.

    3. If using a Virtual Machine with snapshots, take a snapshot thereby allowing you to rollback to a working configuration if necessary

  3. Uninstall and reinstall:

    1. Uninstall the previous version of IWDS, without removing your old folders (they should have been copied somewhere for safety)

    2. Reinstall the new version in the same location

  4. Check the configuration:

    1. IWDS should find the previous information from the "working directory" and automatically retrieve the configuration items. If however IWDS doesn't locate the working directory then indicate it via the "file" menu.

    2. Verify that all LDAP connections and group mappings are present.

    3. If everything is OK, perform a diff/sync operation to make sure IWDS is working correct

  5. Perform a diff/sync operation and make sure IWDS is correctly working.

  6. You can delete the back-up.

XML incompatibilities

Some version changes show XML incompatibilities with previous XML file formats located in the /out directory. If you encounter Character errors while parsing the XML files, rename your /out directory to /old and perform a new retrieve/diff/sync cycle.

From version 1.x to version 2.x

Backup you current IWDS data before installing

Before upgrading IWDS to version 2.x it is highly recommended to make a backup of your current IWDS data, i.e. of your IWDS configuration directory. Do it for each of your configuration directory if you are using several configurations.

You will then be able to reuse those directories with version 2.x

Refresh your IWDS data after installation

Once IWDS 2.x is installed and the configuration directory is defined, it is mandatory to “refresh” your inWebo and LDAP user data as the format of the files used to store these data changes with version 2.x.

User data files produced by previous versions of IWDS can no longer be used to make a “Diff” or do a “Sync”.

Batch mode updated

Beside the format of user data files, version 2.x also features slight changes in the way IWDS operates in batch mode. Please check the “Batch mode” version of the manual for more information.