Zenoss Resource Manager Installation Guide

Transcription

1 Zenoss Resource Mnger Instlltion Guide Relese Zenoss, Inc.

2 Zenoss Resource Mnger Instlltion Guide Copyright 2017 Zenoss, Inc. All rights reserved. Zenoss nd the Zenoss logo re trdemrks or registered trdemrks of Zenoss, Inc., in the United Sttes nd other countries. All other trdemrks, logos, nd service mrks re the property of Zenoss or other third prties. Use of these mrks is prohibited without the express written consent of Zenoss, Inc., or the third-prty owner. Amzon Web Services, AWS, nd EC2 re trdemrks of Amzon.com, Inc. or its ffilites in the United Sttes nd/or other countries. Flsh is registered trdemrk of Adobe Systems Incorported. Orcle, the Orcle logo, Jv, nd MySQL re registered trdemrks of the Orcle Corportion nd/or its ffilites. Linux is registered trdemrk of Linus Torvlds. RbbitMQ is trdemrk of Pivotl Softwre, Inc. SNMP Informnt is trdemrk of Grth K. Willims (Informnt Systems, Inc.). Sybse is registered trdemrk of Sybse, Inc. Tomct is trdemrk of the Apche Softwre Foundtion. VMwre is registered trdemrk or trdemrk of VMwre, Inc. in the United Sttes nd/or other jurisdictions. Windows is registered trdemrk of Microsoft Corportion in the United Sttes nd other countries. All other compnies nd products mentioned re trdemrks nd property of their respective owners. Prt Number: Zenoss, Inc Four Points Drive Bldg 1 - Suite 300 Austin, Texs

3 Contents About this guide...5 Supported operting systems nd browsers... 8 Supported operting environments...9 Chpter 1: Instlling Resource Mnger Instlling the Resource Mnger templte...10 Optionl: Importing Resource Mnger imges Deploying Resource Mnger Chpter 2: Instlling Resource Mnger in high-vilbility cluster...13 Instlling the Resource Mnger templte...13 Importing Resource Mnger imges...13 Deploying Resource Mnger Prt I: Applince deployments Chpter 3: Instlling Control Center mster host Creting virtul mchine Configuring the Control Center mster host Edit connection to configure sttic IPv4 ddressing...22 Setting the system hostnme Adding the mster host to resource pool Deploying Resource Mnger Chpter 4: Instlling delegte hosts Creting virtul mchine Configuring the virtul mchine...31 Edit connection to configure sttic IPv4 ddressing...32 Setting the system hostnme Editing the /etc/hosts file...36 Chpter 5: Configuring multi-host Control Center cluster...37 Enbling NTP on Microsoft Hyper-V guests...37 Adding hosts to the defult resource pool Chpter 6: Configuring ZooKeeper ensemble...42 ZooKeeper nd Control Center Understnding the configurtion process Configuring the mster host s ZooKeeper node...44 Configuring delegte host A s ZooKeeper node Configuring delegte host B s ZooKeeper node

4 Strting ZooKeeper ensemble for the first time...47 Updting delegte hosts...48 Appendix A: Prepring to instll without internet ccess...50 Downloding Resource Mnger imge files Stging the Resource Mnger service definition...50 Stging Docker Engine imge files

5 About this guide About this guide Zenoss Resource Mnger Instlltion Guide provides detiled procedures for instlling Zenoss Resource Mnger (Resource Mnger). Relted Resource Mnger publictions Title Zenoss Resource Mnger Administrtion Guide Zenoss Resource Mnger Configurtion Guide Zenoss Resource Mnger Instlltion Guide Zenoss Resource Mnger Plnning Guide Zenoss Resource Mnger Relese Notes Zenoss Resource Mnger Upgrde Guide Description Provides n overview of Resource Mnger rchitecture nd fetures, s well s procedures nd exmples to help use the system. Provides required nd optionl configurtion procedures for Resource Mnger, to prepre your deployment for monitoring in your environment. Provides detiled informtion nd procedures for creting deployments of Control Center nd Resource Mnger. Provides both generl nd specific informtion for prepring to deploy Resource Mnger. Describes known issues, fixed issues, nd ltebreking informtion not lredy provided in the published documenttion set. Provides detiled informtion nd procedures for upgrding deployments of Resource Mnger. Additionl informtion nd comments If you hve technicl questions bout this product tht re not nswered in this guide, plese visit the Zenoss Support site or contct Zenoss Support. Zenoss welcomes your comments nd suggestions regrding our documenttion. To shre your comments, plese send n emil to docs@zenoss.com. In the emil, include the document title nd prt number. The prt number ppers t the end of the list of trdemrks, t the front of this guide. Chnge history The following list ssocites document prt numbers nd the importnt chnges to this guide since the previous relese. Some of the chnges involve fetures or content, but others do not. For informtion bout new or chnged fetures, refer to the Zenoss Resource Mnger Relese Notes (5.2.5) Updte relese numbers (5.2.4) Updte relese numbers (5.2.3) Add chpter for high-vilbility instlltions. New procedures for instlling the pplince with Hyper-V. Updte relese numbers. 5

6 Zenoss Resource Mnger Instlltion Guide (5.2.2) Remove procedure for dding storge for bckups (no longer required for pplinces) (5.2.1) Updte relese numbers (5.2.0) Add section detiling the supported operting environments. Remove procedures for instlling Control Center clusters. Tht informtion is now in the Control Center Instlltion Guide. Remove the high-vilbility chpters. High-vilbility instlltions re now performed by Zenoss personnel. Remove the pplince instlltion chpters. The chpters will be replced when the pplinces re vilble. The instructions for downloding nd instlling the softwre rtifcts for offline deployments re now in n ppendix Updte relese numbers Updte relese numbers Updte relese numbers Updte relese numbers Added supported operting environments nd updted relese numbers Updte relese numbers Updte relese numbers Updte relese numbers Updte relese numbers Refine the procedure for creting the ppliction dt thin pool Add support for Resource Mnger Add substep to crete the docker override directory Add this document chnge history. Add chpters describing how to instll the Resource Mnger pplince. Chpters re orgnized into prts. Docker configurtion steps now dd the storge driver flg (-s devicempper) to the /etc/ sysconfig/docker file. Docker needs longer strtup timeout vlue, to work round known Docker issue with the devicempper driver. Docker configurtion steps now include dding TimeoutSec=300. 6

