Configure EPXTomcat to be a 64-bit Service - Precisely_EnterWorks - EnterWorks - 11.0

By default, the EPXTomcat service is installed as a 32-bit application and can be configured to use up to 4 GB of memory. If you need more memory, EPXTomcat can be configured as a 64-bit application. Different configuration files are used to define the classpath for the service depending upon whether it is configured as 32-bit or 64-bit.

To determine if EPXTomcat has been configured as 32-bit or 64-bit, see: Determine if EPXTomcat is Configured as 32-bit or 64-bit.

To configure EPXTomcat service to be 64-bit:

1. If EPX services are running, Stop EPX Services.
2. Open a command prompt as Administrator.
3. Change the current directory to:

   <drive>:\Enterworks\EPX\bin

4. Execute the command:

   wrapper.exe -r "<drive>:\Enterworks\EPX\bin\EPX_Web_Wrapper.conf"

5. Edit the file:

   <drive>:\Enterworks\EPX\bin\EPXTomcatService64.bat

   1. Update the ENTERWORKS_TOP setting to point to the <drive>:\Enterworks folder.
   2. Update the jvm max memory setting --JvmMx 6144 to have the desired maximum memory in megabytes.
   3. Change the CLASSPATH reference for jdbcBIC.jar to point to the actual folder:

      <drive>:\Enterworks\EPX\bin\agents\<server>

   4. Change the CLASSPATH reference to the standalone/configuration/conf folder to match what is specified in the file:

      <drive>:\Enterworks\EPX\bin\EPX_Web_Wrapper.conf

   5. At the bottom of the classpath statements, add:

      rem Add classpaths for any custom .jar files below this comment.

   6. Compare the classpaths defined in EPXTomcatService64.bat with the classpaths defined in the EPX_Web_Wrapper.conf file. Make sure that all the classpaths that are defined in EPX_Web_Wrapper.conf are defined in EPXTomcatService64.bat and that they have the correct .jar file version numbers. Put classpaths forany custom .jar files below the comment.
   7. Save the file.
6. Install the new EPXTomcat service wrapper by executing the command:

   EPXTomcatService64.bat install

7. If this environment is distributed and it 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.
8. Edit the file

   <drive>:\Enterworks\EPX\bin\EPX_Web_Wrapper.conf

   Add the following text right above the set of wrapper.java.classpath entries, then save the file.

   ########################################################################
   #
   #                           N O T I C E ! ! ! ! 
   #
   # This file has been supplanted by the EPXTomcatService64.bat file. Any change that
   # would have been made here needs to be made to the EPXTomcatService64.bat file and 
   # then the service must be re-installed to make those changes go into effect.
   #
   #                           N O T I C E ! ! ! ! 
   #
   ########################################################################

9. If you are in the process of installing or upgrading EnterWorks, do not start EPX Services now. If your EnterWorks system is already operational, run the following as an Administrator:

   <drive>:\Enterworks\bin\EPX Start.cmd

You have finished configuring EPXTomcat to run as a 64-bit service.