Zenoss Core Installation Guide

Similar documents
Zenoss Resource Manager Installation Guide

Control Center Installation Guide

McAfee Web Gateway

Installation Guide for

Zenoss Service Impact Installation and Upgrade Guide for Resource Manager 5.x and 6.x

Zenoss Core Installation Guide

Troubleshooting. Verify the Cisco Prime Collaboration Provisioning Installation (for Advanced or Standard Mode), page

Control Center Installation Guide

Zenoss Resource Manager Installation Guide

Control Center Installation Guide

Zenoss Core Installation Guide

Zenoss Resource Manager Installation Guide

LINX MATRIX SWITCHERS FIRMWARE UPDATE INSTRUCTIONS FIRMWARE VERSION

Zenoss Resource Manager Installation Guide

Zenoss Resource Manager Installation Guide

Cisco UCS Performance Manager Installation Guide

Control Center Installation Guide for High-Availability Deployments

Control Center Installation Guide for High-Availability Deployments

McAfee Data Loss Prevention Prevent

Zenoss Resource Manager Installation Guide

VMware Horizon FLEX Administration Guide

McAfee Network Security Platform

Package Contents. Wireless-G USB Network Adapter with SpeedBooster USB Cable Setup CD-ROM with User Guide (English only) Quick Installation

Certificate Replacement. 26 SEP 2017 VMware Validated Design 4.1 VMware Validated Design for Management and Workload Consolidation 4.

the machine and check the components AC Power Cord Carrier Sheet/ Plastic Card Carrier Sheet DVD-ROM

Enterprise Digital Signage Create a New Sign

To access your mailbox from inside your organization. For assistance, call:

Architecture and Data Flows Reference Guide

Error Numbers of the Standard Function Block

Certificate Replacement. 21 AUG 2018 VMware Validated Design 4.3 VMware Validated Design for Management and Workload Consolidation 4.

VMware Virtual Dedicated Graphics Accelerator (vdga) and DirectPath I/O GPU Device Certification Guide ESXi 6.5 GA Release Workbench 3.5.

Certificate Replacement. 21 AUG 2018 VMware Validated Design 4.3 VMware Validated Design for Software-Defined Data Center 4.3

Architecture and Data Flows Reference Guide

Zenoss Resource Manager Configuration Guide

Operational Verification. 26 SEP 2017 VMware Validated Design 4.1 VMware Validated Design for Software-Defined Data Center 4.1

Smart Output Field Installation for M-Series and L-Series Converter

INTEGRATED WORKFLOW ART DIRECTOR

McAfee Network Security Platform

NOTES. Figure 1 illustrates typical hardware component connections required when using the JCM ICB Asset Ticket Generator software application.

Distributed Systems Principles and Paradigms. Chapter 11: Distributed File Systems

Rolling Back Remote Provisioning Changes. Dell Command Integration for System Center

Zenoss Resource Manager Configuration Guide

Zenoss Resource Manager Configuration Guide

All in One Kit. Quick Start Guide CONNECTING WITH OTHER DEVICES SDE-4003/ * 27. English-1

Deployment of VMware NSX-T for Workload Domains. 19 MAR 2019 VMware Validated Design VMware NSX-T 2.4

McAfee Network Security Platform

Zenoss Community Edition (Core) Configuration Guide

Zenoss Core Configuration Guide

Distributed Systems Principles and Paradigms

McAfee Network Security Platform

Migrating vrealize Automation to 7.3 or March 2018 vrealize Automation 7.3

Control Center Installation Guide

Upgrading from vrealize Automation 7.1 or Later to June 2018 vrealize Automation 7.4

High-performance Monitoring Software. User s Manual

Upgrading from vrealize Automation 7.1, 7.2 to 7.3 or 7.1, 7.2, 7.3 to March 2018 vrealize Automation 7.3

VMware Horizon JMP Server Installation and Setup Guide. Modified on 06 SEP 2018 VMware Horizon 7 7.6

Zenoss Core Configuration Guide

Epson Projector Content Manager Operation Guide

McAfee Network Security Platform

Start Here. Quick Setup Guide. the machine and check the components DCP-9015CDW DCP-9020CDW

Start Here. Quick Setup Guide DCP-8110DN DCP-8150DN DCP-8155DN. the machine and check the components

CS 241 Week 4 Tutorial Solutions

Start Here. Quick Setup Guide DCP-7055 / DCP-7060D DCP-7065DN WARNING WARNING CAUTION CAUTION

Upgrading from vrealize Automation to 7.3 or May 2018 vrealize Automation 7.3

File Manager Quick Reference Guide. June Prepared for the Mayo Clinic Enterprise Kahua Deployment

Before you can use the machine, read this Quick Setup Guide for the correct setup and installation.

Active Fail-Open Kit Quick Start Guide

Upgrade. 17 JUL 2018 VMware Validated Design 4.3 VMware Validated Design for Software-Defined Data Center 4.3

vrealize Suite 7.0 Backup and Restore by Using EMC Avamar vrealize Suite 7.0

Start Here. Quick Setup Guide DCP-T300 DCP-T500W DCP-T700W WARNING CAUTION IMPORTANT NOTE WARNING

LINX MATRIX SWITCHERS FIRMWARE UPDATE INSTRUCTIONS FIRMWARE VERSION

In USA: To download other guides for this product, visit the Brother Solutions Center at solutions.brother.com/manuals and select your model.

Cisco UCS Performance Manager Migration Guide

vcloud Director Tenant Portal Guide vcloud Director 9.0

Upgrading from vrealize Automation 6.2 to 7.1

MPE/iX HP 3000 Series 99X. Software Startup Manual

IaaS Configuration for Virtual Platforms

Welch Allyn CardioPerfect Workstation Installation Guide

the machine and check the components Starter Ink Cartridges Basic User s Guide Product Safety Guide CD-ROM USB Interface Cable

the machine and check the components Black Yellow Cyan Magenta Starter Ink Cartridges Telephone Line Cord Adapter (Hong Kong only)

vcloud Director Service Provider Admin Portal Guide vcloud Director 9.1

License Manager Installation and Setup

the machine and check the components Drum Unit and Toner Cartridge Assembly (pre-installed) AC Power Cord Installer CD-ROM Quick Setup Guide

Backup and Restore. 20 NOV 2018 VMware Validated Design 4.3 VMware Validated Design for Software-Defined Data Center 4.3

the machine and check the components Introductory Ink Cartridges CD-ROM 1 Power Cord Telephone Line Cord

Scenarios. VMware Validated Design 4.0 VMware Validated Design for IT Automating IT 4.0

Site Protection and Recovery. VMware Validated Design 4.0 VMware Validated Design for Software-Defined Data Center 4.0

Agilent Mass Hunter Software

Scenarios. VMware Validated Design for IT Automating IT 4.0 EN

the machine and check the components Introductory Ink Cartridges

Start Here MFC-7360 / MFC-7470D /

the machine and check the components Starter Ink Cartridges Basic User s Guide Product Safety Guide CD-ROM* Power Cord

McAfee Network Security Platform

Registering as an HPE Reseller

COMP 423 lecture 11 Jan. 28, 2008

Certificate Replacement

Scenarios. VMware Validated Design for IT Automating IT EN

User Manual. V1.0.1 Nov. 20, 2016

Before you can use the machine, read this Quick Setup Guide for the correct setup and installation.

Intelligent Operations Use Case Deployment Using vrealize Suite Lifecycle Manager

Transcription:

Zenoss Core Instlltion Guide Relese 5.1.5 Zenoss, In. www.zenoss.om

Zenoss Core Instlltion Guide Copyright 2016 Zenoss, In. All rights reserved. Zenoss nd the Zenoss logo re trdemrks or registered trdemrks of Zenoss, In., in the United Sttes nd other ountries. All other trdemrks, logos, nd servie mrks re the property of Zenoss or other third prties. Use of these mrks is prohiited without the express written onsent of Zenoss, In., or the third-prty owner. Amzon We Servies, AWS, nd EC2 re trdemrks of Amzon.om, In. or its ffilites in the United Sttes nd/or other ountries. Flsh is registered trdemrk of Adoe Systems Inorported. Orle, the Orle logo, Jv, nd MySQL re registered trdemrks of the Orle Corportion nd/or its ffilites. Linux is registered trdemrk of Linus Torvlds. RitMQ is trdemrk of VMwre, In. SNMP Informnt is trdemrk of Grth K. Willims (Informnt Systems, In.). Syse is registered trdemrk of Syse, In. Tomt is trdemrk of the Aphe Softwre Foundtion. VMwre is registered trdemrk or trdemrk of VMwre, In. in the United Sttes nd/or other jurisditions. Windows is registered trdemrk of Mirosoft Corportion in the United Sttes nd other ountries. All other ompnies nd produts mentioned re trdemrks nd property of their respetive owners. Prt Numer: 1051.16.207 Zenoss, In. 11305 Four Points Drive Bldg 1 - Suite 300 Austin, Texs 78726 2

Contents Aout this guide... 4 Chpter 1: Instlling on hosts with internet ess...6 Instlling mster host...6 Instlling resoure pool hosts...18 ZooKeeper ensemle onfigurtion... 26 Adding hosts to the defult resoure pool... 31 Deploying Zenoss Core... 32 3

Zenoss Core Instlltion Guide Aout this guide Zenoss Core Instlltion Guide provides detiled proedures for instlling Zenoss Core. Note Zenoss strongly reommends reviewing the Zenoss Core Plnning Guide refully efore using this guide. Relted pulitions Title Zenoss Core Administrtion Guide Zenoss Core Configurtion Guide Zenoss Core Instlltion Guide Zenoss Core Plnning Guide Zenoss Core Relese Notes Zenoss Core Upgrde Guide Desription Provides n overview of Zenoss Core rhiteture nd fetures, s well s proedures nd exmples to help use the system. Provides required nd optionl onfigurtion proedures for Zenoss Core, to prepre your deployment for monitoring in your environment. Provides detiled informtion nd proedures for reting deployments of Control Center nd Zenoss Core. Provides oth generl nd speifi informtion for prepring to deploy Zenoss Core. Desries known issues, fixed issues, nd lte-reking informtion not lredy provided in the pulished doumenttion set. Provides detiled informtion nd proedures for upgrding deployments of Zenoss Core. Additionl informtion nd omments Zenoss welomes your omments nd suggestions regrding our doumenttion. To shre your omments, plese send n emil to dos@zenoss.om. In the emil, inlude the doument title nd prt numer. The prt numer ppers t the end of the list of trdemrks, t the front of this guide. Chnge history The following list ssoites doument prt numers nd the importnt hnges to this guide sine the previous relese. Some of the hnges involve fetures or ontent, ut others do not. For informtion out new or hnged fetures, refer to the Zenoss Core Relese Notes. 1051.16.207 Updte relese numers. 1051.16.176 Updte relese numers. 1051.16.153 Updte relese numers. 1051.16.146 Updte relese numers. 1051.16.125 Refine the proedure for reting the pplition dt thin pool. 4

Aout this guide 1051.16.118 Add support for Zenoss Core 5.1.2. Add sustep to rete the doker override diretory. 1051.16.111 Add this doument hnge history. Add hpters desriing how to instll the Zenoss Core ppline. Chpters re orgnized into prts. Doker onfigurtion steps now dd the storge driver flg (-s deviempper) to the /et/ sysonfig/doker file. Doker needs longer strtup timeout vlue, to work round known Doker issue with the deviempper driver. Doker onfigurtion steps now inlude dding TimeoutSe=300. Rther thn editing /li/systemd/system/doker.servie, Doker onfigurtion steps now inlude dding systemd override file. Add symlink to /tmp in /vr/li/doker. Updte the ommnds for strting nd testing ZooKeeper ensemle. Add proedure for updting the SERVICED_ZK vlue on resoure pool hosts tht re not memers of ZooKeeper ensemle. Add referene topi for the ZooKeeper vriles required on hosts in Control Center luster. Add step to instll the Nmp Nt pkge, whih is used to hek ZooKeeper ensemle sttus. 1051.16.060 Plnning informtion is now in the Zenoss Core Plnning Guide. Informtion out how to strt nd onfigure Zenoss Core is now in the Zenoss Core Configurtion Guide. 5

Zenoss Core Instlltion Guide Instlling on hosts with internet ess 1 The proedures in this hpter instll Control Center nd Zenoss Core on one or more Red Ht Enterprise Linux (RHEL) 7.1 or 7.2 hosts, or one or more CentOS 7.1 or 7.2 hosts. To use the proedures in this hpter, ll Control Center luster hosts must hve internet ess. You my rete single-host or multi-host deployment. For prodution use, Zenoss strongly reommends reting multi-host deployment tht inludes minimum of three rel or virtul mhines. For more informtion out deploying Control Center nd Zenoss Core, refer to the Zenoss Core Plnning Guide. Note For optiml results, review this hpter thoroughly efore strting the instlltion proess. Instlling mster host Perform the proedures in this setion to instll Control Center nd Zenoss Core on mster host. Verifying ndidte host resoures This proedure determines whether hosts's hrdwre resoures nd operting system re suffiient to serve s Control Center mster host. 1 Log in to the ndidte host s root, or s user with superuser privileges. 2 Verify tht the host implements the 64-it version of the x86 instrution set. unme -m If the output is x86_64, the rhiteture is 64-it. Proeed to the next step If the output is i386/i486/i586/i686, the rhiteture is 32-it. Stop this proedure nd selet different host. 3 Verify tht nme resolution works on this host. hostnme -i If the result is not vlid IPv4 dddress, dd n entry for the host to the network nmeserver, or to /et/ hosts. 4 Verify tht the host's numeri identifier is unique. Eh host in Control Center luster must hve unique host identifier. hostid 6

Instlling on hosts with internet ess 5 Determine whether the ville, unused storge is suffiient. Disply the ville storge devies. lslk --output=name,size Compre the ville storge with the mount required for Control Center mster host. For more informtion, refer to the Zenoss Core Plnning Guide. 6 Determine whether the ville memory nd swp is suffiient. Disply the ville memory. free -h Compre the ville memory with the mount required for mster host in your deployment. For more informtion, refer to the Zenoss Core Plnning Guide. 7 Updte the operting system, if neessry. Determine whih relese is instlled. t /et/redht-relese If the result inludes 7.0, perform the following susteps. Updte the operting system. yum updte -y Restrt the system. reoot Prepring storge for the mster host In ddition to the storge required for its operting system, Control Center mster host requires the following storge res: A lol prtition for Doker dt, onfigured s devie mpper thin pool. A lol prtition for Control Center internl servies dt, formtted with the XFS file system. Note Control Center internl servies inlude ZooKeeper, whih requires onsistently fst storge. Zenoss reommends using seprte, high-performne storge resoure for Control Center internl servies. For exmple, drive tht is onfigured with only one primry prtition, whih elimintes ontention y other servies. A lol or remote primry prtition for Zenoss Core dt, onfigured s devie mpper thin pool. A lol primry prtition, remote primry prtition, or remote file server, for kups of Zenoss Core dt. The lol or remote primry prtition is formtted with the XFS file system. A remote file server must provide file system tht is omptile with XFS. Note If you re using primry prtition on lol devie for kups, ensure tht the primry prtition for Control Center internl servies dt is not on the sme devie. For storge sizing informtion, refer to the Zenoss Core Plnning Guide. For devie mpper thin pools, no formtting is required simply rete primry prtitons, whih re onfigured in susequent proedures. For more informtion, refer to the Zenoss Core Plnning Guide. 7