7 About this guide Rther thn editing /lib/systemd/system/docker.service, Docker configurtion steps now include dding systemd override file. Add symlink to /tmp in /vr/lib/docker. Updte the commnds for strting nd testing ZooKeeper ensemble. Add procedure for updting the SERVICED_ZK vlue on delegte hosts tht re not members of ZooKeeper ensemble. Add reference topic for the ZooKeeper vribles required on hosts in Control Center cluster. Add procedures for configuring n NTP server nd clients for offline deployments. Add step to instll the Nmp Nct pckge, which is used to check ZooKeeper ensemble sttus Plnning informtion is now in the Zenoss Resource Mnger Plnning Guide. Informtion bout how to strt nd configure Resource Mnger is now in the Zenoss Resource Mnger Configurtion Guide. New procedures re included, for instlling without internet ccess, nd for instlling high-vilbility deployments. 7

8 Zenoss Resource Mnger Instlltion Guide Supported operting systems nd browsers The following tble identifies the supported combintions of client operting systems nd web browsers. Client OS Windows 7 nd 8.1 Windows 10 Windows Server 2012 R2 Mcintosh OS/X 10.9 Ubuntu LTS Red Ht Enterprise Linux 6.5, CentOS 6.5 Supported Browsers Internet Explorer 11 (Enterprise mode only; comptibility mode is not supported.) Internet Explorer 10 * Internet Explorer 11 (Enterprise mode only; comptibility mode is not supported.) Internet Explorer 10 * Firefox 50 nd lter Chrome 54 nd lter Microsoft Edge Firefox 30 Chrome 36 Firefox 30 nd bove Chrome 36 nd bove Firefox 30 nd bove Chrome 37 nd bove Firefox 30 nd bove Chrome 37 nd bove * Support for Internet Explorer 10 will be withdrwn beginning with the next feture relese of Resource Mnger. 8

9 Supported operting environments Supported operting environments The Resource Mnger ppliction is deployed in nd mnged by Control Center. The supported operting environments of Resource Mnger re the environments tht Control Center supports t given relese. The following sections identify the supported operting environments of Resource Mnger. Resource Mnger, Control Center, nd operting systems The following tble identifies the supported combintions of Resource Mnger, Control Center, nd operting system releses. Resource Mnger Relese 5.2.0, 5.2.1, 5.2.2, 5.2.3, 5.2.4, Control Center Relese 1.2.0, 1.2.1, 1.2.2, 1.2.3, 1.3.0, 1.3.1, 1.3.2, Host OS RHEL/CentOS 7.1, 7.2, or 7.3 (64-bit) 5.1.9, , RHEL/CentOS 7.1 or 7.2 (64-bit) , 1.1.6, , RHEL/CentOS 7.1 or 7.2 (64-bit) , 1.1.6, 1.1.7, RHEL/CentOS 7.1 or 7.2 (64-bit) (internl relese only) (none) (none) 5.1.4, , 1.1.6, RHEL/CentOS 7.1 or 7.2 (64-bit) , 1.1.3, RHEL/CentOS 7.1 or 7.2 (64-bit) , RHEL/CentOS 7.1 or 7.2 (64-bit) , RHEL/CentOS 7.1 or 7.2 (64-bit) Hypervisors Hypervisor Versions VMwre vsphere 5.0, 5.1, 5.5, 6.0, 6.5 Microsoft Hyper-V Version 2.0 with Windows Server 2008 R2 SP1 Version 3.0 with Windows Server 2012 nd 2012 R2 Public cloud pltforms Amzon Web Services (AWS) is fully supported. Microsoft Azure is supported only for collector pools. Deploying full Control Center cluster to operte Resource Mnger is NOT supported on Microsoft Azure. Supported clients nd browsers Resource Mnger supports the sme client operting systems nd web browsers tht Control Center supports. For more informtion, refer to Control Center documenttion. 9

10 Zenoss Resource Mnger Instlltion Guide Instlling Resource Mnger 1 This chpter describes how to instll Resource Mnger on Control Center cluster. For more informtion bout creting Control Center cluster, refer to the following documents: Control Center Plnning Guide Zenoss Resource Mnger Plnning Guide Control Center Instlltion Guide If you re instlling on Control Center cluster tht does not hve internet ccess, perform the procedures in Prepring to instll without internet ccess on pge 50, nd then perform the procedures in this chpter. Instlling the Resource Mnger templte Use this procedure to instll the Resource Mnger service definition templte on the Control Center mster host. If you re instlling on Control Center cluster tht does not hve internet ccess, perform the procedures in Prepring to instll without internet ccess on pge 50 nd then perform this procedure. 1 Log in to the Control Center mster host s root, or s user with superuser privileges. 2 Instll the Resource Mnger templte file. With internet ccess: yum --enblerepo=zenoss-stble instll -y zenoss-resmgr-service Without internet ccess: yum instll -y /tmp/zenoss-resmgr-service norch.rpm The templte file is stored in /opt/serviced/templtes. 3 Authenticte to the Docker Hub repository. Replce Userwith the nme of your Docker Hub ccount. docker login -u User The docker service prompts you for the pssword of the Docker Hub ccount, nd sves hsh of the credentils in the $HOME/.docker/config.json file (root user ccount). 10

11 Instlling Resource Mnger Optionl: Importing Resource Mnger imges Use this procedure to import the Resource Mnger imges into the locl registry. This procedure is only required on Control Center cluster tht does not hve internet ccess. For more informtion, see Prepring to instll without internet ccess on pge Log in to the Control Center mster host s root, or s user with superuser privileges. 2 Chnge directory to /root. cd /root 3 Import the imges. The imges re contined in self-extrcting rchive files. for imge in instll-*.run do echo -n "$imge: "./$imge done Importing begins when you press the y key. If you press y nd then press Enter, the current imge is imported, but the next one is not. 4 List the imges in the registry. docker imges The result should include one imge for ech rchive file. 5 Optionl: Delete the rchive files. rm -i./instll-*.run Deploying Resource Mnger Use this procedure to dd the Resource Mnger ppliction to Control Center, nd to pull ppliction imges into the locl registry. 1 Log in to the Control Center mster host s user with serviced CLI privileges. 2 Add the Resource Mnger ppliction templte to Control Center. serviced templte dd /opt/serviced/templtes/zenoss*.json On success, the serviced commnd returns the templte ID. 3 Identify the resource pool to which the host belongs. serviced host list 4 Deploy the ppliction. Replce Templte-ID with the identifier Resource Mnger templte Replce Pool with the nme of the resource pool to which the mster host belongs (single-host system) or to which the delegte hosts belong (multi-host system) 11

