comtrade oms solution for nutanix user guide installing nutanix oms solution, make sure that the...

Comtrade OMS Solution for Nutanix

USER GUIDE

PRODUCT VERSION: 1.0

PRODUCT RELEASE DATE: MAY 2017

DOCUMENT EDITION: FIRST

LEGAL NOTICESCOPYRIGHT NOTICE

© 2017 Comtrade Software. All rights reserved.

This document contains proprietary information, which is protected by copyright. No part of this document may be photocopied, reproduced, distributed, transmitted, stored in a retrieval system, modified or translated to another language in any form by any means, without the prior written consent of Comtrade Software (Comtrade).

TRADEMARKS

Comtrade Software logos, names, trademarks and/or service marks and combinations thereof are the property of Comtrade or its affiliates. Other product names are the property of their respective trademark or service mark holders and are hereby acknowledged.

Azure, Microsoft, and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

Enterprise Cloud Platform, Nutanix, and Prism are trademarks of Nutanix, Inc. in the United States and/or other jurisdictions.

Redfish® is a registered trademark of Distributed Management Task Force, Inc. (DTMF).

DISCLAIMER

The details and descriptions contained in this document are believed to have been accurate and up to date at the time the document was written. The information contained in this document is subject to change without notice.

Comtrade Software provides this material "as is" and makes no warranty of any kind, expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Comtrade shall not be liable for errors and omissions contained herein. In no event shall Comtrade be liable for any direct, indirect, consequential, punitive, special or incidental damages, including, without limitation, damages for loss and profits, loss of anticipated savings, business interruption, or loss of information arising out of the use or inability to use this document, or any action taken based on the information contained herein, even if it has been advised of the possibility of such damages, whether based on warranty, contract, or any other legal theory.

The only warranties for Comtrade Software products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty.

NOTICE

This document is provided in connection with Comtrade Software products. Comtrade may have copyright, patents, patent applications, trademark, or other intellectual property rights covering the subject matter of this document.

2/31

Except as expressly provided in any written license agreement from Comtrade Software, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property on Comtrade Software products. Use of underlying Comtrade Software product(s) is governed by their respective Software License and Support Terms.

Important: Please read Software License and Support Terms before using the accompanying software product(s).

Comtrade Softwarewww.comtradesoftware.com

3/31

http://www.comtradesoftware.com/

CONTENTS

CHAPTER 1: INTRODUCTION 6

ABOUT COMTRADE OMS SOLUTION FOR NUTANIX 6

PRODUCT ARCHITECTURE 8

ABOUT NUTANIX 8

ABOUT MICROSOFT OPERATIONS MANAGEMENT SUITE 9

CHAPTER 2: INSTALLATION AND CONFIGURATION 10

INSTALLATION PREREQUISITES 10

INSTALLING NUTANIX OMS DATA COLLECTOR 11

CONFIGURING NUTANIX OMS DATA COLLECTOR 12

CONFIGURING OMS SETTINGS 12

CONFIGURING NUTANIX PRISM SETTINGS 13

PERFORMING PRODUCT LICENSING TASKS 15

CONFIGURING CUSTOM PORTS FOR INBOUND TRAFFIC 16

CONFIGURING THE PRODUCT TO USE A PROXY SERVER 17

CONFIGURING CLUSTER NODE-SPECIFIC REDFISH CREDENTIALS 18

ENABLING NUTANIX SYSTEM LOG FORWARDING (OPTIONAL) 18

DEPLOYING NUTANIX OMS SOLUTION 20

CHAPTER 3: REMOVAL 21

REMOVING NUTANIX OMS DATA COLLECTOR 21

REMOVING SOLUTIONS FROM THE OMS WORKSPACE 21

CHAPTER 4: USAGE 22

GENERAL INFORMATION 22

NUTANIX CLUSTERS 22

NUTANIX HARDWARE 23

NUTANIX HARDWARE SENSORS 23

NUTANIX LOG AND EVENT ANALYTICS 24

4/31

NUTANIX STORAGE 24

NUTANIX VIRTUAL MACHINES 24

CHAPTER 5: TROUBLESHOOTING 26

GENERAL TROUBLESHOOTING GUIDELINES 26

NUTANIX OMS DATA COLLECTOR LOG FILES 26

PROBLEMS AND SOLUTIONS 27

BEFORE CONTACTING COMTRADE SOFTWARE CUSTOMER SUPPORT 28

COMTRADE SOFTWARE CUSTOMER SUPPORT AND INFORMATION 29

CONTACTING COMTRADE SOFTWARE 29

CUSTOMER SUPPORT 29

COMPANY WEBSITE AND VIDEO CHANNEL 29

GENERAL INFORMATION 29

FEEDBACK 30

5/31