Zenoss Core Instlltion Guide To rete the required storge, perform the following proedures. Note Dt present on the primry prtitions you selet re destroyed in these proedure. Plese ensure tht dt is ked up elsewhere, or no longer needed, efore proeeding. Creting file system for internl servies This proedure retes n XFS file system on primry prtition. For more informtion out primry prtitions, refer to the Zenoss Core Plnning Guide. Note Control Center internl servies inlude ZooKeeper, whih requires onsistently fst storge. Zenoss reommends using seprte, high-performne storge resoure for Control Center internl servies. For exmple, drive tht is onfigured with only one primry prtition, whih elimintes ontention y other servies. 1 Log in to the trget host s root, or s user with superuser privileges. 2 Identify the trget primry prtition for the file system to rete. lslk --output=name,size,type,fstype,mountpoint For more informtion out the output of the lslk ommnd, nd out reting primry prtitions, refer to the Zenoss Core Plnning Guide. 3 Crete n XFS file system. Reple Prtition with the pth of the trget primry prtition: mkfs -t xfs Prtition 4 Add n entry to the /et/fst file. Reple Prtition with the pth of the primry prtition used in the previous step: eho "Prtition \ /opt/servied/vr/isvs xfs defults 0 0" >> /et/fst 5 Crete the mount point for internl servies dt. mkdir -p /opt/servied/vr/isvs 6 Mount the file system, nd then verify it mounted orretly. mount - && mount grep isvs Exmple result: /dev/xvd1 on /opt/servied/vr/isvs type xfs (rw,reltime,selel,ttr2,inode64,noquot) Creting file system for kups To perform this proedure, you need host with t lest one unused primry prtition, or remote file server. The Control Center mster host requires lol or remote storge spe for kups of Control Center dt. This proedure inludes steps to rete n XFS file system on primry prtition, if neessry, nd steps to mount file system for kups. For more informtion out primry prtitions, refer to the Zenoss Core Plnning Guide. Note If you re using primry prtition on lol devie for kups, ensure tht the primry prtition for Control Center internl servies dt is not on the sme devie. 8

Instlling on hosts with internet ess 1 Log in to the trget host s root, or s user with superuser privileges. 2 Optionl: Identify the trget primry prtition for the file system to rete, if neessry. Skip this step if you re using remote file server. lslk --output=name,size,type,fstype,mountpoint For more informtion out the output of the lslk ommnd, nd out reting primry prtitions, refer to the Zenoss Core Plnning Guide. 3 Optionl: Crete n XFS file system, if neessry. Skip this step if you re using remote file server. Reple Prtition with the pth of the trget primry prtition: mkfs -t xfs Prtition 4 Crete n entry in the /et/fst file. Reple File-System-Speifition with one of the following vlues: the pth of the primry prtition used in the previous step the remote server speifition eho "File-System-Speifition \ /opt/servied/vr/kups xfs defults 0 0" >> /et/fst 5 Crete the mount point for kup dt. mkdir -p /opt/servied/vr/kups 6 Mount the file system, nd then verify it mounted orretly. mount - && mount grep kups Exmple result: /dev/sd3 on /opt/servied/vr/kups type xfs (rw,reltime,selel,ttr2,inode64,noquot) Prepring the mster host operting system This proedure prepres RHEL/CentOS 7.1 or 7.2 host s Control Center mster host. 1 Log in to the ndidte mster host s root, or s user with superuser privileges. 2 Add n entry to /et/hosts for lolhost, if neessry. Determine whether 127.0.0.1 is mpped to lolhost. grep 127.0.0.1 /et/hosts grep lolhost If the preeding ommnds return no result, perform the following sustep. Add n entry to /et/hosts for lolhost. eho "127.0.0.1 lolhost" >> /et/hosts 3 Disle the firewll, if neessry. This step is required for instlltion ut not for deployment. For more informtion, refer to the Zenoss Core Plnning Guide. 9

Zenoss Core Instlltion Guide Determine whether the firewlld servie is enled. systemtl sttus firewlld.servie If the result inludes Ative: intive (ded), the servie is disled. Proeed to the next step. If the result inludes Ative: tive (running), the servie is enled. Perform the following sustep. Disle the firewlld servie. systemtl stop firewlld && systemtl disle firewlld On suess, the preeding ommnds disply messges similr to the following exmple: rm '/et/systemd/system/dus-org.fedorprojet.firewlld1.servie' rm '/et/systemd/system/si.trget.wnts/firewlld.servie' 4 Optionl: Enle persistent storge for log files, if desired. By defult, RHEL/CentOS systems store log dt only in memory or in smll ring-uffer in the /run/log/ journl diretory. By performing this step, log dt persists nd n e sved indefinitely, if you implement log file rottion prties. For more informtion, refer to your operting system doumenttion. mkdir -p /vr/log/journl && systemtl restrt systemd-journld 5 Disle Seurity-Enhned Linux (SELinux), if instlled. Determine whether SELinux is instlled. test -f /et/selinux/onfig && grep '^SELINUX=' /et/selinux/onfig If the preeding ommnds return result, SELinux is instlled. Set the operting mode to disled. Open /et/selinux/onfig in text editor, nd hnge the vlue of the SELINUX vrile to disled. Confirm the new setting. grep '^SELINUX=' /et/selinux/onfig 6 Enle nd strt the Dnsmsq pkge. systemtl enle dnsmsq && systemtl strt dnsmsq 7 Instll the Nmp Nt utility. The utility is used to verify ZooKeeper ensemle onfigurtions. If you re instlling single-host deployment, skip this step. yum instll -y nmp-nt 8 Instll nd onfigure the NTP pkge. Instll the pkge. yum instll -y ntp 10

Instlling on hosts with internet ess Set the system time. ntpd -gq Enle the ntpd demon. systemtl enle ntpd d Configure ntpd to strt when the system strts. Currently, n unresolved issue ssoited with NTP prevents ntpd from restrting orretly fter reoot. The following ommnds provide workround to ensure tht it does. eho "systemtl strt ntpd" >> /et/r.d/r.lol hmod +x /et/r.d/r.lol 9 Instll the Zenoss repository pkge. Instll the pkge. rpm -ivh http://get.zenoss.io/yum/zenoss-repo-1-1.x86_64.rpm Clen out the yum he diretory. yum len ll 10 Reoot the host. reoot Instlling Doker nd Control Center This proedure instlls nd onfigures Doker, nd instlls Control Center. 1 Log in to the mster host s root, or s user with superuser privileges. 2 Instll Doker 1.9.0, nd then disle identl upgrdes. Add the Doker repository to the host's repository list. t > /et/yum.repos.d/doker.repo <<-EOF [dokerrepo] nme=doker Repository seurl=https://yum.dokerprojet.org/repo/min/entos/7 enled=1 gpghek=1 gpgkey=https://yum.dokerprojet.org/gpg EOF Instll Doker 1.9.0. yum len ll && yum mkehe fst yum instll -y doker-engine-1.9.0 Open /et/yum.repos.d/doker.repo with text editor. d Chnge the vlue of the enled key from 1 to 0. e Sve the file nd lose the text editor. 3 Crete symoli link for the Doker temporry diretory. 11