12 Zenoss Resource Mnger Instlltion Guide Replce Deployment with nme for this deployment (for exmple, Test or Production) serviced templte deploy Templte-ID Pool Deployment Control Center pulls Resource Mnger imges into the locl registry, or just tgs the imges. Resource Mnger is redy to be configured for your environment. For more informtion, refer to the Zenoss Resource Mnger Configurtion Guide. 12

13 Instlling Resource Mnger in high-vilbility cluster Instlling Resource Mnger in highvilbility 2 cluster This chpter describes how to instll Resource Mnger on high-vilbility Control Center cluster. For more informtion bout creting high-vilbility Control Center cluster, refer to the Control Center Instlltion Guide for High-Avilbility Deployments. Note Perform the procedures in Prepring to instll without internet ccess on pge 50 nd then strt the procedures in this chpter. Instlling the Resource Mnger templte Use this procedure to instll the Resource Mnger service definition templte on Control Center mster host node. Perform this procedure on both mster host nodes. 1 Log in to the Control Center mster host s root, or s user with superuser privileges. 2 Instll the Resource Mnger templte file. yum instll -y /tmp/zenoss-resmgr-service norch.rpm The templte file is stored in /opt/serviced/templtes. Importing Resource Mnger imges Use this procedure to import the Resource Mnger imges into the locl registry. Perform this procedure on both mster host nodes. 1 Log in to the Control Center mster host s root, or s user with superuser privileges. 2 Chnge directory to /root. cd /root 3 Import the imges. The imges re contined in self-extrcting rchive files. for imge in instll-*.run do echo -n "$imge: "./$imge done 13

14 Zenoss Resource Mnger Instlltion Guide Importing begins when you press y. If you press y nd then press Enter, the current imge is imported, but the next one is not. 4 List the imges in the registry. docker imges The result should include one imge for ech rchive file. 5 Optionl: Delete the rchive files. rm -i./instll-*.run Deploying Resource Mnger Use this procedure to instll the Resource Mnger templte nd then deploy the ppliction. 1 Use the virtul hostnme (HA-Virtul-Nme) or virtul IP ddress (HA-Virtul-IP) of the high-vilbility cluster to strt Bsh shell on the Control Center mster host s root, or s user with superuser privileges. 2 Disply the public hostnme of the current node. unme -n The result is either Primry-Public-Nme or Secondry-Public-Nme. 3 Plce the other node in stndby mode. This voids potentil conflicts nd errors in the event of n unexpected serviced shutdown during the initil deployment. Replce Other-Node-Hostnme with the public hostnme of the other node: pcs cluster stndby Other-Node-Hostnme 4 Add the Resource Mnger ppliction templte to Control Center. serviced templte dd /opt/serviced/templtes/zenoss*.json On success, the serviced commnd returns the templte ID. 5 Identify the resource pool to which the mster host belongs. serviced host list 6 Deploy the ppliction. Replce Templte-ID with the identifier Resource Mnger templte Replce Pool with the nme of the resource pool to which the mster host belongs (single-host system) or to which the delegte hosts belong (multi-host system) Replce Deployment with nme for this deployment (for exmple, Test or Production) serviced templte deploy Templte-ID Pool Deployment Control Center tgs the Resource Mnger imges. 7 Restore the cluster. 14

15 Instlling Resource Mnger in high-vilbility cluster Replce Stndby-Node-Hostnme with the public hostnme of the node tht is in stndby mode: pcs cluster unstndby Stndby-Node-Hostnme Resource Mnger is redy to be configured for your environment. For more informtion, refer to the Zenoss Resource Mnger Configurtion Guide. Note In high-vilbility deployments, the mridb-events nd mridb-model services must be in the sme resource pool s the mster host nodes. A procedure for moving the services from their defult pool is provided in the Zenoss Resource Mnger Configurtion Guide. 15

16 Zenoss Resource Mnger Instlltion Guide Applince deployments The chpters in this prt describe how to instll the Resource Mnger pplince, pre-configured virtul mchine tht is redy to deploy to your hypervisor. The instructions include vriety of options for customizing your deployment for your environment. 16

17 Instlling Control Center mster host Instlling Control Center mster host 3 This chpter describes how to instll Resource Mnger pplince pckge s Control Center mster host. All Resource Mnger deployments require Control Center mster host. Creting virtul mchine You cn crete virtul mchine for the Resource Mnger pplince with VMwre vsphere or Microsoft Hyper-V. Choose one of the procedures in this section. Creting virtul mchine with vsphere To perform this tsk, you need A VMwre vsphere client Permission to downlod Resource Mnger softwre from the Zenoss Support site This procedure instlls Resource Mnger OVA pckges s virtul mchine mnged by vsphere Server version 6.5.0, using VMwre vsphere Web Client 6.5. The procedure might differ with other versions of VMwre vsphere Client. There re two seprte OVA pckges: one for the mster host nd one for delegtes. 1 Downlod the Resource Mnger mster host OVA file from the Zenoss Support site to your worksttion. 2 Use the VMwre vsphere Client to log in to vcenter s root, or s user with superuser privileges, nd then disply the Home view. 17

18 Zenoss Resource Mnger Instlltion Guide 3 Choose VMs nd Templtes. 4 In the top nvigtion br, choose Actions > Deploy OVF Templte. Figure 1: Deploy OVF Templte 5 Use pnels in the Deploy OVF Templte wizrd to select the OVF pckge: b c Select templte: To downlod nd instll the pckge from the internet, enter URL. To choose the pckge from drive on your worksttion or network shre, browse to the loction nd choose the OVA file. Click Next. Select nme nd loction: Specify nme for the OVF, select dtcenter or folder s the deployment loction, nd then click Next. Select resource: Select the host, cluster, or other resource on which to run the deployed templte, nd then click Next. 18

