erwin Evolve 2020.2.1 - Installation Guide

Appendix E - Migrating Older Models

If you are upgrading from a version of CW Suite older than 2013, you may not be able to load in some models that have come from a pre-2013 database.

This is because CW Suite 2013 introduced an updated database schema and older models are not compatible with it.

The Evolve Repository is now stricter about the quality of data that it contains. The import process checks for illegal XML characters in properties (usually caused by copying and pasting text into Evolve Suite), and issues with how Pictures and Publication Sets are encoded. As a result, if any of this data is found when you load models, then those items will not be imported.

These instances are rare, and the likelihood is that your models will be fine.

How will you know if Models are affected?

When you import a model that is affected, the Import Wizard will report exactly which data has been rejected by the import process.

This could be that a Publication Set, Picture, an object instance, or a user-defined property of an object has not been imported.

Copyright © 2022 Quest Software Inc

Recommended Procedures

If you have any existing models that you want to use with Evolve Suite 2020, do the following to ensure there are no potential conflicts before importing the models.

To fix any potential issues:

          1. On your Evolve Suite 2020 machine, launch the Command Prompt

          2. Change directories until your current directory is the erwin ‘Bin’ directory

This is usually C:\Program Files\erwin\CM10\BIN, or C:\Program Files

(x86)\erwin\CM10\BIN on 64-bit machines

          3. Run the following command to check your repository for illegal XML characters and fix any issues

validaterepository -Username:<your_CW_username>

-Password:<your_CW_password>

-Connection:<your_connection_name>

-ApplyFixes

Do not copy and paste this command, as it will not work in the command-line tool.

When you are asked to confirm if you want to run the operation, choose '(A)ll'

Your repository is updated and your models are all validated and fixed where necessary.

You can now export the models for use in Evolve Suite 2020.

Copyright © 2022 Quest Software Inc

Appendix G - Upgrading Your Database For Evolve Web Platform 2020 And Evolve Suite 2020

These instructions explain how to update your database for 2020 database.

Step 1 - Uninstall Evolve & CW Suite

1.It is recommended that you back up your database and any customisations that you have made to Evolve before commencing with the database upgrade. 

2.Uninstall any versions of Evolve and CW Suite currently installed on your system.

Step 2 - Install Evolve Suite 2020

1.Log in to your https://support.quest.com/erwin-evolve/ account and download Evolve Suite 2020.

2.Install Evolve Suite 2020 following the information detailed in the installation guide.

Step 3 - Upgrade The Database

          1. Run Command Prompt as an administrator and navigate to the 'bin' directory where Evolve Suite is installed.

          2. Type the following: ValidateRepository.exe -connection:YourConnectionName username:YourUserName password:YourPassword -upgradedb

          3. The Validate Repository tool will do various checks and will display the results of these checks as well as a prompt to commence the upgrade.

          If your user does not have DBA permissions you will see the following message:

          If you see this message you should not proceed with the database upgrade.

Step 4 - Install Evolve Web Platform 2020

1.Install Evolve WEB PLATFORM 2020 following the information detailed in the installation guide.

2.Restore any customisations that you had backed up prior to uninstalling CW Evolve.

Copyright © 2022 Quest Software Inc