# Python Module for VMware Cloud Foundation Health Monitoring in VMware Aria Operations
![PyPI](https://img.shields.io/pypi/v/vmware-cloud-foundation-health-monitoring?logo=python&logoColor=yellow&label=PyPI&labelColor=Grey&link=https%3A%2F%2Fpypi.org%2Fproject%2Fvmware-cloud-foundation-health-monitoring%2F)
[![Downloads](https://static.pepy.tech/personalized-badge/vmware-cloud-foundation-health-monitoring?period=total&units=abbreviation&left_color=grey&right_color=green&left_text=DOWNLOADS)](https://pepy.tech/project/vmware-cloud-foundation-health-monitoring) [![Downloads](https://static.pepy.tech/personalized-badge/vmware-cloud-foundation-health-monitoring?period=month&units=international_system&left_color=grey&right_color=green&left_text=DOWNLOADS/WEEK)](https://pepy.tech/project/vmware-cloud-foundation-health-monitoring) [<img src="https://img.shields.io/badge/CHANGELOG-READ-blue?&logo=github&logoColor=white" alt="CHANGELOG" >][changelog]
## Table of Contents
- [Python Module for VMware Cloud Foundation Health Monitoring in VMware Aria Operations](#python-module-for-vmware-cloud-foundation-health-monitoring-in-vmware-aria-operations)
- [Table of Contents](#table-of-contents)
- [Introduction](#introduction)
- [Requirements](#requirements)
- [Platforms](#platforms)
- [Operating Systems](#operating-systems)
- [Python Version](#python-version)
- [Python Libraries](#python-libraries)
- [PowerShell Editions and Versions](#powershell-editions-and-versions)
- [PowerShell Modules](#powershell-modules)
- [Implementation](#implementation)
- [Install the Python Module in a Disconnected Environment](#install-the-python-module-in-a-disconnected-environment)
- [For Photon OS](#for-photon-os)
- [For Windows Server](#for-windows-server)
- [Updating the Python Module to the Latest Version](#updating-the-python-module-to-the-latest-version)
- [For Photon OS](#for-photon-os-1)
- [For Windows Server](#for-windows-server-1)
- [VMware Aria Operations Dashboards Preview](#vmware-aria-operations-dashboards-preview)
- [Known Issues](#known-issues)
- [Support](#support)
- [License](#license)
## Introduction
This content supports the [Health Reporting and Monitoring for VMware Cloud Foundation](https://core.vmware.com/health-reporting-and-monitoring-vmware-cloud-foundation) validated solution which enables the user to monitor the operational state of your [VMware Cloud Foundation](https://docs.vmware.com/en/VMware-Cloud-Foundation) environment through custom dashboards, alerts, and notifications. These custom dashboards are intended to serve as an extension to native VMware Aria Operations dashboards and dashboards that are enabled using the respective management packs.
## Requirements
### Platforms
- VMware Cloud Foundation 5.2
- VMware Cloud Foundation 5.1
- VMware Cloud Foundation 5.0
- VMware Cloud Foundation 4.5
### Operating Systems
- Microsoft Windows Server 2019 and 2022
- [VMware Photon OS](https://vmware.github.io/photon/) 3.0 and 4.0
### Python Version
- [Python 3.x](https://www.python.org/downloads/)
Follow the [Python Beginners Guide](https://wiki.python.org/moin/BeginnersGuide/Download) to download and install Python.
### Python Libraries
Install required Python libraries by running the following commands on the host virtual machine:
```python
pip install requests
pip install setuptools
pip install paramiko
pip install maskpass==0.3.1
```
### PowerShell Editions and Versions
- PowerShell Core 7.2.0 or later
### PowerShell Modules
- [PowerShell Module for VMware Cloud Foundation Reporting](https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-reporting) - latest version
## Implementation
Follow the [Implementation of Health Reporting and Monitoring for VMware Cloud Foundation](https://docs.vmware.com/en/VMware-Cloud-Foundation/services/vcf-health-reporting-and-monitoring-v1/GUID-AD58BAF1-7DC9-4514-90B7-7E9FA2E9E5FA.html) from [Health Reporting and Monitoring for VMware Cloud Foundation](https://core.vmware.com/health-reporting-and-monitoring-vmware-cloud-foundation)
## Install the Python Module in a Disconnected Environment
For disconnected environments (_e.g._, dark-site, air-gapped), you can save the Health Reporting and Monitoring Python module and its dependencies from the PyPI using the below instructions.
### For Photon OS
- On the target system, create a directory to save the Python modules
```console
mkdir -p /opt/vmware/hrm-modules
```
- From a system with an Internet connection, make a modules directory and create a new file `requirements.txt` inside it.
```console
mkdir -p /home/hrm-modules/
cd /home/hrm-modules/
vi requirements.txt
```
- Add below content to the `requirements.txt` file and save it.
```console
requests
setuptools
paramiko
maskpass==0.3.1
```
- Create another file `module.txt` in the same location.
```console
vi module.txt
```
- Add below content to the `module.txt` file and save it.
```console
vmware-cloud-foundation-health-monitoring
```
- From a system with an Internet connection, save the module and its dependencies from PyPI by running the following commands in the terminal:
```console
pip download -r module.txt
pip download -r requirements.txt
```
- From the system with an Internet connection, copy the module and its dependencies to a target system by running the following commands in the terminal:
```console
scp -r /home/vcf/hrm-modules/* username@remote_host:/opt/vmware/hrm-modules/
```
- On the target system, install the module and its dependencies by running the following commands in the terminal:
```console
cd /opt/vmware/hrm-modules
pip install -r requirements.txt --no-index --find-links .
pip install -r module.txt --no-index --find-links . -t /opt/vmware/hrm-<sddc_manager_vm_name>
```
### For Windows Server
- From a system with an Internet connection, make a modules folder `F:\hrm-modules`.
- Create a new file `requirements.txt` inside the modules folder.
- Add the below content to the `requirements.txt` file and save it.
```console
requests
setuptools
paramiko
maskpass==0.3.1
```
- In the modules folder `f:\hrm-modules`, create a new file `module.txt`
- Add below content to `module.txt` file and save it.
```console
vmware-cloud-foundation-health-monitoring
```
- From a system with an Internet connection, save the module and its dependencies from PyPI by running the following commands from cmdline:
```console
cd f:\hrm-modules
pip download -r module.txt
pip download -r requirements.txt
```
- From the system with the Internet connection, copy the module and its dependencies to a target system by running the following commands in the PowerShell console:
```powershell
Copy-Item -Path F:\hrm-modules\* -Destination '\\<destination_host>\C$\vmware\hrm-modules
```
- On the target system, install the module and its dependencies by running the following commands in the terminal:
```console
cd c:\vmware\hrm-modules
pip install -r requirements.txt --no-index --find-links .
pip install -r module.txt --no-index --find-links . -t c:\vmware\hrm-<sddc_manager_vm_name>
```
**Once the Python modules are installed, continue to follow the [Implementation of Health Reporting and Monitoring for VMware Cloud Foundation](https://docs.vmware.com/en/VMware-Cloud-Foundation/services/vcf-health-reporting-and-monitoring-v1/GUID-AD58BAF1-7DC9-4514-90B7-7E9FA2E9E5FA.html) from [Health Reporting and Monitoring for VMware Cloud Foundation](https://core.vmware.com/health-reporting-and-monitoring-vmware-cloud-foundation)**
## Updating the Python Module to the Latest Version
### For Photon OS
- Log in to the host virtual machine at `<host_virtual_machine_fqdn>:22` as the `root` user by using a Secure Shell (SSH) client.
- Update the Python Module for Health Reporting and Monitoring in VMware Aria Operations.
```console
pip install vmware-cloud-foundation-health-monitoring --target=/opt/vmware/hrm-<sddc_manager_vm_name> --upgrade
```
- Provide execute permissions to the files in the `hrm-<sddc_manager_vm_name>` directory.
```console
chmod -R 755 /opt/vmware/hrm-<sddc_manager_vm_name>
```
- Switch to the `hrm-<sddc_manager_vm_name>/main` directory.
```console
cd /opt/vmware/hrm-<sddc_manager_vm_name>/main
```
- Edit the `env.json` file and configure the values according to your VMware Cloud Foundation Planning and Preparation Workbook.
```console
vi env.json
```
- Encrypt the service account passwords.
```console
python encrypt-passwords.py
```
- Enter the password for the VMware Aria Operations service account.
- Enter the password for the SDDC Manager service account.
- Enter the password for the SDDC Manager appliance local user.
- Repeat this procedure for each VMware Cloud Foundation instance.
### For Windows Server
- Log in to the host virtual machine at `<host_virtual_machine_fqdn>` as the `Administrator` user by using a Remote Desktop Connection (RDC) client and open a PowerShell console.
- Start Windows Command Prompt.
- Update the Python Module for Health Reporting and Monitoring in VMware Aria Operations.
```console
pip install vmware-cloud-foundation-health-monitoring --target=C:\vmware\hrm-<sddc_manager_vm_name>\ --upgrade
```
- Change to the `hrm-<sddc_manager_vm_name>\main` folder.
```console
cd c:\vmware\hrm-<sddc_manager_vm_name>\main
```
- Edit the `env.json` file and configure the values according to your VMware Cloud Foundation Planning and Preparation Workbook.
```console
notepad env.json
```
- Encrypt the service account passwords.
```console
python encrypt-passwords.py
```
- Enter the password for the VMware Aria Operations service account.
- Enter the password for the SDDC Manager service account.
- Enter the password for the SDDC Manager appliance local user.
- Repeat this procedure for each VMware Cloud Foundation instance.
## VMware Aria Operations Dashboards Preview
1. VCF Health Rollup
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Rollup1-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Rollup2-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Rollup3-min.png)
2. VCF Backup Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Backups1-min.png)
3. VCF Certificate Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Certificates1-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Certificates2-min.png)
4. VCF Compute Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Compute1-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Compute2-min.png)
5. VCF Connectivity Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Connectivity1-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Connectivity2-min.png)
6. VCF DNS Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/DNS1-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/DNS2-min.png)
7. VCF Hardware Compatibility
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/hw-compatibility-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/hw-compatibility-min2.png)
8. VCF Networking Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Networking-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Networking3-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Networking4-min.png)
9. VCF NTP Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/NTP-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/NTP3-min.png)
10. VCF Password Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Password1-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Password2-min.png)
11. VCF SDDC Manager and vCenter Services Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Services1-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Services2-min.png)
12. VCF Snapshot Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Snapshots1-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Snapshots2-min.png)
13. VCF Storage Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/storage1-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/storage2-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/connected-roms-min.png)
14. VCF vSAN Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/vSAN-min.png)
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/vSAN2-min.png)
15. VCF Version Health
![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/version-min.png)
## Known Issues
1. [Remove FQDN suffix dependency in the name when configuring an NSX-T cloud account in VMware Aria Operations](https://github.com/vmware-samples/validated-solutions-for-cloud-foundation/issues/35)
Please make sure that your NSX-T account name is configured as mentioned in this issue.
2. The vCenter Server name needs to be updated in VMware Cloud Foundation 4.x. The filters on the VMware Aria Operations dashboards depend on the name.
To set the Product Name for the vCenter Server, follow the below steps:
1. Log in to the management domain vCenter Server at `https://<management_vcenter_server_fqdn>/ui` as `administrator@vsphere.local`.
2. In the `VMs and templates` inventory, expand the `management domain vCenter Server` tree and expand the management domain data center.
3. Select the first `management domain vCenter Server virtual machine` and select `Configure` tab.
4. In the `Settings` pane select `vApp Options`.
5. Click the `Edit` button. The `Edit vApp Options` dialog box opens.
6. If vApp options are disabled, select the `Enable vApp options` check box and click `OK`.
7. Click the `Details` tab and enter `VMware vCenter Server Appliance` as product name in the `Name` field.
3. Shades of red, green, and yellow may vary on VMware Aria Operations widgets
Shades of red, green, and yellow may be different in different widgets but they represent the same thing. Ignore the shades as this is a VMware Aria Operations product limitation.
## Support
This Python module is not supported by VMware Support Services.
We welcome you to use the [GitHub Issues](https://github.com/vmware-samples/validated-solutions-for-cloud-foundation/issues) to report bugs or suggest enhancements.
In order to have a good experience with our community, we recommend that you read the [contributing guidelines](../CONTRIBUTING.md).
When filing an issue, please check existing open, or recently closed, issues to make sure someone else hasn't already
reported the issue.
Please try to include as much information as you can. Details like these are incredibly useful:
- A reproducible test case or series of steps.
- Any modifications you've made relevant to the bug.
- Anything unusual about your environment or deployment.
## License
Copyright 2023-2024 Broadcom. All Rights Reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
[//]: Links
[changelog]: CHANGELOG.md
Raw data
{
"_id": null,
"home_page": "https://github.com/vmware-samples/validated-solutions-for-cloud-foundation/tree/main/hrm",
"name": "vmware-cloud-foundation-health-monitoring",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "Broadcom",
"author_email": "bhumitra.nagar@broadcom.com",
"download_url": "https://files.pythonhosted.org/packages/30/9d/4d3712e2f74098ee4333fa9b084c39fb9e0f0f7d6a5dae8660f9b3372c87/vmware_cloud_foundation_health_monitoring-2.2.0.1003.tar.gz",
"platform": null,
"description": "# Python Module for VMware Cloud Foundation Health Monitoring in VMware Aria Operations\r\n\r\n![PyPI](https://img.shields.io/pypi/v/vmware-cloud-foundation-health-monitoring?logo=python&logoColor=yellow&label=PyPI&labelColor=Grey&link=https%3A%2F%2Fpypi.org%2Fproject%2Fvmware-cloud-foundation-health-monitoring%2F)\r\n \r\n[![Downloads](https://static.pepy.tech/personalized-badge/vmware-cloud-foundation-health-monitoring?period=total&units=abbreviation&left_color=grey&right_color=green&left_text=DOWNLOADS)](https://pepy.tech/project/vmware-cloud-foundation-health-monitoring) [![Downloads](https://static.pepy.tech/personalized-badge/vmware-cloud-foundation-health-monitoring?period=month&units=international_system&left_color=grey&right_color=green&left_text=DOWNLOADS/WEEK)](https://pepy.tech/project/vmware-cloud-foundation-health-monitoring) [<img src=\"https://img.shields.io/badge/CHANGELOG-READ-blue?&logo=github&logoColor=white\" alt=\"CHANGELOG\" >][changelog]\r\n\r\n## Table of Contents\r\n\r\n- [Python Module for VMware Cloud Foundation Health Monitoring in VMware Aria Operations](#python-module-for-vmware-cloud-foundation-health-monitoring-in-vmware-aria-operations)\r\n - [Table of Contents](#table-of-contents)\r\n - [Introduction](#introduction)\r\n - [Requirements](#requirements)\r\n - [Platforms](#platforms)\r\n - [Operating Systems](#operating-systems)\r\n - [Python Version](#python-version)\r\n - [Python Libraries](#python-libraries)\r\n - [PowerShell Editions and Versions](#powershell-editions-and-versions)\r\n - [PowerShell Modules](#powershell-modules)\r\n - [Implementation](#implementation)\r\n - [Install the Python Module in a Disconnected Environment](#install-the-python-module-in-a-disconnected-environment)\r\n - [For Photon OS](#for-photon-os)\r\n - [For Windows Server](#for-windows-server)\r\n - [Updating the Python Module to the Latest Version](#updating-the-python-module-to-the-latest-version)\r\n - [For Photon OS](#for-photon-os-1)\r\n - [For Windows Server](#for-windows-server-1)\r\n - [VMware Aria Operations Dashboards Preview](#vmware-aria-operations-dashboards-preview)\r\n - [Known Issues](#known-issues)\r\n - [Support](#support)\r\n - [License](#license)\r\n\r\n## Introduction\r\n\r\nThis content supports the [Health Reporting and Monitoring for VMware Cloud Foundation](https://core.vmware.com/health-reporting-and-monitoring-vmware-cloud-foundation) validated solution which enables the user to monitor the operational state of your [VMware Cloud Foundation](https://docs.vmware.com/en/VMware-Cloud-Foundation) environment through custom dashboards, alerts, and notifications. These custom dashboards are intended to serve as an extension to native VMware Aria Operations dashboards and dashboards that are enabled using the respective management packs.\r\n\r\n## Requirements\r\n\r\n### Platforms\r\n- VMware Cloud Foundation 5.2\r\n- VMware Cloud Foundation 5.1\r\n- VMware Cloud Foundation 5.0\r\n- VMware Cloud Foundation 4.5\r\n\r\n### Operating Systems\r\n\r\n- Microsoft Windows Server 2019 and 2022\r\n- [VMware Photon OS](https://vmware.github.io/photon/) 3.0 and 4.0\r\n\r\n### Python Version\r\n\r\n- [Python 3.x](https://www.python.org/downloads/)\r\n\r\nFollow the [Python Beginners Guide](https://wiki.python.org/moin/BeginnersGuide/Download) to download and install Python.\r\n\r\n### Python Libraries\r\n\r\nInstall required Python libraries by running the following commands on the host virtual machine:\r\n\r\n```python\r\npip install requests\r\npip install setuptools\r\npip install paramiko\r\npip install maskpass==0.3.1\r\n```\r\n\r\n### PowerShell Editions and Versions\r\n\r\n- PowerShell Core 7.2.0 or later\r\n\r\n### PowerShell Modules\r\n\r\n- [PowerShell Module for VMware Cloud Foundation Reporting](https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-reporting) - latest version\r\n\r\n## Implementation\r\n\r\nFollow the [Implementation of Health Reporting and Monitoring for VMware Cloud Foundation](https://docs.vmware.com/en/VMware-Cloud-Foundation/services/vcf-health-reporting-and-monitoring-v1/GUID-AD58BAF1-7DC9-4514-90B7-7E9FA2E9E5FA.html) from [Health Reporting and Monitoring for VMware Cloud Foundation](https://core.vmware.com/health-reporting-and-monitoring-vmware-cloud-foundation)\r\n\r\n## Install the Python Module in a Disconnected Environment\r\n\r\nFor disconnected environments (_e.g._, dark-site, air-gapped), you can save the Health Reporting and Monitoring Python module and its dependencies from the PyPI using the below instructions.\r\n\r\n### For Photon OS\r\n\r\n- On the target system, create a directory to save the Python modules\r\n\r\n ```console\r\n mkdir -p /opt/vmware/hrm-modules\r\n ```\r\n\r\n- From a system with an Internet connection, make a modules directory and create a new file `requirements.txt` inside it.\r\n\r\n ```console\r\n mkdir -p /home/hrm-modules/\r\n cd /home/hrm-modules/\r\n vi requirements.txt\r\n ```\r\n\r\n- Add below content to the `requirements.txt` file and save it.\r\n\r\n ```console\r\n requests\r\n setuptools\r\n paramiko\r\n maskpass==0.3.1\r\n ```\r\n\r\n- Create another file `module.txt` in the same location.\r\n\r\n ```console\r\n vi module.txt\r\n ```\r\n \r\n- Add below content to the `module.txt` file and save it.\r\n\r\n ```console\r\n vmware-cloud-foundation-health-monitoring\r\n ```\r\n \r\n- From a system with an Internet connection, save the module and its dependencies from PyPI by running the following commands in the terminal:\r\n\r\n ```console\r\n pip download -r module.txt\r\n pip download -r requirements.txt\r\n ```\r\n\r\n- From the system with an Internet connection, copy the module and its dependencies to a target system by running the following commands in the terminal:\r\n\r\n ```console\r\n scp -r /home/vcf/hrm-modules/* username@remote_host:/opt/vmware/hrm-modules/\r\n ```\r\n \r\n- On the target system, install the module and its dependencies by running the following commands in the terminal:\r\n\r\n ```console\r\n cd /opt/vmware/hrm-modules\r\n pip install -r requirements.txt --no-index --find-links .\r\n pip install -r module.txt --no-index --find-links . -t /opt/vmware/hrm-<sddc_manager_vm_name>\r\n ```\r\n\r\n### For Windows Server\r\n\r\n- From a system with an Internet connection, make a modules folder `F:\\hrm-modules`.\r\n- Create a new file `requirements.txt` inside the modules folder.\r\n- Add the below content to the `requirements.txt` file and save it.\r\n\r\n ```console\r\n requests\r\n setuptools\r\n paramiko\r\n maskpass==0.3.1\r\n ```\r\n\r\n- In the modules folder `f:\\hrm-modules`, create a new file `module.txt`\r\n- Add below content to `module.txt` file and save it.\r\n\r\n ```console\r\n vmware-cloud-foundation-health-monitoring\r\n ```\r\n\r\n- From a system with an Internet connection, save the module and its dependencies from PyPI by running the following commands from cmdline:\r\n\r\n ```console\r\n cd f:\\hrm-modules\r\n pip download -r module.txt \r\n pip download -r requirements.txt\r\n ```\r\n\r\n- From the system with the Internet connection, copy the module and its dependencies to a target system by running the following commands in the PowerShell console:\r\n\r\n ```powershell\r\n Copy-Item -Path F:\\hrm-modules\\* -Destination '\\\\<destination_host>\\C$\\vmware\\hrm-modules\r\n ```\r\n\r\n- On the target system, install the module and its dependencies by running the following commands in the terminal:\r\n\r\n ```console\r\n cd c:\\vmware\\hrm-modules\r\n pip install -r requirements.txt --no-index --find-links .\r\n pip install -r module.txt --no-index --find-links . -t c:\\vmware\\hrm-<sddc_manager_vm_name>\r\n ```\r\n\r\n**Once the Python modules are installed, continue to follow the [Implementation of Health Reporting and Monitoring for VMware Cloud Foundation](https://docs.vmware.com/en/VMware-Cloud-Foundation/services/vcf-health-reporting-and-monitoring-v1/GUID-AD58BAF1-7DC9-4514-90B7-7E9FA2E9E5FA.html) from [Health Reporting and Monitoring for VMware Cloud Foundation](https://core.vmware.com/health-reporting-and-monitoring-vmware-cloud-foundation)**\r\n\r\n## Updating the Python Module to the Latest Version\r\n\r\n### For Photon OS\r\n\r\n- Log in to the host virtual machine at `<host_virtual_machine_fqdn>:22` as the `root` user by using a Secure Shell (SSH) client.\r\n\r\n- Update the Python Module for Health Reporting and Monitoring in VMware Aria Operations.\r\n\r\n ```console\r\n pip install vmware-cloud-foundation-health-monitoring --target=/opt/vmware/hrm-<sddc_manager_vm_name> --upgrade\r\n ``` \r\n\r\n- Provide execute permissions to the files in the `hrm-<sddc_manager_vm_name>` directory.\r\n\r\n ```console\r\n chmod -R 755 /opt/vmware/hrm-<sddc_manager_vm_name>\r\n ``` \r\n\r\n- Switch to the `hrm-<sddc_manager_vm_name>/main` directory.\r\n\r\n ```console\r\n cd /opt/vmware/hrm-<sddc_manager_vm_name>/main\r\n ```\r\n\r\n- Edit the `env.json` file and configure the values according to your VMware Cloud Foundation Planning and Preparation Workbook.\r\n\r\n ```console\r\n vi env.json\r\n ```\r\n\r\n- Encrypt the service account passwords.\r\n\r\n ```console\r\n python encrypt-passwords.py\r\n ```\r\n\r\n- Enter the password for the VMware Aria Operations service account.\r\n- Enter the password for the SDDC Manager service account.\r\n- Enter the password for the SDDC Manager appliance local user.\r\n- Repeat this procedure for each VMware Cloud Foundation instance.\r\n\r\n### For Windows Server\r\n\r\n- Log in to the host virtual machine at `<host_virtual_machine_fqdn>` as the `Administrator` user by using a Remote Desktop Connection (RDC) client and open a PowerShell console.\r\n- Start Windows Command Prompt.\r\n- Update the Python Module for Health Reporting and Monitoring in VMware Aria Operations.\r\n\r\n ```console\r\n pip install vmware-cloud-foundation-health-monitoring --target=C:\\vmware\\hrm-<sddc_manager_vm_name>\\ --upgrade\r\n ```\r\n\r\n- Change to the `hrm-<sddc_manager_vm_name>\\main` folder.\r\n\r\n ```console\r\n cd c:\\vmware\\hrm-<sddc_manager_vm_name>\\main\r\n ```\r\n\r\n- Edit the `env.json` file and configure the values according to your VMware Cloud Foundation Planning and Preparation Workbook.\r\n\r\n ```console\r\n notepad env.json\r\n ```\r\n\r\n- Encrypt the service account passwords.\r\n\r\n ```console\r\n python encrypt-passwords.py\r\n ```\r\n\r\n- Enter the password for the VMware Aria Operations service account.\r\n- Enter the password for the SDDC Manager service account.\r\n- Enter the password for the SDDC Manager appliance local user.\r\n- Repeat this procedure for each VMware Cloud Foundation instance.\r\n\r\n## VMware Aria Operations Dashboards Preview\r\n\r\n1. VCF Health Rollup\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Rollup1-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Rollup2-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Rollup3-min.png)\r\n\r\n2. VCF Backup Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Backups1-min.png)\r\n\r\n3. VCF Certificate Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Certificates1-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Certificates2-min.png)\r\n\r\n4. VCF Compute Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Compute1-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Compute2-min.png)\r\n\r\n5. VCF Connectivity Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Connectivity1-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Connectivity2-min.png)\r\n\r\n6. VCF DNS Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/DNS1-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/DNS2-min.png)\r\n\r\n7. VCF Hardware Compatibility\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/hw-compatibility-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/hw-compatibility-min2.png)\r\n\r\n8. VCF Networking Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Networking-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Networking3-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Networking4-min.png)\r\n\r\n9. VCF NTP Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/NTP-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/NTP3-min.png)\r\n\r\n10. VCF Password Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Password1-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Password2-min.png)\r\n\r\n11. VCF SDDC Manager and vCenter Services Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Services1-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Services2-min.png)\r\n\r\n12. VCF Snapshot Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Snapshots1-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/Snapshots2-min.png)\r\n\r\n13. VCF Storage Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/storage1-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/storage2-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/connected-roms-min.png)\r\n\r\n14. VCF vSAN Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/vSAN-min.png)\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/vSAN2-min.png)\r\n\r\n15. VCF Version Health\r\n\r\n ![](https://raw.githubusercontent.com/vmware-samples/validated-solutions-for-cloud-foundation/main/hrm/images/version-min.png)\r\n\r\n## Known Issues\r\n\r\n1. [Remove FQDN suffix dependency in the name when configuring an NSX-T cloud account in VMware Aria Operations](https://github.com/vmware-samples/validated-solutions-for-cloud-foundation/issues/35)\r\n\r\n Please make sure that your NSX-T account name is configured as mentioned in this issue.\r\n\r\n2. The vCenter Server name needs to be updated in VMware Cloud Foundation 4.x. The filters on the VMware Aria Operations dashboards depend on the name.\r\n\r\n To set the Product Name for the vCenter Server, follow the below steps:\r\n\r\n 1. Log in to the management domain vCenter Server at `https://<management_vcenter_server_fqdn>/ui` as `administrator@vsphere.local`.\r\n 2. In the `VMs and templates` inventory, expand the `management domain vCenter Server` tree and expand the management domain data center.\r\n 3. Select the first `management domain vCenter Server virtual machine` and select `Configure` tab.\r\n 4. In the `Settings` pane select `vApp Options`.\r\n 5. Click the `Edit` button. The `Edit vApp Options` dialog box opens.\r\n 6. If vApp options are disabled, select the `Enable vApp options` check box and click `OK`.\r\n 7. Click the `Details` tab and enter `VMware vCenter Server Appliance` as product name in the `Name` field.\r\n\r\n3. Shades of red, green, and yellow may vary on VMware Aria Operations widgets\r\n\r\n Shades of red, green, and yellow may be different in different widgets but they represent the same thing. Ignore the shades as this is a VMware Aria Operations product limitation.\r\n\r\n## Support\r\n\r\nThis Python module is not supported by VMware Support Services.\r\n\r\nWe welcome you to use the [GitHub Issues](https://github.com/vmware-samples/validated-solutions-for-cloud-foundation/issues) to report bugs or suggest enhancements.\r\n\r\nIn order to have a good experience with our community, we recommend that you read the [contributing guidelines](../CONTRIBUTING.md).\r\n\r\nWhen filing an issue, please check existing open, or recently closed, issues to make sure someone else hasn't already\r\nreported the issue.\r\n\r\nPlease try to include as much information as you can. Details like these are incredibly useful:\r\n\r\n- A reproducible test case or series of steps.\r\n- Any modifications you've made relevant to the bug.\r\n- Anything unusual about your environment or deployment.\r\n\r\n## License\r\n\r\nCopyright 2023-2024 Broadcom. All Rights Reserved.\r\n\r\nRedistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:\r\n\r\n1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.\r\n\r\n2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.\r\n\r\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r\n\r\n[//]: Links\r\n\r\n[changelog]: CHANGELOG.md\r\n",
"bugtrack_url": null,
"license": "BSD-2-Clause",
"summary": "Python Module for VMware Cloud Foundation Health Monitoring in VMware Aria Operations",
"version": "2.2.0.1003",
"project_urls": {
"Homepage": "https://github.com/vmware-samples/validated-solutions-for-cloud-foundation/tree/main/hrm",
"Issues": "https://github.com/vmware-samples/validated-solutions-for-cloud-foundation/issues",
"Source": "https://github.com/vmware-samples/validated-solutions-for-cloud-foundation/tree/main/hrm"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1ecfb127b446e85940e18ae7d3e7e972a53eebb73f598b6b121f0a7d62bb8deb",
"md5": "38917dff1e17726980454972c3e7eee8",
"sha256": "a4c4faacd19739d5c05b7c69e435928f8133126de43ba26c6979fdbc93a27fa3"
},
"downloads": -1,
"filename": "vmware_cloud_foundation_health_monitoring-2.2.0.1003-py3-none-any.whl",
"has_sig": false,
"md5_digest": "38917dff1e17726980454972c3e7eee8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 109468,
"upload_time": "2024-07-24T14:44:58",
"upload_time_iso_8601": "2024-07-24T14:44:58.419505Z",
"url": "https://files.pythonhosted.org/packages/1e/cf/b127b446e85940e18ae7d3e7e972a53eebb73f598b6b121f0a7d62bb8deb/vmware_cloud_foundation_health_monitoring-2.2.0.1003-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "309d4d3712e2f74098ee4333fa9b084c39fb9e0f0f7d6a5dae8660f9b3372c87",
"md5": "426727a0fd7dd08add21c9bfde1a76ce",
"sha256": "32d527ef146639a26d8d781b7a18ced7141cc17a0d99eb686e6ea2890d0d7c70"
},
"downloads": -1,
"filename": "vmware_cloud_foundation_health_monitoring-2.2.0.1003.tar.gz",
"has_sig": false,
"md5_digest": "426727a0fd7dd08add21c9bfde1a76ce",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 112542,
"upload_time": "2024-07-24T14:45:02",
"upload_time_iso_8601": "2024-07-24T14:45:02.108117Z",
"url": "https://files.pythonhosted.org/packages/30/9d/4d3712e2f74098ee4333fa9b084c39fb9e0f0f7d6a5dae8660f9b3372c87/vmware_cloud_foundation_health_monitoring-2.2.0.1003.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-24 14:45:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "vmware-samples",
"github_project": "validated-solutions-for-cloud-foundation",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "vmware-cloud-foundation-health-monitoring"
}