Skip to content

Latest commit

 

History

History
398 lines (255 loc) · 16.7 KB

README.md

File metadata and controls

398 lines (255 loc) · 16.7 KB

Python Module for VMware Cloud Foundation Health Monitoring in VMware Aria Operations

PyPI    Downloads    Downloads    CHANGELOG

Table of Contents

Introduction

This content supports the Health Reporting and Monitoring for VMware Cloud Foundation validated solution which enables the user to monitor the operational state of your 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

Python Version

Follow the Python Beginners Guide to download and install Python.

Python Libraries

Install required Python libraries by running the following commands on the host virtual machine:

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

Implementation

Follow the Implementation of Health Reporting and Monitoring for VMware Cloud Foundation from Health Reporting and Monitoring for 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

    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.

    mkdir -p /home/hrm-modules/
cd /home/hrm-modules/
vi requirements.txt

  • Add below content to the requirements.txt file and save it.

    requests
setuptools
paramiko
maskpass==0.3.1

  • Create another file module.txt in the same location.

    vi module.txt

  • Add below content to the module.txt file and save it.

    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:

    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:

    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:

    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.

    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.

    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:

    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:

    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:

    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 from Health Reporting and Monitoring for 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.

    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.

    chmod -R 755 /opt/vmware/hrm-<sddc_manager_vm_name>

  • Switch to the hrm-<sddc_manager_vm_name>/main directory.

    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.

    vi env.json

  • Encrypt the service account passwords.

    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.

    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.

    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.

    notepad env.json

  • Encrypt the service account passwords.

    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

  2. VCF Backup Health

  3. VCF Certificate Health

  4. VCF Compute Health

  5. VCF Connectivity Health

  6. VCF DNS Health

  7. VCF Hardware Compatibility

  8. VCF Networking Health

  9. VCF NTP Health

  10. VCF Password Health

  11. VCF SDDC Manager and vCenter Services Health

  12. VCF Snapshot Health

  13. VCF Storage Health

  14. VCF vSAN Health

  15. VCF Version Health

Known Issues

  1. Remove FQDN suffix dependency in the name when configuring an NSX-T cloud account in VMware Aria Operations

    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

We welcome you to use the GitHub 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.

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

© Broadcom. All Rights Reserved. The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.

Licensed under the BSD 2-Clause license.