19 Instlling Control Center mster host d e f g Review detils: Verify the templte detils, nd then click Next. Select storge: In Select virtul disk formt, choose Thin Provison, ccept defults for other fields, nd then click Next. Select networks: Accept defults nd click Next. Redy to Complete: Verify the deployment settings, nd then click Finish. The Recent Tsks pne displys deployment progress nd sttus informtion. 6 Nvigte to the new virtul mchine's Getting Strted tb, nd then click Edit virtul mchine settings. 7 Edit Virtul Hrdwre settings for the virtul mchine s follows. Accept defult settings for other options. CPU: For single-host deployments, specify 8; for multi-host deployments, specify 4. Cores per socket: Specify 1. Memory: For single-host deployments, specify 64GB; for multi-host deployments, specify 16GB. Click OK. 8 On the new virtul mchine's Getting Strted tb, click Power on virtul mchine. 9 In the top nvigtion br, choose Actions > Open console. Proceed with Configuring the Control Center mster host on pge 21. Creting virtul mchine with Hyper-V To perform this tsk, you need: A Microsoft Remote Desktop Connection Administrtor privileges on Microsoft Hyper-V server Permission to downlod Resource Mnger softwre from the Zenoss Support site This procedure instlls the Resource Mnger pplince s virtul mchine mnged by Microsoft Hyper-V. There re seprte ISO files for the mster host nd delegtes. In this procedure, you downlod nd instll the mster ISO file. A seprte procedure provides instructions for instlling delegtes. 1 Use Microsoft Remote Desktop Connection to log in to Hyper-V host s Administrtor, or s user with Administrtor privileges. 2 Downlod the Resource Mnger ISO file from the Zenoss Support site to the Hyper-V host. Choose the mster ISO file. 3 Open Hyper-V Mnger. 4 In the left nvigtion pne, choose server to host the virtul mchine. 5 In the Actions pne, choose New > Virtul Mchine. The New Virtul Mchine Wizrd opens. 6 Use pnels in the wizrd to crete the virtul mchine: b c Specify Nme nd Loction: Provide nme for the virtul mchine, nd then click Next. Specify Genertion: Choose Genertion 1, nd then click Next. Assign Memory: Specify memory informtion s follows: Strtup memory d Multi-host deployment: (16GB). Single-host deployments: (64GB). Check Use Dynmic Memory for this virtul mchine. Click Next. Configure Networking: For Connection, choose virtul switch, nd then click Next. 19

20 Zenoss Resource Mnger Instlltion Guide e Connect Virtul Hrd Disk: Crete new disk on which to instll the guest operting system s follows: 1 Choose Crete virtul hrd disk. 2 Specify nme. 3 Size: Enter Click Next. f In lter step, you will crete dditionl disks. Instlltion Options: Access the mster ISO file s follows: g 1 Choose Instll n operting system from bootble CD/DVD-ROM. 2 Choose Imge file (.iso). 3 Specify or browse to the loction of the ISO imge file. Summry/Completing the New Virtul Mchine Wizrd: Verify the description, nd then click Finish. Hyper-V Mnger cretes the new virtul mchine, nd then closes the wizrd. 7 In the Hyper-V Mnger Virtul Mchines re, right-click the new virtul mchine, nd then choose Settings. 8 In the Hrdwre re on the left, configure s follows: b c Ensure tht the virtul hrd disk tht you creted is ttched to n IDE controller. A Hyper-V guest mchine cn only boot from n IDE drive. Choose Processor. In the Processor re on the right, in Number of virtul processors, enter the following vlue for your deployment type: Multi-host deployment: 4 Single-host deployment: 8 d Click Apply. 9 Crete dditionl virtul hrd disks s follows: b c d In the Hrdwre re on the left, choose ny controller nd loction tht will ccommodte the disk. In the controller re on the right, choose Hrd Drive, nd then click Add. In the re on the right, choose Virtul hrd disk, nd then click New. Complete pnels in the New Virtul Hrd Disk Wizrd s follows: 1 Choose Disk Formt: Choose VHDX, nd then click Next. 2 Choose Disk Type: Choose Dynmiclly expnding, nd then click Next. 3 Specify Nme nd Loction: Enter the disk nme, nd then click Next. 4 Configure Disk: e f Choose Crete new blnk virtul hrd disk. b Size: Enter 50. c Click Next. 5 Summry/New Virtul Hrd Disk Wizrd: Verify the description, nd then click Finish. In the Settings window, click Apply. Repet this step to crete dditionl virtul hrd disks in the following sizes (for totl of seven disks): 150GB 50GB 200GB 16GB 20

21 Instlling Control Center mster host 16GB When viewed from the Linux system, the disks might be reordered; however, the instlltion is not ffected by disk order. g In the Settings dilog box, click Apply, nd then click OK. 10 In the Hyper-V Mnger Virtul Mchines re, right-click the new virtul mchine, nd then choose Strt. Figure 2: Strting virtul mchine 11 In the Hyper-V Mnger Virtul Mchines re, right-click the new virtul mchine, nd then choose Connect. 12 In the Virtul Mchine Connection window, press Enter. The pplince instlltion process tkes bout 15 minutes, nd should complete with no dditionl input. If received, disregrd the Fst TSC clibrtion filure messge. Configuring the Control Center mster host Perform this procedure immeditely fter creting nd strting Control Center host. All Control Center deployments must include one system tht is configured s the mster host. 1 Gin ccess to the console interfce of the Control Center host through your hypervisor console interfce. Figure 3: Initil hypervisor console login prompt 2 Log in s the root user. The initil pssword is provided in the console. 3 The system prompts you to enter new pssword for root. Note Psswords must include minimum of eight chrcters, with t lest one chrcter from three of the following chrcter clsses: uppercse letter, lowercse letter, digit, nd specil. 4 The system prompts you to enter new pssword for ccuser. 21

