The PlugIn NY_ConfigurationProvider runs a TCP server, with the help of which configuration files are offered in XML format. Nodes can request these files by a configuration name, receive the file, and import the file's data directly into their JAVA Preferences.
In order for a node to use this service, it must know on which host the service is offered.
For this purpose there is a key
preference.tcp, which is to be given to the starting node as a
The value of the key is an IP address with a port specification.
The value can also be passed as an environment variable.
The key is then called
Since the file is requested over the network before the node network is actually started, it cannot be transported over the channels between the nodes. Therefore, untypically, a TCP connection is opened to the service for this purpose only.
The service searches for an XML file in the
ConfigurationProvider directory below the storage
The file is named after the configuration name, with
The kernel prints the current configuration of a node in the storage directory in XML-JAVA preference format at startup. This file can be easily adapted and used for new nodes.
Client Configuration (node requesting a configuration)
|Either commandline...||SERVER:PORT to connect||preference.tcp||127.0.0.1:18000||-Dpreference.tcp=127.0.0.1:18000|
|... or environment variable||SERVER:PORT to connect||NY_PREFERENCE_TCP||127.0.0.1:18000||NY_PREFERENCE_TCP=127.0.0.1:18000|
Server configuration (NY_ConfigurationProvider plugin)
|Either via commandline...||Storage directory||storage.dir||/home/michael/some/dir||-Dstorage.dir=/home/michael/some/dir|
|... or via environment variable||Storage directory||NY_STORAGE_DIR||/home/michael/some/dir||NY_STORAGE_DIR=/home/michael/some/dir|
|Commandline||Port for the TCP server, default=28346||network/configuration.provider/server.port||18000||-Dserver.port=18000|
|Commandline||Input buffer size, default=2100||network/configuration.provider/connection.input.buffer.size||2100||-Dserver.port=18000|
Do not forget: The XML files should be placed in the %storage%/ConfigurationProvider directory.