Upgrading the EcoSys Application on Tomcat - EcoSys - Installation & Upgrade - Hexagon

If you are using Tomcat 9.0.88 or above and are licensed for the SAP Adapter, copy the stax2-api-###.jar and the woodstox-core-###.jar from that releases build's batch\lib folder to the tomcat\lib folder.

Use the following steps to update the EcoSys web application on the Tomcat application server.

1. Stop the Tomcat service.

2. Delete the following folders:

   • <TOMCAT_HOME>\work\Catalina\localhost\ecosys

   • <TOMCAT_HOME>\webapps\ecosys

3. Replace the ecosys.war file in <TOMCAT_HOME>\webapps with the ecosys.war file in the \deploy folder of the EcoSys application/upgrade package.

4. When upgrading from EcoSys 9.1 to 9.2, navigate to ...\Program Files\Apache Software Foundation\Tomcat\conf and open the server.xml with a text editor.

   1. Add the following two attributes to the jdbc/esfm resource:

      rollbackOnReturn="false"

      enableAutoCommitOnReturn="false"

   For example,

   <!-- ESFM webapp Context -->

   <Context path="/ecosys" docBase="ecosys" debug="0" crossContext="true">

   <Resource name="jdbc/esfm" auth="Container" type="javax.sql.DataSource"

   maxTotal="200" maxIdle="10" maxWaitMillis="-1" removeAbandonedOnBorrow="true" removeAbandonedTimeout="1200"

   logAbandoned="true" username="fmuser" password="xxxxxx"

   driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"

   url="jdbc:sqlserver://localhost:1433;database=esfm" accessToUnderlyingConnectionAllowed="true" enableAutoCommitOnReturn="false" rollbackOnReturn="false"/>

   </Context>

5. Start the Tomcat service.

To upgrade from Ecosys 8.8 or prior versions to Ecosys 9.0 or greater, refer to Upgrading from EcoSys 8.8 or prior to EcoSys 9.0 or greater (see Upgrading from EcoSys prior versions to EcoSys 9.0 or greater).

Remove the Java option -XX:MaxPermSize if previously set, as it is no longer required.