22 Zenoss Resource Mnger Instlltion Guide The ccuser ccount is the defult ccount for gining ccess to the Control Center browser interfce. Edit connection to configure sttic IPv4 ddressing The defult configurtion for network connections is DHCP. To configure sttic IPv4 ddressing, perform this procedure. To nvigte in the text user interfce (TUI): To move forwrd or bckwrd through options, press the rrow keys. To disply menu or choose n option, press Enter. 1 Gin ccess to the Control Center host, through the console interfce of your hypervisor, or through remote shell utility such s PuTTY. 2 Log in s the root user. 3 Select the NetworkMnger TUI menu s follows: In the Applince Administrtion menu, select Configure Network nd DNS, nd then press Enter. 4 On the NetworkMnger TUI menu, select Edit connection, nd then press Enter. The TUI displys the connections tht re vilble on the host. 22

23 Instlling Control Center mster host Figure 4: Exmple: Avilble connections Note Do not use this procedure to modify the docker0 connection. 5 Select the virtul connection, nd then press Enter. Figure 5: Exmple: Edit Connection screen 6 Optionl: If the IPv4 CONFIGURATION re is not visible, select its disply option (<Show>), nd then press Enter. 7 In the IPv4 CONFIGURATION re, select <Automtic>, nd then press Enter. Figure 6: Exmple: IPv4 Configurtion options 8 Configure sttic IPv4 networking s follows: Select Mnul, nd then press Enter. b Beside Addresses, select <Add>, nd then press Enter. 23

24 Zenoss Resource Mnger Instlltion Guide c In the Addresses field, enter n IPv4 ddress for the virtul mchine, nd then press Enter. d Repet the preceding two steps for the Gtewy nd DNS servers fields. 9 Tb to the bottom of the Edit Connection screen to select <OK>, nd then press Enter. 10 Return to the Applince Administrtion menu: On the NetworkMnger TUI screen, select <Quit>, nd then press Enter. 11 Reboot the operting system s follows: b c In the Applince Administrtion menu, select Reboot / Poweroff System. Select Reboot. Select OK, nd then press Enter. Setting the system hostnme The defult hostnme is zsd-mster for the Resource Mnger mster host nd is zsd-delegte for Resource Mnger delegte hosts. To chnge the defult hostnme, perform this procedure. 1 Gin ccess to the Control Center host, through the console interfce of your hypervisor, or through remote shell utility such s PuTTY. 2 Select the NetworkMnger TUI menu s follows: In the Applince Administrtion menu, select Configure Network nd DNS, nd then press Enter. 3 Disply the hostnme entry field. In the NetworkMnger TUI menu, select Set system hostnme. b Select OK, nd then press Enter. 4 In the Hostnme field, enter the hostnme or fully qulified domin nme. 5 Press Tb twice to select OK, nd then press Enter. 6 In the confirmtion dilog box, press Enter. 7 Return to the Applince Administrtion menu: On the NetworkMnger TUI screen, select <Quit>, nd then press Enter. 8 Reboot the operting system s follows: b c In the Applince Administrtion menu, select Reboot / Poweroff System. Select Reboot. Select OK, nd then press Enter. 24

25 Instlling Control Center mster host Adding the mster host to resource pool Complete this procedure to dd the Control Center mster host to the defult resource pool or to new resource pool nmed mster. 1 Gin ccess to the Control Center host, through the console interfce of your hypervisor, or through remote shell utility such s PuTTY. 2 Strt commnd-line session s root s follows: b In the Applince Administrtion menu, select Root Shell. Select Run, nd then press Enter. The menu is replced by commnd prompt similr to the following exmple: [root@hostnme ~]# 3 Optionl: Crete new resource pool, if necessry. For single-host deployments, skip this step. For multi-host deployments, perform the following substeps. Crete new pool nmed mster. b serviced pool dd mster Assign dministrtive nd distributed file system (DFS) permissions to the new resource pool. serviced pool set-permission --dmin --dfs mster 4 Add the mster host to resource pool. For single-host deployments, dd the mster host to the defult resource pool. Replce Hostnme-Or-IP with the hostnme or IP ddress of the Control Center mster host: serviced host dd Hostnme-Or-IP:4979 defult If you enter hostnme, ll hosts in your Control Center cluster must be ble to resolve the nme, either through n entry in /etc/hosts, or through nmeserver on your network. For multi-host deployments, dd the mster host to the mster resource pool nd register its uthentiction token. Replce Hostnme-Or-IP with the hostnme or IP ddress of the Control Center mster host: serviced host dd --register Hostnme-Or-IP:4979 mster If you enter hostnme, ll hosts in your Control Center cluster must be ble to resolve the nme, either through n entry in /etc/hosts, or through nmeserver on your network. 5 To exit the commnd-line session, t the commnd prompt, enter exit. Deploying Resource Mnger You cn use the browser interfce or the commnd-line interfce to deploy Resource Mnger. Choose one of the procedures in this section. 25

26 Zenoss Resource Mnger Instlltion Guide Using the CLI to deploy This procedure dds the Resource Mnger ppliction to the list of pplictions tht Control Center mnges. 1 Gin ccess to the Control Center host, through the console interfce of your hypervisor, or through remote shell utility such s PuTTY. 2 Strt commnd-line session s root s follows: b In the Applince Administrtion menu, select Root Shell. Select Run, nd then press Enter. The menu is replced by commnd prompt similr to the following exmple: [root@hostnme ~]# 3 Add the Zenoss.resmgr ppliction to Control Center. mypth=/opt/serviced/templtes serviced templte dd $mypth/zenoss-resmgr-*.json On success, the serviced commnd returns the templte ID. 4 Deploy the ppliction s shown in the following exmple commnd, replcing vribles with your vlues s shown. Replce Templte-ID with the templte identifier tht ws returned in the previous step. Replce Deployment-ID with nme for this deployment (for exmple, Dev or Test). serviced templte deploy Templte-ID defult Deployment-ID Control Center tgs Resource Mnger imges in the locl registry. Using the browser interfce to deploy When you log in to the Control Center browser interfce for the first time, perform this procedure. 1 Disply the login pge of the Control Center browser interfce. Replce IP-Address with the IP ddress or, if nme resolution of the hostnme is configured in your environment, the hostnme of the Control Center virtul mchine. The Control Center web server listens t the hostnme or IP ddress of the Control Center mster host nd port The web server tht listens for Control Center interfce requests typiclly tkes few minutes to strt fter the Control Center mster host is strted. Figure 7: Control Center login pge 26

