Upgrading from EcoSys prior versions to EcoSys 9.0 or greater - EcoSys - Installation & Upgrade - Hexagon

EcoSys Upgrade

Search by Category
Installation & Upgrade
EcoSys Version

Update EcoSys License File

EcoSys 8.8 and prior versions only support named user licensing which grants access to a limited number of specific/named users. Starting with version 9.0, concurrent licensing is also supported (in addition to named user) which allows users to lease an available license upon login that will be returned to the pool upon logout or session expiration. As such, a new EcoSys FMLicense.properties license file is required for use with versions 9.0+ even if concurrent licensing is not being utilized. To request a new license file that is compatible with versions 9.0+, email epp90compatiblelicenserequest.ecosys.ppm@hexagon.com. Once it is received, replace the existing FMLicense.properties file in the ESFM_HOME directory with the new 9.0+ compatible license file.

Update EcoSys Logging

EcoSys 8.8 and prior versions use Log4j for logging which utilizes a log4j.properties file to configure the settings such as log file names, locations, and sizes. Starting with version 9.0, EcoSys uses Log4j2 which instead utilizes a log4j2.xml file to configure the settings.

If SAML authentication is being used, the commented-out sections in the EcoSys log4j2.xml file for SAML must be uncommented and the log file paths in this file might need corrections.

EcoSys provides a tool to convert the log4j.properties to a log4j2.xml file.

  1. Copy the alt\tools\ecosys-install-utils-log4jmigrator.jar to the c:\EcoSys\ directory

  2. Open a command window and go to the c:\EcoSys\ directory.

  3. Run java -jar ecosys-install-utils-log4jmigrator.jar <path-to-ESFM_HOME>

    Example: java -jar ecosys-install-utils-log4jmigrator.jar C:\EcoSys\ESFM_HOME

    Java must be on the system path.

  4. Once complete, verify the log4j2.xml file in the ESFM_HOME directory for proper file paths, log settings, and roll over sizes.

Update Tomcat

  1. Remove the log4j-1.2.17.jar from the Tomcat \lib directory.

Update JBoss

  1. Remove the \log4j directory from the \modules\com\ecosys directory.

    For environments that use the P6 Adapter, remove the \modules directory from \com\primavera and re-install the Adapter using the steps provided in the P6 Adapter installation guide.

Update WebSphere

  1. Log in to the WebSphere Administration Console.

  2. Navigate to Environment > Shared Libraries.

  3. Click on the shared library that has been created for EcoSys.

  4. Remove the reference to the log4j-1.2.17.jar file from the Classpath section.

  5. Click OK and SAVE.

Update WebLogic

  1. Log in to the WebLogic Administration Console.

  2. Navigate to Environment > Servers.

  3. Click on the managed server running EcoSys.

  4. Navigate to the Server Start tab.

  5. Click on the Lock & Edit button.

  6. Remove the reference to the log4j-1.2.17.jar file from the Class Path section.

  7. Click SAVE and then Activate Changes.