Docs Developer Site

Run XP as a Windows service

Contents

Step by step guide for installing Enonic XP as Windows service

Download service wrapper

Start by download windows service wrapper binary this popular from Github repo. Rename the downloaded file to desired service name, i.e winsw-2.2.0-bin.exe → xp-service.exe

Create service config

Create new xml file named xp-service.xml in the same location as xp-service.exe file.

xml file must be named exactly the same as exe in order for the service to discover it

Refer to the config description to see all available options.

The %BASE% variable always points to the config file location:

<service>
    <id>xp-service</id>
    <name>Enonic XP Service</name>
    <description>Enonic XP distribution run as a MS Windows service.</description>
    <env name="XP_INSTALL" value="%BASE%/enonic-xp-windows-sdk-7.0.0"/> (1)
    <env name="JAVA_HOME" value="%XP_INSTALL%/jdk"/> (2)
    <env name="XP_HOME" value="%BASE%/xp-service-home"/> (3)
    <executable>%XP_INSTALL%/bin/server.bat</executable>
    <log mode="roll-by-size-time"> (4)
        <sizeThreshold>10240</sizeThreshold>
        <pattern>dd-MM-yyyy</pattern>
        <autoRollAtTime>00:00:00</autoRollAtTime>
        <keepFiles>7</keepFiles>
    </log>
    <serviceaccount> (5)
        <domain>***user domain***</domain>
        <user>***user name***</user>
        <password>***user password***</password>
        <allowservicelogon>true</allowservicelogon>
    </serviceaccount>
</service>
1 XP_INSTALL sets the location of your unzipped enonic XP distribution
2 JAVA_HOME specifies location of Java within the XP distro (system-wide JAVA_HOME will be used if omitted)
3 XP_HOME defines the location of Enonic XP home folder (defaults to %XP_INSTALL%/home)
4 log rotates log using <pattern> provided by both date and file size
5 serviceaccount specifies user account (and password) that the service will run as (allowservicelogon will automatically be set to true for specified user)
To know your user name and domain type set user in cmd and hit enter

Using service

You need to start cmd.exe with administrator permissions to run service commands

Installing

First, we need to install our new service. Run the following command:

xp-service.exe install

Verify that the service was installed by looking at the output:

2019-06-20 18:09:38,107 INFO  - Installing the service with id 'xp-service'

where xp-service.exe is the name of the service wrapper you downloaded earlier.

Checking status

You can check its status now by running following command:

xp-service.exe status

If you have not already started the service, you should see the following:

Stopped

Starting

Service is stopped by default and we need to start it with the following command:

xp-service.exe start

You should see something like this in the output:

2019-06-20 18:12:44,698 INFO  - Starting the service with id 'xp-service'

Stopping

To stop the service type:

xp-service.exe stop

You should now see something like this:

2019-06-20 18:17:14,588 INFO  - Stopping the service with id 'xp-service'

Uninstalling

To uninstall the service type:

xp-service.exe uninstall

Should produce output as follows:

2019-06-20 18:18:02,356 INFO  - Uninstalling the service with id 'xp-service'

Contents