27 Instlling Control Center mster host 2 At the login pge, enter ccuser nd its pssword. If the Deployment Wizrd does not disply utomticlly, click Appliction, locted t the right side of the pge. 3 In the Select Applictions step, select the ppliction nme (Zenoss.resmgr), nd then click Next. 4 In the Select Resource Pool step, select defult, nd then click Next. 5 In the Deployment Applictions step, enter n identifier for this deployment of Resource Mnger, nd then click Deploy. 6 At the top of the pge, click Logout. If you re creting single-host deployment, proceed to the Zenoss Resource Mnger Configurtion Guide. If you re creting multi-host deployment, proceed to the next chpter. 27

28 Zenoss Resource Mnger Instlltion Guide Instlling delegte hosts 4 This chpter describes how to instll Resource Mnger pplince pckge s Control Center delegte host. You cn dd s mny delegte hosts s you need to Control Center cluster. Perform the procedures in Instlling Control Center mster host on pge 17 before performing the procedures in this chpter. Creting virtul mchine You cn crete virtul mchine for the Resource Mnger delegte pplince with VMwre vsphere or Microsoft Hyper-V. Choose one of the procedures in this section. Creting virtul mchine with vsphere To perform this tsk, you need A VMwre vsphere client Permission to downlod Resource Mnger softwre from the Zenoss Support site This procedure instlls Resource Mnger OVA pckges s virtul mchine mnged by vsphere Server version 6.5.0, using VMwre vsphere Web Client 6.5. The procedure might differ with other versions of VMwre vsphere Client. There re two seprte OVA pckges: one for the mster host nd one for delegtes. 1 Downlod the Resource Mnger delegte OVA file from the Zenoss Support site to your worksttion, if necessry. 2 Use the VMwre vsphere Client to log in to vcenter s root, or s user with superuser privileges, nd then disply the Home view. 28

29 Instlling delegte hosts 3 In the top nvigtion br, choose Actions > Deploy OVF Templte. Figure 8: Deploy OVF Templte 4 Use pnels in the Deploy OVF Templte wizrd to select the OVF pckge: b c d Select templte: To downlod nd instll the pckge from the internet, enter URL. To choose the pckge from drive on your worksttion or network shre, browse to the loction nd choose the OVA file. Click Next. Select nme nd loction: Specify nme for the OVF, select dtcenter or folder s the deployment loction, nd then click Next. Select resource: Select the host, cluster, or other resource on which to run the deployed templte, nd then click Next. Review detils: Verify the templte detils, nd then click Next. 29

30 Zenoss Resource Mnger Instlltion Guide e f g Select storge: In Select virtul disk formt, choose Thin Provison, ccept defults for other fields, nd then click Next. Select networks: Accept defults nd click Next. Redy to Complete: Verify the deployment settings, nd then click Finish. The Recent Tsks pne displys deployment progress nd sttus informtion. 5 Nvigte to the new virtul mchine's Getting Strted tb, nd then click Edit virtul mchine settings. 6 Updte the memory ssigned to the mchine to 32GB, nd then click OK. 7 On the new virtul mchine's Getting Strted tb, click Power on virtul mchine. Creting virtul mchine with Hyper-V To perform this tsk, you need: A Microsoft Remote Desktop Connection Administrtor privileges on Microsoft Hyper-V server Permission to downlod Resource Mnger softwre from the Zenoss Support site This procedure instlls the Resource Mnger pplince s virtul mchine mnged by Microsoft Hyper-V. There re seprte ISO files for the mster host nd delegtes. In this procedure, you downlod nd instll the delegte ISO file. A seprte procedure provides instructions for instlling the mster. 1 Use Microsoft Remote Desktop Connection to log in to Hyper-V host s Administrtor, or s user with Administrtor privileges. 2 Downlod the Resource Mnger ISO file from the Zenoss Support site to the Hyper-V host. Choose the delegte ISO file. 3 Open Hyper-V Mnger. 4 In the left nvigtion pne, choose server to host the virtul mchine. 5 In the Actions pne, choose New > Virtul Mchine. The New Virtul Mchine Wizrd opens. 6 Use pnels in the wizrd to crete the virtul mchine: b c Specify Nme nd Loction: Provide nme for the virtul mchine, nd then click Next. Specify Genertion: Choose Genertion 1, nd then click Next. Assign Memory: Specify memory informtion s follows: d e Strtup memory: Enter (32GB). Check Use Dynmic Memory for this virtul mchine. Click Next. Configure Networking: For Connection, choose virtul switch, nd then click Next. Connect Virtul Hrd Disk: Crete new disk on which to instll the guest operting system s follows: 1 Choose Crete virtul hrd disk. 2 Specify nme. 3 Size: Enter Click Next. f In lter step, you will crete dditionl disks. Instlltion Options: Access the delegte ISO file s follows: 1 Choose Instll n operting system from bootble CD/DVD-ROM. 2 Choose Imge file (.iso). 30

31 Instlling delegte hosts 3 Specify or browse to the loction of the ISO imge file. g Summry/Completing the New Virtul Mchine Wizrd: Verify the description, nd then click Finish. 7 In the Hyper-V Mnger Virtul Mchines re, right-click the new virtul mchine, nd then choose Settings. 8 In the Hrdwre re on the left, configure s follows: Ensure tht the virtul hrd disk tht you creted is ttched to n IDE controller. A Hyper-V guest mchine cn only boot from n IDE drive. b Choose Processor. c In Number of virtul processors, enter 8, nd then click Apply. 9 Crete dditionl virtul hrd disks s follows: b c d e f In the Hrdwre re on the left, choose ny controller nd loction tht will ccommodte the disk. In the controller re on the right, choose Hrd Drive, nd then click Add. In the re on the right, choose Virtul hrd disk, nd then click New. Complete pnels in the New Virtul Hrd Disk Wizrd s follows: 1 Choose Disk Formt: Choose VHDX, nd then click Next. 2 Choose Disk Type: Choose Dynmiclly expnding, nd then click Next. 3 Specify Nme nd Loction: Enter the disk nme, nd then click Next. 4 Configure Disk: Choose Crete new blnk virtul hrd disk. b Size: Enter 50. c Click Next. 5 Summry/New Virtul Hrd Disk Wizrd: Verify the description, nd then click Finish. In the Settings window, click Apply. Repet this step to crete two 16GB virtul hrd disks (for totl of four disks). When viewed from the Linux system, the disks might be reordered; however, the instlltion is not ffected by disk order. g In the Settings dilog box, click Apply, nd then click OK. 10 In the Hyper-V Mnger Virtul Mchines re, right-click the new virtul mchine, nd then choose Strt. Figure 9: Strting virtul mchine 11 In the Hyper-V Mnger Virtul Mchines re, right-click the new virtul mchine, nd then choose Connect. 12 In the Virtul Mchine Connection window, press Enter. The pplince instlltion process tkes bout 15 minutes, nd should complete with no dditionl input. If received, disregrd the Fst TSC clibrtion filure messge. Configuring the virtul mchine This procedure configures the new virtul mchine s delegte host. 31

