Configuring IBM WebSphere Liberty for EcoSys - EcoSys - 9.4 - Installation & Upgrade - Hexagon

This configuration was done using the IBM WebSphere Liberty.

Prerequisites

• IBM WebSphere Liberty Web Profile downloaded and installed (Refer to the Supported Platform Versions for supported versions)

• An IBM Liberty Profile. If it does not exist:

  • Open a Command Prompt

  • Go to the <Liberty Install Location>\wlp\bin

  • Run the command ‘server.bat create <ServerName>’

    Example: server.bat create defaultServer

The command will return ‘Server <ServerName> created.’ when successful

• IBM Liberty installed as a Windows Server. If not already installed as a windows service:

  • open a Command Prompt

  • Go to the <Liberty Install Location>\wlp\bin

  • Run the command ‘server registerWinService <ServerName>’

    Example: server.bat create defaultServer

• A windows service has been installed with the name <ServerName>

  • Go to Services in windows and change the Startup Type from Manual to Automatic.

Setting up EcoSys

These steps will assume that the Liberty Profile name is defaultServer.

1. Go to <Liberty Install Location>\wlp\usr\servers\defaultServer

2. Edit or create the file jvm.options

   1. Add the line -DESFM_HOME=c:\ecosys\ESFM_HOME

      

3. Edit <Liberty Install Location>\wlp\usr\servers\defaultServer\server.env

   1. Add the line JAVA_HOME=<Full Path to the JAVA HOME>

      Example: JAVA_HOME=C:\Program Files\Java\jdk-21.0.6+7

4. Edit <Liberty Install Location>\wlp\usr\servers\defaultServer\server.xml

   Before the ending </server> add the following :

   <classloading useJarUrls="true" />

   <library id="jdbc">

   <file name="<PATH AND FULL NAME OF JDBC JAR FILE>.jar" />

   </library>

   <dataSource id="EcoSysDataSource" jndiName="jdbc/esfm"

   type="javax.sql.DataSource"

   isolationLevel="TRANSACTION_READ_COMMITTED"

   beginTranForResultSetScrollingAPIs="false"

   beginTranForVendorAPIs="false"

   >

   <jdbcDriver libraryRef="jdbc" />

   <properties URL="jdbc:sqlserver://localhost:1433;database=esfm;encrypt=false;trustServerCertificate=true" user="fmuser" password="fmuser" />

   <connectionManager

   maxPoolSize="200" minPoolSize="200"

   enableSharingForDirectLookups="false"

   purgePolicy="FailingConnectionOnly"

   />

   </dataSource>

   <application id="ecosys" location="ecosys.war" name="ecosys" type="war">

   <classloader commonLibrary="jdbc" />

   </application>

5. Copy the ecosys.war file from the C:\EcoSys\deploy folder into the <Liberty Install Location>\wlp\usr\servers\defaultServer\apps folder.

6. Start IBM WebSphere Liberty service