Comtrade OMS Solution for Nutanix USER GUIDE PRODUCT VERSION: 1.0 PRODUCT RELEASE DATE: MAY 2017 DOCUMENT EDITION: FIRST

Transcription

1 Cmtrade OMS Slutin fr Nutanix USER GUIDE PRODUCT VERSION: 1.0 PRODUCT RELEASE DATE: MAY 2017 DOCUMENT EDITION: FIRST

2 LEGAL NOTICES COPYRIGHT NOTICE 2017 Cmtrade Sftware. All rights reserved. This dcument cntains prprietary infrmatin, which is prtected by cpyright. N part f this dcument may be phtcpied, reprduced, distributed, transmitted, stred in a retrieval system, mdified r translated t anther language in any frm by any means, withut the prir written cnsent f Cmtrade Sftware (Cmtrade). TRADEMARKS Cmtrade Sftware lgs, names, trademarks and/r service marks and cmbinatins theref are the prperty f Cmtrade r its affiliates. Other prduct names are the prperty f their respective trademark r service mark hlders and are hereby acknwledged. Azure, Micrsft, and Windws are either registered trademarks r trademarks f Micrsft Crpratin in the United States and/r ther cuntries. Enterprise Clud Platfrm, Nutanix, and Prism are trademarks f Nutanix, Inc. in the United States and/r ther jurisdictins. Redfish is a registered trademark f Distributed Management Task Frce, Inc. (DTMF). DISCLAIMER The details and descriptins cntained in this dcument are believed t have been accurate and up t date at the time the dcument was written. The infrmatin cntained in this dcument is subject t change withut ntice. Cmtrade Sftware prvides this material "as is" and makes n warranty f any kind, expressed r implied, including, but nt limited t, the implied warranties f merchantability and fitness fr a particular purpse. Cmtrade shall nt be liable fr errrs and missins cntained herein. In n event shall Cmtrade be liable fr any direct, indirect, cnsequential, punitive, special r incidental damages, including, withut limitatin, damages fr lss and prfits, lss f anticipated savings, business interruptin, r lss f infrmatin arising ut f the use r inability t use this dcument, r any actin taken based n the infrmatin cntained herein, even if it has been advised f the pssibility f such damages, whether based n warranty, cntract, r any ther legal thery. The nly warranties fr Cmtrade Sftware prducts and services are set frth in the express warranty statements accmpanying such prducts and services. Nthing herein shuld be cnstrued as cnstituting an additinal warranty. NOTICE This dcument is prvided in cnnectin with Cmtrade Sftware prducts. Cmtrade may have cpyright, patents, patent applicatins, trademark, r ther intellectual prperty rights cvering the subject matter f this dcument. 2/31

3 Except as expressly prvided in any written license agreement frm Cmtrade Sftware, the furnishing f this dcument des nt give yu any license t these patents, trademarks, cpyrights, r ther intellectual prperty n Cmtrade Sftware prducts. Use f underlying Cmtrade Sftware prduct(s) is gverned by their respective Sftware License and Supprt Terms. Imprtant: Please read Sftware License and Supprt Terms befre using the accmpanying sftware prduct(s). Cmtrade Sftware 3/31

4 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

5 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

6 CHAPTER 1: INTRODUCTION This chapter intrduces Cmtrade OMS Slutin fr Nutanix and explains hw it interacts with Nutanix Enterprise Clud Platfrm and Micrsft Operatins Management Suite. ABOUT COMTRADE OMS SOLUTION FOR NUTANIX Cmtrade OMS Slutin fr Nutanix (Nutanix OMS Slutin) is an availability, perfrmance management, and analysis slutin that extends end-t-end service mnitring capabilities f OMS t include npremises Nutanix appliances. It includes multiple slutins (als referred t as Nutanix OMS Slutin cmpnents) with a predefined set f views t fully integrate Nutanix data, events, and lgs int the OMS prtal, prviding the peratin verview and lg analytics acrss the Nutanix infrastructure and enabling delivery f effective business service management. Nutanix OMS Slutin als prvides pssibility t generate alerts accrding t availability, perfrmance, cnfiguratin, r security cnditins that are identified. It enables yu t mnitr, detect, trublesht, remediate, and prevent prblems frm ccurring in yur Nutanix appliance. Nutanix OMS Slutin prvides the fllwing majr features: Discvery and visualizatin: Autmatic discvery and visualizatin f Nutanix clusters, hsts, strage, and virtual machines (VMs) by using histrical charts and predefined queries. It als prvides predefined queries fr Nutanix lg and event analytics. Centralized mnitring f the discvered Nutanix envirnment, lg and event analytics ver the OMS prtal. Health, availability, and perfrmance mnitring: Mnitring f the Nutanix infrastructure health state frm perfrmance issues t utilizatin, latency, lad, and availability. Detectin f perfrmance degradatin befre it affects end users Mnitring f Nutanix cmpnents and tasks: Autmatic detectin f Nutanix infrastructure cmpnents, such as: Clusters: Strage, CPU, and memry capacity and utilizatin, I/O latency, IOPS, I/O bandwidth, blcks, hsts, number f VMs. Virtual machines: Number f VMs (per cluster, pwered n/pwered ff/suspended/paused VMs), ttal CPU and memry utilizatin, ttal VM I/O latency, IOPS. Hardware: Hst CPU and memry utilizatin, number f hsted VMs, hst I/O latency and IOPS, blcks per cluster, Nutanix hardware editins, number f SSD drives, number f HDD drives. Hardware sensrs: Fans and fan rtatin speeds, cmpnents and cmpnent 6/31

