REQUEST PASSWORD RESET

RESET YOUR PASSWORD

OK
forgot password?
CANCEL
SHOW API DOCS NAV

REST API

API Endpoints

Enterprise

Arcentry Development

Arcentry Enterprise - Running as a Service & Logging

Arcentry Enterprise is the commercial on-premise version of Arcentry. You can learn more about it here or contact us at info@arcentry.com.

Arcentry Enterprise can run as a background service on Windows. To do so, it spawns a daemon process that controls and manages the Arcentry Enterprise process itself. Here's how it works:

Installing the Service

To install the service, open a cmd prompt with administrator privileges

Open Command as Admin

and run

arcentry-enterprise-win.exe --service install

You should see

Service Install Command Console output

Once installed, you should see the service in the task manager's service tab:

Task Manager Service Tab

as well as in Window's service panel

Windows Service Panel

From here, you can start and stop the service as well as check on its status.

Interacting with the service

The Arcentry Service can be controlled from Window's task manager or service panel (see above) or from the command line. Here you can run any of the following commands:

arcentry-enterprise-win.exe --service start arcentry-enterprise-win.exe --service stop arcentry-enterprise-win.exe --service restart

Uninstalling the Service

The service can be uninstalled by running the following command:

arcentry-enterprise-win.exe --service uninstall

Running Multiple Instances as a Service

You can install and run as many instances of Arcentry Enterprise as a service as you like. To do so, simply add a --servicename somename parameter to any service command, e.g.

arcentry-enterprise-win.exe --service install --servicename devServer arcentry-enterprise-win.exe --service start --servicename devServer arcentry-enterprise-win.exe --service install --servicename prodServer arcentry-enterprise-win.exe --service start --servicename prodServer

Logging from the Service

A Service is a background process that does not have associated console output. To allow for logging, Arcentry 1.10.0 introduces two new logging options: File and Event Viewer.

You can configure these in the Logging section of arcentry-conf.yml

# Logging logLevel: info # can be debug, info, warn or error logType: console # Can be console, file or event-viewer logDir: logs/ # Base path for logs, relative to the working directory. Only applied if logType = file

Logging to a file

Arcentry's file logging not only redirects the output of the log stream to a file, but also manages this file, creates new files if the current one gets too big and rotates the files so ensure seamless logging throughout. To use file logging, set the logType in arcentry-conf.yml to file.

You can see realtime logs by "tailing" this file. This can be done via PowerShell by running:

Get-Content arc-std-log.txt -Wait

or by using one of the techniques outlined here.

Logging to Windows Event Viewer

Windows comes with an internal event-viewer that services are expected to log to. You can access it from the start-menu by searching for "Event Viewer":

Searching for the Windows Event Viewer

Arcentry supports this option by setting the logType in arcentry-conf.yml to event-viewer.

To see Arcentry's logs, select "Windows Logs -> Application" on the left and search/filter for "Arcentry Enterprise" in the source column.

Event Viewer Output for Arcentry Service