libcurlphp

2020/10/0307:171/113InstallationfromsourcesZabbixDocumentation3.
0-https://www.
zabbix.
com/documentation/3.
0/3InstallationfromsourcesYoucangettheverylatestversionofZabbixbycompilingitfromthesources.
Astep-by-steptutorialforinstallingZabbixfromthesourcesisprovidedhere.
5.
4.
6InstallingZabbixdaemons1DownloadthesourcearchiveGototheZabbixdownloadpageanddownloadthesourcearchive.
Oncedownloaded,extractthesources,byrunning:$tar-zxvfzabbix-3.
0.
0.
tar.
gzEnterthecorrectZabbixversioninthecommand.
Itmustmatchthenameofthedownloadedarchive.
2CreateuseraccountForalloftheZabbixdaemonprocesses,anunprivilegeduserisrequired.
IfaZabbixdaemonisstartedfromanunprivilegeduseraccount,itwillrunasthatuser.
However,ifadaemonisstartedfroma'root'account,itwillswitchtoa'zabbix'useraccount,whichmustbepresent.
Tocreatesuchauseraccount(initsowngroup,"zabbix"),onaRedHat-basedsystem,run:groupadd--systemzabbixuseradd--system-gzabbix-d/usr/lib/zabbix-s/sbin/nologin-c"ZabbixMonitoringSystem"zabbixonaDebian-basedsystem,run:addgroup--system--quietzabbixadduser--quiet--system--disabled-login--ingroupzabbix--home/var/lib/zabbix--no-create-homezabbixZabbixprocessesdonotneedahomedirectory,whichiswhywedonotrecommendcreatingit.
However,ifyouareusingsomefunctionalitythatrequiresit(e.
g.
storeMySQLcredentialsin$HOME/.
my.
cnf)youarefreetocreateitusingthefollowingcommands.
OnRedHat-basedsystems,run:mkdir-mu=rwx,g=rwx,o=-p/usr/lib/zabbixchownzabbix:zabbix/usr/lib/zabbixOnDebian-basedsystems,run:Lastupdate:2020/06/2613:45manual:installation:installhttps://www.
zabbix.
com/documentation/3.
0/manual/installation/installhttps://www.
zabbix.
com/documentation/3.
0/Printedon2020/10/0307:17mkdir-mu=rwx,g=rwx,o=-p/var/lib/zabbixchownzabbix:zabbix/var/lib/zabbixAseparateuseraccountisnotrequiredforZabbixfrontendinstallation.
IfZabbixserverandagentarerunonthesamemachineitisrecommendedtouseadierentuserforrunningtheserverthanforrunningtheagent.
Otherwise,ifbotharerunasthesameuser,theagentcanaccesstheservercongurationleandanyAdminleveluserinZabbixcanquiteeasilyretrieve,forexample,thedatabasepassword.
RunningZabbixasroot,bin,oranyotheraccountwithspecialrightsisasecurityrisk.
3CreateZabbixdatabaseForZabbixserverandproxydaemons,aswellasZabbixfrontend,adatabaseisrequired.
ItisnotneededtorunZabbixagent.
SQLscriptsareprovidedforcreatingdatabaseschemaandinsertingthedataset.
ZabbixproxydatabaseneedsonlytheschemawhileZabbixserverdatabaserequiresalsothedatasetontopoftheschema.
HavingcreatedaZabbixdatabase,proceedtothefollowingstepsofcompilingZabbix.
4CongurethesourcesWhenconguringthesourcesforaZabbixserverorproxy,youmustspecifythedatabasetypetobeused.
Onlyonedatabasetypecanbecompiledwithaserverorproxyprocessatatime.
Toseeallofthesupportedcongurationoptions,insidetheextractedZabbixsourcedirectoryrun:.
/configure--helpTocongurethesourcesforaZabbixserverandagent,youmayrunsomethinglike:.
/configure--enable-server--enable-agent--with-mysql--enable-ipv6--with-net-snmp--with-libcurl--with-libxml2--with-libcurlcongurationoptionwithcURL7.
20.
0orhigherisrequiredforSMTPauthentication,supportedsinceZabbix3.
0.
0.
--with-libcurland--with-libxml2congurationoptionsarerequiredforvirtualmachinemonitoring,supportedsinceZabbix2.
2.
0.
TocongurethesourcesforaZabbixserver(withPostgreSQLetc.
),youmayrun:.
/configure--enable-server--with-postgresql--with-net-snmpTocongurethesourcesforaZabbixproxy(withSQLiteetc.
),youmayrun:.
/configure--prefix=/usr--enable-proxy--with-net-snmp--with-sqlite3--2020/10/0307:173/113InstallationfromsourcesZabbixDocumentation3.
0-https://www.
zabbix.
com/documentation/3.
0/with-ssh2TocongurethesourcesforaZabbixagent,youmayrun:.
/configure--enable-agentYoumayusethe--enable-staticagtostaticallylinklibraries.
Ifyouplantodistributecompiledbinariesamongdierentservers,youmustusethisagtomakethesebinariesworkwithoutrequiredlibraries.
Notethat--enable-staticdoesnotworkunderSolaris.
Using--enable-staticoptionisnotrecommendedwhenbuildingserver.
Inordertobuildtheserverstaticallyyoumusthaveastaticversionofeveryexternallibraryneeded.
Thereisnostrictcheckforthatincongurescript.
Command-lineutilitieszabbix_getandzabbix_senderarecompiledif--enable-agentoptionisused.
AddoptionalpathtotheMySQLcongurationle--with-mysql=//mysql_congtoselectthedesiredMySQLclientlibrarywhenthereisaneedtouseonethatisnotlocatedinthedefaultlocation.
ItisusefulwhenthereareseveralversionsofMySQLinstalledorMariaDBinstalledalongsideMySQLonthesamesystem.
Use--with-ibm-db2agtospecifylocationoftheCLIAPI.
Use--with-oracleagtospecifylocationoftheOCIAPI.
ForencryptionsupportseeCompilingZabbixwithencryptionsupport5MakeandinstalleverythingIfinstallingfromgit,itisrequiredtorunrst:$makedbschemamakeinstallThisstepshouldberunasauserwithsucientpermissions(commonly'root',orbyusingsudo).
Runningmakeinstallwillbydefaultinstallthedaemonbinaries(zabbix_server,zabbix_agentd,zabbix_proxy)in/usr/local/sbinandtheclientbinaries(zabbix_get,zabbix_sender)in/usr/local/bin.
Tospecifyadierentlocationthan/usr/local,usea--prexkeyinthepreviousstepofconguringsources,forexample--prex=/home/zabbix.
Inthiscasedaemonbinarieswillbeinstalledunder/sbin,whileutilitiesunder/bin.
Manpageswillbeinstalledunder/share.
6ReviewandeditcongurationlesedittheZabbixagentcongurationle/usr/local/etc/zabbix_agentd.
confYouneedtocongurethisleforeveryhostwithzabbix_agentdinstalled.
Lastupdate:2020/06/2613:45manual:installation:installhttps://www.
zabbix.
com/documentation/3.
0/manual/installation/installhttps://www.
zabbix.
com/documentation/3.
0/Printedon2020/10/0307:17YoumustspecifytheZabbixserverIPaddressinthele.
Connectionsfromotherhostswillbedenied.
edittheZabbixservercongurationle/usr/local/etc/zabbix_server.
confYoumustspecifythedatabasename,userandpassword(ifusingany).
WithSQLitethefullpathtodatabaselemustbespecied;DBuserandpasswordarenotrequired.
Therestoftheparameterswillsuityouwiththeirdefaultsifyouhaveasmallinstallation(uptotenmonitoredhosts).
YoushouldchangethedefaultparametersifyouwanttomaximizetheperformanceofZabbixserver(orproxy)though.
Seetheperformancetuningsectionformoredetails.
ifyouhaveinstalledaZabbixproxy,edittheproxycongurationle/usr/local/etc/zabbix_proxy.
confYoumustspecifytheserverIPaddressandproxyhostname(mustbeknowntotheserver),aswellasthedatabasename,userandpassword(ifusingany).
WithSQLitethefullpathtodatabaselemustbespecied;DBuserandpasswordarenotrequired.
7StartupthedaemonsRunzabbix_serverontheserverside.
shell>zabbix_serverMakesurethatyoursystemallowsallocationof36MB(orabitmore)ofsharedmemory,otherwisetheservermaynotstartandyouwillsee"Cannotallocatesharedmemoryfor.
"intheserverlogle.
ThismayhappenonFreeBSD,Solaris8.
Seethe"Seealso"sectionatthebottomofthispagetondouthowtoconguresharedmemory.
Runzabbix_agentdonallthemonitoredmachines.
shell>zabbix_agentdMakesurethatyoursystemallowsallocationof2MBofsharedmemory,otherwisetheagentmaynotstartandyouwillsee"Cannotallocatesharedmemoryforcollector.
"intheagentlogle.
ThismayhappenonSolaris8.
IfyouhaveinstalledZabbixproxy,runzabbix_proxy.
shell>zabbix_proxy5.
4.
7InstallingZabbixwebinterfaceCopyingPHPlesZabbixfrontendiswritteninPHP,sotorunitaPHPsupportedwebserverisneeded.
InstallationisdonebysimplycopyingthePHPlesfromfrontends/phptothewebserverHTMLdocumentsdirectory.
2020/10/0307:175/113InstallationfromsourcesZabbixDocumentation3.
0-https://www.
zabbix.
com/documentation/3.
0/CommonlocationsofHTMLdocumentsdirectoriesforApachewebserversinclude:/usr/local/apache2/htdocs(defaultdirectorywheninstallingApachefromsource)/srv/www/htdocs(OpenSUSE,SLES)/var/www/html(Fedora,RHEL,CentOS)/var/www(Debian,Ubuntu)ItissuggestedtouseasubdirectoryinsteadoftheHTMLroot.
TocreateasubdirectoryandcopyZabbixfrontendlesintoit,executethefollowingcommands,replacingtheactualdirectory:mkdir/zabbixcdfrontends/phpcp-a.
/zabbixIfinstallingfromgitandplanningtouseanyotherlanguagethanEnglish,youmustgeneratetranslationles.
Todoso,run:locale/make_mo.
shmsgfmtutilityfromgettextpackageisrequired.
Additionally,touseanyotherlanguagethanEnglish,itslocaleshouldbeinstalledonthewebserver.
Seethe"Seealso"sectioninthe"Userprole"pagetondouthowtoinstallitifrequired.
InstallingfrontendStep1Inyourbrowser,openZabbixURL:http:///zabbixYoushouldseetherstscreenofthefrontendinstallationwizard.
Lastupdate:2020/06/2613:45manual:installation:installhttps://www.
zabbix.
com/documentation/3.
0/manual/installation/installhttps://www.
zabbix.
com/documentation/3.
0/Printedon2020/10/0307:17Step2Makesurethatallsoftwareprerequisitesaremet.
Pre-requisiteMinimumvalueDescriptionPHPversion5.
4.
0PHPmemory_limitoption128MBInphp.
ini:memory_limit=128MPHPpost_max_sizeoption16MBInphp.
ini:post_max_size=16MPHPupload_max_lesizeoption2MBInphp.
ini:upload_max_lesize=2MPHPmax_execution_timeoption300seconds(values0and-1areallowed)Inphp.
ini:max_execution_time=300PHPmax_input_timeoption300seconds(values0and-1areallowed)Inphp.
ini:max_input_time=300PHPsession.
auto_startoptionmustbedisabledInphp.
ini:session.
auto_start=0DatabasesupportOneof:IBMDB2,MySQL,Oracle,PostgreSQL,SQLiteOneofthefollowingmodulesmustbeinstalled:ibm_db2,mysql,oci8,pgsql,sqlite3bcmathphp-bcmathmbstringphp-mbstringPHPmbstring.
func_overloadoptionmustbedisabledInphp.
ini:mbstring.
func_overload=02020/10/0307:177/113InstallationfromsourcesZabbixDocumentation3.
0-https://www.
zabbix.
com/documentation/3.
0/Pre-requisiteMinimumvalueDescriptionPHPalways_populate_raw_post_dataoptionmustbedisabledRequiredonlyforPHPversions5.
6.
0ornewer.
Inphp.
ini:always_populate_raw_post_data=-1socketsphp-net-socket.
Requiredforuserscriptsupport.
gd2.
0orhigherphp-gd.
PHPGDextensionmustsupportPNGimages(--with-png-dir),JPEG(--with-jpeg-dir)imagesandFreeType2(--with-freetype-dir).
libxml2.
6.
15php-xmlorphp5-domxmlwriterphp-xmlwriterxmlreaderphp-xmlreaderctypephp-ctypesessionphp-sessiongettextphp-gettextSinceZabbix2.
2.
1,thePHPgettextextensionisnotamandatoryrequirementforinstallingZabbix.
Ifgettextisnotinstalled,thefrontendwillworkasusual,however,thetranslationswillnotbeavailable.
Optionalpre-requisitesmayalsobepresentinthelist.
AfailedoptionalprerequisiteisdisplayedinorangeandhasaWarningstatus.
Withafailedoptionalpre-requisite,thesetupmaycontinue.
IfthereisaneedtochangetheApacheuserorusergroup,permissionstothesessionfoldermustbeveried.
OtherwiseZabbixsetupmaybeunabletocontinue.
Step3Enterdetailsforconnectingtothedatabase.
Zabbixdatabasemustalreadybecreated.
Lastupdate:2020/06/2613:45manual:installation:installhttps://www.
zabbix.
com/documentation/3.
0/manual/installation/installhttps://www.
zabbix.
com/documentation/3.
0/Printedon2020/10/0307:17Step4EnterZabbixserverdetails.
EnteringanameforZabbixserverisoptional,however,ifsubmitted,itwillbedisplayedinthemenubarandpagetitles.
Step5Reviewasummaryofsettings.
2020/10/0307:179/113InstallationfromsourcesZabbixDocumentation3.
0-https://www.
zabbix.
com/documentation/3.
0/Step6Downloadthecongurationleandplaceitunderconf/inthewebserverHTMLdocumentssubdirectorywhereyoucopiedZabbixPHPlesto.
Providingthewebserveruserhaswriteaccesstoconf/directorythecongurationlewouldbesavedautomaticallyanditwouldbepossibletoproceedtothenextsteprightaway.
Step7Finishtheinstallation.
Lastupdate:2020/06/2613:45manual:installation:installhttps://www.
zabbix.
com/documentation/3.
0/manual/installation/installhttps://www.
zabbix.
com/documentation/3.
0/Printedon2020/10/0307:17Step8Zabbixfrontendisready!
ThedefaultusernameisAdmin,passwordzabbix.
ProceedtogettingstartedwithZabbix.
SeealsoHowtoconguresharedmemoryforZabbixdaemons1.
2020/10/0307:1711/113InstallationfromsourcesZabbixDocumentation3.
0-https://www.
zabbix.
com/documentation/3.
0/From:https://www.
zabbix.
com/documentation/3.
0/-ZabbixDocumentation3.
0Permanentlink:https://www.
zabbix.
com/documentation/3.
0/manual/installation/installLastupdate:2020/06/2613:45