CHAPTER 1: INTRODUCTIONThis chapter introduces Comtrade OMS Solution for Nutanix and explains how it interacts with Nutanix Enterprise Cloud Platform and Microsoft Operations Management Suite.

ABOUT COMTRADE OMS SOLUTION FOR NUTANIX

Comtrade OMS Solution for Nutanix (Nutanix OMS Solution) is an availability, performance management, and analysis solution that extends end-to-end service monitoring capabilities of OMS to include on-premises Nutanix appliances. It includes multiple solutions (also referred to as Nutanix OMS Solution components) with a predefined set of views to fully integrate Nutanix data, events, and logs into the OMS portal, providing the operation overview and log analytics across the Nutanix infrastructure and enabling delivery of effective business service management. Nutanix OMS Solution also provides possibility to generate alerts according to availability, performance, configuration, or security conditions that are identified. It enables you to monitor, detect, troubleshoot, remediate, and prevent problems from occurring in your Nutanix appliance.

Nutanix OMS Solution provides the following major features:

l Discovery and visualization:

o Automatic discovery and visualization of Nutanix clusters, hosts, storage, and virtual machines (VMs) by using historical charts and predefined queries. It also provides predefined queries for Nutanix log and event analytics.

o Centralized monitoring of the discovered Nutanix environment, log and event analytics over the OMS portal.

l Health, availability, and performance monitoring:

o Monitoring of the Nutanix infrastructure health state from performance issues to utilization, latency, load, and availability.

o Detection of performance degradation before it affects end users

l Monitoring of Nutanix components and tasks:

o Automatic detection of Nutanix infrastructure components, such as:

n Clusters: Storage, CPU, and memory capacity and utilization, I/O latency, IOPS, I/O bandwidth, blocks, hosts, number of VMs.

n Virtual machines: Number of VMs (per cluster, powered on/powered off/suspended/paused VMs), total CPU and memory utilization, total VM I/O latency, IOPS.

n Hardware: Host CPU and memory utilization, number of hosted VMs, host I/O latency and IOPS, blocks per cluster, Nutanix hardware editions, number of SSD drives, number of HDD drives.

n Hardware sensors: Fans and fan rotation speeds, components and component

6/31


temperatures, power supply and power control units, their voltages and wattages.

n Storage: Storage utilization, storage pools, containers.

l Nutanix log analytics:

o Provision of a central point for investigating logs.

o Collection of, correlation of, and search in log and performance data generated by operating systems and applications.

o Usage of predefined queries to help remediate problems occurring in Nutanix clusters.

l Problem identification and resolution mechanism:

o Provision of information that can help you identify the problem and its root cause.

o Alert-based notification about increased resource utilization.

7/31


PRODUCT ARCHITECTURE Nutanix OMS Solution uses a sophisticated component called Comtrade OMS Data Collector for Nutanix (Nutanix OMS Data Collector) that is installed on a system of your choice (Data Collector system). Nutanix OMS Data Collector connects to one or more Nutanix appliances by using the Nutanix REST API interface and sends the collected performance data to OMS by using its HTTP Data Collector API. Nutanix OMS Data Collector can also act as a syslog server and can forward Nutanix system log files to OMS.

The following diagram shows how Nutanix OMS Solution connects the OMS platform and the Nutanix infrastructure.

Figure 1 High-level overview of the Nutanix OMS Solution environment

ABOUT NUTANIX

Nutanix delivers enterprise computing and storage featuring built-in virtualization.

Nutanix hyperconverged infrastructure natively integrates servers, storage network, and storage into a single x86-based server deployed in scale-out clusters. Nodes that are part of the enterprise-scale clusters run industry-standard or native hypervisors and the Nutanix operating system (AOS, formerly known as NOS). Each server contains x86-64 processors, memory, solid state drives (SSDs), and traditional hard disk drives (HDDs) that aggregate storage resources into a single storage pool. Capacity is added by adding nodes to the computing cluster.

8/31


Built-in virtualization allows applications and data to move freely between on-premises environments and public clouds. All data, metadata, and operations are distributed across the entire cluster combining physical and virtual storage. All this eliminates performance bottlenecks, enables predictable scalability without limits, reduces power and space consumption, and eliminates storage complexity.

Nutanix Enterprise Cloud Platform features predictable performance, cloud-like infrastructure consumption, robust security, and application mobility for a broad range of enterprise applications without infrastructure constraints. The infrastructure is truly invisible, shifting focus back to applications.

ABOUT MICROSOFT OPERATIONS MANAGEMENT SUITE

Microsoft Operations Management Suite (OMS) is a cloud-based IT management solution that helps you manage and protect your on-premises and cloud infrastructure.

You can benefit from the following major value areas of OMS:

l Insight and analytics

l Automation and control

l Protection and recovery

l Security and compliance

