Preserving customizations

The upgrade process automatically preserves the M-Business database from your previous installation, if you request this during the installation process. If you are installing the new version of M-Business Server in the same location as the previous version, the upgrade process also preserves changes you have made in configuration files.

You must manually migrate all application customizations after you run the M-Business Server installer.

If you are installing the new version of M-Business Server to a new location, you must manually restore configuration file settings as well.

To restore configuration file settings after upgrade is complete
  1. Compare each of the files in the backed up <M-Business_Home>/conf directory from the previous installation with its newly installed counterpart.

    Carefully note any differences in settings that you find.

  2. Replace any values that were manually edited in the previous installation's files.

    For example, if in a previous release you changed the MaxClients setting in the sync.conf.default file to 100 and you want to retain this setting, you will need to make this exact change in the new sync.conf.default file.

    Caution

    Because the settings and sequence of settings in these files changes from version to version, it is important that you not simply copy your backed up configuration and default files over the newly installed configuration and default files. To do so could overwrite new settings or could alter the sequence of critical settings.

  3. Save your changes.

  4. After you have made all the configuration file changes, run the defaults_setup.bat script from the <M-Business_Home>/conf directory.

  5. Start or restart M-Business Server services.

    For detailed instructions on starting, stopping, and restarting M-Business Server, refer to the Administrator Guide for M-Business Anywhere Server. See Configuring M-Business Server after installation.

To restore other customizations after upgrade is complete
  1. Carefully examine the files in the backup copy of the earlier installation to identify those that implement M-Business Anywhere customizations.

    In particular, look for:

    • Certificate files in <M-Business_Home>/conf/
    • Application files under <M-Business_Home>/tomcat/
    Tip

    The files in the <M-Business_Home>/bin/ directory have a timestamp that reflects the date on which that version of M-Business Anywhere was released. Any files that have a later timestamp may reflect customizations.

  2. Move or copy all the files that support your M-Business Anywhere customizations from the previous installation to the corresponding location in the new installation.