Child pages
  • Running the Server As a Service

Versions Compared

Key

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

...

When running the Servoy Application Server and the database on the same Windows machine, both as a Windows Service, then a dependency can be configured between the different Windows services. See #Configuring Windows Service dependencies for more info.

Stoc

Supported platforms

While the The Java Service Wrapper used by Servoy supports virtually all platforms on which a Java Virtual Machine is available (also required to run the Servoy Application Server), in Servoy up to Servoy 6 it's only installed properly on Windows. As of Servoy 6 the service component is properly installed on Windows, OSX and other *nix flavors. For more info on the Java service Wrapper see the paragraph #More info on the Java Service Wrapper component below.

The Java service Wrapper component will create a Windows Service on the Windows platform and on other platforms it utilized Unix Daemons.

...

The Java Service Wrapper is an optional component that needs to be checked in by default installed by the Servoy All-In-One installer , when installing a Servoy Application Server (see Running the All-In-One Installer (The Application Server Service option for more info on the All-In-One installer).

When checked during the 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.

On the Windows platform the Windows Service will be automatically installed when the All-In-One installer has finished. 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.

Wiki Markup
The Service component installation comes with two files to install and uninstall the Service: 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.  

...

Changing configuration on Windows

...

When

(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.

Uninstalling the Windows Service can be done using the following command:

Code Block

wrapper -r wrapper.conf

(Re)installing the Windows Service can be done using the following command:

...

.

...

Configuring the Windows Service to automatically start on reboot of the machine 

By default the Windows Service is configured to be started manually. This can be changed by setting the wrapper.ntservice.starttype property to AUTO_START.

...

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 eachother.

Windows

The following property requires a unique value:

...

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.

OSX/*nix

On OSX and *nix, the name used for the deamon is configured in ServoyServer:

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.

...