zhmc-os-forwarder 0.2.0

Documentation

• Documentation

• Change log

Supported environments

• Operating systems: Linux, macOS, Windows

• Python versions: 3.5 and higher

• HMC versions: 2.11.1 and higher

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 LPARs it should forward to which syslog servers.

  Download the Example forwarder config file and edit that copy according to your needs.

  For details, see Forwarder config file.

• Run the forwarder as follows:

  $ zhmc_os_forwarder -c config.yaml
  zhmc_os_forwarder version: 0.2.0
  zhmcclient version: 1.10.0
  Verbosity level: 0
  Opening session with HMC 10.11.12.13 (user: johndoe@us.ibm.com, certificate validation: False)
  Forwarder is up and running (Press Ctrl-C to shut down)

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 LPARs in DPM mode are not automatically detected.

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.