Starting the Server

Version 21.0.8126


Starting the Server

Version 21.0.8126


ArcESB is built on top of an application framework that provides Web services, authentication, encryption, and automation facilities. The application can be hosted on any Windows-based or Java-based Web server. Both the Windows and Java editions include a stand-alone server, so no external server is required to host the application.

Windows Edition

The Windows edition comes with an embedded Web server. To get up and running with the stand-alone server, follow the steps below.

  1. Launch the server (if it is not already running) either through the Windows Start Menu or by running ArcESB.exe in the installation directory.
  2. If the web UI does not automatically open in a browser, manually launch the UI:
    • Double-click the Arc icon in the system tray.
    • Or, right-click the Arc icon and select Start Application.
    • Or, use a browser to manually navigate to the address and port where the server is listening (the default port is 8001).

See the Embedded Server section for information on enabling SSL/TLS and other configuration options for the embedded web server.

See the Configuration in IIS for information on hosting Arc in IIS.

Java Edition

The Java edition comes bundled with a Web server, built on top of Jetty, to support simple cross-platform deployment. This stand-alone web server is launched by running the arcesb.jar file located in the installation directory, for example:

java -jar arcesb.jar

The configuration for this Web server is contained within the arcesb.xml file found in the “webapp” folder of the installation directory. This configuration XML file can be modified according to specific deployment needs. The file contains commented-out examples of server modifications, and any valid Jetty XML configuration syntax is supported.

Additionally, Arc also provides a service script which may be used to set up a systemd or init.d service on unix systems.

Arc can also be deployed to any Java servlet container. See the Java Edition section for step-by-step deployment guides to several major Java Web servers.

Linux Service Configuration

Follow these steps to ensure that your Linux install of ArcESB functions as expected:

  1. When you install ArcESB, ensure that the user performing the installation has read and write permissions for the install directory. The root user works fine for this.

  2. Run the service script. By default, the path to this script is /opt/arcesb/service.sh.

  3. After running the service script, start the service according to the service manager your linux distribution uses:

    • For init.d, run sudo service arcesb start.
    • For systemd, run sudo systemctl start arcesb.

Note: No matter how you choose to deploy Arc, the files and folders within AppDirectory must be readable and writable by the user running the application. The service installer included with the Java Edition setup uses ‘arcesb’ as this user.

If the application was previously run as a different user and you wish to restore the necessary permissions for an ‘arcesb’ user to run the application, run this command (changing the directory if needed):

sudo chown -R arcesb:arcesb /opt/arcesb