Deploy JAR Files - Precisely_EnterWorks - EnterWorks - 11.0

EnterWorks Guide

Product type
Software
Portfolio
Verify
Product family
EnterWorks
Product
Precisely EnterWorks
Precisely EnterWorks > EnterWorks
Version
11.0
Language
English
Product name
Precisely EnterWorks
Title
EnterWorks Guide
Copyright
2024
First publish date
2007
Last updated
2025-01-07
Published on
2025-01-07T07:44:20.997352

If a .jar file is new to EnterWorks or it has been modified since it was last deployed to EnterWorks, it must be deployed.

To deploy one or more .jar files:

  1. Stop all EnterWorks services.
  2. Inject the .jar file into the epimserver.ear file on each server that hosts EnableServerTomcat, EnableServerWildflyController, or EnableServerWildflyWorker:
    1. Copy the class .jar files to the folder:
      <drive>:\Enterworks\lib\Services\lib
    2. Run the following script as an administrator:
      <drive>:\Enterworks\bin\DeployServicesJar.bat
  3. Provide access to the .jar files to EPX:
    1. On the server hosting EnableServerWildflyController, run the script:
      <drive>:\Enterworks\bin\CopyEpimJarsToEPX.bat
    2. If EPX is not on the same server as EnableServerWildflyController, copy the files in
      <drive>:\Enterworks\lib\Services\lib
      from the server hosting EnableServerWildflyController to the same folder on the server hosting EPX.
    3. If any of the code in a .jar file is going to be accessed from EPX, such as by a workflow, scheduled import preprocess, or scheduled export postprocess, then the .jar file needs to be added to the appropriate classpath configuration file. To do so, first Determine if EPXTomcat is Configured as 32-bit or 64-bit).
    4. If EPXTomcat is configured as 32-bit:
      1. Open the following file in an editor:
        <drive>:\Enterworks\EPX\bin\EPX_Web_Wrapper.conf
      2. The classpaths are listed in the file in the format:
        wrapper.java.classpath.<classpath-number>=<path-to-custom-jar>
        Add the classpaths for your .jar files to the bottom of the file, using the same format. To get the <classpath-number>, increment the <classpath-number> of the last entry in the file. The <classpath-number> must be unique and there should be no gaps in the number sequence.
    5. Or, if EPX Tomcat has been configured as 64-bit:
      1. Open the following file in an editor:
        <drive>:\Enterworks\EPX\bin\EPXTomcatService64.bat
      2. Add your classpaths to the bottom of the file, in the format:
        set "CLASSPATH=%CLASSPATH%;%ENTERWORKS_LIB%/EnableServer/lib/<jar-filename>.jar
      3. Run the script, passing in "remove" as a parameter (no quotes):
        <drive>:\Enterworks\EPX\bin\EPXTomcatService64.bat remove
      4. Run the script again, passing in "install" as a parameter (no quotes):
        <drive>:\Enterworks\EPX\bin\EPXTomcatService64.bat install
      5. If your EnterWorks system uses a network service account that is not mapped to a drive, you must set the EPXTomcat service's Log On properties:
        1. Open the Services window, right-click EPXTomcat, and select Properties. The Properties window will appear.
        2. Open the Log On tab.
        3. Select This account and enter the network service account's name and password.
        4. Click Apply.
  4. Restart all EnterWorks services.