Configuration on sillysky.net

Configuration files

Wed, 15 Oct 2025 00:00:00 +0000

If you want to create a new node, there is no configuration in the Java Preferences yet. You have the possibility to give a new configuration to the node, in the form of simple property files.

Since the configuration in Java Preferences is organized hierarchically, we can create a configuration file for each Preferences node. To which preference node the key-value pairs belong is written in the header of the configuration file.

Configuration Nodes and Keys

Wed, 15 Oct 2025 00:00:00 +0000

All public keys for nyssr.net are listed here. Since the Java Preferences are hierarchically ordered, the paths of the nodes to which the keys belong are also shown.

All paths are relative to the base path "/sillysky/nodes/CONFIG_NAME/" in the USER tree of Java Preferences. The configuration name CONFIG_NAME is mostly the Node-ID. Since node IDs of client nodes can also have a random node ID, the configuration name can be different.

CVersion

Wed, 15 Oct 2025 00:00:00 +0000

CVersion is a utility class for comparing version information as used in software library files.

Creation

There is a factory method for creating a CVersion instance. It creates a version object from a string. If you use a filename, please use it without extension.

@NotNull
public static CVersion fromFilename(@NotNull final String aFilename);

// usage:
final CVersion v = CVersion.fromFilename("mylib-1.2.3-SNAPSHOT");

Another static method creates the version object from a file object. Here the extension of the file name is removed. The file object is saved as a user object in the version object and can be retrieved later (see below).

Environment variables

Wed, 15 Oct 2025 00:00:00 +0000

All configuration values can also be set via environment variables. Since most shells only use uppercase letters, digits and underscores for environment keys, and the names must not start with digits, we go the following way:

The key starts with "NY_".
Dots ('.') become 2 underscores: "__".
Preference path delimiter ('/') becomes 3 underscores: "___".

Example

NY_KERNEL__CONFIGURATION___NODE__DESCRIPTION=MyNode

becomes

kernel.configuration/node.description=MyNode

Importing JAVA preference files

Wed, 15 Oct 2025 00:00:00 +0000

The Java Preferences are hierarchically organized in nodes. The library allows to export and import complete subtrees into an XML file.

nyssr.net exports the existing settings of a node to the storage directory at startup. We can modify this file for a new node and give it to the first startup.