32 Zenoss Resource Mnger Instlltion Guide 1 Gin ccess to the console interfce of the Control Center host through your hypervisor console interfce. Figure 10: Initil hypervisor console login prompt 2 Log in s the root user. The initil pssword is provided in the console. 3 The system prompts you to enter new pssword for root. Note Psswords must include minimum of eight chrcters, with t lest one chrcter from three of the following chrcter clsses: uppercse letter, lowercse letter, digit, nd specil. 4 The system prompts you to enter new pssword for ccuser. The ccuser ccount is the defult ccount for gining ccess to the Control Center browser interfce. 5 In the IP field, enter the hostnme, fully qulified domin nme, or IPv4 ddress of the mster host. Note If you enter the hostnme or fully qulified domin nme of the mster host, you need n entry in the /etc/hosts file of the delegte host or nmeserver on your network tht resolves the nme to its IPv4 ddress. Press Tb to select Ok, nd then press Enter. The system reboots. Edit connection to configure sttic IPv4 ddressing The defult configurtion for network connections is DHCP. To configure sttic IPv4 ddressing, perform this procedure. To nvigte in the text user interfce (TUI): 32

33 Instlling delegte hosts To move forwrd or bckwrd through options, press the rrow keys. To disply menu or choose n option, press Enter. 1 Gin ccess to the Control Center host, through the console interfce of your hypervisor, or through remote shell utility such s PuTTY. 2 Log in s the root user. 3 Select the NetworkMnger TUI menu s follows: In the Applince Administrtion menu, select Configure Network nd DNS, nd then press Enter. 4 On the NetworkMnger TUI menu, select Edit connection, nd then press Enter. The TUI displys the connections tht re vilble on the host. 33

34 Zenoss Resource Mnger Instlltion Guide Figure 11: Exmple: Avilble connections Note Do not use this procedure to modify the docker0 connection. 5 Select the virtul connection, nd then press Enter. Figure 12: Exmple: Edit Connection screen 6 Optionl: If the IPv4 CONFIGURATION re is not visible, select its disply option (<Show>), nd then press Enter. 7 In the IPv4 CONFIGURATION re, select <Automtic>, nd then press Enter. Figure 13: Exmple: IPv4 Configurtion options 8 Configure sttic IPv4 networking s follows: Select Mnul, nd then press Enter. b Beside Addresses, select <Add>, nd then press Enter. 34

35 Instlling delegte hosts c In the Addresses field, enter n IPv4 ddress for the virtul mchine, nd then press Enter. d Repet the preceding two steps for the Gtewy nd DNS servers fields. 9 Tb to the bottom of the Edit Connection screen to select <OK>, nd then press Enter. 10 Return to the Applince Administrtion menu: On the NetworkMnger TUI screen, select <Quit>, nd then press Enter. 11 Reboot the operting system s follows: b c In the Applince Administrtion menu, select Reboot / Poweroff System. Select Reboot. Select OK, nd then press Enter. Setting the system hostnme The defult hostnme is zsd-mster for the Resource Mnger mster host nd is zsd-delegte for Resource Mnger delegte hosts. To chnge the defult hostnme, perform this procedure. 1 Gin ccess to the Control Center host, through the console interfce of your hypervisor, or through remote shell utility such s PuTTY. 2 Select the NetworkMnger TUI menu s follows: In the Applince Administrtion menu, select Configure Network nd DNS, nd then press Enter. 3 Disply the hostnme entry field. In the NetworkMnger TUI menu, select Set system hostnme. b Select OK, nd then press Enter. 4 In the Hostnme field, enter the hostnme or fully qulified domin nme. 5 Press Tb twice to select OK, nd then press Enter. 6 In the confirmtion dilog box, press Enter. 7 Return to the Applince Administrtion menu: On the NetworkMnger TUI screen, select <Quit>, nd then press Enter. 8 Reboot the operting system s follows: b c In the Applince Administrtion menu, select Reboot / Poweroff System. Select Reboot. Select OK, nd then press Enter. 35

36 Zenoss Resource Mnger Instlltion Guide Editing the /etc/hosts file This procedure is conditionl. Perform this procedure only if you use hostnmes or fully qulified domin nmes insted of IPv4 ddresses, nd only fter ll delegte hosts re instlled nd renmed. Perform this procedure on the Control Center mster host nd on ech delegte host. 1 Gin ccess to the Control Center host, through the console interfce of your hypervisor, or through remote shell utility such s PuTTY. 2 Strt commnd-line session s root s follows: b In the Applince Administrtion menu, select Root Shell. Select Run, nd then press Enter. The menu is replced by commnd prompt similr to the following exmple: [root@hostnme ~]# 3 Open the /etc/hosts file in text editor. The following steps use the nno editor. Strt the editor. nno /etc/hosts Figure 14: Exmple nno session b Optionl: On delegte hosts, the file might include two entries with the sme IP ddress. Remove the first of the two entries, which mps the IP ddress to the zsd-mster hostnme. c Add entries for the Control Center mster host nd for ech delegte host. d To sve, press Control-o. e To exit, press Control-x. 4 Return to the Applince Administrtion menu. exit 5 Exit the Applince Administrtion menu. Use the down-rrow key to select Exit. b Press Tb, nd then press Enter. 36

