Configuring Tomcat for EcoSys - EcoSys - Version 8.6 - Installation - Hexagon PPM

EcoSys Installation

PPMProduct
EcoSys
PPMCategory_custom
Installation & Upgrade
Version_EcoSys
8.6

Installing and deploying EcoSys on the Tomcat application server. This install was done using the Tomcat Windows Service Installer.

When using the instructions below, replace any Tomcat versions numbers with the version of Tomcat being used.

Java Configuration for Tomcat

  1. Navigate \Program Files\Apache Software Foundation\Tomcat\bin and run Tomcat8w.exe

    The Java Virtual Machine listed should be the one selected at Java_JDK_Installation.

  2. Add the two java options in the image above and enter the C:\EcoSys\ESFM_HOME directory path.

    -DESFM_HOME=C:\EcoSys\ESFM_HOME

  3. Set the initial memory pool and the maximum memory pool to the size recommended in the EcoSys Server Sizing Recommendations document.

Adding a JDBC Connection Pool

  1. Navigate to \Program Files\Apache Software Foundation\Tomcat\conf and open the server.xml with a text editor.

  2. Choose the database connection string below that matches the database environment and copy and paste it above the closing </host> tag.

    For ORACLE:

    <!-- ESFM webapp Context -->
    <Context path="/ecosys" docBase="ecosys" debug="0" crossContext="true">
    <Resource name="jdbc/esfm" auth="Container" type="javax.sql.DataSource"
    maxTotal="100" maxIdle="10" maxWaitMillis="-1" removeAbandonedOnBorrow="true" removeAbandonedTimeout="600"
    logAbandoned="true" username="fmuser" password="fmuser"
    driverClassName="oracle.jdbc.OracleDriver"
    url="jdbc:oracle:thin:@localhost:1521:global" accessToUnderlyingConnectionAllowed="true"
    testOnBorrow="true" validationQuery="SELECT 1 FROM DUAL" validationQueryTimeout="2"/>
    </Context>

    For MSSQL:

    <!-- ESFM webapp Context -->
    <Context path="/ecosys" docBase="ecosys" debug="0" crossContext="true">
    <Resource name="jdbc/esfm" auth="Container" type="javax.sql.DataSource"
    maxTotal="100" maxIdle="10" maxWaitMillis="-1" removeAbandonedOnBorrow="true" removeAbandonedTimeout="600"
    logAbandoned="true" username="fmuser" password="fmuser"
    driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
    url="jdbc:sqlserver://localhost:1433;database=esfm" accessToUnderlyingConnectionAllowed="true"/>
    </Context>

    It is important to configure removeAbandonedTimeout to be greater than the maximum of datasource.read.timeout and datasource.update.timeout located in the FMServerSettings.properties file.

Copying Library Files

  1. Copy the intgserver-wrapper.jar and the log4j-1.2.17.jar from the C:\EcoSys\alt\lib folder to the \Program Files\Apache Software Foundation\Tomcat\lib folder.

  2. Copy the correct database JDBC driver into \Program Files\Apache Software Foundation\Tomcat\lib folder.

    If Primavera API is being used, please refer to EcoSys P6 Adapter Installation document.

Deploying EcoSys

  1. Copy the ecosys.war file from the C:\EcoSys\deploy folder into the \Program Files\Apache Software Foundation\Tomcat\webapps folder.

  2. Start Tomcat and the ecosys.war file will deploy.