zhmc-os-forwarder 0.1.0

IBM Z HMC OS Message Forwarder

The IBM Z HMC OS Message Forwarder connects to the console of operating systems running in LPARs on Z systems and forwards the messages written by the operating system to its console to a remote syslog server.

The Z systems can be in classic or DPM operatonal mode.

Documentation

• Documentation (not yet)

• Change log (not yet)

Quickstart

• Install the forwarder and all of its Python dependencies as follows:

  $ pip install zhmc-os-forwarder

• Provide a config file for use by the forwarder.

  The config file tells the forwarder which HMC to use, and for which CPCs and partitions it should forward to which syslog servers.

  Download the example config file as config.yaml and edit that copy according to your environment.

• Run the forwarder as follows:

  $ zhmc_os_forwarder -c config.yaml

Limitations

At this point, the forwarder has several limitations. All of them are intended to be resolved in future releases.

• The forwarder does not recover from HMC restart or connection loss

• Restarting the forwarder will send again all OS messages the HMC has buffered

• New and deleted partitions in DPM mode are not automatically detected.

• No documentation

Reporting issues

If you encounter a problem, please report it as an issue on GitHub.

License

This package is licensed under the Apache 2.0 License.