7 Nutanix lg analytics: temperatures, pwer supply and pwer cntrl units, their vltages and wattages. Strage: Strage utilizatin, strage pls, cntainers. Prvisin f a central pint fr investigating lgs. Cllectin f, crrelatin f, and search in lg and perfrmance data generated by perating systems and applicatins. Usage f predefined queries t help remediate prblems ccurring in Nutanix clusters. Prblem identificatin and reslutin mechanism: Prvisin f infrmatin that can help yu identify the prblem and its rt cause. Alert-based ntificatin abut increased resurce utilizatin. 7/31

8 PRODUCT ARCHITECTURE Nutanix OMS Slutin uses a sphisticated cmpnent called Cmtrade OMS Data Cllectr fr Nutanix (Nutanix OMS Data Cllectr) that is installed n a system f yur chice (Data Cllectr system). Nutanix OMS Data Cllectr cnnects t ne r mre Nutanix appliances by using the Nutanix REST API interface and sends the cllected perfrmance data t OMS by using its HTTP Data Cllectr API. Nutanix OMS Data Cllectr can als act as a syslg server and can frward Nutanix system lg files t OMS. The fllwing diagram shws hw Nutanix OMS Slutin cnnects the OMS platfrm and the Nutanix infrastructure. Figure 1 High-level verview f the Nutanix OMS Slutin envirnment ABOUT NUTANIX Nutanix delivers enterprise cmputing and strage featuring built-in virtualizatin. Nutanix hypercnverged infrastructure natively integrates servers, strage netwrk, and strage int a single x86-based server deplyed in scale-ut clusters. Ndes (hsts) that are part f the enterprise-scale clusters run industry-standard r native hypervisrs and the Nutanix perating system (AOS, frmerly knwn as NOS). Each server cntains x86-64 prcessrs, memry, slid state drives (SSDs), and traditinal hard disk drives (HDDs) that aggregate strage resurces int a single strage pl. Capacity is added by adding ndes t the cmputing cluster. 8/31

9 Built-in virtualizatin allws applicatins and data t mve freely between n-premises envirnments and public cluds. All data, metadata, and peratins are distributed acrss the entire cluster cmbining physical and virtual strage. Such cmbined functinality eliminates perfrmance bttlenecks, enables predictable scalability withut limits, reduces pwer and space cnsumptin, and eliminates strage cmplexity. Nutanix Enterprise Clud Platfrm features predictable perfrmance, clud-like infrastructure cnsumptin, rbust security, and applicatin mbility fr a brad range f enterprise applicatins withut infrastructure cnstraints. The infrastructure is truly invisible, shifting fcus back t applicatins. ABOUT MICROSOFT OPERATIONS MANAGEMENT SUITE Micrsft Operatins Management Suite (OMS) is a clud-based IT management slutin that helps yu manage and prtect yur n-premises and clud infrastructure. Yu can benefit frm the fllwing majr value areas f OMS: Insight and analytics Autmatin and cntrl Prtectin and recvery Security and cmpliance In additin t prviding valuable services n its wn, OMS can integrate with Micrsft System Center cmpnents such as System Center Operatins Manager t extend yur existing management investment int the clud. System Center and OMS can wrk tgether t prvide a full hybrid management experience. Fr mre infrmatin abut OMS, see the prduct dcumentatin. 9/31

10 CHAPTER 2: INSTALLATION AND CONFIGURATION This chapter cntains instructins n hw t install and cnfigure Nutanix OMS Slutin n the Nutanix appliance and OMS sides. T install and cnfigure Nutanix OMS Slutin, cmplete these tasks: 1. Ensure that the installatin prerequisites are fulfilled. Fr details, see "Installatin prerequisites" belw. 2. Install Nutanix OMS Data Cllectr. Fr details, see "Installing Nutanix OMS Data Cllectr" n the next page. 3. Cnfigure Nutanix OMS Data Cllectr. Fr details, see "Cnfiguring Nutanix OMS Data Cllectr" n page Optinal. Enable the Nutanix system t prvide system lgs fr OMS. Fr details, see "Enabling Nutanix system lg frwarding (ptinal)" n page Deply Nutanix OMS Slutin. Fr details, see "Deplying Nutanix OMS Slutin" n page 20. INSTALLATION PREREQUISITES Befre installing Nutanix OMS Slutin, make sure that the fllwing prerequisites are fulfilled: Prduct requirements dcumented in Cmtrade OMS Slutin fr Nutanix Release Ntes are met. Nutanix appliance prerequisites: Fr cnnecting the Nutanix OMS Data Cllectr system with Nutanix Prism, a Nutanix Prism user accunt is selected. This accunt must exist in each Nutanix cluster that yu plan t mnitr. Cmtrade Sftware recmmends that yu select an accunt that has privileges nly fr cllecting (reading) data. Fr cllecting hardware sensr data, a user accunt is selected that can access hardware sensrs n cluster ndes thrugh Redfish API implementatin n the ndes. Cmtrade Sftware recmmends that yu select an accunt that has privileges nly fr cllecting (reading) data. Nutanix OMS Slutin supprts cnfiguratins with different user credentials n different cluster ndes. OMS platfrm prerequisites: The OMS wrkspace ID and primary key are knwn. T acquire the OMS wrkspace ID and primary key, d the fllwing: 10/31