In addition to providing valuable services on its own, OMS can integrate with Microsoft System Center components such as System Center Operations Manager to extend your existing management investment into the cloud.

System Center and OMS can work together to provide a full hybrid management experience.

For more information about OMS, see the product documentation.

9/31

CHAPTER 2: INSTALLATION AND CONFIGURATIONThis chapter contains instructions on how to install and configure Nutanix OMS Solution on the Nutanix appliance and OMS sides. To install and configure Nutanix OMS Solution, complete these tasks:

1. Ensure that the installation prerequisites are fulfilled. For details, see "Installation prerequisites" below.

2. Install Nutanix OMS Data Collector. For details, see "Installing Nutanix OMS Data Collector" on the next page.

3. Configure Nutanix OMS Data Collector. For details, see "Configuring Nutanix OMS Data Collector" on page 12.

4. Optional. Enable the Nutanix system to provide system logs for OMS. For details, see "Enabling Nutanix system log forwarding (optional)" on page 18.

5. Deploy Nutanix OMS Solution. For details, see "Deploying Nutanix OMS Solution" on page 20.

INSTALLATION PREREQUISITES

Before installing Nutanix OMS Solution, make sure that the following prerequisites are fulfilled:

l Product requirements documented in Comtrade OMS Solution for Nutanix Release Notes are met.

l Nutanix appliance prerequisites:

o For connecting the Nutanix OMS Data Collector system with Nutanix Prism, a Nutanix Prism user account is selected. This account must exist in each Nutanix cluster that you plan to monitor.

Comtrade Software recommends that you select an account that has privileges only for collecting (reading) data.

o For collecting hardware sensor data, a user account is selected that can access hardware sensors on cluster nodes through Redfish API implementation on the nodes.

Comtrade Software recommends that you select an account that has privileges only for collecting (reading) data. Nutanix OMS Solution supports configurations with different user credentials on different cluster nodes.

l OMS platform prerequisites:

o The OMS workspace ID and primary key are known.

To acquire the OMS workspace ID and primary key, do the following:

10/31


1. Open a web browser, go to the Overview | Microsoft Operations Management Suite webpage and then click Sign in.

2. On the Sign in to your account webpage, provide your access credentials, and then sign in to the OMS portal.

3. Click Settings.

4. In the Overview page, select Connected Sources > Windows Servers. Locate the Workspace ID and Primary Key fields and copy their contents.

o Name resolution for the fully qualified domain name that includes the workspace ID is functioning.

To verify this, on the Data Collector system, open a command shell and run the following command:

nslookup <WorkspaceID>.ods.opinsights.azure.com

The command output should resemble the following sample output:

Server: <DNSfqdn> Address: <DNSipAddress> Non-authoritative answer: <WorkspaceID>.ods.opinsights.azure.com canonical name = opinsightsweuods.trafficmanager.net. opinsightsweuods.trafficmanager.net canonical name = opinsights-weu-ods-b.cloudapp.net. Name: opinsights-weu-ods-b.cloudapp.net Address: <IPaddress>

l Web browser prerequisites:

o A compatible web browser is used to access the Nutanix OMS Data Collector configuration GUI. For a list of the compatible web browsers, see the Comtrade OMS Solution for Nutanix Compatibility Matrix.

o The web browser must be set to allow JavaScript execution.

For information on Nutanix Enterprise Cloud Platform and the OMS platform (for example, hardware and software requirements, operating system support, and installation and configuration procedures), see the Nutanix and Microsoft documentation.

INSTALLING NUTANIX OMS DATA COLLECTOR

To install Nutanix OMS Data Collector, do the following:

1. Go to the Comtrade OMS Solution for Nutanix – Login webpage, log in, and download the Nutanix OMS Data Collector installation package and a corresponding license file with your product key.

2. Save the installation package and the license file on the system that will host Nutanix OMS Data Collector.

3. Open a command shell and change the current directory to the one with the installation package.

11/31

https://www.microsoft.com/en-us/cloud-platform/operations-management-suite

http://managementpacks.comtrade.com/downloadarea/ct_nutanix_omssolutions/index.html


4. Run the following command (with a user account having privileges to install RPM packages):

rpm -i cts-oms-dc-nutanix-<Version>.x86_64.rpm

To verify that Nutanix OMS Data Collector was installed successfully, do the following:

1. Verify that the ctsomsdc service is started. Run the following command:

service ctsomsdc status

The command output should resemble the following:

ctsomsdc is running ... PID=<ProcessID>

TIP You can use the following commands to manage the ctsomsdc service:

service ctsomsdc start|stop|status|restart

CONFIGURING NUTANIX OMS DATA COLLECTOR

To configure Nutanix OMS Data Collector, complete the following tasks in the Nutanix OMS Data Collector configuration GUI:

1. Configure OMS settings.

