Starting the Server

Version 22.0.8209


Starting the Server

Version 22.0.8209


CData Arc 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 start up and run the stand-alone server, follow these steps:

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

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

See Configuration in IIS for information about hosting Arc in IIS.

Java Edition

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

java -jar arc.jar

The configuration for this web server is contained within the arc.xml file, which is located int the webapp folder of the installation directory. You can modify this configuration XML file according to your specific deployment needs. The file contains commented-out examples of server modifications, and any valid Jetty XML configuration syntax is supported.

In addition, Arc provides a service.sh script that you can use to set up a systemd or init.d service on UNIX systems.

You can also deploy Arc to any Java servlet container. See Java Edition for step-by-step deployment guides to several major Java web servers.

Linux Service Configuration

Follow these steps to ensure that your Linux installation of Arc functions as expected:

  1. When you install Arc, ensure that the user who is performing the installation has read and write permissions for the install directory. The root user works fine for this.
  2. Run the service.sh script. This script is located at the root of setup.zip, so if it was extracted to /opt/arc, the path to this script is /opt/arc/service.sh.
  3. After you run the service.sh script, start the service according to the service manager that your Linux distribution uses:

    • For init.d, submit this command: sudo service arc start
    • For systemd, submit this command: sudo systemctl start arc

Note: No matter how you choose to deploy Arc, the files and folders within ApplicationDirectory must be readable and writable by the user who is running the application. The service installer that is included with the Java edition setup uses cdataarc as this user.

If the application was run previously as a different user and you want to restore the necessary permissions for a cdataarc user to run the application, run this command (changing the directory if needed):

sudo chown -R cdataarc:cdataarc /opt/arc