# IBM Z HMC OS Message Forwarder
[](https://pypi.python.org/pypi/zhmc-os-forwarder/)
[](https://github.com/zhmcclient/zhmc-os-forwarder/actions/workflows/test.yml?query=branch%3Amaster)
[](https://readthedocs.org/projects/zhmc-os-forwarder/builds/)
[](https://coveralls.io/github/zhmcclient/zhmc-os-forwarder?branch=master)
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 systems in the LPARs to remote syslog
servers.
The Z systems can be in classic or DPM operational mode.
The forwarder attempts to stay up as much as possible, for example it
performs automatic session renewals with the HMC if the logon session
expires, and it survives HMC reboots and automatically resumes
forwarding again once the HMC come back up, without loosing or
duplicating any messages.
# Documentation
- [Documentation](https://zhmc-os-forwarder.readthedocs.io/en/stable/)
- [Change log](https://zhmc-os-forwarder.readthedocs.io/en/stable/changes.html)
# 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:
``` bash
$ 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](examples/config_example.yaml) and edit that
copy according to your needs.
For details, see
[Forwarder config file](https://zhmc-os-forwarder.readthedocs.io/en/stable/usage.html#forwarder-config-file).
- Run the forwarder as follows:
``` bash
$ 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](https://github.com/zhmcclient/zhmc-os-forwarder/issues).
# License
This package is licensed under the
[Apache 2.0 License](http://apache.org/licenses/LICENSE-2.0).
Raw data
{
"_id": null,
"home_page": null,
"name": "zhmc-os-forwarder",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Andreas Maier <maiera@de.ibm.com>, Kathir Velusamy <kathir.velu@in.ibm.com>",
"keywords": "hmc, prometheus, monitoring",
"author": null,
"author_email": "Andreas Maier <maiera@de.ibm.com>",
"download_url": "https://files.pythonhosted.org/packages/62/b6/273374148734180689ddbe838963876ea435bc7e9d71306ff64b6545fa65/zhmc_os_forwarder-1.0.0.tar.gz",
"platform": "any",
"description": "# IBM Z HMC OS Message Forwarder\n\n[](https://pypi.python.org/pypi/zhmc-os-forwarder/)\n[](https://github.com/zhmcclient/zhmc-os-forwarder/actions/workflows/test.yml?query=branch%3Amaster)\n[](https://readthedocs.org/projects/zhmc-os-forwarder/builds/)\n[](https://coveralls.io/github/zhmcclient/zhmc-os-forwarder?branch=master)\n\nThe **IBM Z HMC OS Message Forwarder** connects to the console of\noperating systems running in LPARs on Z systems and forwards the\nmessages written by the operating systems in the LPARs to remote syslog\nservers.\n\nThe Z systems can be in classic or DPM operational mode.\n\nThe forwarder attempts to stay up as much as possible, for example it\nperforms automatic session renewals with the HMC if the logon session\nexpires, and it survives HMC reboots and automatically resumes\nforwarding again once the HMC come back up, without loosing or\nduplicating any messages.\n\n# Documentation\n\n- [Documentation](https://zhmc-os-forwarder.readthedocs.io/en/stable/)\n- [Change log](https://zhmc-os-forwarder.readthedocs.io/en/stable/changes.html)\n\n# Supported environments\n\n- Operating systems: Linux, macOS, Windows\n- Python versions: 3.5 and higher\n- HMC versions: 2.11.1 and higher\n\n# Quickstart\n\n- Install the forwarder and all of its Python dependencies as follows:\n\n ``` bash\n $ pip install zhmc-os-forwarder\n ```\n\n- Provide a *config file* for use by the forwarder.\n\n The config file tells the forwarder which HMC to use, and for which\n CPCs and LPARs it should forward to which syslog servers.\n\n Download the\n [Example forwarder config file](examples/config_example.yaml) and edit that\n copy according to your needs.\n\n For details, see\n [Forwarder config file](https://zhmc-os-forwarder.readthedocs.io/en/stable/usage.html#forwarder-config-file).\n\n- Run the forwarder as follows:\n\n ``` bash\n $ zhmc_os_forwarder -c config.yaml\n zhmc_os_forwarder version: 0.2.0\n zhmcclient version: 1.10.0\n Verbosity level: 0\n Opening session with HMC 10.11.12.13 (user: johndoe@us.ibm.com, certificate validation: False)\n Forwarder is up and running (Press Ctrl-C to shut down)\n ```\n\n# Limitations\n\nAt this point, the forwarder has several limitations. All of them are\nintended to be resolved in future releases.\n\n- The forwarder does not recover from HMC restart or connection loss\n- Restarting the forwarder will send again all OS messages the HMC has\n buffered\n- New and deleted LPARs in DPM mode are not automatically detected.\n\n# Reporting issues\n\nIf you encounter a problem, please report it as an\n[issue on GitHub](https://github.com/zhmcclient/zhmc-os-forwarder/issues).\n\n# License\n\nThis package is licensed under the\n[Apache 2.0 License](http://apache.org/licenses/LICENSE-2.0).\n",
"bugtrack_url": null,
"license": "Apache License, Version 2.0",
"summary": "IBM Z HMC OS Message Forwarder",
"version": "1.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/zhmcclient/zhmc-os-forwarder/issues",
"Changelog": "https://zhmc-os-forwarder.readthedocs.io/en/latest/changes.html",
"Documentation": "https://zhmc-os-forwarder.readthedocs.io/en/latest/",
"Homepage": "https://github.com/zhmcclient/zhmc-os-forwarder",
"Source Code": "https://github.com/zhmcclient/zhmc-os-forwarder"
},
"split_keywords": [
"hmc",
" prometheus",
" monitoring"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c75e979a6a186751c0cbf449bb2092e60efc8745a610c1bae90ee916e836a970",
"md5": "4f1daa6d3783d6af4dff93bb4378097d",
"sha256": "c4c42b93deae1e494eab216c93742580f6b2eaa28b8819d8c4036b39a1443cda"
},
"downloads": -1,
"filename": "zhmc_os_forwarder-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4f1daa6d3783d6af4dff93bb4378097d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 25844,
"upload_time": "2024-10-10T12:28:07",
"upload_time_iso_8601": "2024-10-10T12:28:07.217408Z",
"url": "https://files.pythonhosted.org/packages/c7/5e/979a6a186751c0cbf449bb2092e60efc8745a610c1bae90ee916e836a970/zhmc_os_forwarder-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "62b6273374148734180689ddbe838963876ea435bc7e9d71306ff64b6545fa65",
"md5": "3aecdf0e8af1e635586f6ed61fc75010",
"sha256": "6c19c76a4d83a23d3719cfcc52b750b5fc578ad1f234ebca4fa05a8c0e682adc"
},
"downloads": -1,
"filename": "zhmc_os_forwarder-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "3aecdf0e8af1e635586f6ed61fc75010",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 71889,
"upload_time": "2024-10-10T12:28:08",
"upload_time_iso_8601": "2024-10-10T12:28:08.633303Z",
"url": "https://files.pythonhosted.org/packages/62/b6/273374148734180689ddbe838963876ea435bc7e9d71306ff64b6545fa65/zhmc_os_forwarder-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-10 12:28:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zhmcclient",
"github_project": "zhmc-os-forwarder",
"travis_ci": true,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "zhmc-os-forwarder"
}
JSON