Nutanix OMS Data Collector uses these settings to determine your OMS workspace it should forward data to.

2. Configure Nutanix Prism settings.

Nutanix OMS Data Collector uses these settings to determine its data sources (Nutanix clusters).

3. Perform product licensing tasks.

Nutanix OMS Data Collector starts collecting and relaying data after it successfully verifies a locally installed license file.

In specific circumstances, additional configuration tasks are required:

1. Configure custom ports for inbound traffic for Nutanix OMS Data Collector.

Port reconfiguration is needed when a firewall blocks inbound network traffic on the default (predefined) ports.

2. Configure the product to use a proxy server.

Proxy server must be used when direct communication between Nutanix OMS Data Collector and OMS is not possible.

3. Configure Nutanix cluster node-specific Redfish credentials.

4. A special command-line tool, set_redfish_credentials, must be used to configure Redfish credentials for individual cluster nodes.

CONFIGURING OMS SETTINGS

To configure OMS settings, do the following:

12/31


1. Open a web browser and go to webpage of the Nutanix OMS Data Collector configuration GUI (for example, at the address https://computer.company.com:8443).

2. In the configuration GUI, click Microsoft OMS Settings.

Figure 2 Microsoft OMS Settings page

3. In the main toolbar, click Edit.

4. In the text boxes, enter the Workspace ID and Primary Key you acquired from the OMS portal, and then click Save.

CONFIGURING NUTANIX PRISM SETTINGS

To configure Nutanix Prism settings, do the following:

1. In the Nutanix OMS Data Collector configuration GUI, click Nutanix Prism Settings.

2. In the main toolbar, click Add New Data Source.

13/31


Figure 3 Nutanix Prism Settings page

3. Specify the Nutanix cluster that you plan to monitor. To do so, follow the steps:

a. Enter the following data:

l Host name or IP address of the Nutanix cluster's virtual system

l Port number (default value: 9440)

l Credentials of the Prism user account configured to be used for connection to Nutanix OMS Data Collector


l Credentials for accessing hardware sensors on cluster nodes through Redfish API implementation on the nodes (IPMI web interface credentials, default values: ADMIN, ADMIN)


IMPORTANT The specified Redfish credentials are used for all cluster nodes. If Redfish API implementations on different cluster nodes use different credentials, an additional configuration step is required later in this procedure.

b. Click Save.

4. If needed, configure different Redfish API implementation credentials for individual cluster nodes.

14/31


For instructions, see "Configuring cluster node-specific Redfish credentials" on page 18.

5. Repeat steps 2 and 4 for each additional Nutanix cluster that you plan to monitor using Nutanix OMS Solution.

PERFORMING PRODUCT LICENSING TASKS

Nutanix OMS Solution licenses for purchase are issued for and bound to a specific Data Collector system. They are time-limited. Each license limits the total number of CPU sockets in all Nutanix clusters from where data is collected by the Nutanix OMS Data Collector instance installed on the Data Collector system. If the number of actual sockets in the monitored clusters does not exceed the number specified in the license, the license is treated as valid.

Licenses for purchase are issued based on the license specification that is sent in scope of your license order. Timely renewal of your licensees ensures continuity of product operation.

Nutanix OMS Solution evaluation licenses can be used on any Data Collector system.

To order a Nutanix OMS Solution license for one Nutanix OMS Data Collector instance, and activate the instance so that it starts collecting and relaying monitoring data, do the following:

1. In the Nutanix OMS Data Collector configuration GUI, click Product License.

Figure 4 Product License – License Manager page

2. If you are evaluating the product and have received evaluation license (the License.dat file), skip to step 11. If you purchased the product, continue with step 3.

3. In the License Manager pane, click Generate to generate a customized license specification that matches your Nutanix OMS Data Collector configuration.

4. When the specification is ready, click Save to save it to the License.req file.

15/31


5. Open a web browser and go to the MP Licensing Portal webpage.

6. If you already have a licensing portal account, click Sign in and enter your user name and password to sign in. Else, click Create an account and fill in the form to create an account.

7. Click Activate permanent licenses, enter your purchase order number, and then click Next.

8. Click Choose File, browse to the folder with the License.req file, and select the file. Click Send Request.

9. In the Activate permanent licenses page, review the list of Nutanix clusters and the number of required CPU sockets within each cluster for which you want to activate the license. Click Activate Licenses to send your license order.

10. After you receive a registration confirmation email from Comtrade Software, save the attached License.dat file to a location on the system from where you are connected to the Nutanix OMS Data Collector configuration GUI.

11. In the Nutanix OMS Data Collector configuration GU, in the License Manager pane, click Browse.

12. Navigate to the folder with the License.dat file, select it, and click Open.

13. Click Upload and allow a few moments for Nutanix OMS Data Collector to restart.

Your Nutanix OMS Data Collector instance on this system is activated.

You can always check licensing status (the number of actual and licensed CPU sockets) on the left side of the Nutanix OMS Data Collector configuration GUI. The LICENSE IS INVALID message may denote two distinctive cases:

l License is invalid in terms of how many Nutanix clusters and hosts (CPU sockets) are being monitored

This is the case when the number of actual CPU sockets is smaller than the number of licensed CPU sockets. To make your license valid again, repeat the procedure documented in this section.

l License has expired

This is the case when the number of licensed CPU sockets is still equal to or bigger than the number of actual CPU sockets, but the licensed period expired. Contact Comtrade Software Customer Support for assistance.

CONFIGURING CUSTOM PORTS FOR INBOUND TRAFFIC

To configure Nutanix OMS Data Collector to listen on custom (non-predefined) ports, do the following:

1. On the Data Collector system, open a command shell and run the following command to stop Nutanix OMS Data Collector:

service ctsomsdc stop

2. Change the current directory to /opt/cts/nutanix-oms/conf and open the configuration.json file in a plain text editor.

3. Change the main port number used by Nutanix OMS Data Collector. To do so, locate the serverConfig object, and change the value of the following attributes:

16/31

https://managementpacks.comtrade.com/mp-licensing/


l webServerPort, for HTTP l webSecureServerPort, for HTTPS

Lines that define default attribute values of serverConfig are as follows:

"serverConfig": { "startWebServer": true, "webServerPort": 8080, "startSecureWebServer": true, "webSecureServerPort": 8443 },

4. Change the port number used for Nutanix system log forwarding. To do so, locate the syslogConfig object, and change the value of the port attribute:

Lines that define default attribute values of syslogConfig are as follows:

"serverConfig": { "port": 54100, "startOnStartup": true, },

5. Save your changes.

6. In a command shell, run the following command to start Nutanix OMS Data Collector:

service ctsomsdc start

CONFIGURING THE PRODUCT TO USE A PROXY SERVER

Nutanix OMS Data Collector automatically uses an HTTP proxy server for communication with OMS when the proxy server is set in the interactive command shell configuration for the user account that runs Nutanix OMS Data Collector. If a proxy server is not set, you must update the configuration yourself.

To set a proxy server for Nutanix OMS Data Collector, do the following:

1. Open the ~/.bashrc file in a plain text editor.

2. Add the following line to the file:

export HTTP_PROXY=<ProxyServerFQDN>:<ProxyServerPort>

In this instance, the placeholders have the meanings as follows.

<ProxyServerFQDN> Fully qualified domain name of the system that acts as a proxy

<ProxyServerPort> Port number that the proxy server is using

Example:

export HTTP_PROXY=proxy.company.com:5000

3. Save your changes.

4. Open a command shell and run the following command to restart Nutanix OMS Data Collector:

service ctsomsdc restart

17/31


CONFIGURING CLUSTER NODE-SPECIFIC REDFISH CREDENTIALS

To configure different Redfish API implementation credentials for individual nodes of a Nutanix cluster, do the following:

1. On the Data Collector system, open a command shell and run the following command to stop Nutanix OMS Data Collector:

service ctsomsdc stop

2. Change the current directory as follows:

cd /opt/cts/nutanix-oms/bin/tools

3. Run the following command to list configured Nutanix clusters and their nodes:

./set_redfish_credentials -l

4. Run the following command to configure or change Redfish credentials for a cluster node in the Data Collector's data source configuration:

./set_redfish_credentials -a <RedfishAddress>

In this instance, the placeholder has the meaning as follows.

<RedfishAddress> IP address of the Redfish API implementation on the cluster node

Alternatively, run the following command instead:

./set_redfish_credentials -n <HostName>

In this instance, the placeholder has the meaning as follows.

<HostName> Host name of the Nutanix cluster node

5. Supply the credentials as prompted by the command.

6. Repeat steps 4 and 5 for each additional cluster node that uses different Redfish credentials.

7. Run the following command to start Nutanix OMS Data Collector:


ENABLING NUTANIX SYSTEM LOG FORWARDING (OPTIONAL)To benefit from the OMS log analytics functionality, you must enable log forwarding from the Nutanix appliances to Nutanix OMS Data Collector. The cumulative size of the forwarded logs affects the cost of your OMS license, and may grow very large. You should therefore carefully select the systems from which you plan to collect logs and decide which log severity levels to include.

To enable Nutanix system log forwarding, do the following (documented commands must be run in the command shell):

1. Connect to the Nutanix cluster by using SSH:

ssh nutanix@<ClusterName>


18/31


nutanixOne of Nutanix cluster's default (predefined) user names that you can use for

SSH connections

<ClusterName> Host name of the Nutanix cluster

2. Start the Nutanix command-line interface:

ncli

3. Stop the rsyslog service and prevent it from being automatically started in the future:

rsyslog-config set-status enable=false

4. Enable log forwarding to Nutanix OMS Data Collector:

rsyslog-config add-server name=<HostName> ip-address=<IPaddress> port=54100 network-protocol=UDP


<HostName>Fully qualified domain name of the system where Nutanix OMS Data Collector is

installed

<IPaddress> IP address of the system where Nutanix OMS Data Collector is installed

In this instance, is the , and is the IP address of this system.

5. Specify Nutanix modules from which you plan to collect logs and the log severity levels. For each module, you can select a different level.

For each Nutanix module, run the following command:

rsyslog-config add-module server-name=<HostName> module-name=<ModuleName> level=<Level> include-monitor-logs=true


<HostName>Fully qualified domain name of the system where Nutanix OMS Data Collector is

installed

<ModuleName>A Nutanix module name; available modules are: cassandra, cerebro, curator,

genesis, prism, stargate, zookeeper

<Level>One of the following severity levels: INFO, WARNING, ERROR, FATAL; the specified

level defines the minimum severity level that is still included in data forwarding

Example:

rsyslog-config add-server name=computer.company.com ip-address=10.17.100.100 port=54100 network-protocol=UDPrsyslog-config add-module server-name=computer.company.com module-name=cassandra level=WARNING include-monitor-logs=truersyslog-config add-module server-name=computer.company.com module-name=cerebro

19/31


level=WARNING include-monitor-logs=truersyslog-config add-module server-name=computer.company.com module-name=curator level=WARNING include-monitor-logs=truersyslog-config add-module server-name=computer.company.com module-name=genesis level=WARNING include-monitor-logs=truersyslog-config add-module server-name=computer.company.com module-name=prism level=WARNING include-monitor-logs=truersyslog-config add-module server-name=computer.company.com module-name=stargate level=WARNING include-monitor-logs=truersyslog-config add-module server-name=computer.company.com module-name=zookeeper level=WARNING include-monitor-logs=true

IMPORTANT Chosen severity level affects the size of the forwarded logs. To avoid overloading OMS, consider setting a higher minimum severity level.

6. Start the rsyslog service:

rsyslog-config set-status enable=true

DEPLOYING NUTANIX OMS SOLUTION

Depending on the data you want to view on the OMS portal, you must add all or specific solutions to your OMS workspace.

To add solutions to your OMS workspace, do the following:

1. Sign in to the Azure portal.

2. In the New blade under Marketplace, select the Monitoring + management group.

3. In the Monitoring + Management blade, click See all.

4. To the right of Management Solutions, click More.

5. In the Management Solutions blade, select one of the following management solutions that you want to add to a workspace:

l Nutanix Clusters

l Nutanix Hardware

l Nutanix Hardware Sensors

l Nutanix Log and Event Analytics

l Nutanix Storage

l Nutanix Virtual Machines

6. In the management solution blade, review information, and then click Create.

7. In the blade of the added management solution, select a workspace to associate the solution with.

8. Review other options and click Create.

9. Repeat steps 2 to 8 for each additional solution that you want to use.

20/31

CHAPTER 3: REMOVALThis chapter contains instructions on how to effectively remove Nutanix OMS Solution from your environment. To remove Nutanix OMS Solution, complete these tasks:

1. Remove Nutanix OMS Data Collector from its host system. For details, see "Removing Nutanix OMS Data Collector" below.

2. Remove included solutions from OMS portal. For details, see "Removing solutions from the OMS workspace" below.

REMOVING NUTANIX OMS DATA COLLECTOR

To remove Nutanix OMS Data Collector, do the following:

1. On the Data Collector system, open a command shell.

2. Run the following command (with a user account having privileges to remove RPM packages):

rpm -e cts-oms-dc-nutanix

REMOVING SOLUTIONS FROM THE OMS WORKSPACE

To remove solutions from the OMS workspace, do the following:

1. Sign in to the Azure portal.

2. Navigate to Log Analytics > Subscriptions > <YourWorkspaceName>.

3. In the <YourWorkspaceName> blade , click Solutions.

4. In the solution list, select the solution for removal.

5. In the solution blade, click Delete, and then click Yes to confirm the deletion.

6. Repeat steps 4 and 5 for each additional component of Nutanix OMS Solution.

21/31

CHAPTER 4: USAGEThis chapter describes Nutanix OMS Solution components (solutions) . For conceptual and usage information on OMS, see the product documentation.

GENERAL INFORMATION

All Nutanix OMS Solution components share a common feature: ability to monitor Nutanix appliances from an OMS workspace. Each component includes a set of predefined views that cover specific area of the monitored Nutanix infrastructure. These views are based on preconfigured queries. Some of the components also include a set of predefined alerts, based on preconfigured semaphores. Even when an alert is enabled (switched on), it is not active until you configure its alert rule so that it automatically performs at least one action, depending on how you prefer to be notified.

IMPORTANT Only alerts of critical severity are enabled by default, but they are inactive, that is, their alert rules are not configured.

You can always add new or customize the predefined views and alerts. For alerts, you can change their general settings (for example, severity, search query, and time window), their schedules, and their actions. For more information, see the Understanding alerts in OMS Log Analytics webpage on the Microsoft Docs website.

NUTANIX CLUSTERS

This solution provides an overview of the health status and performance for Nutanix clusters. It includes the following views:

l Storage Capacity (storage capacity in TB over time by cluster)

l CPU Capacity (CPU capacity in GHz over time by cluster)

l Memory Capacity over time by Cluster

l Storage, Memory, and CPU Utilization over time by Cluster

l Controller Information (IOPS, cluster I/O latency (ms), I/O bandwidth)

l Total VMs per Cluster (number of running, switched off, and suspended VMs)

l Nutanix Alerts (number of active critical alerts and warnings)

l List of Queries

The solution includes the following alerts:

l ClusterCPUusage_80 rule

l ClusterCPUusage_90 rule

l ClusterMEMUsage_80 rule

l ClusterMEMUsage_90 rule

22/31

https://docs.microsoft.com/en-us/azure/log-analytics/log-analytics-alerts


l ClusterSTORUsage_80 rule

l ClusterSTORUsage_90 rule

NUTANIX HARDWARE

This solution provides a summary of the health status and performance for Nutanix hardware. It includes the following views:

l Host CPU Usage over time

l Host Memory Usage over time

l Hosts by Number of Hosted VMs over time

l Hosts I/O Latency over time

l Host IOPS over time

l HDD and SSD Drives

l List of Queries


l HostCPUusage_70 rule

l HostCPUusage_90 rule

l HostMEMusage_70 rule

l HostMEMusage_90 rule

NUTANIX HARDWARE SENSORS

This solution extends Nutanix hardware monitoring beyond disks and hosts by using DMTF’s Redfish standard specification and schema implementations, and offers management of scalable platform hardware to collect low-level information from hardware component sensors. The solution includes the following views:

l Total Fans

l Fans (fan speeds over time)

l Total Voltage Sensors

l Voltages (voltage readings over time)

l Total Temperature Sensors

l Temperature (temperature over time)

l Power Levels over Time (input voltage, power output, consumed watts)

l List of Queries

23/31


NUTANIX LOG AND EVENT ANALYTICS

This solution provides a central point for Nutanix log and event collection and analytics. It also provides predefined queries on the Nutanix log files and events to help troubleshoot various Nutanix alerts and issues. The solution includes the following views:

l Syslog Messages (number of messages in all clusters)

l List of Queries

NUTANIX STORAGE

This solution provides a summary of the health status and performance for Nutanix storage. It includes the following views:

l Cluster Storage (storage utilization by cluster over time)

l Storage Pool SSD Vs. HDD Ratio (ratio of SSD units to HDD units by storage pool over time)

l Storage Pool (disk average I/O latency, disk I/O bandwidth, disk IOPS by storage pool over time)

l Container SSD Vs. HDD Ratio (ratio of SSD units to HDD units by container over time)

l Container (disk average I/O latency, disk I/O bandwidth, disk IOPS by container over time)

l List of Queries

NUTANIX VIRTUAL MACHINES

This solution provides a summary of the health status and performance for virtual machines hosted on Nutanix clusters. It includes the following views:

l VM per Cluster (number of VMs by cluster over time)

l VM CPU Utilization (VM CPU utilization by cluster over time)

l VM Memory Utilization (VM memory utilization by cluster over time)

l VM I/O Latency (VM I/O latency by cluster over time)

l VM I/O Bandwidth (VM I/O bandwidth by cluster over time)

l VM IOPS (VM IOPS by cluster over time)

l CVM CPU Utilization (CVM CPU utilization by cluster over time)

l CVM Memory Utilization (CVM memory utilization by cluster over time)

l List of Queries


l NutanixCVMCPUusage_70 rule

l NutanixCVMCPUusage_90 rule

l NutanixCVMMEM_70 rule

24/31


l NutanixCVMMEM_90 rule

l NutanixVMCPU_70 rule

l NutanixVMCPU_90 rule

l NutanixVMMEM_70 rule

l NutanixVMMEM_90 rule

25/31

CHAPTER 5: TROUBLESHOOTINGIf you encounter problems when using Nutanix OMS Solution, you can often solve them yourself. This chapter is intended to help you.

GENERAL TROUBLESHOOTING GUIDELINES

When investigating an issue, first verify that:

l All installation prerequisites are fulfilled and the product is configured according to the provided instructions.

l You are not running into a known product limitation. For a list of the limitations, see the Comtrade OMS Solution for Nutanix Release Notes.

l Your issue is not related to third-party software or hardware (Nutanix or Microsoft). Otherwise, contact the respective vendor for assistance.

l You have the latest operating system and software application patches installed on the affected systems.

l The affected systems are not running out of memory or storage space.

NUTANIX OMS DATA COLLECTOR LOG FILES

Nutanix OMS Data Collector records occurrences of unexpected behavior (errors) into its log files. You can browse through the most recent log entries in the Data Collector Log page of the Nutanix OMS Data Collector configuration GUI.

26/31


Figure 5 Data Collector Log page

Stopping the pointer on an entry displays the associated stack trace. To download the complete set of log files with an entire error history, click Download Entire Log in the main toolbar.

PROBLEMS AND SOLUTIONS

This section lists symptoms of common problems that you may encounter while using Nutanix OMS Solution, together with proposed actions – resolution steps.

You cannot reach Nutanix OMS Data Collector configuration GUI

Symptom

Webpage of the Nutanix OMS Data Collector configuration GUI is inaccessible.

Action

Verify the status of the ctsomsdc service on the Data Collector system. Do the following:

1. Open a command shell and run the following command:

service ctsomsdc status

2. Depending on the command output that you get, do one of the following:

l ctsomsdcis not running ...

Run the following command to start it:


27/31


l ctsomsdc is running ... PID=<ProcessID>

This means that the service is running, but unresponsive. Run the following command to restart it:

service ctsomsdc restart

Microsoft OMS settings do not appear to be saved

Symptom

In the Microsoft OMS Settings page of the Nutanix OMS Data Collector configuration GUI, nothing happens after you attempt to save configuration for which a valid workspace ID and a primary key are specified.

Action

Inspect the Nutanix OMS Data Collector log for the following error—it may indicate that Nutanix OMS Data Collector is not able to establish a direct connection to OMS:

"message":"Could not process web request to OMS.","stack":"Error: connect ETIMEDOUT <OMSworkspaceAddress>:443"

If you find this error, set the HTTP proxy server in the operating system's configuration on the Data Collector system. For instructions, see "Configuring the product to use a proxy server" on page 17.

BEFORE CONTACTING COMTRADE SOFTWARE CUSTOMER SUPPORT

If you cannot solve your issue, report it. Before contacting Comtrade Software Customer Support, make sure that:

l You perform the general checks. For details, see "General troubleshooting guidelines" on page 26.

l You verify that your problem is not documented in this chapter. For details, see "Problems and solutions" on the previous page.

l You collect relevant data that might be required to send to Comtrade Software Customer Support: a description of your problem, configuration specification of your environment, and similar information. For a complete list, see "Customer support" on page 29.

The Comtrade Software Customer Support team will provide you with further instructions. Among other things, you may be asked to perform diagnostic operations in your environment and collect specific data from your systems and send it to Comtrade Software.

NOTE The Comtrade Software Customer Support team is not qualified to solve the issues related to third-party software or hardware.

For information on how to reach Comtrade Software Customer Support, see "Comtrade Software Customer Support and information " on page 29.

28/31

COMTRADE SOFTWARE CUSTOMER SUPPORT AND INFORMATION CONTACTING COMTRADE SOFTWARE

Use the following email and webpage addresses if you need:

l Additional information about this product

l Help with the product licensing process

l Assistance while using the product

l Information about other Comtrade Software products

CUSTOMER SUPPORT

Should you require additional information or assistance while using the product, contact the vendor that shipped it. If you have purchased the product directly from Comtrade Software, submit your query through the following webpage:www.comtradesoftware.com/submit-an-issue/

Important: Before contacting support department, perform a health check on all systems that are in failed (critical, red) state and have the following information ready:

l Symptoms

l Sequence of events leading to the problem

l Commands and options that you used

l Messages you have received (a description with the date and time)

COMPANY WEBSITE AND VIDEO CHANNEL

For more information about our company and other products we offer, visit Comtrade Software website at:www.comtradesoftware.com

For additional product-related information, watch videos on the Comtrade Software channel on YouTube:www.youtube.com/user/comtradeproducts

GENERAL INFORMATION

For questions related to product business or purchase of this or other Comtrade Software products, send an email to:[email protected]

29/31

https://www.comtradesoftware.com/submit-an-issue/

http://www.comtradesoftware.com/

http://www.youtube.com/user/comtradeproducts

mailto:[email protected]


FEEDBACK

For comments or suggestions about this product, including its documentation, send an email to:[email protected]

We will be glad to hear from you!

30/31

mailto:[email protected]

comtrade oms solution for nutanix user guide installing nutanix oms solution, make sure that the...

Documents