37 Configuring multi-host Control Center cluster Configuring multi-host Control Center 5 cluster This chpter describes how to configure n pplince-bsed multi-host Control Center cluster. A multi-host Resource Mnger deployment includes one Control Center mster host nd one or more delegte hosts. Zenoss recommends deploying t lest two delegte hosts to enble creting ZooKeeper ensemble. Enbling NTP on Microsoft Hyper-V guests Note The procedures in this section re required only for multi-host deployments running s Microsoft Hyper-V guests. VMwre vsphere guests use n hourly cron job to synchronize their system clocks with the host. Like most distributed pplictions, Control Center requires common time source. The procedures in this section enble NTP to synchronize the system clocks of ll hosts in your Control Center cluster. Configure NTP to rely on time source s follows, depending on internet ccess of the hosts in your Control Center cluster: If ll hosts cn ccess the internet, configure NTP to rely on public time servers. If no host cn ccess the internet, configure NTP to rely on privte mster server. Configuring NTP for public time servers (Hyper-V only) This procedure uses the defult configurtion of NTP to synchronize system clocks with public time servers. If ll hosts in the Control Center cluster cn ccess the internet, repet this procedure on ech host in the cluster, strting with the Control Center mster host. 1 Gin ccess to the Control Center host, through the console interfce of your hypervisor, or through remote shell utility such s PuTTY. 2 Strt commnd-line session s root s follows: b In the Applince Administrtion menu, select Root Shell. Select Run, nd then press Enter. The menu is replced by commnd prompt similr to the following exmple: [root@hostnme ~]# 3 Stop Control Center. systemctl stop serviced 37

38 Zenoss Resource Mnger Instlltion Guide 4 Synchronize the system clock nd enble the NTP demon. Set the system time. b c d ntpd -gq Enble the ntpd demon. systemctl enble ntpd Configure ntpd to strt when the system strts. Currently, n unresolved issue ssocited with NTP prevents ntpd from restrting correctly fter reboot, nd the following commnds provide workround to ensure tht it does. echo "systemctl strt ntpd" >> /etc/rc.d/rc.locl chmod +x /etc/rc.d/rc.locl Strt ntpd. systemctl strt ntpd 5 Strt Control Center. systemctl strt serviced Configuring n NTP mster server (Hyper-V only) This procedure configures n NTP mster server on the Control Center mster host. Perform this procedure only if the host does not hve internet ccess. 1 Gin ccess to the Control Center host, through the console interfce of your hypervisor, or through remote shell utility such s PuTTY. 2 Strt commnd-line session s root s follows: b In the Applince Administrtion menu, select Root Shell. Select Run, nd then press Enter. The menu is replced by commnd prompt similr to the following exmple: [root@hostnme ~]# 3 Crete bckup of the NTP configurtion file. cp -p /etc/ntp.conf /etc/ntp.conf.orig 4 Edit the NTP configurtion file s follows: b Open /etc/ntp.conf with text editor. Replce ll lines in the file with the following lines: # Use the locl clock server prefer fudge strtum 10 driftfile /vr/lib/ntp/drift brodcstdely # Give loclhost full ccess rights restrict

39 Configuring multi-host Control Center cluster c # Grnt ccess to client hosts restrict ADDRESS_RANGE msk NETMASK nomodify notrp Replce ADDRESS_RANGE with the rnge of IPv4 network ddresses tht re llowed to query this NTP server. For exmple, the following IP ddresses re ssigned to the hosts in Control Center cluster: For the preceding ddresses, the vlue for ADDRESS_RANGE is d Replce NETMASK with the IPv4 network msk tht corresponds with the ddress rnge. For exmple, the network msk for is e Sve the file nd exit the editor. 5 Stop Control Center. systemctl stop serviced 6 Enble nd strt the NTP demon s follows: Enble the ntpd demon. b c systemctl enble ntpd Configure ntpd to strt when the system strts. Currently, n unresolved issue ssocited with NTP prevents ntpd from restrting correctly fter reboot, nd the following commnds provide workround to ensure tht it does. echo "systemctl strt ntpd" >> /etc/rc.d/rc.locl chmod +x /etc/rc.d/rc.locl Strt ntpd. systemctl strt ntpd 7 Strt Control Center. systemctl strt serviced Configuring NTP clients (Hyper-V only) This procedure configures delegtes to synchronize their clocks with the NTP server on the Control Center mster host. Perform this procedure only if the delegtes do not hve internet ccess. Repet this procedure on ech delegte in your Control Center cluster. 1 Gin ccess to the Control Center host, through the console interfce of your hypervisor, or through remote shell utility such s PuTTY. 2 Strt commnd-line session s root s follows: b In the Applince Administrtion menu, select Root Shell. Select Run, nd then press Enter. 39

40 Zenoss Resource Mnger Instlltion Guide The menu is replced by commnd prompt similr to the following exmple: ~]# 3 Crete bckup of the NTP configurtion file. cp -p /etc/ntp.conf /etc/ntp.conf.orig 4 Edit the NTP configurtion file s follows: b Open /etc/ntp.conf with text editor. Replce ll lines in the file with the following lines: # Point to the mster time server server MASTER_ADDRESS restrict defult ignore restrict restrict MASTER_ADDRESS msk nomodify notrp noquery driftfile /vr/lib/ntp/drift c Replce both instnces of MASTER_ADDRESS with the IPv4 ddress of the host where the NTP server is running (the Control Center mster host). d Sve the file nd exit the editor. 5 Stop Control Center. systemctl stop serviced 6 Synchronize the clock with the mster server. ntpd -gq 7 Enble nd strt the NTP demon s follows: Enble the ntpd demon. b c systemctl enble ntpd Configure ntpd to strt when the system strts. Currently, n unresolved issue ssocited with NTP prevents ntpd from restrting correctly fter reboot, nd the following commnds provide workround to ensure tht it does. echo "systemctl strt ntpd" >> /etc/rc.d/rc.locl chmod +x /etc/rc.d/rc.locl Strt ntpd. systemctl strt ntpd 8 Strt Control Center. systemctl strt serviced Adding hosts to the defult resource pool This procedure dds one or more hosts to the defult resource pool. 40