Differences

This shows you the differences between two versions of the page.

--- 261:upgrade_from_712 [2026/04/15 16:39] – [Execute Manual Actions] Weinlein, Thomas
+++ 261:upgrade_from_712 [2026/04/22 12:35] (current) – [How to upgrade to version 26.1] Weinlein, Thomas
@@ Line 4: / Line 4: @@
 Please [[stages-support@ul.com|contact our customer care team]] to request an upgrade of your Stages Managed Service instance.
+If you use a customized metamodel on your Stages Managed Service instance, it needs to be adapted to v26 by your Stages product consultant first.
 //Note: all process release automations have to be finished before an upgrade can be performed.//
+(see Report [[reports:start#running-process-release-automations|Running Process Release Automations]])
+//Note: An existing SAML connection needs to be reestablished, by registering new URLs at the IDP server.//
 ===== Upgrade your system to at least Stages 7.12.5.0 =====
@@ Line 36: / Line 41: @@
 === server.xml migration ===
-Remove the following lines from conf/server.xml
+Remove the following lines from ''$STAGES_CONF/server.xml''
-<code xml $STAGES_CONF/server.xml>
+<code xml>
 <Realm className="org.apache.catalina.realm.CombinedRealm" >
     <Realm className="de.methodpark.stages.containerauth.SSLAuthenticatorRealm" roles="pki_user"/>
@@ Line 47: / Line 52: @@
 and
-<code xml $STAGES_CONF/server.xml>
+<code xml>
 <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
 </code>
@@ Line 53: / Line 58: @@
 remove the Context elements with path="/stages" and path="/reporting":
-<code xml $STAGES_CONF/server.xml>
+<code xml>
 <Context path="/stages" docBase="stages" cookies="true">
 [...]
@@ Line 64: / Line 69: @@
 In case one of the Connectors are configured to use protocol "org.apache.coyote.http11.Http11Nio**2**Protocol" replace that by "org.apache.coyote.http11.Http11NioProtocol"
-<code xml $STAGES_CONF/server.xml>
+<code xml>
 <Connector port="[...]"
 protocol="org.apache.coyote.http11.Http11NioProtocol"
@@ Line 75: / Line 80: @@
 >//In case SAML SSO is enabled please ensure the idp-metadata.xml file is available in ''$CONF_STAGES''.//
-Stages comes with a new authentication framework which also brings a new format to configure the available authentication methods.
+The ACS URLs changed and because of that the information about Stages in the IDP must be updated. Best case is to take the sp-metadata.xml file and import it on the IDP. Certificates should stay the same.
-Execute the upgradeConfig.sh
+The authentication section in the ''config.xml ''file needs to be migrated to a new format. The basic conversion can be done by the following script call. Please review the results in detail and add missing information as the ''idp-metadata.xml'' file from the SAML IDP.
+The original ''config.xml'' will be backed up as ''config.before-26.1.xml''.
+<code bash>
+$STAGES_ROOT/bin/upgradeConfigXml.sh|bat
+</code>
 === Database access configuration migration ===
+The ''conf/database.properties'' file used in Stages 7.12 and earlier is no longer in use. Database connection settings are now configured in ''conf/config.properties'' and ''conf/secret.properties'' with the following property keys:
+<code properties config.properties>
+database.driver.class.name=
+database.jdbc.url=
+</code>
+They are similar to these properties from conf/database.properties: torque.database.default.driver, torque.database.default.url
+<code properties secret.properties>
+database.username=
+database.password=
+</code>
+and those are the like torque.database.default.username, and torque.database.default.password.
+>Add rewriteBatchedStatements=true as parameter to database.jdbc.url if you are using MySQL.