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:
- Stop all EnterWorks services.
- Inject the .jar file into the
epimserver.ear
file on each server that hostsEnableServerTomcat
,EnableServerWildflyController
, orEnableServerWildflyWorker
:- Copy the class .jar files to the folder:
<drive>:\Enterworks\lib\Services\lib
- Run the following script as an administrator:
<drive>:\Enterworks\bin\DeployServicesJar.bat
- Copy the class .jar files to the folder:
- Provide access to the .jar files to EPX:
- On the server hosting
EnableServerWildflyController
, run the script:<drive>:\Enterworks\bin\CopyEpimJarsToEPX.bat
- If EPX is not on the same server as
EnableServerWildflyController
, copy the files in
from the server hosting<drive>:\Enterworks\lib\Services\lib
EnableServerWildflyController
to the same folder on the server hosting EPX. - 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).
- If EPXTomcat is configured as 32-bit:
- Open the following file in an editor:
<drive>:\Enterworks\EPX\bin\EPX_Web_Wrapper.conf
- The classpaths are listed in the file in the format:
Add the classpaths for your .jar files to the bottom of the file, using the same format. To get thewrapper.java.classpath.<classpath-number>=<path-to-custom-jar>
<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.
- Open the following file in an editor:
- Or, if EPX Tomcat has been configured as 64-bit:
- Open the following file in an editor:
<drive>:\Enterworks\EPX\bin\EPXTomcatService64.bat
- Add your classpaths to the bottom of the file, in the format:
set "CLASSPATH=%CLASSPATH%;%ENTERWORKS_LIB%/EnableServer/lib/<jar-filename>.jar
- Run the script, passing in "remove" as a parameter (no quotes):
<drive>:\Enterworks\EPX\bin\EPXTomcatService64.bat remove
- Run the script again, passing in "install" as a parameter (no quotes):
<drive>:\Enterworks\EPX\bin\EPXTomcatService64.bat install
- 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:
- Open the Services window, right-click EPXTomcat, and select Properties. The Properties window will appear.
- Open the Log On tab.
- Select This account and enter the network service account's name and password.
- Click Apply.
- Open the following file in an editor:
- On the server hosting
- Restart all EnterWorks services.