SBK-GEM-YAL: distributed YML launcher

SBK-GEM-YAL loads a YML description and delegates to SBK-GEM. It combines declarative configuration with the same SSH orchestration, embedded SBM aggregation, remote SBK processes, drivers, and loggers used by direct SBK-GEM execution.

Build

./gradlew :sbk-gem-yal:check
./gradlew :sbk-gem-yal:installDist

Run

./sbk-gem-yal/build/install/sbk-gem-yal/bin/sbk-gem-yal -help

Use the example YML files in this module as structural references, then replace hosts, authentication, remote paths, and backend arguments for the benchmark environment.

The checked-in example intentionally omits gempass. Passwordless public-key authentication is preferred: SBK-GEM uses the launching user’s SSH agent and OpenSSH-configured key files. Supply gempass only when the remote account requires password authentication, or set SBK_GEM_SSH_PASSWD outside the YML file. The remote host key must already be trusted in that user’s ~/.ssh/known_hosts file. Set knownhosts to use a dedicated trust file. hostkeycheck defaults to true; disabling it is intended only for isolated, disposable environments and permits server impersonation.

Security and reproducibility

• Do not commit private keys, passwords, tokens, or production host inventories.
• Restrict permissions on external connection files.
• Verify remote host keys and add trusted nodes to the launching user’s ~/.ssh/known_hosts before running GEM.
• Ensure remote clients can reach the embedded SBM callback host and port.
• Record the YML file, SBK commit, remote Java version, backend version, and host topology with results.

Code map

• io.gem.main.SbkGemYalMain: executable entry point.
• io.gem.api.impl.SbkGemYal: loads YML and delegates to SBK-GEM.
• io.gem.params.impl.SbkGemYmlMap: maps YML fields into GEM arguments.

See SBK-GEM for orchestration behavior and the distributed code flow.