Zenoss Core Instlltion Guide Doker uses its temporry diretory to spool imges. The defult diretory is /vr/li/doker/tmp. The following ommnd speifies the sme diretory tht Control Center uses, /tmp. You n speify ny diretory tht hs minimum of 10GB of unused spe. Crete the doker diretory in /vr/li. mkdir /vr/li/doker Crete the link to /tmp. ln -s /tmp /vr/li/doker/tmp 4 Crete systemd override file for the Doker servie definition. Crete the override diretory. mkdir -p /et/systemd/system/doker.servie.d Crete the override file. t <<EOF > /et/systemd/system/doker.servie.d/doker.onf [Servie] TimeoutSe=300 EnvironmentFile=-/et/sysonfig/doker ExeStrt= ExeStrt=/usr/in/doker demon \$OPTIONS -H fd:// EOF Relod the systemd mnger onfigurtion. systemtl demon-relod 5 Instll Control Center. Control Center inludes utility tht simplifies the proess of reting devie mpper thin pool. yum len ll && yum mkehe fst yum --enlerepo=zenoss-stle instll -y servied-1.1.7 6 Crete devie mpper thin pool for Doker dt. Identify the primry prtition for the thin pool to rete. lslk --output=name,size,type,fstype,mountpoint Crete the thin pool. Reple Pth-To-Devie with the pth of n unused primry prtition: servied-storge rete-thin-pool doker Pth-To-Devie On suess, the result inludes the nme of the thin pool, whih lwys strts with /dev/mpper. 7 Configure nd strt the Doker servie. Crete vriles for dding rguments to the Doker onfigurtion file. The --exe-opt rgument is workround for Doker issue on RHEL/CentOS 7.x systems. Reple Thin-Pool-Devie with the nme of the thin pool devie reted in the previous step: mydriver="-s deviempper" myfix="--exe-opt ntive.groupdriver=groupfs" 12