11 1. Open a web brwser, g t the Overview Micrsft Operatins Management Suite webpage and then click Sign in. 2. On the Sign in t yur accunt webpage, prvide yur access credentials, and then sign in t the OMS prtal. 3. Click Settings. 4. In the Overview page, select Cnnected Surces > Windws Servers. Lcate the Wrkspace ID and Primary Key fields and cpy their cntents. Name reslutin fr the fully qualified dmain name that includes the wrkspace ID is functining. T verify this, n the Data Cllectr system, pen a cmmand shell and run the fllwing cmmand: nslkup <WrkspaceID>.ds.pinsights.azure.cm The cmmand utput shuld resemble the fllwing sample utput: Server: <DNSfqdn> Address: <DNSipAddress> Nn-authritative answer: <WrkspaceID>.ds.pinsights.azure.cm cannical name = pinsightsweuds.trafficmanager.net. pinsightsweuds.trafficmanager.net cannical name = pinsights-weu-dsb.cludapp.net. Name: pinsights-weu-ds-b.cludapp.net Address: <IPaddress> Web brwser prerequisites: A cmpatible web brwser is used t access the Nutanix OMS Data Cllectr cnfiguratin GUI. Fr a list f the cmpatible web brwsers, see the Cmtrade OMS Slutin fr Nutanix Cmpatibility Matrix. The web brwser must be set t allw JavaScript executin. Fr infrmatin n Nutanix Enterprise Clud Platfrm and the OMS platfrm (fr example, hardware and sftware requirements, perating system supprt, and installatin and cnfiguratin prcedures), see the Nutanix and Micrsft dcumentatin. INSTALLING NUTANIX OMS DATA COLLECTOR T install Nutanix OMS Data Cllectr, d the fllwing: 1. G t the Cmtrade OMS Slutin fr Nutanix Lgin webpage, lg in, and dwnlad the Nutanix OMS Data Cllectr installatin package and a crrespnding license file with yur prduct key. 2. Save the installatin package and the license file n the system that will hst Nutanix OMS Data Cllectr. 3. Open a cmmand shell and change the current directry t the ne with the installatin package. 11/31

12 4. Run the fllwing cmmand (with a user accunt having privileges t install RPM packages): rpm -i cts-ms-dc-nutanix-<versin>.x86_64.rpm T verify that Nutanix OMS Data Cllectr was installed successfully, d the fllwing: 1. Verify that the ctsmsdc service is started. Run the fllwing cmmand: service ctsmsdc status The cmmand utput shuld resemble the fllwing: ctsmsdc is running... PID=<PrcessID> TIP Yu can use the fllwing cmmands t manage the ctsmsdc service: service ctsmsdc start stp status restart CONFIGURING NUTANIX OMS DATA COLLECTOR T cnfigure Nutanix OMS Data Cllectr, cmplete the fllwing tasks in the Nutanix OMS Data Cllectr cnfiguratin GUI: 1. Cnfigure OMS settings. Nutanix OMS Data Cllectr uses these settings t determine yur OMS wrkspace it shuld frward data t. 2. Cnfigure Nutanix Prism settings. Nutanix OMS Data Cllectr uses these settings t determine its data surces (Nutanix clusters). 3. Perfrm prduct licensing tasks. Nutanix OMS Data Cllectr starts cllecting and relaying data after it successfully verifies a lcally installed license file. In specific circumstances, additinal cnfiguratin tasks are required: 1. Cnfigure custm prts fr inbund traffic fr Nutanix OMS Data Cllectr. Prt recnfiguratin is needed when a firewall blcks inbund netwrk traffic n the default (predefined) prts. 2. Cnfigure the prduct t use a prxy server. Prxy server must be used when direct cmmunicatin between Nutanix OMS Data Cllectr and OMS is nt pssible. 3. Cnfigure Nutanix cluster nde-specific Redfish credentials. A special cmmand-line tl, set_redfish_credentials, must be used t cnfigure Redfish credentials fr individual cluster ndes. CONFIGURING OMS SETTINGS T cnfigure OMS settings, d the fllwing: 12/31

