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 containing 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 regarding the stop and start orders for services.

In general, the proper order for stopping the EnterWorks components is:

  1. EPX

  2. EnterWorks2020

  3. EPIM

The proper order for starting the components is:

  1. EPIM

  2. EnterWorks2020

  3. EPX

Typically, when EnterWorks is running on Windows, 3rd party applications, (such as Elasticsearch, RabbitMQ, and MongoDB), are not restarted. If they are restarted, all EnterWorks components on all servers must also be restarted.

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 instance: 

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

might hold the following folders:

  • DAMReportUtility

  • EnableServer

  • EPX

  • MonitorDAMDrop

  • RegenerateDAMVariant

which would contain logfiles 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 on all servers in an environment, perform the following steps on each server:

    1. Open File Explorer and navigate to:

      <drive>:\Enterworks\bin

    2. Right-click Stop Enterworks and select Run as Administrator.

    3. A command prompt will appear and services will start shutting down.

    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 EnableServer or EPX in the file path.

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

    EnterWorks services are now shut down.

  • 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 navigate 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.