Child pages
  • Running the Server As a Service

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

During installation, an extra service directory is created in the ../application_server/ directory. This directory contains, among others, the configuration file for the service, called 'wrapper.conf'.

If the 'Setup Service' option is checked in the installer, the Service will actually be setup on the machine. By default this option is unchecked, as in most cases the service configuration will require changes.

The Service component installation comes with two files to install and uninstall the Service: install install_service.[bat/sh] and uninstall_service.[bat/sh]. 

Additional Configuration

The configuration of the Java Service Wrapper is done through the file wrapper.conf located in ../application_server/service.

(warning)  When changing the value of any any wrapper.ntservice.* property on Windows, the Service needs to be uninstalled first and reinstalled after the changes have been made.

...

If the database is running on the same machine as a Windows Service as well, it is possible to configure a dependency to it in the Java Service Wrapper configuration. The dependency can be set by adding the name of the Windows Service for the database on which the Servoy Application Service depends as a the wrapper.ntservice.dependency.x property. The 'x' at the end of the property name needs to be a sequential number, starting with 1, for each dependency.

...

When the Servoy Application server is started as a service through the Java Service Wrapper, the assignment of memory goes through the configuration of the wrapper in 'wrapper.conf', instead of through servoy_server.[bat/sh].

Below the mapping for the three relevant memory settings and their equivalent in the wrapper.conf:

  • Initial Java Heap Size > wrapper.java.initmemory=...
  • Maximum Java Heap Size > wrapper.java.maxmemory=...
  • Maximum Java Perm Size > wrapper.java.additional.4=-XX:MaxPermSize=...

For more information on the the meaning of these settings and their suggested values, see Memory Management.

...

When running multiple Servoy Application Servers as a Service on a single machine, some configuration adjustments are required to not let the different services influence eachothereach other.

Windows

The following property requires a unique value:

  • wrapper.ntservice.name (default ServoyService)

On Windows the wrapper.ntservice.displayname and wrapper.ntservice.description could be modified to further distinguish the different Windows Services from each other. Note that these two settings are just for display purposes in the Services overview in Windows and do not affect the actual operation of the services.

...

Code Block
# Application
APP_NAME="ServoyServer"
APP_LONG_NAME="Servoy Application Server"

The APP_NAME has to be unique for each Service. 

All Platforms

The wrapper.port value does not have to be unique, because the Java Service Wrapper automatically looks for a free port if the specified port is already taken.

...

The Java Service Wrapper is a bundled third party component also called Java Service Wrapper Standard by Tanuki Software. For indepth documentation in depth view of the subject have a look hereon their documentation.

The component is licensed by Servoy to be bundled and used in combination with the Servoy Application Server only. It's not allowed to use the component outside the context of the Servoy Application Server.