Stages Documentation

This is an old revision of the document!

Mandatory Manual Upgrade Steps for Version 7.5

These actions need to be executed after upgrading to Stages 7.5 from previous Stages 7 versions.

Metamodel Configurations

  • Custom implementation of Check Readiness validators may need to be adjusted and recompiled against this Stages version.
  • TBD: Process Link

The new Unified Configuration version 2.5 already contains those updates.

To update your Stages configuration to Unified Configuration V2.5, or to enhance your customized metamodel to use these new features, please contact your Stages Product Consultant or sales@methodpark.com.

Manual Upgrade Steps

  • The following settings are needed in database.properties for MySQL:
    • The Connector/J driver must be used (https://dev.mysql.com/downloads/connector/j/). The Connector/J driver is compatible with MySQL 5.6 and later. Replace the existing connector in the stages/lib directory and execute update.bat/update.sh after that.
    • torque.database.default.adapter=DBMM
    • torque.database.default.driver=com.mysql.cj.jdbc.Driver
    • When using the Connector/J driver with MySQL 5.x, the “serverTimezone” parameter may be needed on some systems, too (e.g. serverTimezone=Europe/Berlin). Append it to the “torque.database.default.url”.
    • The old driver (org.gjt.mm.mysql.Driver) can still be used with MySQL 5.x
  • Delete the contents of methodpark/stages/elasticsearch/data and restart Stages after that.
    Note: On Windows “Stages Search” is a separate service that needs to be started before the Stages service. It may take some time until the search index is rebuilt and all search results can be found again.
  • In order to update the diagram font configuration please perform the following steps (only necessary if another font than the standard SourceSansPro shall be used):
    • Copy the font file, you want to use, to the conf/fonts folder
    • Add config property “diagram.font” with value=“<FontFamilyName>:<FileName>” e.g. “Source Sans Pro:SourceSansPro-Regular.ttf”
    • Run update.bat/update.sh

General Recommendations

To be safe in case of any crashes/problems during the update, back up your database (dump) and finally run the Stages update script:

  • Stop the Stages service
  • Execute the update script:
    • Windows: “…\stages\bin\update.bat”
    • Linux: “…/stages/bin/update.sh”
  • Restart the Stages service