Instlling on hosts with internet ess myflg="--storge-opt dm.thinpooldev" mypool="thin-pool-devie" Add the rguments to the Doker onfigurtion file. eho 'OPTIONS="'$myDriver $myfix $myflg'='$mypool'"' \ >> /et/sysonfig/doker Strt or restrt Doker. systemtl restrt doker The initil strtup tkes up to minute, nd my fil. If the strtup fils, repet the previous ommnd. 8 Configure nme resolution in ontiners. Eh time it strts, doker selets n IPv4 sunet for its virtul Ethernet ridge. The seletion n hnge; this step ensures onsisteny. Identify the IPv4 sunet nd netmsk doker hs seleted for its virtul Ethernet ridge. ip ddr show doker0 grep inet Open /et/sysonfig/doker in text editor. Add the following flgs to the end of the OPTIONS delrtion. Reple Bridge-Sunet with the IPv4 sunet doker seleted for its virtul ridge, nd reple Bridge-Netmsk with the netmsk doker seleted: --dns=bridge-sunet --ip=bridge-sunet/bridge-netmsk For exmple, if the ridge sunet nd netmsk is 172.17.0.1/16, the flgs to dd re --dns=172.17.0.1 --ip=172.17.0.1/16. Note Leve lnk spe fter the end of the thin pool devie nme, nd mke sure the doule quote hrter (") is t the end of the line. d Restrt the Doker servie. systemtl restrt doker Instlling Zenoss Core This proedure instlls Zenoss Core nd onfigures the NFS server. 1 Log in to the mster host s root, or s user with superuser privileges. 2 Instll Zenoss Core. yum --enlerepo=zenoss-stle instll -y zenoss-ore-servie 3 Configure nd restrt the NFS server. Currently, n unresolved issue prevents the NFS server from strting orretly. The following ommnds provide workround to ensure tht it does. Open /li/systemd/system/nfs-server.servie with text editor. Chnge rpind.trget to rpind.servie on the following line: Requires= network.trget pro-fs-nfsd.mount rpind.trget 13

Zenoss Core Instlltion Guide Relod the systemd mnger onfigurtion. systemtl demon-relod Configuring Control Center This proedure retes thin pool for pplition dt nd ustomizes key onfigurtion vriles of Control Center. 1 Log in to the mster host s root, or s user with superuser privileges. 2 Configure Control Center to serve s the mster nd s n gent. The following vriles onfigure servied to serve s oth mster nd gent: SERVICED_AGENT Defult: 0 (flse) Determines whether servied instne performs gent tsks. Agents run pplition servies sheduled for the resoure pool to whih they elong. The servied instne onfigured s the mster runs the sheduler. A servied instne my e onfigured s gent nd mster, or just gent, or just mster. SERVICED_MASTER Defult: 0 (flse) Determines whether servied instne performs mster tsks. The mster runs the pplition servies sheduler nd other internl servies, inluding the server for the Control Center rowser interfe. A servied instne my e onfigured s gent nd mster, or just gent, or just mster. Only one servied instne in Control Center luster my e the mster. Open /et/defult/servied in text editor. Find the SERVICED_AGENT delrtion, nd then hnge the vlue from 0 to 1. The following exmple shows the line to hnge: # SERVICED_AGENT=0 Remove the numer sign hrter (#) from the eginning of the line. d Find the SERVICED_MASTER delrtion, nd then hnge the vlue from 0 to 1. The following exmple shows the line to hnge: # SERVICED_MASTER=0 e Remove the numer sign hrter (#) from the eginning of the line. f Sve the file, nd then lose the editor. 3 Crete thin pool for Zenoss Core dt. Identify the primry prtition for the thin pool to rete, nd the mount of spe ville on the primry prtition. lslk --output=name,size,type,fstype,mountpoint For more informtion out the output of the lslk ommnd nd primry prtitions, refer to the Zenoss Core Plnning Guide. Crete vrile for 50% of the spe ville on the primry prtition for the thin pool to rete. The thin pool stores pplition dt nd snpshots of the dt. You n dd storge to the pool t ny time. 14

Instlling on hosts with internet ess Reple Hlf-Of-Aville-Spe with 50% of the spe ville in the primry prtition, in gigytes. Inlude the symol for gigytes (G) fter the numeri vlue. myfifty=hlf-of-aville-speg Crete the thin pool. Reple Pth-To-Devie with the pth of the trget primry prtition: servied-storge rete-thin-pool -o dm.sesize=$myfifty \ servied Pth-To-Devie On suess, the result inludes the nme of the thin pool, whih lwys strts with /dev/mpper. 4 Configure Control Center with the nme of the thin pool for Zenoss Core dt. The Control Center onfigurtion file is /et/defult/servied. (For more informtion out servied onfigurtion options, refer to the Control Center online help.) d Open /et/defult/servied in text editor. Lote the SERVICED_FS_TYPE delrtion. Remove the numer sign hrter (#) from the eginning of the line. Add SERVICED_DM_THINPOOLDEV immeditely fter SERVICED_FS_TYPE. Reple Thin-Pool-Nme with the nme of the thin pool reted previously: SERVICED_DM_THINPOOLDEV=Thin-Pool-Nme e Sve the file, nd then lose the editor. 5 Optionl: Speify n lternte privte sunet for Control Center, if neessry. The defult privte sunet my lredy e in use in your environment. The following vrile onfigures servied to use n lternte sunet: SERVICED_VIRTUAL_ADDRESS_SUBNET Defult: 10.3 The 16-it privte sunet to use for servied's virtul IPv4 ddresses. RFC 1918 restrits privte networks to the 10.0/24, 172.16/20, nd 192.168/16 ddress spes. However, servied epts ny vlid, 16-it, IPv4 ddress spe for its privte network. Open /et/defult/servied in text editor. Lote the SERVICED_VIRTUAL_ADDRESS_SUBNET delrtion, nd then hnge the vlue. The following exmple shows the line to hnge: # SERVICED_VIRTUAL_ADDRESS_SUBNET=10.3 d Remove the numer sign hrter (#) from the eginning of the line. Sve the file, nd then lose the editor. User ess ontrol Control Center provides rowser interfe nd ommnd-line interfe. To gin ess to the Control Center rowser interfe, users must hve login ounts on the Control Center mster host. (Pluggle Authentition Modules (PAM) is supported.) In ddition, users must e memers of the Control Center dministrtive group, whih y defult is the system group, wheel. To enhne seurity, you my hnge the dministrtive group from wheel to ny non-system group. 15

Zenoss Core Instlltion Guide To use the Control Center ommnd-line interfe, users must hve login ounts on the Control Center mster host, nd e memers of the doker user group. Memers of the wheel group, inluding root, re memers of the doker group. Adding users to the defult dministrtive group This proedure dds users to the defult dministrtive group of Control Center, wheel. Performing this proedure enles users with superuser privileges to gin ess to the Control Center rowser interfe. Note Perform this proedure or the next proedure, ut not oth. 1 Log in to the host s root, or s user with superuser privileges. 2 Add users to the system group, wheel. Reple User with the nme of login ount on the mster host. usermod -G wheel User Repet the preeding ommnd for eh user to dd. Note For informtion out using Pluggle Authentition Modules (PAM), refer to your operting system doumenttion. Configuring regulr group s the Control Center dministrtive group This proedure hnges the defult dministrtive group of Control Center from wheel to non-system group. Note Perform this proedure or the previous proedure, ut not oth. 1 Log in to the Control Center mster host s root, or s user with superuser privileges. 2 Crete vrile for the group to designte s the dministrtive group. In this exmple, the nme of group to rete is servied. You my hoose ny nme or use n existing group. GROUP=servied 3 Crete new group, if neessry. groupdd $GROUP 4 Add one or more existing users to the new dministrtive group. Reple User with the nme of login ount on the host: usermod -G $GROUP User Repet the preeding ommnd for eh user to dd. 5 Speify the new dministrtive group in the servied onfigurtion file. The following vrile speifies the dministrtive group: SERVICED_ADMIN_GROUP Defult: wheel The nme of the Linux group on the Control Center mster host whose memers re uthorized to use the Control Center rowser interfe. You my reple the defult group with group tht does not hve superuser privileges. Open /et/defult/servied in text editor. 16

Instlling on hosts with internet ess Find the SERVICED_ADMIN_GROUP delrtion, nd then hnge the vlue from wheel to the nme of the group you hose erlier. The following exmple shows the line to hnge: # SERVICED_ADMIN_GROUP=wheel Remove the numer sign hrter (#) from the eginning of the line. d Sve the file, nd then lose the editor. 6 Optionl: Prevent root users nd memers of the wheel group from gining ess to the Control Center rowser interfe, if desired. The following vrile ontrols privileged logins: SERVICED_ALLOW_ROOT_LOGIN Defult: 1 (true) Determines whether root, or memers of the wheel group, my gin ess to the Control Center rowser interfe. Open /et/defult/servied in text editor. Find the SERVICED_ALLOW_ROOT_LOGIN delrtion, nd then hnge the vlue from 1 to 0. The following exmple shows the line to hnge: # SERVICED_ALLOW_ROOT_LOGIN=1 d Remove the numer sign hrter (#) from the eginning of the line. Sve the file, nd then lose the editor. Enling use of the ommnd-line interfe This proedure enles users to perform dministrtive tsks with the Control Center ommnd-line interfe y dding individul users to the doker group. 1 Log in to the Control Center mster host s root, or s user with superuser privileges. 2 Add users to the Doker group, doker. Reple User with the nme of login ount on the host. usermod -G doker User Repet the preeding ommnd for eh user to dd. Strting Control Center This proedure strts the Control Center servie, servied. 1 Log in to the mster host s root, or s user with superuser privileges. 2 Strt servied. systemtl strt servied To monitor progress, enter the following ommnd: journltl -flu servied -o t The servied demon invokes doker to pull its internl servies imges from Doker Hu. The Control Center rowser nd ommnd-line interfes re unville until the imges re instlled nd the servies re strted. The proess tkes pproximtely 5-10 minutes. When the messge Trying to disover my pool repets, Control Center is redy for the next steps. 17

Zenoss Core Instlltion Guide 3 Note Perform this step only if you re instlling single-host deployment. Optionl: Add the mster host to the defult resoure pool. Reple Hostnme-Or-IP with the hostnme or IP ddress of the Control Center mster host: servied host dd Hostnme-Or-IP:4979 defult If you enter hostnme, ll hosts in your Control Center luster must e le to resolve the nme, either through n entry in /et/hosts, or through nmeserver on your network. Isolting the mster host in seprte resoure pool Note If you re onfiguring single-host deployment, skip this proedure. Control Center enles or just performs rpid reovery from pplition servie filures. When Control Center internl servies nd pplition servies shre host, pplition filures n limit reovery options. Zenoss strongly reommends isolting the Control Center mster host in seprte resoure pool. This proedure retes new resoure pool for the Control Center mster host, nd then dds the mster host to the pool. 1 Log in to the mster host s root, or s user with superuser privileges. 2 Crete new resoure pool nmed mster. servied pool dd mster 3 Add the mster host to the mster resoure pool. Reple Hostnme-Or-IP with the hostnme or IP ddress of the Control Center mster host: servied host dd Hostnme-Or-IP:4979 mster If you enter hostnme, ll hosts in your Control Center luster must e le to resolve the nme, either through n entry in /et/hosts, or through nmeserver on your network. Instlling resoure pool hosts Note If you re instlling single-host deployment, skip this setion. Control Center resoure pool hosts run the pplition servies sheduled for the resoure pool to whih they elong, nd for whih they hve suffient RAM nd CPU resoures. Zenoss Core hs two rod tegories of pplition servies: Infrstruture nd olletion. The servies ssoited with eh tegory n run in the sme resoure pool, or n run in seprte resoure pools. For improved reliility, two resoure pool hosts re onfigured s nodes in n Aphe ZooKeeper ensemle. The storge required for ensemle hosts is slightly different thn the storge required for ll other resoure pool hosts: Eh ensemle host requires seprte primry prtition for Control Center internl servies dt, in ddition to the primry prtition for Doker dt. Unless the ZooKeeper servie on the Control Center mster host fils, their roles in the ZooKeeper ensemle do not ffet their roles s Control Center resoure pool hosts. Note The hosts for the ZooKeeper ensemle require stti IP ddresses, euse ZooKeeper does not support hostnmes in its onfigurtions. 18

Instlling on hosts with internet ess Repet the proedures in the following setions for eh host you wish to dd to your Control Center deployment. Verifying ndidte host resoures This proedure determines whether hosts's hrdwre resoures nd operting system re suffiient to serve s Control Center resoure pool host. Perform this proedure on eh resoure pool host in your deployment. 1 Log in to the ndidte host s root, or s user with superuser privileges. 2 Verify tht the host implements the 64-it version of the x86 instrution set. unme -m If the output is x86_64, the rhiteture is 64-it. Proeed to the next step If the output is i386/i486/i586/i686, the rhiteture is 32-it. Stop this proedure nd selet different host. 3 Verify tht nme resolution works on this host. hostnme -i If the result is not vlid IPv4 dddress, dd n entry for the host to the network nmeserver, or to /et/ hosts. 4 Verify tht the host's numeri identifier is unique. Eh host in Control Center luster must hve unique host identifier. hostid 5 Determine whether the ville, unused storge is suffiient. Disply the ville storge devies. lslk --output=name,size Compre the ville storge with the mount required for resoure pool host in your deployment. In prtiulr, resoure pool hosts tht re onfigured s nodes in ZooKeeper ensemle require n dditionl primry prtition for Control Center internl servies dt. For more informtion, refer to the Zenoss Core Plnning Guide. 6 Determine whether the ville memory nd swp is suffiient. Disply the ville memory. free -h Compre the ville memory with the mount required for resoure pool host in your deployment. For more informtion, refer to the Zenoss Core Plnning Guide. 7 Updte the operting system, if neessry. Determine whih relese is instlled. t /et/redht-relese If the result inludes 7.0, perform the following susteps. Updte the operting system. yum updte -y 19

Zenoss Core Instlltion Guide Restrt the system. reoot Prepring resoure pool host This proedure prepres RHEL/CentOS 7.1 or 7.2 host s Control Center resoure pool host. 1 Log in to the ndidte resoure pool host s root, or s user with superuser privileges. 2 Add n entry to /et/hosts for lolhost, if neessry. Determine whether 127.0.0.1 is mpped to lolhost. grep 127.0.0.1 /et/hosts grep lolhost If the preeding ommnds return no result, perform the following sustep. Add n entry to /et/hosts for lolhost. eho "127.0.0.1 lolhost" >> /et/hosts 3 Disle the firewll, if neessry. This step is required for instlltion ut not for deployment. For more informtion, refer to the Zenoss Core Plnning Guide. Determine whether the firewlld servie is enled. systemtl sttus firewlld.servie If the result inludes Ative: intive (ded), the servie is disled. Proeed to the next step. If the result inludes Ative: tive (running), the servie is enled. Perform the following sustep. Disle the firewlld servie. systemtl stop firewlld && systemtl disle firewlld On suess, the preeding ommnds disply messges similr to the following exmple: rm '/et/systemd/system/dus-org.fedorprojet.firewlld1.servie' rm '/et/systemd/system/si.trget.wnts/firewlld.servie' 4 Optionl: Enle persistent storge for log files, if desired. By defult, RHEL/CentOS systems store log dt only in memory or in smll ring-uffer in the /run/log/ journl diretory. By performing this step, log dt persists nd n e sved indefinitely, if you implement log file rottion prties. For more informtion, refer to your operting system doumenttion. mkdir -p /vr/log/journl && systemtl restrt systemd-journld 5 Disle Seurity-Enhned Linux (SELinux), if instlled. Determine whether SELinux is instlled. test -f /et/selinux/onfig && grep '^SELINUX=' /et/selinux/onfig If the preeding ommnds return result, SELinux is instlled. Set the operting mode to disled. 20

Instlling on hosts with internet ess Open /et/selinux/onfig in text editor, nd hnge the vlue of the SELINUX vrile to disled. Confirm the new setting. grep '^SELINUX=' /et/selinux/onfig 6 Enle nd strt the Dnsmsq pkge. systemtl enle dnsmsq && systemtl strt dnsmsq 7 Instll nd onfigure the NTP pkge. Instll the pkge. yum instll -y ntp Set the system time. ntpd -gq Enle the ntpd demon. systemtl enle ntpd d Configure ntpd to strt when the system strts. Currently, n unresolved issue ssoited with NTP prevents ntpd from restrting orretly fter reoot. The following ommnds provide workround to ensure tht it does. eho "systemtl strt ntpd" >> /et/r.d/r.lol hmod +x /et/r.d/r.lol 8 Instll the Nmp Nt utility. The utility is used to verify ZooKeeper ensemle onfigurtions. Perform this step only on the two resoure pool hosts tht re designted for use in the ZooKeeper ensemle. yum instll -y nmp-nt 9 Instll the Zenoss repository pkge. Instll the pkge. rpm -ivh http://get.zenoss.io/yum/zenoss-repo-1-1.x86_64.rpm Clen out the yum he diretory. yum len ll 10 Reoot the host. reoot Creting file system for Control Center internl servies This proedure retes n XFS file system on primry prtition. 21

Zenoss Core Instlltion Guide Note Perform this proedure only on the two resoure pool hosts tht re designted for use in the ZooKeeper ensemle. No other resoure pool hosts run Control Center internl servies, so no other pool hosts need prtition for internl servies dt. 1 Log in to the trget host s root, or s user with superuser privileges. 2 Identify the trget primry prtition for the file system to rete. lslk --output=name,size,type,fstype,mountpoint 3 Crete n XFS file system. Reple Isvs-Prtition with the pth of the trget primry prtition: mkfs -t xfs Isvs-Prtition 4 Crete the mount point for Control Center internl servies dt. mkdir -p /opt/servied/vr/isvs 5 Add n entry to the /et/fst file. Reple Isvs-Prtition with the pth of the primry prtition used in the previous step: eho "Isvs-Prtition \ /opt/servied/vr/isvs xfs defults 0 0" >> /et/fst 6 Mount the file system, nd then verify it mounted orretly. mount - && mount grep isvs Exmple result: /dev/xvd1 on /opt/servied/vr/isvs type xfs (rw,reltime,selel,ttr2,inode64,noquot) Instlling Doker nd Control Center This proedure instlls nd onfigures Doker, nd instlls Control Center. 1 Log in to the resoure pool host s root, or s user with superuser privileges. 2 Instll Doker 1.9.0, nd then disle identl upgrdes. Add the Doker repository to the host's repository list. t > /et/yum.repos.d/doker.repo <<-EOF [dokerrepo] nme=doker Repository seurl=https://yum.dokerprojet.org/repo/min/entos/7 enled=1 gpghek=1 gpgkey=https://yum.dokerprojet.org/gpg EOF Instll Doker 1.9.0. yum len ll && yum mkehe fst yum instll -y doker-engine-1.9.0 Open /et/yum.repos.d/doker.repo with text editor. 22

Instlling on hosts with internet ess d Chnge the vlue of the enled key from 1 to 0. e Sve the file nd lose the text editor. 3 Crete symoli link for the Doker temporry diretory. Doker uses its temporry diretory to spool imges. The defult diretory is /vr/li/doker/tmp. The following ommnd speifies the sme diretory tht Control Center uses, /tmp. You n speify ny diretory tht hs minimum of 10GB of unused spe. Crete the doker diretory in /vr/li. mkdir /vr/li/doker Crete the link to /tmp. ln -s /tmp /vr/li/doker/tmp 4 Crete systemd override file for the Doker servie definition. Crete the override diretory. mkdir -p /et/systemd/system/doker.servie.d Crete the override file. t <<EOF > /et/systemd/system/doker.servie.d/doker.onf [Servie] TimeoutSe=300 EnvironmentFile=-/et/sysonfig/doker ExeStrt= ExeStrt=/usr/in/doker demon \$OPTIONS -H fd:// EOF Relod the systemd mnger onfigurtion. systemtl demon-relod 5 Instll Control Center. Control Center inludes utility tht simplifies the proess of reting devie mpper thin pool. yum len ll && yum mkehe fst yum --enlerepo=zenoss-stle instll -y servied-1.1.7 6 Crete devie mpper thin pool for Doker dt. Identify the primry prtition for the thin pool to rete. lslk --output=name,size,type,fstype,mountpoint Crete the thin pool. Reple Pth-To-Devie with the pth of n unused primry prtition: servied-storge rete-thin-pool doker Pth-To-Devie On suess, the result inludes the nme of the thin pool, whih lwys strts with /dev/mpper. 7 Configure nd strt the Doker servie. Crete vriles for dding rguments to the Doker onfigurtion file. The --exe-opt rgument is workround for Doker issue on RHEL/CentOS 7.x systems. 23

Zenoss Core Instlltion Guide Reple Thin-Pool-Devie with the nme of the thin pool devie reted in the previous step: mydriver="-s deviempper" myfix="--exe-opt ntive.groupdriver=groupfs" myflg="--storge-opt dm.thinpooldev" mypool="thin-pool-devie" Add the rguments to the Doker onfigurtion file. eho 'OPTIONS="'$myDriver $myfix $myflg'='$mypool'"' \ >> /et/sysonfig/doker Strt or restrt Doker. systemtl restrt doker The initil strtup tkes up to minute, nd my fil. If the strtup fils, repet the previous ommnd. 8 Configure nme resolution in ontiners. Eh time it strts, doker selets n IPv4 sunet for its virtul Ethernet ridge. The seletion n hnge; this step ensures onsisteny. Identify the IPv4 sunet nd netmsk doker hs seleted for its virtul Ethernet ridge. ip ddr show doker0 grep inet Open /et/sysonfig/doker in text editor. Add the following flgs to the end of the OPTIONS delrtion. Reple Bridge-Sunet with the IPv4 sunet doker seleted for its virtul ridge, nd reple Bridge-Netmsk with the netmsk doker seleted: --dns=bridge-sunet --ip=bridge-sunet/bridge-netmsk For exmple, if the ridge sunet nd netmsk is 172.17.0.1/16, the flgs to dd re --dns=172.17.0.1 --ip=172.17.0.1/16. Note Leve lnk spe fter the end of the thin pool devie nme, nd mke sure the doule quote hrter (") is t the end of the line. d Restrt the Doker servie. systemtl restrt doker Configuring nd strting Control Center This proedure ustomizes key onfigurtion vriles of Control Center. 1 Log in to the resoure pool host s root, or s user with superuser privileges. 2 Configure Control Center s n gent of the mster host. The following vrile onfigures servied to serve s gent: SERVICED_AGENT Defult: 0 (flse) Determines whether servied instne performs gent tsks. Agents run pplition servies sheduled for the resoure pool to whih they elong. The servied instne onfigured s the mster 24

Instlling on hosts with internet ess runs the sheduler. A servied instne my e onfigured s gent nd mster, or just gent, or just mster. SERVICED_MASTER Defult: 0 (flse) Determines whether servied instne performs mster tsks. The mster runs the pplition servies sheduler nd other internl servies, inluding the server for the Control Center rowser interfe. A servied instne my e onfigured s gent nd mster, or just gent, or just mster. Only one servied instne in Control Center luster my e the mster. In ddition, the following lines need to e edited, to reple {{SERVICED_MASTER_IP}} with the IP ddress of the mster host: # SERVICED_ZK={{SERVICED_MASTER_IP}}:2181 # SERVICED_DOCKER_REGISTRY={{SERVICED_MASTER_IP}}:5000 # SERVICED_ENDPOINT={{SERVICED_MASTER_IP}}:4979 # SERVICED_LOG_ADDRESS={{SERVICED_MASTER_IP}}:5042 # SERVICED_LOGSTASH_ES={{SERVICED_MASTER_IP}}:9100 # SERVICED_STATS_PORT={{SERVICED_MASTER_IP}}:8443 Open /et/defult/servied in text editor. Find the SERVICED_AGENT delrtion, nd then hnge the vlue from 0 to 1. The following exmple shows the line to hnge: # SERVICED_AGENT=0 d e Remove the numer sign hrter (#) from the eginning of the line. Find the SERVICED_MASTER delrtion, nd then remove the numer sign hrter (#) from the eginning of the line. Glolly reple {{SERVICED_MASTER_IP}} with the IP ddress of the mster host. Note Remove the numer sign hrter (#) from the eginning of eh vrile delrtion tht inludes the mster IP ddress. f Sve the file, nd then lose the editor. 3 Optionl: Speify n lternte privte sunet for Control Center, if neessry. The defult privte sunet my lredy e in use in your environment. The following vrile onfigures servied to use n lternte sunet: SERVICED_VIRTUAL_ADDRESS_SUBNET Defult: 10.3 The 16-it privte sunet to use for servied's virtul IPv4 ddresses. RFC 1918 restrits privte networks to the 10.0/24, 172.16/20, nd 192.168/16 ddress spes. However, servied epts ny vlid, 16-it, IPv4 ddress spe for its privte network. Open /et/defult/servied in text editor. Lote the SERVICED_VIRTUAL_ADDRESS_SUBNET delrtion, nd then hnge the vlue. The following exmple shows the line to hnge: # SERVICED_VIRTUAL_ADDRESS_SUBNET=10.3 d Remove the numer sign hrter (#) from the eginning of the line. Sve the file, nd then lose the editor. 25

Zenoss Core Instlltion Guide 4 Strt the Control Center servie (servied). systemtl strt servied To monitor progress, enter the following ommnd: journltl -flu servied -o t To instll dditionl resoure pool hosts, return to Verifying ndidte host resoures on pge 19. ZooKeeper ensemle onfigurtion Note If you re instlling single-host deployment, or if your deployment inludes fewer thn two resoure pool hosts, skip this setion. Control Center relies on Aphe ZooKeeper to oordinte its servies. The proedures in this setion rete ZooKeeper ensemle of 3 nodes. To perform these proedures, you need Control Center mster host nd minimum of two resoure pool hosts. Eh resoure pool host requires seprte primry prtition for Control Center internl servies, nd eh should hve stti IP ddress. For more informtion out storge requirements, refer to the Zenoss Core Plnning Guide. Note Zenoss strongly reommends onfiguring ZooKeeper ensemle for ll prodution deployments. A ZooKeeper ensemle requires minimum of 3 nodes, nd 3 nodes is suffiient for most deployments. A 5-node onfigurtion improves filover protetion during mintenne windows. Ensemles lrger thn 5 nodes re not neessry. An odd numer of nodes is reommended, nd n even numer of nodes is strongly disourged. Note The Control Center ZooKeeper servie requires onsistently fst storge. Idelly, the primry prtition for Control Center internl servies is on seprte, high-performne devie tht hs only one primry prtition. Control Center vriles for ZooKeeper This tles in this setion ssoites the ZooKeeper-relted Control Center vriles to set in /et/defult/ servied with the roles tht hosts ply in Control Center luster. Tle 1: Control Center mster host SERVICED_ISVCS_ZOOKEEPER_ID The unique identifier of ZooKeeper ensemle node. Vlue: 1 SERVICED_ISVCS_ZOOKEEPER_QUORUM The ZooKeeper node ID, IP ddress, peer ommunitions port, nd leder ommunitions port of eh host in n ensemle. Eh quorum definition must e unique, so the IP ddress of the "urrent" host is 0.0.0.0. Vlue: ZooKeeper-ID@IP-Address:2888:3888,... SERVICED_ZK The list of endpoints in the Control Center ZooKeeper ensemle, seprted y the omm hrter (,). Eh endpoint inludes the IP ddress of the ensemle node, nd the port tht Control Center uses to ommunite with it. Vlue: IP-Address:2181,... 26

Instlling on hosts with internet ess Tle 2: Control Center resoure pool host nd ZooKeeper ensemle node SERVICED_ISVCS_ZOOKEEPER_ID The unique identifier of ZooKeeper ensemle node. Vlue: 2 or 3 SERVICED_ISVCS_ZOOKEEPER_QUORUM The ZooKeeper node ID, IP ddress, peer ommunitions port, nd leder ommunitions port of eh host in n ensemle. Eh quorum definition must e unique, so the IP ddress of the "urrent" host is 0.0.0.0. Vlue: ZooKeeper-ID@IP-Address:2888:3888,... SERVICED_ISVCS_START The list of Control Center internl servies to strt nd run on hosts other thn the mster host. Vlue: zookeeper SERVICED_ZK The list of endpoints in the Control Center ZooKeeper ensemle, seprted y the omm hrter (,). Eh endpoint inludes the IP ddress of the ensemle node, nd the port tht Control Center uses to ommunite with it. Vlue: IP-Address:2181,... Tle 3: Control Center resoure pool host only SERVICED_ZK The list of endpoints in the Control Center ZooKeeper ensemle, seprted y the omm hrter (,). Eh endpoint inludes the IP ddress of the ensemle node, nd the port tht Control Center uses to ommunite with it. Vlue: IP-Address:2181,... Configuring the mster host s ZooKeeper node This proedure onfigures the Control Center mster host s memer of the ZooKeeper ensemle. Note For ury, this proedure onstruts Control Center onfigurtion vriles in the shell nd ppends them to /et/defult/servied. The lst step is to move the vriles from the end of the file to more pproprite lotions. 1 Log in to the mster host s root, or s user with superuser privileges. 2 Crete vrile for eh Control Center host to inlude in the ZooKeeper ensemle. The vriles re used in susequent steps. Note Define the vriles identilly on the mster host nd on eh resoure pool host. Reple Mster-Host-IP with the IP ddress of the Control Center mster host, nd reple Pool-Host-A-IP nd Pool-Host-B-IP with the IP ddresses of the Control Center resoure pool hosts to inlude in the ensemle: node1=mster-host-ip node2=pool-host-a-ip node3=pool-host-b-ip 27

Zenoss Core Instlltion Guide Note ZooKeeper requires IP ddresses for ensemle onfigurtion. 3 Set the ZooKeeper node ID to 1. eho "SERVICED_ISVCS_ZOOKEEPER_ID=1" >> /et/defult/servied 4 Speify the nodes in the ZooKeeper ensemle. You my opy the following text nd pste it in your onsole: eho "SERVICED_ZK=${node1}:2181,${node2}:2181,${node3}:2181" \ >> /et/defult/servied 5 Speify the nodes in the ZooKeeper quorum. ZooKeeper requires unique quorum definition for eh node in its ensemle. To hieve this, reple the IP ddress of the urrent node with 0.0.0.0. You my opy the following of text nd pste it in your onsole: q1="1@0.0.0.0:2888:3888" q2="2@${node2}:2888:3888" q3="3@${node3}:2888:3888" eho "SERVICED_ISVCS_ZOOKEEPER_QUORUM=${q1},${q2},${q3}" \ >> /et/defult/servied 6 Clen up the Control Center onfigurtion file. d e f g h i Open /et/defult/servied with text editor. Nvigte to the end of the file, nd ut the line tht ontins the SERVICED_ZK vrile delrtion t tht lotion. The vlue of this delrtion speifies 3 hosts. Lote the SERVICED_ZK vrile ner the eginning of the file, nd then delete the line it is on. The vlue of this delrtion is just the mster host. Pste the SERVICED_ZK vrile delrtion from the end of the file in the lotion of the just-deleted delrtion. Nvigte to the end of the file, nd ut the line tht ontins the SERVICED_ISVCS_ZOOKEEPER_ID vrile delrtion t tht lotion. Lote the SERVICED_ISVCS_ZOOKEEPER_ID vrile ner the end of the file, nd then delete the line it is on. This delrtion is ommented out. Pste the SERVICED_ISVCS_ZOOKEEPER_ID vrile delrtion from the end of the file in the lotion of the just-deleted delrtion. Nvigte to the end of the file, nd ut the line tht ontins the SERVICED_ISVCS_ZOOKEEPER_QUORUM vrile delrtion t tht lotion. Lote the SERVICED_ISVCS_ZOOKEEPER_QUORUM vrile ner the end of the file, nd then delete the line it is on. This delrtion is ommented out. j Pste the SERVICED_ISVCS_ZOOKEEPER_QUORUM vrile delrtion from the end of the file in the lotion of the just-deleted delrtion. k Sve the file, nd then lose the text editor. 7 Verify the ZooKeeper environment vriles. egrep '^[^#]*SERVICED' /et/defult/servied egrep '(_ZOO _ZK)' 28

Instlling on hosts with internet ess Configuring resoure pool host s ZooKeeper node To perform this proedure, you need resoure pool host with n XFS file system on seprte prtition, reted previously. This proedure onfigures ZooKeeper ensemle on resoure pool host. Repet this proedure on eh Control Center resoure pool host to dd to the ZooKeeper ensemle. 1 Log in to the resoure pool host s root, or s user with superuser privileges. 2 Crete vrile for eh Control Center host to inlude in the ZooKeeper ensemle. The vriles re used in susequent steps. Note Define the vriles identilly on the mster host nd on eh resoure pool host. Reple Mster-Host-IP with the IP ddress of the Control Center mster host, nd reple Pool-Host-A-IP nd Pool-Host-B-IP with the IP ddresses of the Control Center resoure pool hosts to inlude in the ensemle: node1=mster-host-ip node2=pool-host-a-ip node3=pool-host-b-ip Note ZooKeeper requires IP ddresses for ensemle onfigurtion. 3 Set the ID of this node in the ZooKeeper ensemle. For Pool-Host-A-IP (node2), use the following ommnd: eho "SERVICED_ISVCS_ZOOKEEPER_ID=2" >> /et/defult/servied For Pool-Host-B-IP (node3), use the following ommnd: eho "SERVICED_ISVCS_ZOOKEEPER_ID=3" >> /et/defult/servied 4 Speify the nodes in the ZooKeeper ensemle. You my opy the following text nd pste it in your onsole: eho "SERVICED_ZK=${node1}:2181,${node2}:2181,${node3}:2181" \ >> /et/defult/servied 5 Speify the nodes in the ZooKeeper quorum. ZooKeeper requires unique quorum definition for eh node in its ensemle. To hieve this, reple the IP ddress of the urrent node with 0.0.0.0. For Pool-Host-A-IP (node2), use the following ommnds: q1="1@${node1}:2888:3888" q2="2@0.0.0.0:2888:3888" q3="3@${node3}:2888:3888" eho "SERVICED_ISVCS_ZOOKEEPER_QUORUM=${q1},${q2},${q3}" \ >> /et/defult/servied For Pool-Host-B-IP (node3), use the following ommnds: q1="1@${node1}:2888:3888" q2="2@${node2}:2888:3888" 29