World Map
Java Service Wrapper is the easiest way to make your product more reliable.
  • Free Trial
  • Buy Now
wrapper.wait_for_hostid.* Properties

Overview

NOTE

This set of properties is only necessary for Wrapper instances using a Server License on Linux/UNIX platforms. Development and Community Licenses will not require them.

Starting with Wrapper version 3.4.0, it's possible to install/integrate the Wrapper into the boot scripts of UNIX platforms. However, as the Server License is tied the hostId of a Network Interface, it may happen that the interface is not yet available at an early time while the OS is starting up.

When installed as UNIX daemon, the Wrapper will defuse this race-condition by waiting for network interfaces to be available before validating a Server License. By default the Wrapper waits (within the specified timeout) until at least one network interface is found, but this behavior can be changed to keep waiting until the license's hostId is found.

The following set of properties makes it possible to enable/disable and configure this feature:

wrapper.wait_for_hostid

Compatibility :3.4.0
Editions :Professional EditionStandard EditionCommunity Edition (Not Supported)
Platforms :Windows (Not Supported)Mac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Tells the Wrapper to wait for Network Interfaces at startup.

When starting as Daemon, The default value is "TRUE", "FALSE" otherwise.

Example:
wrapper.wait_for_hostid=TRUE

While waiting for an interface, the Wrapper will print out every 10 seconds a short notifier to the log file that it is waiting for an interface.

Example of Log file:
wrapper  | Waiting for hostId(s)... (System HostId(s): xxxxx

It has already been seen that some network interfaces (especially WiFi interfaces) are configured to be up after the user logs in or at a stage happening after daemons are started, hence can't be used by the Wrapper on startup. It is, therefore, recommended to use the Ethernet interface when it's desired to start the Wrapper during booting a machine.

wrapper.wait_for_hostid.strict

Compatibility :3.5.41
Editions :Professional EditionStandard EditionCommunity Edition (Not Supported)
Platforms :Windows (Not Supported)Mac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

This property can be set to TRUE to force waiting for a specific HostId up to the value of wrapper.wait_for_hostid.timeout.

The default value is "FALSE", which tells the Wrapper to stop waiting once at least one network interface is found.

NOTE

Before version 3.5.41, the Wrapper always waited for the license's HostId to be available, hence behaved the same as when wrapper.wait_for_hostid.strict is set to TRUE.

wrapper.wait_for_hostid.timeout

Compatibility :3.5.41
Editions :Professional EditionStandard EditionCommunity Edition (Not Supported)
Platforms :Windows (Not Supported)Mac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Configures the maximum number of seconds that the Wrapper will wait for the Network Interfaces to come up. Up to this time, the Wrapper will check for the interfaces once every second.

The default value is "15" seconds.

Example: (30 seconds)
wrapper.wait_for_hostid.timeout=30

wrapper.max_hostid_timeout

Compatibility :3.4.0 (Deprecated as of 3.5.41)
Editions :Professional EditionStandard EditionCommunity Edition (Not Supported)
Platforms :Windows (Not Supported)Mac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

WARNING

Use of this property has been deprecated as of Wrapper version 3.5.41 in favor of the wrapper.wait_for_hostid.timeout property.

Reference: Timeout