Updating / Upgrading from Previous Versions

Customers whose support and maintenance is up-to-date are eligible to upgrade from an older version of the software to a newer versions. However, during the installatoin process the installer program for Directory Update, Directory Manager, Directory Search, and Directory Password does not provde a direct upgrade path from an older version.

Keep in mind that almost all configuration and customization work is performed via XML files. Most of these files can be retained between versions.

Files you can retain between versions

  • DirectorySettings.XML
  • AddressSettings.XML
  • Subsettings.XML

You can not retain older versions of the AppSettings.XML file, the dll, css, ascx, or aspx files. You must use the new versions of these files.

The most common support problem we see from customers during upgrades is that they accidentally keep older versions of the files that they should not have retained.

Update / Upgrade Process

The upgrade from an older version to a newer version is essentially an uninstall and reinstall. The following is an example for upgrading Directory Update (v1.6 and later), but these steps can be used for Directory Manager and Directory Search as well.

  1. Backup the c:\inetpub\wwwroot\DirectoryUpdate folder
  2. In Control Panel, remove Directory Update
  3. Delete the c:\inetpub\wwwroot\DirectoryUpdate folder
  4. Follow the instructions to install the new version
  5. Create a dedicated application pool for Ithicos Applications (such as IthicosAppPool)
  6. Test the new installation with the default files
  7. Make a backup of the default XML files so that you have the original files
  8. Edit the new AppSettings.XML to recustomize any settings you may have made. You can use your old AppSettings.XML file as a guide.
  9. Test
  10. Restore your original DirectorySettings.XML (and AddressSettings.XML file if applicable)
  11. Test using the restored XML file

Upgrading Directory Update v1.6 and earlier

The XML files with Directory Update v1.6 and earlier are not compatible with newer versions of Directory Update. You must completely remove the old version and customize the new files that come with the new version.

  1. Backup the c:\inetpub\wwwroot\DirectoryUpdate folder
  2. In Control Panel, remove Directory Update
  3. Delete the c:\inetpub\wwwroot\DirectoryUpdate folder
  4. Follow the instructions to install the new version
  5. Create a dedicated application pool for Ithicos Applications (such as IthicosAppPool)
  6. Test the new installation with the default files
  7. Make a backup of the default XML files so that you have the original files
  8. Customize the XML files that come with the new version. You can use your old XML file as a guide.
  9. Test during the customization.