Software Update on sillysky.net

CRecordGetPluginList

Tue, 09 Dec 2025 00:00:00 +0000

The message is used to retrieve the list of loaded plugins on a node. Usually, only a portion of the available plugins are loaded at startup. Therefore, the list is part of the node's configuration.

The message is part of the API of the software update or the NY_LocalSoftwareUpdaterPlugIn plugin. The message belongs to a nanoservice in the SYSTEM namespace.

{
  "id": "246d6b26-3197-47a5-a6c7-b97395cce4ac",
  "name": "GET_PLUGIN_LIST",
  "isNanoService": "true",
  "namespaces": "SYSTEM",
  "description": "Get the plugin list of the node.",
  "slots": [
    {
      "key": "1",
      "name": "PLUGIN_LIST",
      "direction": "RESPONSE",
      "presenceConstraint": "OPTIONAL",
      "type": "STRING_ARRAY",
      "description": "The list of plugins to load on start-up."
    }
  ]
}

Arguments

None.

CRecordGetVersion

Tue, 09 Dec 2025 00:00:00 +0000

The message is used to obtain a JSON text with various lists of the currently used software. It contains the kernel version, the list of used libraries, the list of available plugins, and the list of running plugins on the node.

The message is part of the API of the software update or the NY_LocalSoftwareUpdaterPlugIn plugin. The message belongs to a nanoservice in the SYSTEM namespace.

{
  "id": "a462af95-d126-4d19-bb45-0c77f9b30e5c",
  "name": "GET_VERSION",
  "isNanoService": "true",
  "namespaces": "SYSTEM",
  "description": "Get a JSON with version information of libraries, plugins, and a list of loaded plugins of that node.",
  "slots": [
    {
      "key": "10",
      "name": "JSON",
      "direction": "RESPONSE",
      "presenceConstraint": "OPTIONAL",
      "type": "STRING",
      "description": "The version information."
    }
  ]
}

Arguments

None.

CRecordReboot

Tue, 09 Dec 2025 00:00:00 +0000

This message initiates a node reboot. The reboot can occur immediately, or at a specific time. The exit code can also be specified.

The message is part of the API of the software update or the NY_LocalSoftwareUpdaterPlugIn plugin. The message belongs to a nanoservice in the SYSTEM namespace.

{
  "id": "12a32a43-605a-465e-9af5-7a11285bae5f",
  "name": "REBOOT",
  "isNanoService": "true",
  "namespaces": "SYSTEM",
  "description": "Reboot the node.",
  "slots": [
    {
      "key": "1",
      "name": "TIME",
      "direction": "REQUEST",
      "presenceConstraint": "OPTIONAL",
      "type": "ZONED_DATE_TIME",
      "description": "Optional: The time to reboot."
    },
    {
      "key": "2",
      "name": "CODE",
      "direction": "REQUEST",
      "presenceConstraint": "OPTIONAL",
      "type": "INT",
      "description": "The application exit code(default: 1)."
    }
  ]
}

Arguments

SESSION_TOKEN: Valid session token. The NY_Shutdown permission is required for the reboot.
TIME : Optional: The time at which the reboot should occur.
CODE : The application exit code. The default value is 1.

CRecordSetPluginList

Tue, 09 Dec 2025 00:00:00 +0000

This message transmits the lists of JAR files needed for an update.

The message is part of the API of the software update or the NY_LocalSoftwareUpdaterPlugIn plugin. The message belongs to a nanoservice in the SYSTEM namespace.

{
  "id": "55310d32-5724-4c36-a108-b03c0481b746",
  "name": "SET_PLUGIN_LIST",
  "isNanoService": "true",
  "namespaces": "SYSTEM",
  "description": "Set the library and plugin list of the node.\nEntries can have short names (json-simple),\nlong names (json-simple-1.1.1),\nfull names (json-simple-1.1.1.jar) or\nadditional hash codes (json-simple-1.1.1.jar(XYNWCBXB3367HES79YHDNA9G6G)).",
  "slots": [
    {
      "key": "1",
      "name": "LIBRARY_LIST",
      "direction": "REQUEST",
      "presenceConstraint": "OPTIONAL",
      "type": "STRING_ARRAY",
      "description": "The new list of libraries in the classpath (directory lib)."
    },
    {
      "key": "2",
      "name": "PLUGIN_LIST",
      "direction": "REQUEST",
      "presenceConstraint": "OPTIONAL",
      "type": "STRING_ARRAY",
      "description": "The list of plugins to download (directory plugins)."
    },
    {
      "key": "3",
      "name": "PLUGIN_TO_LOAD_LIST",
      "direction": "REQUEST",
      "presenceConstraint": "OPTIONAL",
      "type": "STRING_ARRAY",
      "description": "The new list of plugins to load on start-up."
    },
    {
      "key": "4",
      "name": "REBOOT",
      "direction": "REQUEST",
      "presenceConstraint": "OPTIONAL",
      "type": "BOOLEAN",
      "description": "True: Node shall reboot after updating the software."
    }
  ]
}

Arguments

SESSION_TOKEN : Valid session token. The NY_Shutdown permission is required for the reboot. The NY_SoftwareUpdate permission is required for downloading JARs.
LIBRARY_LIST : Optional: The list of libraries and the kernel JAR to download. The hash is optional and is only required if you want to distinguish between files with the same name but different versions. The hash value of the file is displayed on the console when the file is imported into the FileStore. Only the files that do not already exist will be downloaded. Files that existed before the update and no longer exist will be imported into the remote FileStore and deleted from the directory. If this list is missing, the kernel file and libraries will not be modified.
PLUGIN_LIST : Optional: The list of plugins in the plugins directory. The hash is optional and is only required if you want to distinguish between files with the same name but different versions. The hash value of the file is displayed on the console when the file is imported into the FileStore. Only the files that do not already exist will be downloaded. Files that existed before the update and no longer exist will be imported into the remote FileStore and deleted from the directory. If the list is missing, the files in the plugins directory will not be modified.
PLUGIN_TO_LOAD_LIST : Optional: The list of plugins to load when the node is started. If this list is missing, the node's existing list is not modified. Preferably use filenames without version numbers here. The kernel automatically selects the latest version when there are multiple versions of a plugin. This way, you avoid updating the list when installing new software.
REBOOT : The default here is true for rebooting the nodes after the update.