13 1. Open a web brwser and g t webpage f the Nutanix OMS Data Cllectr cnfiguratin GUI (fr example, at the address 2. In the cnfiguratin GUI, click Micrsft OMS Settings. Figure 2 Micrsft OMS Settings page 3. In the main tlbar, click Edit. 4. In the text bxes, enter the Wrkspace ID and Primary Key yu acquired frm the OMS prtal, and then click Save. CONFIGURING NUTANIX PRISM SETTINGS T cnfigure Nutanix Prism settings, d the fllwing: 1. In the Nutanix OMS Data Cllectr cnfiguratin GUI, click Nutanix Prism Settings. 2. In the main tlbar, click Add New Data Surce. 13/31

14 Figure 3 Nutanix Prism Settings page 3. Specify the Nutanix cluster that yu plan t mnitr. T d s, fllw the steps: a. Enter the fllwing data: b. Click Save. Hst name r IP address f the Nutanix cluster's virtual system Prt number (default value: 9440) Credentials f the Prism user accunt cnfigured t be used fr cnnectin t Nutanix OMS Data Cllectr Cmtrade Sftware recmmends that yu select an accunt that has privileges nly fr cllecting (reading) data. Credentials fr accessing hardware sensrs n cluster ndes thrugh Redfish API implementatin n the ndes (IPMI web interface credentials, default values: ADMIN, ADMIN) Cmtrade Sftware recmmends that yu select an accunt that has privileges nly fr cllecting (reading) data. IMPORTANT The specified Redfish credentials are used fr all cluster ndes. If Redfish API implementatins n different cluster ndes use different credentials, an additinal cnfiguratin step is required later in this prcedure. 4. If needed, cnfigure different Redfish API implementatin credentials fr individual cluster ndes. 14/31

15 Fr instructins, see "Cnfiguring cluster nde-specific Redfish credentials" n page Repeat steps 2 and 4 fr each additinal Nutanix cluster that yu plan t mnitr using Nutanix OMS Slutin. PERFORMING PRODUCT LICENSING TASKS Nutanix OMS Slutin licenses fr purchase are issued fr and bund t a specific Data Cllectr system. They are time-limited. Each license limits the ttal number f CPU sckets in all Nutanix clusters frm where data is cllected by the Nutanix OMS Data Cllectr instance installed n the Data Cllectr system. If the number f actual sckets in the mnitred clusters des nt exceed the number specified in the license, the license is treated as valid. Licenses fr purchase are issued based n the license specificatin that is sent in scpe f yur license rder. Timely renewal f yur licensees ensures cntinuity f prduct peratin. Nutanix OMS Slutin evaluatin licenses can be used n any Data Cllectr system. T rder a Nutanix OMS Slutin license fr ne Nutanix OMS Data Cllectr instance, and activate the instance s that it starts cllecting and relaying mnitring data, d the fllwing: 1. In the Nutanix OMS Data Cllectr cnfiguratin GUI, click Prduct License. Figure 4 Prduct License License Manager page 2. If yu are evaluating the prduct and have received evaluatin license (the License.dat file), skip t step 11. If yu purchased the prduct, cntinue with step In the License Manager pane, click Generate t generate a custmized license specificatin that matches yur Nutanix OMS Data Cllectr cnfiguratin. 4. When the specificatin is ready, click Save t save it t the License.req file. 15/31

16 5. Open a web brwser and g t the MP Licensing Prtal webpage. 6. If yu already have a licensing prtal accunt, click Sign in and enter yur user name and passwrd t sign in. Else, click Create an accunt and fill in the frm t create an accunt. 7. Click Activate permanent licenses, enter yur purchase rder number, and then click Next. 8. Click Chse File, brwse t the flder with the License.req file, and select the file. Click Send Request. 9. In the Activate permanent licenses page, review the list f Nutanix clusters and the number f required CPU sckets within each cluster fr which yu want t activate the license. Click Activate Licenses t send yur license rder. 10. After yu receive a registratin cnfirmatin frm Cmtrade Sftware, save the attached License.dat file t a lcatin n the system frm where yu are cnnected t the Nutanix OMS Data Cllectr cnfiguratin GUI. 11. In the Nutanix OMS Data Cllectr cnfiguratin GU, in the License Manager pane, click Brwse. 12. Navigate t the flder with the License.dat file, select it, and click Open. 13. Click Uplad and allw a few mments fr Nutanix OMS Data Cllectr t restart. Yur Nutanix OMS Data Cllectr instance n this system is activated. Yu can always check licensing status (the number f actual and licensed CPU sckets) n the left side f the Nutanix OMS Data Cllectr cnfiguratin GUI. The LICENSE IS INVALID message may dente tw distinctive cases: License is invalid in terms f hw many Nutanix clusters and hsts (CPU sckets) are being mnitred This is the case when the number f actual CPU sckets is smaller than the number f licensed CPU sckets. T make yur license valid again, repeat the prcedure dcumented in this sectin. License has expired This is the case when the number f licensed CPU sckets is still equal t r bigger than the number f actual CPU sckets, but the licensed perid expired. Cntact Cmtrade Sftware Custmer Supprt fr assistance. CONFIGURING CUSTOM PORTS FOR INBOUND TRAFFIC T cnfigure Nutanix OMS Data Cllectr t listen n custm (nn-predefined) prts, d the fllwing: 1. On the Data Cllectr system, pen a cmmand shell and run the fllwing cmmand t stp Nutanix OMS Data Cllectr: service ctsmsdc stp 2. Change the current directry t /pt/cts/nutanix-ms/cnf and pen the cnfiguratin.jsn file in a plain text editr. 3. Change the main prt number used by Nutanix OMS Data Cllectr. T d s, lcate the servercnfig bject, and change the value f the fllwing attributes: 16/31

17 webserverprt, fr HTTP websecureserverprt, fr HTTPS Lines that define default attribute values f servercnfig are as fllws: "servercnfig": { "startwebserver": true, "webserverprt": 8080, "startsecurewebserver": true, "websecureserverprt": 8443 }, 4. Change the prt number used fr Nutanix system lg frwarding. T d s, lcate the syslgcnfig bject, and change the value f the prt attribute: Lines that define default attribute values f syslgcnfig are as fllws: "servercnfig": { "prt": 54100, "startonstartup": true, }, 5. Save yur changes. 6. In a cmmand shell, run the fllwing cmmand t start Nutanix OMS Data Cllectr: service ctsmsdc start CONFIGURING THE PRODUCT TO USE A PROXY SERVER Nutanix OMS Data Cllectr autmatically uses an HTTP prxy server fr cmmunicatin with OMS when the prxy server is set in the interactive cmmand shell cnfiguratin fr the user accunt that runs Nutanix OMS Data Cllectr. If a prxy server is nt set, yu must update the cnfiguratin yurself. T set a prxy server fr Nutanix OMS Data Cllectr, d the fllwing: 1. Open the ~/.bashrc file in a plain text editr. 2. Add the fllwing line t the file: exprt HTTP_PROXY=<PrxyServerFQDN>:<PrxyServerPrt> In this instance, the placehlders have the meanings as fllws. <PrxyServerFQDN> <PrxyServerPrt> Fully qualified dmain name f the system that acts as a prxy Prt number that the prxy server is using Example: exprt HTTP_PROXY=prxy.cmpany.cm: Save yur changes. 4. Open a cmmand shell and run the fllwing cmmand t restart Nutanix OMS Data Cllectr: service ctsmsdc restart 17/31

18 CONFIGURING CLUSTER NODE-SPECIFIC REDFISH CREDENTIALS T cnfigure different Redfish API implementatin credentials fr individual ndes f a Nutanix cluster, d the fllwing: 1. On the Data Cllectr system, pen a cmmand shell and run the fllwing cmmand t stp Nutanix OMS Data Cllectr: service ctsmsdc stp 2. Change the current directry as fllws: cd /pt/cts/nutanix-ms/bin/tls 3. Run the fllwing cmmand t list cnfigured Nutanix clusters and their ndes:./set_redfish_credentials -l 4. Run the fllwing cmmand t cnfigure r change Redfish credentials fr a cluster nde in the Data Cllectr's data surce cnfiguratin:./set_redfish_credentials -a <RedfishAddress> In this instance, the placehlder has the meaning as fllws. <RedfishAddress> IP address f the Redfish API implementatin n the cluster nde Alternatively, run the fllwing cmmand instead:./set_redfish_credentials -n <HstName> In this instance, the placehlder has the meaning as fllws. <HstName> Hst name f the Nutanix cluster nde 5. Supply the credentials as prmpted by the cmmand. 6. Repeat steps 4 and 5 fr each additinal cluster nde that uses different Redfish credentials. 7. Run the fllwing cmmand t start Nutanix OMS Data Cllectr: service ctsmsdc start ENABLING NUTANIX SYSTEM LOG FORWARDING (OPTIONAL) T benefit frm the OMS lg analytics functinality, yu must enable lg frwarding frm the Nutanix appliances t Nutanix OMS Data Cllectr. The cumulative size f the frwarded lgs affects the cst f yur OMS license, and may grw very large. Yu shuld therefre carefully select the systems frm which yu plan t cllect lgs and decide which lg severity levels t include. T enable Nutanix system lg frwarding, d the fllwing (dcumented cmmands must be run in the cmmand shell): 1. Cnnect t the Nutanix cluster by using SSH: ssh nutanix@<clustername> In this instance, the placehlders have the meanings as fllws. 18/31

19 nutanix <ClusterName> One f Nutanix cluster's default (predefined) user names that yu can use fr SSH cnnectins Hst name f the Nutanix cluster 2. Start the Nutanix cmmand-line interface: ncli 3. Stp the rsyslg service and prevent it frm being autmatically started in the future: rsyslg-cnfig set-status enable=false 4. Enable lg frwarding t Nutanix OMS Data Cllectr: rsyslg-cnfig add-server name=<hstname> ip-address=<ipaddress> prt=54100 netwrk-prtcl=udp In this instance, the placehlders have the meanings as fllws. <HstName> <IPaddress> Fully qualified dmain name f the system where Nutanix OMS Data Cllectr is installed IP address f the system where Nutanix OMS Data Cllectr is installed In this instance, is the, and is the IP address f this system. 5. Specify Nutanix mdules frm which yu plan t cllect lgs and the lg severity levels. Fr each mdule, yu can select a different level. Fr each Nutanix mdule, run the fllwing cmmand: rsyslg-cnfig add-mdule server-name=<hstname> mdule-name=<mdulename> level=<level> include-mnitr-lgs=true In this instance, the placehlders have the meanings as fllws. <HstName> <MduleName> <Level> Fully qualified dmain name f the system where Nutanix OMS Data Cllectr is installed A Nutanix mdule name; available mdules are: cassandra, cerebr, curatr, genesis, prism, stargate, zkeeper One f the fllwing severity levels: INFO, WARNING, ERROR, FATAL; the specified level defines the minimum severity level that is still included in data frwarding Example: rsyslg-cnfig add-server name=cmputer.cmpany.cm ip-address= prt=54100 netwrk-prtcl=udp rsyslg-cnfig add-mdule server-name=cmputer.cmpany.cm mdule-name=cassandra level=warning include-mnitr-lgs=true rsyslg-cnfig add-mdule server-name=cmputer.cmpany.cm mdule-name=cerebr 19/31

20 level=warning include-mnitr-lgs=true rsyslg-cnfig add-mdule server-name=cmputer.cmpany.cm mdule-name=curatr level=warning include-mnitr-lgs=true rsyslg-cnfig add-mdule server-name=cmputer.cmpany.cm mdule-name=genesis level=warning include-mnitr-lgs=true rsyslg-cnfig add-mdule server-name=cmputer.cmpany.cm mdule-name=prism level=warning include-mnitr-lgs=true rsyslg-cnfig add-mdule server-name=cmputer.cmpany.cm mdule-name=stargate level=warning include-mnitr-lgs=true rsyslg-cnfig add-mdule server-name=cmputer.cmpany.cm mdule-name=zkeeper level=warning include-mnitr-lgs=true IMPORTANT Chsen severity level affects the size f the frwarded lgs. T avid verlading OMS, cnsider setting a higher minimum severity level. 6. Start the rsyslg service: rsyslg-cnfig set-status enable=true DEPLOYING NUTANIX OMS SOLUTION Depending n the data yu want t view n the OMS prtal, yu must add all r specific slutins t yur OMS wrkspace. T add slutins t yur OMS wrkspace, d the fllwing: 1. Sign in t the Azure prtal. 2. In the New blade under Marketplace, select the Mnitring + management grup. 3. In the Mnitring + Management blade, click See all. 4. T the right f Management Slutins, click Mre. 5. In the Management Slutins blade, select ne f the fllwing management slutins that yu want t add t a wrkspace: Nutanix Clusters Nutanix Hardware Nutanix Hardware Sensrs Nutanix Lg and Event Analytics Nutanix Strage Nutanix Virtual Machines 6. In the management slutin blade, review infrmatin, and then click Create. 7. In the blade f the added management slutin, select a wrkspace t assciate the slutin with. 8. Review ther ptins and click Create. 9. Repeat steps 2 t 8 fr each additinal slutin that yu want t use. 20/31

21 CHAPTER 3: REMOVAL This chapter cntains instructins n hw t effectively remve Nutanix OMS Slutin frm yur envirnment. T remve Nutanix OMS Slutin, cmplete these tasks: 1. Remve Nutanix OMS Data Cllectr frm its hst system. Fr details, see "Remving Nutanix OMS Data Cllectr" belw. 2. Remve included slutins frm OMS prtal. Fr details, see "Remving slutins frm the OMS wrkspace" belw. REMOVING NUTANIX OMS DATA COLLECTOR T remve Nutanix OMS Data Cllectr, d the fllwing: 1. On the Data Cllectr system, pen a cmmand shell. 2. Run the fllwing cmmand (with a user accunt having privileges t remve RPM packages): rpm -e cts-ms-dc-nutanix REMOVING SOLUTIONS FROM THE OMS WORKSPACE T remve slutins frm the OMS wrkspace, d the fllwing: 1. Sign in t the Azure prtal. 2. Navigate t Lg Analytics > Subscriptins > <YurWrkspaceName>. 3. In the <YurWrkspaceName> blade, click Slutins. 4. In the slutin list, select the slutin fr remval. 5. In the slutin blade, click Delete, and then click Yes t cnfirm the deletin. 6. Repeat steps 4 and 5 fr each additinal cmpnent f Nutanix OMS Slutin. 21/31

22 CHAPTER 4: USAGE This chapter describes Nutanix OMS Slutin cmpnents (slutins). Fr cnceptual and usage infrmatin n OMS, see the prduct dcumentatin. GENERAL INFORMATION All Nutanix OMS Slutin cmpnents share a cmmn feature: ability t mnitr Nutanix appliances frm an OMS wrkspace. Each cmpnent includes a set f predefined views that cver specific area f the mnitred Nutanix infrastructure. These views are based n precnfigured queries. Sme f the cmpnents als include a set f predefined alerts, based n precnfigured semaphres. Even when an alert is enabled (switched n), it is nt active until yu cnfigure its alert rule s that it autmatically perfrms at least ne actin, depending n hw yu prefer t be ntified. IMPORTANT Only alerts f critical severity are enabled by default, but they are inactive, that is, their alert rules are nt cnfigured. Yu can always add new r custmize the predefined views and alerts. Fr alerts, yu can change their general settings (fr example, severity, search query, and time windw), their schedules, and their actins. Fr mre infrmatin, see the Understanding alerts in OMS Lg Analytics webpage n the Micrsft Dcs website. NUTANIX CLUSTERS This slutin prvides an verview f the health status and perfrmance fr Nutanix clusters. It includes the fllwing views: Strage Capacity (strage capacity in TB ver time by cluster) CPU Capacity (CPU capacity in GHz ver time by cluster) Memry Capacity ver time by Cluster Strage, Memry, and CPU Utilizatin ver time by Cluster Cntrller Infrmatin (IOPS, cluster I/O latency (ms), I/O bandwidth) Ttal VMs per Cluster (number f running, switched ff, and suspended VMs) Nutanix Alerts (number f active critical alerts and warnings) List f Queries The slutin includes the fllwing alerts: ClusterCPUusage_80 rule ClusterCPUusage_90 rule ClusterMEMUsage_80 rule ClusterMEMUsage_90 rule 22/31

23 ClusterSTORUsage_80 rule ClusterSTORUsage_90 rule NUTANIX HARDWARE This slutin prvides a summary f the health status and perfrmance fr Nutanix hardware. It includes the fllwing views: Hst CPU Usage ver time Hst Memry Usage ver time Hsts by Number f Hsted VMs ver time Hsts I/O Latency ver time Hst IOPS ver time HDD and SSD Drives List f Queries The slutin includes the fllwing alerts: HstCPUusage_70 rule HstCPUusage_90 rule HstMEMusage_70 rule HstMEMusage_90 rule NUTANIX HARDWARE SENSORS This slutin extends Nutanix hardware mnitring beynd disks and hsts by using DMTF s Redfish standard specificatin and schema implementatins, and ffers management f scalable platfrm hardware t cllect lw-level infrmatin frm hardware cmpnent sensrs. The slutin includes the fllwing views: Ttal Fans Fans (fan speeds ver time) Ttal Vltage Sensrs Vltages (vltage readings ver time) Ttal Temperature Sensrs Temperature (temperature ver time) Pwer Levels ver Time (input vltage, pwer utput, cnsumed watts) List f Queries 23/31

24 NUTANIX LOG AND EVENT ANALYTICS This slutin prvides a central pint fr Nutanix lg and event cllectin and analytics. It als prvides predefined queries n the Nutanix lg files and events t help trublesht varius Nutanix alerts and issues. The slutin includes the fllwing views: Syslg Messages (number f messages in all clusters) List f Queries NUTANIX STORAGE This slutin prvides a summary f the health status and perfrmance fr Nutanix strage. It includes the fllwing views: Cluster Strage (strage utilizatin by cluster ver time) Strage Pl SSD Vs. HDD Rati (rati f SSD units t HDD units by strage pl ver time) Strage Pl (disk average I/O latency, disk I/O bandwidth, disk IOPS by strage pl ver time) Cntainer SSD Vs. HDD Rati (rati f SSD units t HDD units by cntainer ver time) Cntainer (disk average I/O latency, disk I/O bandwidth, disk IOPS by cntainer ver time) List f Queries NUTANIX VIRTUAL MACHINES This slutin prvides a summary f the health status and perfrmance fr virtual machines hsted n Nutanix clusters. It includes the fllwing views: VM per Cluster (number f VMs by cluster ver time) VM CPU Utilizatin (VM CPU utilizatin by cluster ver time) VM Memry Utilizatin (VM memry utilizatin by cluster ver time) VM I/O Latency (VM I/O latency by cluster ver time) VM I/O Bandwidth (VM I/O bandwidth by cluster ver time) VM IOPS (VM IOPS by cluster ver time) CVM CPU Utilizatin (CVM CPU utilizatin by cluster ver time) CVM Memry Utilizatin (CVM memry utilizatin by cluster ver time) List f Queries The slutin includes the fllwing alerts: NutanixCVMCPUusage_70 rule NutanixCVMCPUusage_90 rule NutanixCVMMEM_70 rule 24/31

25 NutanixCVMMEM_90 rule NutanixVMCPU_70 rule NutanixVMCPU_90 rule NutanixVMMEM_70 rule NutanixVMMEM_90 rule 25/31

26 CHAPTER 5: TROUBLESHOOTING If yu encunter prblems when using Nutanix OMS Slutin, yu can ften slve them yurself. This chapter is intended t help yu. GENERAL TROUBLESHOOTING GUIDELINES When investigating an issue, first verify that: All installatin prerequisites are fulfilled and the prduct is cnfigured accrding t the prvided instructins. Yu are nt running int a knwn prduct limitatin. Fr a list f the limitatins, see the Cmtrade OMS Slutin fr Nutanix Release Ntes. Yur issue is nt related t third-party sftware r hardware (Nutanix r Micrsft). Otherwise, cntact the respective vendr fr assistance. Yu have the latest perating system and sftware applicatin patches installed n the affected systems. The affected systems are nt running ut f memry r strage space. NUTANIX OMS DATA COLLECTOR LOG FILES Nutanix OMS Data Cllectr recrds ccurrences f unexpected behavir (errrs) int its lg files. Yu can brwse thrugh the mst recent lg entries in the Data Cllectr Lg page f the Nutanix OMS Data Cllectr cnfiguratin GUI. 26/31

27 Figure 5 Data Cllectr Lg page Stpping the pinter n an entry displays the assciated stack trace. T dwnlad the cmplete set f lg files with an entire errr histry, click Dwnlad Entire Lg in the main tlbar. PROBLEMS AND SOLUTIONS This sectin lists symptms f cmmn prblems that yu may encunter while using Nutanix OMS Slutin, tgether with prpsed actins reslutin steps. Yu cannt reach Nutanix OMS Data Cllectr cnfiguratin GUI Symptm Webpage f the Nutanix OMS Data Cllectr cnfiguratin GUI is inaccessible. Actin Verify the status f the ctsmsdc service n the Data Cllectr system. D the fllwing: 1. Open a cmmand shell and run the fllwing cmmand: service ctsmsdc status 2. Depending n the cmmand utput that yu get, d ne f the fllwing: ctsmsdcis nt running... Run the fllwing cmmand t start it: service ctsmsdc start 27/31

28 ctsmsdc is running... PID=<PrcessID> This means that the service is running, but unrespnsive. Run the fllwing cmmand t restart it: service ctsmsdc restart Micrsft OMS settings d nt appear t be saved Symptm In the Micrsft OMS Settings page f the Nutanix OMS Data Cllectr cnfiguratin GUI, nthing happens after yu attempt t save cnfiguratin fr which a valid wrkspace ID and a primary key are specified. Actin Inspect the Nutanix OMS Data Cllectr lg fr the fllwing errr it may indicate that Nutanix OMS Data Cllectr is nt able t establish a direct cnnectin t OMS: "message":"culd nt prcess web request t OMS.","stack":"Errr: cnnect ETIMEDOUT <OMSwrkspaceAddress>:443" If yu find this errr, set the HTTP prxy server in the perating system's cnfiguratin n the Data Cllectr system. Fr instructins, see "Cnfiguring the prduct t use a prxy server" n page 17. BEFORE CONTACTING COMTRADE SOFTWARE CUSTOMER SUPPORT If yu cannt slve yur issue, reprt it. Befre cntacting Cmtrade Sftware Custmer Supprt, make sure that: Yu perfrm the general checks. Fr details, see "General trubleshting guidelines" n page 26. Yu verify that yur prblem is nt dcumented in this chapter. Fr details, see "Prblems and slutins" n the previus page. Yu cllect relevant data that might be required t send t Cmtrade Sftware Custmer Supprt: a descriptin f yur prblem, cnfiguratin specificatin f yur envirnment, and similar infrmatin. Fr a cmplete list, see "Custmer supprt" n page 29. The Cmtrade Sftware Custmer Supprt team will prvide yu with further instructins. Amng ther things, yu may be asked t perfrm diagnstic peratins in yur envirnment and cllect specific data frm yur systems and send it t Cmtrade Sftware. NOTE The Cmtrade Sftware Custmer Supprt team is nt qualified t slve the issues related t thirdparty sftware r hardware. Fr infrmatin n hw t reach Cmtrade Sftware Custmer Supprt, see "Cmtrade Sftware Custmer Supprt and infrmatin " n page /31

29 COMTRADE SOFTWARE CUSTOMER SUPPORT AND INFORMATION CONTACTING COMTRADE SOFTWARE Use the fllwing and webpage addresses if yu need: Additinal infrmatin abut this prduct Help with the prduct licensing prcess Assistance while using the prduct Infrmatin abut ther Cmtrade Sftware prducts CUSTOMER SUPPORT Shuld yu require additinal infrmatin r assistance while using the prduct, cntact the vendr that shipped it. If yu have purchased the prduct directly frm Cmtrade Sftware, submit yur query thrugh the fllwing webpage: Imprtant: Befre cntacting supprt department, perfrm a health check n all systems that are in failed (critical, red) state and have the fllwing infrmatin ready: Symptms Sequence f events leading t the prblem Cmmands and ptins that yu used Messages yu have received (a descriptin with the date and time) COMPANY WEBSITE AND VIDEO CHANNEL Fr mre infrmatin abut ur cmpany and ther prducts we ffer, visit Cmtrade Sftware website at: Fr additinal prduct-related infrmatin, watch vides n the Cmtrade Sftware channel n YuTube: GENERAL INFORMATION Fr questins related t prduct business r purchase f this r ther Cmtrade Sftware prducts, send an t: inf@cmtradesftware.cm 29/31

30 FEEDBACK Fr cmments r suggestins abut this prduct, including its dcumentatin, send an t: inf@cmtradesftware.cm We will be glad t hear frm yu! 30/31

31