Restart EnterWorks Services - EnterWorks - Match_and_Merge - Precisely_EnterWorks - Sales_and_Services_Portal - 3 - 3.1

EnterWorks Fusion

Product type
Software
Portfolio
Verify
Product family
EnterWorks
Product
Precisely EnterWorks > Match and Merge
Precisely EnterWorks > Fusion
Version
3.1
Language
English
Product name
Precisely EnterWorks
Title
EnterWorks Fusion
Copyright
2023
First publish date
2007

The Process of Restarting EnterWorks Services

The scripts for starting and stopping EnterWorks services on Windows servers are:

  • Start Enterworks.cmd

  • Stop Enterworks.cmd

They are installed on each server that contains non-3rd party components, (EnterWorks Server, microservices, Utilities, and EPX). These scripts will call the appropriate component Stop and Start scripts to stop and start the services running on that server. This may include one or more of the following commands:

  • EPIM Stop.cmd and EPIM Start.cmd: Stop and start the EnterWorks Server services.

  • EPX Stop.cmd and EPX Start.cmd: Stop and start the EPX services.

  • Microservices Stop.cmd and Microservices Start.cmd: Stop and start the microservices.

The component scripts will only stop and start the corresponding services that have been configured on the server. Some components may be installed on more than one server. For example, the EPIM Stop.cmd and EPIM Start.cmd scripts on one server might stop and start the EnterWorks Tomcat and JBoss Controller processes, while the same scripts on another server might stop and start the JBoss Worker processes.

The Start Enterworks.cmd and Stop Enterworks.cmd command scripts on each server are located in: <install directory>\Enterworks\bin.

When you run any start or stop scripts, run them as Administrator.

It is important to stop and start services in the correct order, depending on your system's configuration. See the configuration-specific documentation provided to you by your EnterWorks account representative for more information about the stop and start orders for services.

Warning: EPX must be stopped first and started last, otherwise EPX will continue attempting to interact with Tomcat and repeatedly fail, which causes invalid workflow processing.
Warning: Unless directed to do so, do not restart third-party applications such as RabbitMQ. If you do need to restart them, all EnterWorks components on all servers must also be restarted. The third-party applications must be running if any EnterWorks services are running, so the third-party applications are the last to be stopped and the first to start.

The proper order for stopping the EnterWorks components is:

  1. EPX
  2. EnterWorks2020
  3. EPIM
  4. Third-party applications – only if necessary

The proper order for starting the components is:

  1. Third-party applications – only if they have been stopped
  2. EPIM
  3. EnterWorks2020
  4. EPX

Every time the EnterWorks services are started using the <XXX> Start.cmd scripts, system log files are moved to an archive folder whose name is comprised of the current year, date, and time. The archive folders are stored in:

<drive>:\Enterworks\logs\archive

For example:

<drive>:\Enterworks\logs\archive\2019-03-14@15-23-43-84

might hold the following folders:

  • DAMReportUtility

  • EnableServer

  • EPX

  • MonitorDAMDrop

  • RegenerateDAMVariant

which would contain log files for those components of EnterWorks.

Periodically, older archive directories should be removed to prevent the archives from becoming large enough to impact EnterWorks system's efficiency.

To stop all EnterWorks Services

To stop all EnterWorks services on all servers in an environment, perform these steps on each server:

  1. Open File Explorer and go to:
    <drive>:\Enterworks\bin
  2. Right-click Stop Enterworks and select Run as Administrator.
  3. A command prompt will appear and services will begin stopping.
  4. Once the script is finished, verify that no EnterWorks related services are still running.
    1. Open Task Manager and select the Processes tab.
    2. Right-click either CPU or Memory on the header to bring up the list of available columns.
    3. Select Command line.
    4. Expand the width of the Command line column until you can see the path and name of any running processes.
    5. Verify that the following processes do not appear in the list:
      • Commons Daemon Service Runner: Any that have EnableServer in the file path.

      • enable-<serviceName>-service

      • Java(TM) Platform SE Binary: Any that have Enterworks or EPX in the file path.

    6. If any of the listed processes appears, right-click the process and select End Task.

EnterWorks services are now stopped.

To start all EnterWorks Services

Servers need to be restarted in a particular order, depending on the services they host.

Sequence Services Hosted Comments
1

EnableServerTomcat

EnableServerWildflyController

If the EnableServerTomcat service is not collocated with the EnableServerWildflyController service, restart one immediately after the other.
2, 3, or 4 EnableServerWildflyWorker<n> If the Worker services are on more than one server, restart one immediately after the other.
2, 3, or 4

EPXTomcat

EPXJboss

 
2, 3, or 4 enable-<name>-service  
5 enable-web-server-service If the enable-web-server-service is on its own server, it should be started last. If it is collocated with other microservices, it will be started last by the script.

To start all EnterWorks services on all servers in an environment, repeat the following steps on each server:

  1. Open File Explorer and go to:
    <drive>:\Enterworks\bin
  2. Right-click Start Enterworks and select Run as Administrator.
  3. A command prompt will appear indicating that the services are starting. This prompt will close once all services have been started.
  4. Verify that the services have been started by opening the Services control panel and confirming that all Enable* and enable* services (that have not been disabled) have a status of Running.

The EnterWorks services have been started.