BigBrotherInstallationandConfigurationGuide

ThisguidehasbeenwrittenbyCookITServices.ItwillshowyouhowtogetBigBrother
installedandoperatingonaSolarisserver.Ifyouwouldlikeacustomisedversionofthis
guide(differentplatform/etc)contactusasat:
http://www.cookitservices.com
Copyright2005
GuideVersion2.0
WeprovideBigBrotherconsultingservices.
1.Introduction...........................................................................................................................4
TargetAudienceforthisdocument......................................................................................4
WhyisuseBigBrother?.......................................................................................................4
Whataboutusingacommercialenterprisemonitoringproduct?.....................................4
Whatdoesitmonitor?...........................................................................................................4
Howarewenotifiedwhensomethinggoeswrong?.............................................................4
Whataboutchangingitforourneeds?.................................................................................5
2.Someterminology.................................................................................................................5
3.InstallingBIGBrother..........................................................................................................6
3.1Downloadthesourcecode..............................................................................................6
3.2Decompressthepackage.................................................................................................6
3.3Modifythesearchpath...................................................................................................6
3.4Untarthebigbrothersoftware........................................................................................7
3.5CreateabigbrothergroupandusertoownandrunBigBrother..................................7
3.6InstalltheServerSoftware..............................................................................................7
3.6.1Step1......................................................................................................................8
3.6.2Step2.....................................................................................................................12
3.6.3Step3.....................................................................................................................13
3.6.4Step4.....................................................................................................................13
3.6.5Step5.....................................................................................................................13
3.6.6Step6.....................................................................................................................14
3.6.7Step7.....................................................................................................................14
3.6.8Step8.....................................................................................................................14
3.6.9Step9.....................................................................................................................14
3.6.10Step10.................................................................................................................14
3.6.11Step11.................................................................................................................15

3.7InstalltheClientSoftware........................................................................................16
4.ConfiguringBigBrother.....................................................................................................19
4.1DownloadthelatestBBConfigpackagefromhttp://www.deadcat.net........................19
4.2Configurekeywordstolookforinthemessagesfile...................................................24
4.3CustomiseDiskFreechecks.........................................................................................24
4.4Configurewhoisnotifiedwithmessages.....................................................................25
4.5Updatethedescriptionseenonthefrontpage..............................................................26
4.6Startuptheserver.........................................................................................................26
4.7GenericInstructionsToConfigureExtensionScripts..................................................27
4.8ExtensionScripts..........................................................................................................28
5.InstallClientSoftwareonnewTargetServer.....................................................................28
AddtheentrytoBBConfig.................................................................................................29
Regeneratethebbconfigurationfiles.................................................................................29
Generateclienttarball(readytotransfertotheclientserver)...........................................29
Transferclienttarfiletonewserver...................................................................................29
Logintothedestinationclient............................................................................................29
CreateabigbrothergroupandusertoownandrunBigBrother......................................29
Movetarfileintothebbcdirectory....................................................................................29
Gotobbclientdir...............................................................................................................29
Extracttheclientfiles.........................................................................................................30
Maketheclientautomaticallystartonboot........................................................................30
Nowtomakeitstartautomatically.............................................................................31
Starttheclient.....................................................................................................................31
Checkforerrors..................................................................................................................31
6.Tips.....................................................................................................................................32
BigBrotherDocumentation....................................................................................................32
HowtoAcknowledgingalerts................................................................................................32
SMSsetupforbigbrother(onSolaris)...................................................................................32
ConfiguringSolarisforhighspeeddialout...........................................................................34
1.Configureyourserialportfordialout............................................................................34
2.Testcommunicationwiththemodem.............................................................................35
3.SetthemodemDTEspeed.............................................................................................36
4.Testhighspeedcommunicationwiththemodem..........................................................37
5.Checkpermissionsandownershipofthedevicefiles....................................................39
6.Dialaremotesystem......................................................................................................39
ConfigureBigBrothertosendSMSmessages.......................................................................40
GNUtarInstallation...............................................................................................................41
PerlInstallation.......................................................................................................................41
RRDInstallation.....................................................................................................................44
WhyuseRRD?...................................................................................................................45

LARRDInstallation................................................................................................................45
WhyuseLARRD?..............................................................................................................45
ToactivateLARRDtrendingonaBigBrotherClient...........................................................48
MRTGinstallation..................................................................................................................48
WhyuseMRTG?................................................................................................................48
Installzlibfirst................................................................................................................49
Installjpeglibraries........................................................................................................49
Installinglibpng..............................................................................................................49
InstallingGD..................................................................................................................50
InstallMRTG..................................................................................................................50
Configurebbmrtg.pl...........................................................................................................51
Whyusebbmrtg.pl?........................................................................................................51
Configuremrtgrrd.cgi........................................................................................................52
Whyusemrtgrrd.cgil?...................................................................................................52
Addadeviceformrtgtomonitor.......................................................................................53
ConfigureMRTGtorunfromcron....................................................................................53
BigBrother.pmInstallation.....................................................................................................54
WhyuseBigBrother.pm?...................................................................................................54
FPINGInstallation..................................................................................................................54
WhyuseFPING?................................................................................................................54
InstalltheFPINGbinary.....................................................................................................54
Installfping.pl.....................................................................................................................55
DisableBigBrotherserverfromperformingpings............................................................55
ConfigureSNMPintegration..................................................................................................56
WhyuseSNMP?.................................................................................................................56
Installopenssl(ifnotalreadyinstalled)..............................................................................56
EnsureSNMPisnotcurrentlyrunning...............................................................................56
NETSNMPInstallation.....................................................................................................57
InstalltheNETSNMPPerlModules.................................................................................58
TestaSNMPdevice...........................................................................................................58
InstalltheCPANPerlModules..........................................................................................58
Installbbxsnmp.....................................................................................................................59

1.Introduction
BigBrotherisdesignedtoletanyonefromomniscientSysAdmins,toPointyHeaded
Bosses,seehowthenetworkisdoinginnearrealtime,fromanywebbrowser,anywhere.
BigBrotherdisplaysstatusinformationaswebpagesorWMLpagesforWAPenabled
devices.Thesewebpageshavethesystemsmonitoreddownthelefthandsideofthepage,
thetestsforeachsystemacrossthetopofthepage.Thisresultsinamatrixofcolourcoded
dotsonscreen.GreenisGood,RedisBad.Inaddition,thebackgroundcolourofthestatus
pagesisalwaysthecolourofthemostseriousconditionofanyelementbeingmonitoredat
thattime.
TargetAudienceforthisdocument
AjuniorsystemsadministratorwithsomeknowledgeofUNIX.ThisGuideshouldcontain
enoughdetailtogetanenterprisemonitoringsolutioninstalledatyoursite.Startsmall
thoughuntilyoufullyunderstandhoweverythingworks.e.g.oneserverandoneclient.
WhyisuseBigBrother?
Itischeapanditworks!Aslongasyoudonotchargeforthemonitoringservice,youdo
notrequireacommerciallicense.Problemsareusuallyknownbeforeanycustomerscontact
you.Sometimesproblemsarefixedbeforethecustomerevenknowssomethingwent
wrong!
Whataboutusingacommercialenterprisemonitoringproduct?
Itisexpensive!Itmayormaynotmonitoreverythingyouneed,butcostisamajorfactor.
Extrahardwareandtrainingwillberequired.Youwillprobablyneedmanypermanentstaff
justtomanageit.
BigBrothercanbeinstalledandrunningbeforeyouevenstartevaluatingthelargescale
commercialequivalents.
Whatdoesitmonitor?
SunSolaris,almostanyUNIXvariant(Linux,etc),NT,Novell,VMS,andanydevicethat
canuseSNMP(e.g.CiscoEquipment,NokiaFirewalls,CacheflowProxies,etc)
Howarewenotifiedwhensomethinggoeswrong?
Email,pagerandalsoSMSitsendsmessagestomobilephones.

Whataboutchangingitforourneeds?
Thesourcecodeisincluded,soyoucanchangewhateverwelike.Ifthereareextratests
thatyouwantperformed,simplywritethecodeyourselfusingUNIXshellscript,perl,java,
whatever(orcontacthttp://www.cookitservices.comforhelp).Thereisawebsitehosting
extratestspeoplehavewrittenandsharewiththeworld.(http://www.deadcat.net).
BigBrotheritselfismainlywritteninUNIXshellscript,withsomepartswritteninCfor
speed.
Fordetailedinformationlookat:
http://ww.bb4.com
http://ww.bb4.org
Note:Awebserverisrequiredtoviewbigbrotheroutput.i.e.InstallApache
AworkingCcompilerisalsorequired.i.e.Installgcc(ForSolarisgetareadyto
installversionfromhttp://www.sunfreeware.com)
Conventionsusedinthisguide:
Whereyouseeaninstructionshowingthisprompt#itindicatesyoushouldexecutethe
instructionastherootuser.Whereyouseethisprompt$itindicatesyoushouldexecute
thecommandasthebigbrotheruser.

2.

Someterminology

BBDISPLAYistheserverthatreceivestheupdatesfromthebigbrotherclients.Thisis
whereyoupointyourwebbrowsertoquicklyseethestateofyourservers.
BBNETistheserverthatwillperformnetworktests.e.g.DNS,SMTP,IMAP,etc.This
guidesassumesyourmainBBDISPLAYserverwillalsofunctionasanetworktesting
server.
BBPAGERistheserverthatwillsendalerts.ThisguidesassumesyourmainBBDISPLAY
serverwillalsofunctionasapagingserver.

BBCLIENT.Machinethathasthebigbrothertools/agentrunningonit.ForBigBrother
1.9eyourBBDISPLAYserverwillusuallyalsobeaBBCLIENTserver.Bydefault,the
clientsoftwareisnotautomaticallyinstalledwhenyouinstalltheserversoftware.

3.InstallingBIGBrother
3.1
Downloadthesourcecode
Note:TherearecurrentlytwoversionsofBigBrother.Theprofessionalversionandbetter
thanfree(btf).Theprofessionalversiondoesnotcontainsourcecodeandrequiresa
commerciallicenseforuse,thebtfversioncontainsthesourcecodeanddoesnotrequirea
commerciallicenseformostcompanies.Seehttp://ww.bb4.comandhttp://ww.bb.orgfor
moreinformation.
Thisguideisforthebetterthanfreeversion,
Thesourcecodeisavailablefromhttp://www.bb4.org/.Atthetimeofwriting,thelatest
versionforUNIXis
v1.9e
Downloadthisfileintoatemporarydirectory,suchas/usr/local
3.2
Decompressthepackage
Todecompressthedownloadedpackagefile:
#cd/usr/local
#gunzipbb*
Thisreplacesthedownloadedfilewiththedecompressedfile
bb1.9e.tar
3.3
Modifythesearchpath
Ifyouhaven'talreadydonesoforothersoftware,younowneedtomodifythesearchpaths
sothatthesystemcanfindtheprogramanditsmanualpages.Thisisdonebyeditingthe
file~/.profileandaddingthefollowinglines(iftheyaren'talreadythere)totheend:
PATH=/usr/local/bin:/usr/local/sbin:/usr/ccs/bin
:$PATH

MANPATH=$MANPATH:/usr/man/:/usr/local/man
LD_LIBRARY_PATH=/lib:/usr/lib:/usr/openwin/lib:/
usr/local/ssl/lib:/usr/local/lib
exportPATHMANPATHLD_LIBRARY_PATH
It'sadvisabletologoutandloginagainatthispointtoactivatethesechanges.

3.4
Untarthebigbrothersoftware
Installingthepackageissimplyamatterofissuingthefollowingcommands:
#cd/usr/local
#tarxvf./bb1.9e.tar
Thiscreates3filesBB.README.FIRST,BBSVR
bb1.9ebtf.tar,andBBCLTbbc1.9ebtf.tar.Read
theREADME!!
#tarxvf./BBSVRbb1.9ebtf.tar
3.5

CreateabigbrothergroupandusertoownandrunBigBrother

Note:followyoursiteguidelinesonuserandgroupcreation.Thefollowingisan
exampleonly
#groupaddg1984bbgroup
#useraddu1984g1984d/usr/local/bbbbuser
s/bin/ksh
3.6

InstalltheServerSoftware

Note:Followingsectionwastakendirectlyfrom
README.INSTALL,withextracommentsfromus.
ThissectionisforinstallingBigBrotherona
newplatform,ortoinstallaBBDISPLAYserver.

ToinstallBBonaclientseethesectionlater
inthisdocument.
bb1.9ebtf/referredas$BBHOME
bbvar/acks/referredas$BBACKS
/data/referredas$BBATA
/disabled/referredas$BBDISABLED
/hist/referredas$BBHIST
/histlogs/referredas$BBHISTLOGS
/logs/referredas$BBLOGS

3.6.1

Step1

Renamethedefaultinstallationdir.Wewillchangeitbacklater.
mvbb1.9ebtfbb
cdbb
ThisdirectoryisoftenreferredasBBHOMEor$BBHOME
cd./install
./bbconfig<OSNAME>
whereOSNAMEisbsdisco3scofreebsdsolarishpux9hpux
linuxsunosnetbsdosfultrixirix
unixwareredhataixdynixdebiandgux
calderamandrake
Notethat<OSNAME>isoptional,BBwilltrytofigureitout.

IfyouarerunningLinuxyoumayhavetoprovidetheproper
distributionname:
./bbconfigredhat
./bbconfigdebian
./bbconfigcaldera
./bbconfigmandrake
./bbconfiglinux
./bbconfigwillaskyouquestionsaboutyoursetup
bereadywith:
Iftheoldstylestructurebekept
IfyouintendtouseFQDN(Fullyqualifieddomainnames)

Whichhost(s)is(are)theBBDISPLAY(s)
Whichhost(s)is(are)theBBPAGER(s)
IfthecurrenthostisaBBDISPLAY/BBPAGER
Defaultemailrecipientfornotification
URLyouintendtoviewBBwith
URLoftheBBCGIscripts
Theuseridofyourwebserver
e.g.
PLEASEREADTHISSOFTWARELICENSEAGREEMENT(THE"AGREEMENT")
CAREFULLY.BYDOWNLOADING,INSTALLING,COPYINGORUSINGTHEBIG
BROTHERSOFTWARE(THE"PRODUCT"),YOUINDICATEACCEPTANCEOFAND
AGREETOTHETERMSANDCONDITIONSOFTHISAGREEMENT.IFYOUDONOT
AGREETOTHESETERMSANDCONDITIONS,DONOTINSTALLORUSETHEPRODUCT.

[snip]
Doyouagreetothetermsofthislicense(y/n):y
Welcome to the Big Brother installation procedure...
Please confirm your OS: [solaris]:
---> We'll configure for solaris...
Big Brother needs it's own user id. If your BB user
doesn't exist,
you'll have to create it then re-run bbconfig.
What will be the user ID for BB [bb]: bbuser
---> BB will only run from user 'bbuser'
Making sure BBHOME </usr/local/bb> is writable...
---> OK, /usr/local/bb is fine...

When you set up your machines, you should use Fully

Qualified
Domain names, this means you use the whole name, like
www.bb4.com,
instead of just 'www'. This is recommended.

Use FQDN (y/n): [y] y

---> Good, we'll use FQDN

Big Brother creates HTML pages with the status of

your network.
You'll need a web server to publish this information.

What host will be the BBDISPLAY [bbserver.mydomain.com]:

---> OK... bbserver.mydomain.com will be a BBDISPLAY

server.

Big Brother sends important messages to a pager

This
machine will at a minimum to be able to send mail.

What host will be the BBPAGER [bbserver.mydomain.com]:

Some questions regarding the current host

(bbserver.mydomain.com) will be asked.

Is this host a BBDISPLAY host (y/n): [y]

Is this host a BBPAGER host (y/n): [y]
Enter the default recipient: [root@bbserver.mydomain.com]
Since Big Brother produces results to be displayed on
web
pages, we need to know where to view these results.
Enter the base URL for BB [/bb]:
---> OK... Big Brother will live under http://
bbserver.mydomain.com/bb
Big Brother also uses CGI scripts to create dynamic
output.
What directory do these scripts live in?
Enter CGI directory [/home/www/httpd/cgi-bin]: /
usr/local/apache2/cgi-bin
---> OK... CGI scripts will live at /usr/local/apache2/cgi-bin
Enter the base URL of the CGI scripts [/cgi-bin]:
---> OK... The base URL location of CGI scripts is in /cgi-bin
---------------------------------------------------------> UPDATING Makefile
--> UPDATING runbb.sh
--> UPDATING bbsys.local

--> CHECKING COMMAND PATHNAMES

*** Verifying pathnames to necessary commands...
DIG is unavailable, the directive "dig" cannot be used in bbhosts
You
DIG
***
-->
-->
-->

are missing these commands:

Done.
UPDATING bbdef.sh
UPDATING URL location
INSTALLING CGI scripts

BB needs to set the group name of the www/rep

directory
to the group name of the web server by using its user
name
Enter web server user id [nobody]: apache
You may override the group name determined by the
previous step.
Enter group name [nobody]: apache
-->
-->
-->
-->

SETTING WRITE PERMISSION FOR OWNER AND GROUP FOR www/rep

CHANGING THE GROUP ID OF www/rep
UPDATING pager scripts
UPDATING pager scripts

--------------------------------------------------------

---------------------------------------------------------> Done.

Now do
chown -R bbuser /usr/local/bbvar /usr/local/bb
su - bbuser
to continue installation using that

user ID
Now compile Big Brother
cd /usr/local/bb/src
make
make install
--------------------------------------------------------

Changethedirnamebacktocurrentversion
#mv/usr/local/bb/usr/local/bb1.9ebtf
Createasoftlinktothebbdir.ThiswillmakeupgradingBigBrothereasier.
#lns/usr/local/bb1.9ebtf/usr/local/bb
Thisisusefulasyoudon'thavetochangethedirectoryinyourstartupscript.(seesection
11)
Addthisto.profileforbbuser
#vi/usr/local/bb/.profile
PATH=/sbin:/usr/sbin:/usr/bin:/usr/local/bin:/usr/local/sb
in:/usr/ccs/bin

MANPATH=$MANPATH:/usr/man/:/usr/local/man

LD_LIBRARY_PATH=/lib:/usr/lib:/usr/openwin/lib:/usr/local/
ssl/lib:/usr/local/lib
exportPATHMANPATHLD_LIBRARY_PATH

lns/full_path_to_bb/www/WWW/bb(where/WWWistheDocumentRootdir).
Makesurethepermissionsarecorrect.Configureyourwebserver
forthisdirectoryifneedbe.
Alsomakesurethatyourwebserverfollowssymboliclinks
Note:usethelocationofthebblinkinstep5)
TocheckwhereyourDocumentRootdirectoryislocated
#find/namehttpd.conf
#grepDocument/full_path_to/httpd.conf
e.g.
#lns/usr/local/bb/www/usr/local/apache2/htdocs/bb

3.6.2

Step2

Becomebbuser

#subbuser
Thisshouldputyouinthebbuserhomedir(/usr/local/bb)
$cdsrc
$make
$makeinstall

3.6.3

Step3

$cd../etc
editbbhosts,putyourhostsnamesinthere.Refertoinstall/README.
ThisisthecoreofBigBrother.Youmustreadthedocshere.
editbbdef.sh,setalarmlevelsandthings.Ifyouwanttouse
fullyqualifieddomainnamehoststhenmakesureyousetFQDN=TRUE
inetc/bbdef.sh.Ifthisisthefirsthostyouinstallandintend
touseitasthedisplay/notificationserveraswellastheserver
thattestthenetworkservicesthenyourbbhostsshouldcontain
thisline:
xxx.xxx.xxx.xxxbbserver.mydomain.com#BBDISPLAYBBPAGERBBNET
Edit/usr/local/bb/etc/bbdefserver.shandmakethefollowingchanges:
BBLOGSTATUS="DYNAMIC"
BBNETTHREADS=5
RUNOPTS="DATAMSGEMBEDHTML"
3.6.4

Step4
./bbchkcfg.sh
Checksthebbdef.sh/bbinc.sh/bbsys.shsourcescriptsforinvalidentries
./bbchkhosts.sh
Checksthebbhostsfileforerrors

3.6.5

Step5

3.6.6

Step6

3.6.7

Step7
cd/usr/local/bb
./runbb.shstart
ExaminetheBBOUTfileforanyerrors
NBTheHTMLsummarypages(bb.html/bb2.html)shouldbeavailable
2minutesafterthestartup.Don'tpanictheyllbethereif
youarepatient.Inyourbrowser,youshouldbeableto
seetheresultsathttp://bbserver.mydomain.com/bb/or
http://bbserver.mydomain.com/bb/bb.html(assumingyouused/bbasBBURLroot)

3.6.8

Step8
Debug,andlookatallthedocs.

3.6.9

Step9
Checktheonlinedocumentation!Itlivesunder:
http://bb4.org/bb/bbhelp.html

3.6.10 Step10
Thiswillhaveenabledyoutohaveadisplay/pagerserversetup.
Atthispointnoclientsarerunning.Whenyouhaveallof
yourhostsdefinedinetc/bbhoststhen
useinstall/bbclienttocreateatarballforBBclientsofthesame
OS/HWtype.IfyouhavedifferentOS/HWplatformsthen
reinstallBBoneachone(thenusethebbclienttocreateatarball
foreachidenticalOS/HWclient)anddon'tforgettocopyyourmaster
bbhostsfiletoit.Runthroughtheinstallproceduretomake
surethattheclientsarealsoinstalledproperly(bbchkcfg.sh/bbchkhosts.cfg)
(Note:ThismeansyoucannotuseabbclientonSolarisSPARCandthenftpittoa
differentplatform.e.g.itwillnotworkonSCO,Solarisx86,orTru64.Youmust
install,compile,andconfiguretheclientsoftwareforeachplatformyouwantto
support.Youdonot,however,needtorunaBBDISPLAYserveroneachdifferent
platform)

3.6.11 Step11
IfyouwishtostartBBautomaticallyatstartup,createafilecalledbbandputitin
your/etc/init.ddir:
e.g.ForSolaris
#vi/etc/init.d/bb
Putviintoinsertmode(i)
Thenpastethefollowingscript
#!/bin/sh
#
#bbThisshellscripttakescareofstartingandstopping
#BigBrother
#
#description:BigBrotherisasystem&networkmonitor
#
BBHOME=/usr/local/bb
BBUSER=bbuser
[f$BBHOME/runbb.sh]||exit0
#Seehowwewerecalled.
case"$1"in
start)
#Startdaemons.
su$BBUSERc"cd$BBHOME;./runbb.shstart"
;;
stop)
#Stopdaemons.
su$BBUSERc"cd$BBHOME;./runbb.shstop"
;;
status)
statusbb
;;
restart|reload)
$0stop
$0start
;;
*)
echo"Usage:bb{start|stop|restart|reload|status}"

exit1
esac
exit0
#EndofBigBrotherstartupscript
Nowtomakeitstartautomatically
#lns/etc/init.d/bb/etc/rc2.d/S99bb
#lns/etc/init.d/bb/etc/rc0.d/K01bb
Maketheinitscriptexecutable
#chmodu+x/etc/init.d/bb
3.7InstalltheClientSoftware
#cd/usr/local
Extracttheclienttarfile.
#tarxvf./BBCLTbbc1.9ebtf.tar
#chownRbbuser:bbgroupbbc1.9ebtf
#mvbbc1.9ebtfbbc
#subbuser
#cd../bbc
#cdinstall
#./bbconfig
PLEASEREADTHISSOFTWARELICENSEAGREEMENT(THE"AGREEMENT")
CAREFULLY.BYDOWNLOADING,INSTALLING,COPYINGORUSINGTHEBIG
BROTHER SOFTWARE (THE "PRODUCT"), YOU INDICATE ACCEPTANCE OF
AND
AGREETOTHETERMSANDCONDITIONSOFTHISAGREEMENT. IFYOUDO
NOT
AGREETOTHESETERMSANDCONDITIONS,DONOTINSTALLORUSETHE
PRODUCT.
[snip]

Doyouagreetothetermsofthislicense(y/n):y
Thankyou,installationcontinuing...

WelcometotheBigBrotherinstallationprocedure.
PleaseconfirmyourOS:[solaris]:
>We'llconfigureforsolaris...
BigBrotherneedsit'sownuserid.IfyourBBuserdoesn'texist,
you'llhavetocreateitthenrerunbbconfig.
WhatwillbetheuserIDforBB[bb]:bbuser
>BBwillonlyrunfromuser'bbuser'
MakingsureBBHOME</usr/local/bbc>iswritable...
>OK,/usr/local/bbcisfine...

Whenyousetupyourmachines,youshoulduseFullyQualified
Domainnames,thismeansyouusethewholename,likewww.bb4.com,
insteadofjust'www'.Thisisrecommended.
UseFQDN(y/n):[y]
>Good,we'lluseFQDN

>UPDATINGrunbb.sh
>UPDATINGbbsys.local
>CHECKINGCOMMANDPATHNAMES
***Verifyingpathnamestonecessarycommands...
***Done.
>UPDATINGbbdef.sh

>Done.Nowdo
chownRbbuser/usr/local/bbc
NowcompileBigBrother
cd/usr/local/bbc/src
make
makeinstall

#cd../src
#make
#makeinstall
Renamethedirectorybacktotheoriginalname
#mv/usr/local/bbc/usr/local/bbc1.9ebtf

Createasoftlinktothenewclientdirectory.ThiswillmakeupgradingBigBrothereasier.
#lns/usr/local/bbc1.9ebtf/usr/local/bbc
editbbhosts,putyourhostsnamesinthere.Refertoinstall/README.
ThisisthecoreofBigBrother.Youmustreadthedocshere.
editbbdef.sh,setalarmlevelsandthings.Ifyouwanttouse
fullyqualifieddomainnamehoststhenmakesureyousetFQDN=TRUE
inetc/bbdef.sh.Ifthisisthefirsthostyouinstallandintend
touseitasthedisplay/notificationserveraswellastheserver
thattestthenetworkservicesthenyourbbhostsshouldcontain
thisline:
xxx.xxx.xxx.xxxthis.host.name

#BBDISPLAYBBPAGERBBNET

Everyclientwillneedanentryinthisbbhostsfile.WewilluseatoolcalledBBConfigto
editthisfileforus.

4.

ConfiguringBigBrother

4.1

DownloadthelatestBBConfigpackagefromhttp://www.deadcat.net

(BBConfigdoesalotofthehardworkofeditingmultiplebbfilestoconfigureit.You
couldalsoeditthevariousbb*tabfilesandbbhostsyourself,butitwillbemoreerror
prone)
Placethefilein/usr/local
e.g.#cpBBConfig1.9.tar.gz/usr/local
Installingthepackageissimplyamatterofissuingthefollowingcommands:
#cd/usr/local
#gunzipBBConfig*
#tarxvf./BBConfig*.tar
#cdBBConfig1_9
#perlinstallbbhome/usr/local/bb

***ReadtheBBConfig.READMEfile.****
Samplebbconfig(configurationfilesfor
BBConfig)
# Uncomment the following lines if you want to turn on
# the generation of $BBHOME/etc/security.
#
objectclass: bigbrother
security:
off

#----------------------------------------# Templates
#----------------------------------------# Sample template for Solaris
#
objectclass:
template
name:
solaris
services:
dns ftp
procpanic:
inetd syslogd /usr/sbin/cron sshd
ext:
bb-top.sh network2.sh bb-cpu2.sh bbprtdiag.sh bb-iostat.sh bb-ntp.sh bf-larrd.sh
cpu:
500:600
msg:
/var/adm/messages: : atal ; anic ; rror;
ERROR ; OFFLINE ; half-duplex ; ailing ; transport failed ;
disk not responding ; NOTICE ; WARNING ; repeated : ntpdate ;
xntpd ; core : forceload
objectclass:
name:

template
NTServer

objectclass:
name:
services:

template
dns
dns

objectclass:
name:
services:

template
cisco
snmp

objectclass:
name:
services:
snmp:

template
cacheflow_pxy
snmp
public cacheflow_cpu

#----------------------------------------# Hosts
#----------------------------------------################################################
# Unix Servers
################################################
host:
bbserver.mydomain.com
ip:
0.0.0.0
template:
solaris
template:
veritas
bbservices:
BBDISPLAY BBNET BBPAGER
bbset:
UnixServers
procpanic:
/usr/local/apache2/bin/httpd;<=2
ext_add:
larrd/larrd.pl bf-larrd.sh bbmrtg.pl
host:
ip:
template:
template:
bbset:
ext:
disk:

solaris1.mydomain.com
10.10.0.4
solaris
veritas
UnixServers
netbackup.sh
/:96:98

################################################
# DNS Servers
################################################
host:
ip:
template:
bbset:

dns1.mydomain.com
10.10.0.5
dns
DNS

host:
ip:
template:
bbset:

dns2.mydomain.com
10.10.0.6
dns
DNS

################################################
# NT Servers
################################################
host:
ip:
template:
bbset:

ntserver1.mydomain.com
10.10.0.7
NTServer
NTServers

################################################

# Cisco
################################################
host:
ip:
template:
bbset:

ciscorouter1.mydomain.com
10.10.0.1
cisco
cisco_router

################################################
# Proxy Servers
################################################
host:
ip:
template:
bbset:
services:

proxy1.mydomain.com
10.10.0.8
cacheflow_pxy
cacheflow_proxy
snmp

Samplebbdisp
page cisco Cisco Equipment
group-compress Cisco Routers
<bbset cisco_router>
pagesolarisSolarisEquipment
group-compress Unix Servers
<bbset UnixServers>
page dns Domain Name Servers
group-compress DNS Servers
<bbset DNS>
page NT NT Servers
group-compress NT Servers
<bbset NTServers>
page proxys Proxys
group-compress Cacheflow Proxy Servers
<bbset cacheflow_proxy>
ProducesaHostsFile
Samplehostsfile(/usr/local/bb/etc/bbhosts)

#
#THEBIGBROTHERHOSTSFILE
#
#THISFILESHOULDBETHESAMEONALLSYSTEMS
RUNNINGBIGBROTHER
#CHANGETHISFILETOREFLECTYOURENVIRONMENT!
#
page cisco Cisco Equipment
group-compress Cisco Routers
10.10.0.1ciscorouter1.mydomain.com#snmp
pagesolarisSolarisEquipment
groupcompressUnixServers
0.0.0.0bbserver.mydomain.com#BBDISPLAYBBNET
BBPAGER
10.10.0.4solaris1.mydomain.com#dnsftp
groupcompressDNSServers
10.10.0.5dns1.mydomain.com#dns
10.10.0.6dns2.mydomain.com#dns
page NT NT Servers
group-compress NT Servers
10.10.0.7

ntserver1.mydomain.com #

page proxys Proxys

group-compress Cacheflow Proxy Servers
10.10.0.8

proxy1.mydomain.com #

snmp

Notetheline:
0.0.0.0bbserver.mydomain.com#BBPAGERBBNETBBDISPLAY
Thislinetellseachclientwheretosenditsoutput.
Westronglyrecommendusingthisstyle.
Or,youcouldalsousesomethinglikethis:

10.10.0.1bbserver.mydomain.com#BBPAGERBBNETBBDISPLAYftppop3topcpu2
logsdns
The0.0.0.0forcestheclienttodoaDNSlookupeverytimeitwantstosenddatatothe
BBDISPLAYserver.SoifyoueverwanttomoveyourBBDISPLAYservertoanewIP
address,thenyoudon'thavetoupdateeveryclient.JustasimpleDNSchange.
ThisdoesalsomeanifDNSonyourclientsfails,oryourmainDNSserverfails,thenBig
Brotherstopsworking.But,ifthathappensyouwillhavebiggerproblemsthanclientsnot
beingabletosendupdatestoyourmainBigBrotherserver!

4.2

Configurekeywordstolookforinthemessagesfile

Usebbconfigtosetthisup.Usethemsgdirective.
Samplelinethatmaybeusedisbelow
msg:/var/adm/messages::atal;anic;rror;ERROR;OFFLINE;halfduplex;ailing;
transportfailed;disknotresponding;WARNING;core;repeated;NOTICE:ntpdate;
xntpd:forceload
Add/removekeywordsasdesired.
4.3
CustomiseDiskFreechecks
Samplefile/usr/local/bbc/bbdftab
Thismustbeconfiguredoneachclient(putthesettingsinbbconfig,andletitgeneratethe
bbdftabfileforyou)
Samplebbdftabthatbbconfighasproduced.
#
#bbdftab
#BIGBROTHERCUSTOMDISKPARTITIONMONITORINGFILE
#FORMAT:[host:]partition:warn%:panic%
#
#bbdftab:configurationfilefordiskspacechecking
#
#hostcanbeFQDN(fullyqualifieddomainname)or
#justaplainhostnamebutitispreferredthatyou
#useaFQDN.

#
#FORTHESAMEFILESYSTEMSONEACHCLIENTUSEEITHER
#localhost:/mntpoint:XX:YY
#or
#/mntpoint:XX:YY
#
#COPYTHISFILETObbdftabANDEDITTOTASTE
#ANYPARTITIONSNOTEXPLICITLYLISTEDHEREWILL
#USETHEVALUESSETBYDFWARN&DFPANICSETIN
#bbdef.sh.DEFAULTSINbbdef.shARE
#WARNINGAT90%ANDPANICAT95%
#
#Youcanalsousevalues>100tomakeitalwaysgreen
#
#/usr:92:98
#/home:88:93
#/db:100:101
solaris1.mydomain.com:/:96:98
4.4
Configurewhoisnotifiedwithmessages
Note:thenotificationsectionishighlyconfigurable.Certainpeopleorgroupscanbe
notifiedatcertaintimesforsomeevents.e.g.Youcansetupagrouptoonlybenotified
aboutprinterproblems,duringworkhours.
Theexamplebelowisverysimple.
InthefileontheBBDISPLAYserver(/usr/local/bb/etc/bbwarnsetup.cfg)
changethelinestartingwithpgsysadmins:
e.g.
#
#The"pggroupname"tokenspecifiesthattherecipientslistedcan
#bereferredto"pggroupname"intherecipientsfieldinthebbwarnrules.cfg
#configfile.Youcandefineasmanypagegroupsthatyouneed
#
#i.e.pgrouteradmins:joe@localhostjoey@localhostjoanne@localhost
#inrules:*;;*;;*;*;pgrouteradminsroot@localhost
#
#itistheequivalentof

#*;;*;;*;*;joe@localhostjoey@localhostjoanne@localhostroot@localhost
#
#Scope:BBPAGER
#Reset:No
pgsysadmins:root@localhostmy.name@mydomain.com
InthefileontheBBDISPLAYserver(/usr/local/bb/etc/bbwarnrules.cfg)
Changeittoreflectthesectionmentionedbelow:
#
#Enteryourruleshere
#
*;;*;;*;*;pgsysadmins
4.5

Updatethedescriptionseenonthefrontpage

Editthefile/usr/local/bb/etc/bbinc.sh
Lookfortheline
MKBBLOCAL="<B><I>PagesHostedLocally</I></B>"
Changeitto:
MKBBLOCAL="<B><I>OurMonitoredServices</I></B>"
4.6
Startuptheserver
e.g.ForSolaris
#/etc/init.d/bbstart
or
#subbuser
$cd/usr/local/bb
$./runbb.shstart
Checkthefile$BBHOME/BBOUTforerrors
e.g.
$tailf/usr/local/bb/BBOUT

Pointyourwebbrowseratyourwebserver
e.g.http://bbserver.mydomain.com/bb
YoushouldseeBigBrotherworking.
4.7

GenericInstructionsToConfigureExtensionScripts

Note:Somescriptsdownloadedfromhttp://www.deadcat.netneedtobemodifiedtomake
themwork.Theydonotallwork"outofthebox".
Someshellscriptingknowledgeisrequired.
Extracttherequiredscriptintothe"ext"dirunderbigbrotherrootdir.
e.g.
$cd/usr/local/bb/ext

$tarxvf./myextscript.tar

Checkthecontentsoftheextensionscriptforanyinstructions.Youmayneedtochange
variablesettings.Youmayalsoneedtoaddentriesintothebbsys.localfile.
Youwillneedtoaddthescripttothebbbbexttabfile.(TIP:easierifyouusebbconfig
instead)
e.g.
$cd/usr/local/BBConfig/etc
$vibbconfig
Addinyourextensionscriptfilename
e.g.
hostmyserver1.mydomain.com
ip:0.0.0.0
ext_addmyextscript.sh
Restartbigbrother
e.g.
$/usr/local/bbc/runbb.shrestart

4.8
ExtensionScripts
Checkouthttp://ww.deadcat.net
Somescriptsthatmaybeusefulnamesmaybeslightlydifferent (downloadthelatest
version)
bbtray0.51.zip
This is a little win32 trayicon program that monitors a predefined BBDISPLAY page
(normallythe"CondensedView"page)andalertswhenthestatusofthatpagechanges,
usingapopupwindowandsoundalarm.
bbntp.shTestNTPonvariousmachines.Warnswhentimedriftstoofar.
bbiostat.shperformancechecksusingvmstatandiostat
bbvxcheck.shVeritasdiskchecks
bbtop.pl
bbcpu2.sh
bbbind.sh
bbprtdiag.sh
network2.sh
larrd(producesperformance/trendinggraphs)
bbmrtg.pl
bbnetbackup.sh
bbradius.sh

5.

InstallClientSoftwareonnewTargetServer

e.g.onaSunsevercalledsolaris1.
GoingtoaSunsevercalledsolaris2.
Usingbigbrotherversion1.9e
(NotetargetclientmustbethesameOStype.e.g.YoucannotuseaSunSparctocreatea
clientforaSolarisIntelbox.Don'tforgettocopyyourmasterbbhostsfiletoit.Run
throughtheinstallproceduretomakesurethattheclientsarealsoinstalledproperly
(bbchkcfg.sh/bbchkhosts.cfg)

AddtheentrytoBBConfig
OnyourBBServereditbbconfigfilefirst,addyournewhost
e.g.
host:
solaris2.mydomain.com
ip:
10.10.0.10
template:
solaris
bbset:
UnixServers
Regeneratethebbconfigurationfiles
$/usr/local/BBConfig/bin/bbconfigure
Generateclienttarball(readytotransfertotheclientserver)
#cd/usr/local/bbc
#tarcvf<clientname>.tar*
Transferclienttarfiletonewserver
e.g.
#scp<clientname>.tardestclient:/usr/local/
Logintothedestinationclient
#sshsolaris2
CreateabigbrothergroupandusertoownandrunBigBrother
Note:followyoursiteguidelinesonuserandgroupcreation.Thefollowingisan
exampleonly
#groupaddg1984bbgroup

#useraddu1984g1984d/usr/local/bbcs/bin/kshm
bbuser

Movetarfileintothebbcdirectory
#mv<clientname>.tar/usr/local/bbc
Gotobbclientdir
#cd/usr/local/bbc

Extracttheclientfiles
#tarxvf<clientname>.tar
Maketheclientautomaticallystartonboot
IfyouwishtostartBBautomaticallyatstartup,createafilecalledbbcandputitinyour/
etc/init.ddir:
eg.ForSolaris
#vi/etc/init.d/bbc
Putviintoinsertmode(i)
Thenpastethefollowingscript
#!/bin/sh
#
#bbcThisshellscripttakescareofstartingandstopping
#BigBrotherClient
#
#description:BigBrotherisasystem&networkmonitor
#
BBHOME=/usr/local/bbc
BBUSER=bbuser
[f$BBHOME/runbb.sh]||exit0
#Seehowwewerecalled.
case"$1"in
start)
#Startdaemons.
su$BBUSERc"cd$BBHOME;./runbb.shstart"
;;
stop)
#Stopdaemons.
su$BBUSERc"cd$BBHOME;./runbb.shstop"
;;
status)

statusbb
;;
restart|reload)
$0stop
$0start
;;
*)
echo"Usage:bbc{start|stop|restart|reload|status}"
exit1
esac
exit0
#EndofBigBrotherstartupscript
Nowtomakeitstartautomatically
#lns/etc/init.d/bbc/etc/rc2.d/S99bbc
#lns/etc/init.d/bbc/etc/rc0.d/K01bbc
Maketheinitscriptexecutable
#chmodu+x/etc/init.d/bbc
Starttheclient
Eitherasroot
#/etc/init.d/bbcstart
Orbecomebbuser
#subbuser
$./runbb.shstart
Checkforerrors.
Checkthefile/usr/local/bbc/BBOUTforerrors
Ifeverythingisworking,youshouldseeresultsontheBBDISPLAYserversoon.

6.

Tips

Ifyouremove/disableatestthathadbeenworking,youneedtoremovethecorresponding
filefromthelogsdir.Ifyoudon't,thetestwillturnpurple,indicatingnoreport.
e.g.Stopthetestthatwasrunningonaservercalledsolaris1.mydomain.com.Thetest
waslookingforprocesses,whichshowsuponthedisplayserverunderacolumntitleof"ps"
OntheBBDISPLAYserver
$cd/usr/local/bb/bin
$./bbrmsolaris1.mydomain.comps
NextrefreshontheBBDISPLAYservershouldchangefrompurpletoa""

BigBrotherDocumentation
Forcompletedocumentationonyourcurrentversionclickonthe"i"inacircledisplayedon
everyBigBrotherpage.

HowtoAcknowledgingalerts
Subject: Re:!BB1554311!solaris1.mydomain.com.disk100010053108013

ThecodeinthesubjectlinecanbeusedtoAcknowledgethealert.Forthis
particularemailitis"1554311".
Tostopfurtheralerts,enterthatcodeonthebbpagewithalightningrod.Specify
howmanyminutes"grace"youwant.
Thiscodeisuniqueforeachalert,andperson.Tostopthealertsforeveryone
changethelast2numbersto99.eg"1554399"

SMSsetupforbigbrother(onSolaris)

Downloadthesmsclientfromhttp://www.styx.demon.co.uk
(Thisguideisforversionsms_client2.0.8y)
Uncompresstheclient
e.g.
#gunzip./sms_client2.0.8y.tar.gz
Untarthesms_client
e.g.
#tarxvf./sms_client2.0.8y.tar
ReadtheREADME
Install:
servername#shconfigure
servername#make;makeinstall
IfyouareintheUKyouneedtoupdatethephonenumbersused:
#cd/etc/sms/services
#vivodafone
changethenumberto:07785499999
#vivodafone_tap
changethenumberto:07785499993
#vicellnet
changethenumberto:07860980480
#viorange
changethenumberto:07973100602
#vione2one
changethenumberto:07956201072

Addentriestoyourphonebook
#cd/etc/sms
#visms_addressbook
Belowthelinethatsays

User4="vodafone:12344"
Addyouownentries
e.g.myname="orange:07912345678"
Configurethemodem
#vi/etc/sms/sms_modem
Uncommentthelinethatsays:
#MDM_device="cua/a"#SOLARIS
e.g.
MDM_device="cua/a"#SOLARIS
Checkthedir/var/lockexists,ifnotcreateit
#mkdir/var/lock
========
(Thefollowingdialoutsectionwastakenfromwww.kempston.net/solaris/dialup.html)

ConfiguringSolarisforhighspeeddialout
Pleasenotethatyoumustbeloggedinasrootwhileimplementingtheseinstructions.
TheseinstructionsdescribehowtoconfigureSolarisandyourmodemfordialouttoa
remotecomputer.Implementtheseinstructionsfirst,evenifyouwantto
configureyoursystemfordialinaccess.
1.Configureyourserialportfordialout
StartadmintoolunderCDE:
#admintool&
SelecttheBrowsemenuandthenSerialPortsfromthedropdownlist.Clickontheline
startingaifyourmodemisattachedtothefirstserialportorontheline
startingbifyourmodemisconnectedtothesecondserialport.SelecttheEditmenuand
thenModifyfromthedropdownlist.
Changethefollowingfields:

Template:ModemDialoutOnly
BaudRate:9600
CickonOKandcloseadmintool.

2.Testcommunicationwiththemodem
Theunixcommand"tip"isusedtocommunicatewithamodem.Ifyou'reinterestedinthe
gorydetail,themanualpageforthiscommandcanbedisplayedbytyping:
#mantip
Ifyourmodemisattachedtothefirstserialport:
#tip/dev/cua/a
Ifyourmodemisattachedtothesecondserialport:
#tip/dev/cua/b
andthecommandshouldrespond:
connected
Ifitresponds:
Allportsbusy
Itmeanseitherthatyourserialportisconfiguredincorrectly,perhapsfordialininsteadof
dialout,orthatthereisamorefundamentalproblemincommunicatingwith
theport.Inthiscase,havealookatCelesteStokely'sTutorialonSolaris2.xModems&
Terminalswhichcontainsawealthofusefulinformationaboutmodems.
Type:
ATZ
andthemodemshouldrespond:

OK
Ifthere'snoresponsefromthemodem,checkthatyou'reusingastraightthroughcablewith
pin2atoneendconnectedtopin2attheotherend,pin3topin3and
soon.A"nullmodem"orcrossovercable,designedforusewithaterminal,willnotwork.
Type:
ATI4
Mostmodemsrespondtothiscommandbyreportingtheircurrentsettings.Ifthisdoesn't
work,tryAT&v,ATL5,ATL6,ATL7orAT*c.Ifallelsefails,consult
yourmodemmanual.Whenusinga3COMUSRV90modem,itresponds:
U.S.Robotics56KMessageSettings...
B0E1F1L2M1Q0V1X4Y0
SPEED=300PARITY=NWORDLEN=8
DIAL=TONEOFFLINE
&A1&B1&C1&D2&H1&I0&K1
&M4&N0&P0&R2&S0&T5&U0&Y1
...
NotethattheactualspeedatwhichSolarisiscommunicatingwiththemodemisonly300
baud,or30characterspersecond,despitethespeedhavingbeensetusing
admintooltobe9600.Thereasonforthisisthattipdefaultstoaspeedof300baudandwe'll
fixthisinthenextstep.
Closetipbytyping"ENTERkey,tilde,fullstop"asthreekeystrokes:
~.

3.SetthemodemDTEspeed
Editthefile/etc/remoteandinsertalineatthestartofthisfilereading:
modem:dv=/dev/cua/a:br#115200

Ifyourmodemisattachedtothefirstserialport,or:
modem:dv=/dev/cua/b:br#115200
Ifyourmodemisattachedtothesecondserialport.
Thisenablesustocommunicatewiththemodemataspeedof115200bitspersecond.It's
importanttounderstandthattherearetwospeedstobeconsideredin
modemcommunication.There'sthespeedatwhichthehostcomputertalkstoaconnected
modemandthisisknownastheDataTerminalEquipmentorDTE
speed.There'salsothespeedatwhichthemodemtransmitsandreceivesdataacrossthe
telephonelineandthisisknownastheDataCommunicationEquipmentor
DCEspeed.A56KorV90modemiscapableofaDCEspeedofupto56K,althoughthisis
unlikelytobeachievedinpractice.Datasentdownatelephone
connectionisoftencompressedwiththereceivingmodemuncompressingthedatabefore
sendingittothehostcomputer.Soamodemtomodemspeed(DCE)of
56Kcouldresultinamodemtocomputerspeed(DTE)wellinexcessof56K.Forthis
reason,theDTEspeedshouldbesetatleast50%higherthanthemaximum
DCEspeedandaDTEspeedof115200isrecommendedforusewith56Kmodems.
However,notallSunhardwareiscapableoftalkingtoaserialportatthisspeed.Ifyouhave
aSunUltra5orbetter,oranIntelP90orbetter,yoursystemshould
beabletosustainaDTEspeedof115200.IfyouhaveanolderSunsystem,youmaywell
notbeabletodriveaV90modematitsmaximumspeedandwillneedto
experimenttofindthehighestDTEspeedthatyourhardwaresupports.If115200doesn't
work,tryspecifying38400,19200or9600inthelinein/etc/remote.

4.Testhighspeedcommunicationwiththemodem
Trythetiptestagain,thistimespecifyingthenameofthenewentryin/etc/remoteasa
parametertotipandyoushouldberewardedwithahighspeedconnectionto
themodem:
#tipmodem
connected
ATI4
U.S.Robotics56KMessageSettings...
B0E1F1L2M1Q0V1X4Y0

SPEED=115200PARITY=NWORDLEN=8
DIAL=TONEOFFLINE
&A1&B1&C1&D2&H1&I0&K1
&M4&N0&P0&R2&S0&T5&U0&Y1
...
CheckthattheoutputfromATI4reportstheDTEspeedcorrectlyas115200orwhatever
you'vesetthisto.
Whileconnectedtothemodem,checkthatthefollowingmodemsettingsarecorrect:
&B1Fixedserialportrate
&C1NormalCarrierDetect(CD)operation
&D2NormalDTRoperations
&H1HardwareflowcontrolusingClearToSend(CTS)
&N0Connection(DCE)speeddeterminedbynegotiation
withtheremotemodemtothehighestusablespeed
&R2ReceiveddatatocomputeronlyonRTS
Tochangeoneofthe'&'modemregistersettings,typeATfollowedbytheregistername
andrequiredvalue.Forexample,tochangethevalueofregister&Bto1,
type:
AT&B1
Whenallthechangeshavebeenmade,savethecurrentsettingstothemodem'snonvolatile
RAMbytyping:
AT&W
Dothisevenifnoregistervalueshavebeenchangedbecausesavingthecurrentvalueswill
savethecurrentportspeedassetbytip.
Finally,exitfromtipbytyping"ENTERkey,tilde,fullstop"asthreekeystrokes:
~.

5.Checkpermissionsandownershipofthedevicefiles
Thepermissionsandownershipoftheserialportdevicefilesmaywellbeincorrect.Check
them,forthefirstserialport,bytyping"lsl/dev/cua/a"toseedetailsof
thatfile(whichisasymboliclinktotheunderlyingdevicefile)andbytyping"lslL/
dev/cua/a"toseedetailsoftheunderlyingdevicefile.Replace"/dev/cua/a"with
"/dev/cua/b"forthesecondserialport.Ifpermissionsandownershiparecorrect,theoutput
shouldbelike:
#lsl/dev/cua/b
lrwxrwxrwx1rootroot32Jun2722:14/dev/cua/b>../../
devices/isa/asy@1,2f8:b,cu
#lslL/dev/cua/b
crw1uucptty106,131073Dec1317:16/dev/cua/b
Inthisexample,thepermissionsoftheunderlyingdevicefilearerw,theownerisuucp
andthegroupistty.Ignoretheremainingfieldsontheoutputwhich
varyfromonesystemtoanother.Ifyourdevicefilesdon'thavethesepermissionsand
ownerships,changethembytyping:
Forthesymboliclink/dev/cua/b:
#chmod777/dev/cua/b
#chownhroot/dev/cua/b
#chgrphroot/dev/cua/b
Fortheunderlyingdevicefile:
#chmodR600/dev/cua/b
#chownuucp/dev/cua/b
#chgrptty/dev/cua/b
ConfigurationofSolarisforhighspeeddialoutcapabilityisnowcomplete.

6.Dialaremotesystem
Ifyouhavearemotesystemthatacceptsincomingmodemterminalconnections,the
procedureforconnectingtoaremotesystemisasfollows:

First,connecttothemodemasbefore:
#tipmodem
connected
ThentellthemodemtodialtheremotesystembytypingATDTfollowedbythetelephone
numberofthemodemattachedtotheremotesystem.Forexample,todial
outtotelephonenumber1234567,type:
ATDT1234567
Youshouldhearthelocalmodemdialling,followedbyaudiotoneswhileitnegotiatesa
connection(DCE)speedwiththeremotemodem.Finally,theCONNECT
stringfromthelocalmodemshouldappear,followedbythegreetingandloginpromptfrom
theremotecomputer:
CONNECT45333/ARQ/V90/LAPM/V42BIS
WelcometoKempstonNetworks
login:
NotethataV90connectionwillbeachievedonlyiftheremotesystemisrunningadigital
terminalserver,suchasthoseusedbyISPs.WhenthereareV90modems
atbothendsofthelink,thebestspeedachievableis33.6Kbitspersecond.Inthiscase,you
mayseeaCONNECTstringlike:
CONNECT31200/ARQ/V34/LAPM/V42BIS
WelcometoKempstonNetworks
login:
NotallmodemsoutputtheCONNECTstring.Ifyoudon'tseetheloginpromptwithina
coupleofsecondsoftheconnectionbeingestablished,presstheENTER
keyonce.Thisshouldtriggeraloginpromptfromtheremotecomputer.
(endofsectiontakenfromhttp://www.kempston.net/solaris/dialup.html)
==============

ConfigureBigBrothertosendSMSmessages
Editthefile$BBHOME/etc/bbwarnrules.cfg

Addanewrulecalledsmsclient<sms_person>:<standardBBrules>
Eg.
*;*;*;;15;08001900;smsclientcraig:~15:60

GNUtarInstallation
Downloadfromhttp://www.gnu.org/software/tar/tar.html
#gunzipctar1.15.1.tar.gz|tarxf
#cdtar1.15.1
#./configure
#make
#makeinstall

PerlInstallation
DownloadthecurrentstablereleaseofPerl
http://www.cpan.org/src/stable.tar.gz
ThisdocumentassumesyouareinstallingPerl5.8.6
#gunzipcstable.tar.gz|tarxf
#cdperl5.8.6
Typethefollowing:
#shConfigureDcc=gcc
Acceptmostofthedefaults,withsomespecificchanges:
Whichoftheseapply,ifany?[solaris_2]
Operatingsystemname?[solaris]
Operatingsystemversion?[2.9](or2.7,2.8,2.9...)
BuildPerlforSOCKS?[n]
UsethePerlIOabstractionlayer?[y]
BuildathreadingPerl?[n]
BuildPerlformultiplicity?[n]

UsewhichCcompiler?[gcc]
Directoriestouseforlibrarysearches?
[/usr/local/lib/usr/lib/usr/ccs/lib]
Whatisthefileextensionusedforsharedlibraries?[so]
Trytouselongdoublesifavailable?[n]
Whatlibrariestouse?[lsocketlnslldllmlc]
Whatoptimizer/debuggerflagshouldbeused?[O]
Anyadditionalccflags?[fnostrictaliasingI/usr/local/include]
Anyadditionalccflags?[fnostrictaliasingpipeI/usr/local/include]
Anyadditionalldflags(NOTincludinglibraries)?[L/usr/local/lib]
Trytouse64bitintegers,ifavailable?[y](unlessyou'reusing32bitSolaris)
Trytousemaximal64bitsupport,ifavailable?[n]
Whatisyourarchitecturename[sun4solaris64int]
Installationprefixtouse?(~nameok)[/usr/local/]
WhatinstallationprefixshouldIuseforinstallingfiles?(~nameok)
[/usr/local/]
Pathnamewheretheprivatelibraryfileswillreside?(~nameok)
[/usr/local/lib/perl5/5.8.6]
Wheredoyouwanttoputthepublicarchitecturedependentlibraries?(~nameok)
[/usr/local/lib/perl5/5.8.6/sun4solaris]
Doyouwishtowrapmalloccallstoprotectagainstpotentialoverflows?[y]
Doyouwishtoattempttousethemallocthatcomeswithperl5?[n]
Installationprefixtouseforaddonmodulesandutilities?(~nameok)
[/usr/local/]
Pathnameforthesitespecificlibraryfiles?(~nameok)
[/usr/local/lib/perl5/site_perl/5.8.6]
Pathnameforthesitespecificarchitecturedependentlibraryfiles?(~nameok)
[/usr/local/lib/perl5/site_perl/5.8.6/sun4solaris]
Doyouwanttoconfigurevendorspecificaddondirectories?[n]
Colonseparatedlistofadditionaldirectoriesforperltosearch?[nonePathnamewherethe
publicexecutableswillreside?(~nameok)
[/usr/local/bin]]
Installanyextramodules(yorn)?[n]
DirectoryforthemainPerl5htmlpages?(~nameok)
[/usr/local/doc/html/]
DirectoryforthePerl5modulehtmlpages?(~nameok)[none]
[/usr/local/doc/html/modules]
Listofearlierversionstoincludein@INC?[none]
Doyouwanttoinstallperlas/usr/bin/perl?[n]
ShallIuse/usr/local/bin/nmtoextractCsymbolsfromthelibraries?[n]

Doyouwishtousedynamicloading?[y]
Sourcefiletousefordynamicloading[ext/DynaLoader/dl_dlopen.xs]
Anyspecialflagstopassto/usr/local/bin/gccctocompilesharedlibrarymodules?
[fPIC]
Whatcommandshouldbeusedtocreatedynamiclibraries?
[gcc]
Anyspecialflagstopassto/usr/local/bin/gcctocreateadynamicallyloadedlibrary?
[GL/usr/local/lib]
Anyspecialflagstopassto/usr/local/bin/gcctousedynamiclinking?
[none]
Buildasharedlibperl.so(y/n)[n]
WheredothemainPerl5manualpages(source)go?(~nameok)
[/usr/local/man/man1]
WhatsuffixshouldbeusedforthemainPerl5manpages?[1]
Wheredotheperl5librarymanpages(source)go?(~nameok)
[/usr/local/man/man3]
Whatsuffixshouldbeusedfortheperl5librarymanpages?[3]
Yourhostnameappearstobe"bbserver".Right?[y]
Whatisyourdomainname?[.mydomain.com]
Whatisyouremailaddress?[something.else@bbserver.mydomain.com]
Perladministratoremailaddress[something.else@bbserver.mydomain.com]
Doyouwanttoinstallonlytheversionspecificpartsofperl?[n]
WhatshallIputafterthe#!tostartupperl("none"tonotuse#!)?
[/usr/local/bin/perl]
Wheredoyoukeeppubliclyexecutablescripts?(~nameok)
[/usr/local/bin]
Pathnamewheretheaddonpublicexecutablesshouldbeinstalled?(~nameok)
[/usr/local/bin]
Pathnamewherethesitespecifichtmlpagesshouldbeinstalled?(~nameok)
[/usr/local/doc/html]
Pathnamewherethesitespecificlibraryhtmlpagesshouldbeinstalled?(~name
ok)
[/usr/local/doc/html/modules]
Pathnamewherethesitespecificmanualpagesshouldbeinstalled?(~nameok)
[/usr/local/man/man1]
Pathnamewherethesitespecificlibrarymanualpagesshouldbeinstalled?(~nameok)
[/usr/local/man/man3]
Pathnamewhereaddonpublicexecutablescriptsshouldbeinstalled?(~nameok)
[/usr/local/bin]
Usethe"faststdio"ifavailable?[y]

Trytounderstandlargefiles,ifavailable?[n]
Whatistheextensionofdynamicallyloadedmodules[so]
ShallIignoregethostname()fromnowon?[n]
Whatisthesizeofacharacter(inbytes)?[1]
Doyoustillwanttousevfork()?[n]
Doublesmustbealignedonahowmanybyteboundary?[8]
Usewhichfunctiontogeneraterandomnumbers?[drand48]
Whattypepointeristhesecondargumenttogetgroups()andsetgroups()?
[gid_t]
Whatpagerisusedonyoursystem?[/usr/bin/more]
Whatisthetypeforsocketaddressstructuresizes?[int]
Whichcompilercompiler(yacc)shallIuse?[yacc]
Whatextensionsdoyouwishtoloaddynamically?[blah..blah..blah](usethedefault)
Whatextensionsdoyouwishtoloadstatically?[none]
Pressreturnoruseashellescapetoeditconfig.sh:
Runmakedependnow?[y]
Whenitisfinished,do:
grepcppsymbolsconfig.sh
andmakesure"D_LARGEFILE_SOURCED_FILE_OFFSET_BITS=64"doesNOT
appear.
_LARGEFILE_SOURCE=1isokay,ensureitdoesnothavetheDonthefrontifit.
_FILE_OFFSET_BITS=64isokay,ensureitdoesnothavetheDonthefrontifit.
Thendo:
mvmakefileold.makefile
make
maketest(ignoreerrors)
makeinstall

RRDInstallation

WhyuseRRD?
FasterthanMRTGsdefaultgraphingmethod.
RRDtoolisusedwithLARRDandMRTG.OthertoolsuseRRDaswell.
Downloadfromhttp://www.mrtg.org
#mvrrdtool1.0.49.tar.gz/usr/local
#cd/usr/local
#gunziprrdtool1.0.49.tar.gz
#tarxvfrrdtool1.0.49.tar
#cdrrdtool1.0.49
#./configure
#make
#makeinstall
#makesiteperlinstall
#lns/usr/local/rrdtool1.0.49/usr/local/rrdtool

LARRDInstallation
WhyuseLARRD?
LARRDisaperformancegraphingtoolusedwithBB.Willshowyougraphsoftrendsof
selectedtests.
EnsuretheRRDtoolhasalreadybeeninstalled.
Downloadlarrd0.43cfromhttp://ww.deadcat.net
Copyto/usr/localonyourbigbrotherdisplayserver.
Untarthefile:
#tarxvf./larrd0.43c.tar
Createasoftlink
#lns/usr/local/larrd0.43c/usr/local/larrd

#chownRbbuser:bbgrouplarrd

ThefollowinginstructionsarefromtheINSTALLfile
larrdINSTALL

1)untarlarrd$VER.tarin/usr/local(orthedirectoryoflocalsoftware
installs),butyou'vealreadydonethisifyouarereadingthisfile.
Ifyoudon'tchoose/usr/local/,yourlifewillbemoredifficult.
Beginningwitheditinglarrd.plandchangingwherelarrdlives.
2)cdintothedirectorythatwascreated.
Type'perlinstallbbhome/path/to/BBHOMElarrdhome/path/to/LARRDHOME'
3)link/usr/local/larrdto/usr/local/larrd$VER.
e.g.#cd/usr/local
#lns./larrd0.43c./larrd
4)link$BBHOME/ext/larrdto/usr/local/larrd.
e.g.#lns/usr/local/larrd/usr/local/bb/ext/larrd
5)larrdgrapher.cgiandlarrdgraphs.cgi($LARRDHOME/cgi/*)will
becopiedtothecgibindirectoryforyourwebserver.
e.g./usr/local/apache2/cgibin
Besuretoproperlysetownershipandpermissionssothewebserver
canexecuteit.Ifyouhavenotinstalledlarrdin/usr/local/larrd,
youwillneedtoeditlarrdgrapher.cgiandchangethelarrdinstallation
directory.
OurTIP:afterlarrdgrapher.cgiiscopiedtothecgibindiryoumaywanttodeletethe
versioninthe/usr/local/larrddirectory.Itcanbeconfusinglaterifyouwanteditthecgi
scriptandfinditinthelarrddirectoryfirst.Iwouldsuggestmakingalinkfromthecgibin
dirscripttothelarrddirectory.
e.g.lns/usr/local/apache2/cgibin/larrdgrapher.cgi/usr/local/larrd/cgi/larrdgrapher.cgi
Editlarrdgraphs.cgitocheckorsettheseitems:
Checkthepathtoperlonthefirstline(magicline).

MakesurethepathstoBBHOMEandLARRDHOMEmatchyourinstallation.
Checkthelistofvmstatlarrdgraphsforyourplatform
Checkthelistofnetstatlarrdgraphsforyourplatform
Checkthelistofdisklarrdgraphsforyourplatform
Applypatchfilebbrep.html.patchtobbrep.htmlfileonyourBBDISPLAY
hosttoaddahyperlinktothelarrdgraphs.cgitothereportsmenu.
6)add"larrd/larrd.pl"tobbbbexttabin$BHOME/etc
IfyouuseBBConfig:
e.g.#vibbconfig
findtheBBDISPLAYserverandaddalinesimilartothis(ifitnotalreadythere)
ext_add:larrd/larrd.pl
Regeneratethebbconfigurationfiles
#/usr/local/BBConfig/bin/bbconfigure
7) edit/usr/local/larrd/larrdconfig.pl
8)Changepermissionsonthelarrddir
#chownRbbuser:bbgroup/usr/local/larrd0.43c
9)changepermissionson$LARRDHOME/tmpsoyourwebservercanwritetoit
e.g.#chgrpapache/usr/local/larrd/tmp
#chmod775/usr/local/larrd/tmp
10)RestartBB.
11)OnceyourBBDIPSPLAYisrebuilt,youshouldnowseeatrendscolumn.
itmaytakeafewiterationstoproperlymakealltheHTML
andgraphs.

IfnothingdisplayschecktheLARRDOUTfilein$BBHOMEforerrors.

ToactivateLARRDtrendingonaBigBrotherClient
Copytheindividualbottomfeederscriptsto$BBHOME/ext
WhereBBHOMEisthedirectoryforthebbclientcode/usr/local/bbc
e.g.
#cp/usr/local/larrd/bf/vmstatbf.sh$BBHOME/ext/.
#cp/usr/local/larrd/bf/netstatbf.sh$BBHOME/ext/.
Note:ThisisdifferenttowhatINSTALL.clientsrecommends.Thisallowsgreatercontrol
overwhichbottomfeederscriptsarerunoneachclient.i.e.addthescriptstobbbbexttab,
ratherthaneditingbflarrd.shoneveryclient.
Addsomethinglikethistobbconfigforthatserver
host:bbclient.mydomain.com
ip:10.0.0.2
ext:vmstatbf.plnetstatbf.pl
Regeneratebb*tabfiles
#/usr/local/BBConfig/bin/bbconfigure
Transferthenewclientcodetotheclient
Restartclient.
After10+minutestrendsshouldappearonyourBBDISPLAYserver.

MRTGinstallation
WhyuseMRTG?
Graphnetworkinformatione.g.checkbandwidthofservers.BBhasanextensionthatwill
monitorMRTGgraphstoensurethresholdsarenotexceeded.e.g.iftheinputtoaserver
exceeds80%youcansetanalarm.Iftheinputdropsbelow10%youcanalsosetanalarm.
etc,etc.
EnsureRRDtoolhasalreadybeeninstalled.

EnsurePerlhasbeeninstalled
ReviewtheInstallguideforunix:
http://people.ee.ethz.ch/~oetiker/webtools/mrtg/unixguide.html
Installzlibfirst
Downloadfromhttp://www.gzip.org/zlib/
#gunzipczlib1.2.1.tar.gz|tarxf
#cdzlib1.2.1
#./configure
#make
#makeinstall
Installjpeglibraries
Downloadfromftp://ftp.uu.net/graphics/jpeg/
Getthefilejpegsrc.v6b.tar.gz
Oncetransferredtoyourbigbrotherserveruncompress
#gunzipcjpegsrc.v6b.tar.gz|tarxf
#cdjpeg6b
#./configure
#make
#makeinstall
#makeinstalllib
Installinglibpng
Downloadfromhttp://www.libpng.org/
Getthefilelibpng1.2.8.tar.gz
Oncetransferredtoyourbigbrotherserveruncompress
#gunzipclibpng1.2.8.tar.gz|tarxf
#cdlibpng1.2.8
#cpscripts/makefile.solarismakefile
#make

#makeinstall
InstallingGD
Downloadfromhttp://www.boutell.com/gd/http/
Getthefilegd2.0.33.tar.gz
Oncetransferredtoyourbigbrotherserveruncompress
#gunzipcgd2.0.33.tar.gz|tarxf
#cdgd2.0.33
#./configuredisableshared
#make
#makeinstall
InstallMRTG
Downloadfromhttp://ww.mrtg.org
Oncetransferredtoyourbigbrotherserveruncompress
#gunzipcmrtg2.11.1.tar.gz|tarxf
#cdmrtg2.11.1
#./configure
#make
#makeinstall
#lns/usr/local/mrtg2/usr/local/mrtg
#cprdoc/usr/local/mrtg
#mkdir/usr/local/mrtg/wor
#chownapache/usr/local/mrtg/work
#mkdir/usr/local/mrtg/cfg
#cp/usr/local/mrtg/bin/cfgmaker/usr/local/mrtg/cfg/cfgmaker
#cd/usr/local/mrtg/cfg
Createthemrtg.cfgfile
#vimrtg.cfg
###GlobalDefaults

#togetbitsinsteadofbytesandgraphsgrowingtothe
right

#Options[_]:growright,bits
EnableIPv6:no

WorkDir:/usr/local/mrtg/work
Options[_]:bits,growright
LogFormat:rrdtool

PathAdd:/usr/local/rrdtool/bin/

LibAdd:/usr/local/rrdtool/lib/perl/
#addnewfileshere
#ensurethefilenamematchesthehostnamebigbrother
uses

#e.g.

#Include:/usr/local/mrtg/cfg/bbclient.mydomain.com.cfg
#Include:/usr/local/mrtg/cfg/cisco1.mydomain.com.cfg

EnsurealladjustmentshavebeenmadetouseRRD
http://people.ee.ethz.ch/~oetiker/webtools/mrtg/mrtgrrd.html

Configurebbmrtg.pl
Whyusebbmrtg.pl?
ThispluginmonitorsyourMRTGgraphs.Highlycustomisablethresholdscanbeset.
e.g.iftheinputtoaserverexceeds80%youcansetanalarm.Iftheinputdropsbelow10%
youcanalsosetanalarm.etc,etc.
Downloadbbmrtg1.6.tar.gzfromhttp://ww.deadcat.net
#gunzipcbbmrtg1.6.tar.gz|tarxf
#cdbbmrtg1.6
#cpbbmrtg.template/usr/local/mrtg/cfg
#cpbbmrtg1.6.pl/usr/local/bbc/ext/
#cd/usr/local/bbc/ext
#mvbbmrtg1.6.plbbmrtg.pl
Editthefile
#vibbmrtg.pl

Changethefirstlinetoyourperlbinaryifneeded
Changethislinefrom:
my$mrtgCfg='/var/mrtg/cfg/bbmrtg.cfg';#aka'~mrtg/mtrg.cfg'
to
my$mrtgCfg='/usr/local/mrtg/cfg/mrtg.cfg';#aka'~mrtg/mtrg.cfg'
Uncommentthisline:
#uselib'/usr/local/rrdtool/lib/perl';
AddthislinetoyourbbconfigfileforyourBBDIPSPLAYserver
ext_add:bbmrtg.pl
e.g.
host:
ip:
template:
template:
bbservices:
bbset:
procpanic:
ext_add:

bbserver.mydomain.com
0.0.0.0
solaris
veritas
BBDISPLAY BBNET BBPAGER
UnixServers
/usr/local/apache2/bin/httpd;<=2
larrd/larrd.pl bf-larrd.sh bbmrtg.pl

Regeneratebb*tabfiles
# /usr/local/BBConfig/bin/bbconfigure
Configuremrtgrrd.cgi
Whyusemrtgrrd.cgil?
mrtdrrd.cgiisascriptthatallowsyoutoseeallyourMRTGgraphsononepage.Itisused
bybbmrtg.pl.
Downloadthemrtgrrdcgifromhttp://www.mrtg.org
#gunzipcmrtgrrd0.7.tar.gz|tarxf
#cdmrtgrrd0.7
Editmrtgrrd.cgi
Directlyafterthissection:
}elsif(/^([\w\d]+)*:*(\S.*)$/){
my($opt,$val)=(lc($1),$2);

$cfgref>{$opt}=$val;
next;
Add:
}elsif(/^bb\*.*/){
next;
Changethislinetomatchthelocationofthemrtg.cfgfileonyoursystem
BEGIN{@config_files=qw(/home/fadmin/mrtg/cfg/mrtg.cfg);}
e.g.
BEGIN{@config_files=qw(/usr/local/mrtg/cfg/mrtg.cfg);}
Changethislinefrom:
}elsif(/^Include\s*:\s*(\S*)$/){
To:
}elsif(/^Include\s*:\s*(\S*)$/i){
Copytothewebservercgibindir
#cpmrtgrrd.cgi/usr/local/apache2/cgibin/

Addadeviceformrtgtomonitor
#cd/usr/local/mrtg/cfg
e.g.
#./cfgmakeriftemplate=bbmrtg.templatecommunity@bbclient.mydomain.comoutput
bbclient.mydomain.com.cfg
Thiswillcreateafilecalledbbclient.mydomain.com.cfginthe/usr/local/mrtg/cfgdirectory
Editthemrtg.cfgfiletoincludethisfile
e.g.
#vimrtg.cfg
Addthistotheendofthefile:
Include:/usr/local/mrtg/cfg/bbclient.mydomain.com.cfg
ConfigureMRTGtorunfromcron.
#crontabe

Addalinelikethis(allononeline):
0,5,10,15,20,25,30,35,40,45,50,55****/usr/local/mrtg/bin/mrtg/
usr/local/mrtg/cfg/mrtg.cfglogging/var/adm/mrtg.log

BigBrother.pmInstallation
WhyuseBigBrother.pm?
Thisisaperlmoduleusedwithsomeperlextensionscriptsondeadcat.Youwillbeusing
perlscriptsthatneedit.
Downloadfromhttp://www.deadcat.net
#gunzipBigBrother.pm.gz
#mkdir/usr/local/bbc/ext/perl
#cpBigBrother.pm/usr/local/bbc/ext/perl

FPINGInstallation
WhyuseFPING?
Itisfasterthanstandardping.Pingsaredoneinparalleltomanyservers.Canbesetto
limitnumberofpingsperpingstorm.e.g.pingallserversingroupsof10atatime.
InstalltheFPINGbinary
Downloadfromhttp://www.fping.com/
#tarxvffping.tar
#cdfping2.4b2_to
#./configure
#make
#chmodu+xinstallsh
#makeinstall
Changepermissionsonthefpingbinarytoallowanyusertoexecuteit.
e.g.#chmodu+s/usr/local/sbin/fping

Note:thisisasecurityrisk.Anotheroptionistoinstallandusesudo

Installfping.pl
Note:ThisscriptneedsDate::Manipfromhttp://search.cpan.organd
BigBrother.pmfromhttp://www.deadcat.net
Ensuretheyhavebothbeeninstalled
Downloadfromhttp://www.deadcat.net
#gunzipcfping.pl.tar.gz|tarxf
#cpfping.pl/usr/local/bbc/ext
#vi/usr/local/bbc/ext/fping.pl
Changethislinefrom
$fping_command="sudofping";
To
$fping_command="/usr/local/sbin/fping";
Addfping.pltobbconfigfortheBBNETserver
e.g.
host:bbserver.mydomain.com
ext_add:fping.pl
Regeneratebb*tabfiles
#/usr/local/BBConfig/bin/bbconfigure
DisableBigBrotherserverfromperformingpings
Edit/usr/local/bb/etc/bbdefserver.shtostopBBitselffromdoinganypingtests
change
CONNTEST=TRUE
To
CONNTEST=FALSE

ConfigureSNMPintegration
WhyuseSNMP?
CanbeusedtomonitoranySNMPdevice.Testsareavailableforcisco,netapp,lotusnotes,
nokia,cacheflow,etc
Installopenssl(ifnotalreadyinstalled)
Downloadfromhttp://ww.openssl.com
Note:Solaris9andabovecontain/dev/random.IfyouareinstallingOpenSSLonanearlier
versionyouwillneedtoinstallapatch.
IfyouareusingSolaris8,youcanadd/dev/urandomand/dev/randomdevicesbyinstalling
patch112438(Sparc)or112439(x86),whichareavailableviathePatchfinderat
http://sunsolve.sun.com(Solaris9includesthesedevicesbydefault).For/dev/random
supportforearlierSolarisversions,seeSun'sstatementathttp://sunsolve.sun.com/pub
cgi/retrieve.pl?doc=fsrdb/27606&zone_32=SUNWski(theSUNWskipackageisavailablein
patch105710).*
*http://www.openssl.org/support/faq.html#USER1
Note:openssl0.9.7e.tar.gzisactuallybrokenonSolaris.
Youmayneedastablesnapshotfromhere:
ftp://ftp.openssl.org/snapshot/
#gunzipcopenssl0.9.7e.tar.gz|tarxf
#cdopenssl0.9.7e
#./config
#make
#maketest
#makeinstall
EnsureSNMPisnotcurrentlyrunning

ThefollowingsectionhasbeentakenfromtheNetSNMPinstallguide.

DetermineexistingSNMPfunctionality

SNMPusesports161and162bydefault.Onlyoneapplicationcanusethematatime.If
thereisanexistingSNMPapplication(eg.Sun'ssnmpdxdaemon)youneedtoeitherturn
thisofforworkaroundit.Youmayalsohaveapreviousversionofnetsnmp,theolder
ucdsnmp,orsomethingcompletelydifferent.Thefollowingcommands:
psef|grepsnm|grepvgrep
psef|grepmibi|grepvgrep
Ifyouseesomethinglike:
root64310Jan16?5:49/usr/local/sbin/snmpd
Youprobablyhaveanoldversionofnetsnmprunning
Ifyouseesomethinglike:
root184410Jan14?0:00/usr/lib/snmp/snmpdxyc/etc/snmp/conf
root188210Jan14?0:00/usr/lib/dmi/snmpXdmidsbbserver.mydomain.com
and/or
root185118440Jan14?1:27mibiisarp32790
thenSun'sSNMPdaemonsarerunning.
Outofthebox,SunrunsfourSNMPdaemons;mibiisa,idmispd,xnmpXdmidandsnmpdx.
Thesemustbedisabledbeforerunningnetsnmp.Hereistheprocedure:
#cd/etc/rc3.d
#./S76snmpdxstop
#./S77dmistop
#mvS76snmpdxs76snmpdx
#mvS77dmis77dmi
IfyouareusingSolsticeDisksuite,youmayalsoberunningmdlogd.Leavethisalone.

NETSNMPInstallation

Downloadfromhttp://netsnmp.sourceforge.net/
Note:youmustusegnutartoextractthis
#gunzipcnetsnmp5.2.tar.gz|/usr/local/bin/tarxf
#cdnetsnmp5.2
#./configureenablesharedenableembeddedperl\
withpersistentdirectory=/var/netsnmpwithlogfile=/var/log/snmpd.log\
withdefaultsnmpversion=3withgnulddisabledeveloper
#make
Ifyougetafatalerrorlikethiswhileexecutingmake:
/usr/include/sys/swap.h:47:2:#error"Cannotuseswapctlinthelargefilescompilation
environment"
...youwillneedtoreinstallPerl,usingtheinstructionslocatedearlierinthisguide.
Ifyoudonotgetanyfatalerrormessages,runthis:
#makeinstall
InstalltheNETSNMPPerlModules
#cdperl
#perlMakefile.PL
#make
#maketest
#makeinstall(asroot)
TestaSNMPdevice
Trysomethingsimilartothis:
#snmpgetv1cpublicciscorouter1.mydomain.comsysDescr.0
WherepublicisthereadonlycommunitystringforyourSNMPdevice.
InstalltheCPANPerlModules
DownloadtheNet::SNMPpackagefromhttp://search.cpan.org
#gunzipcNetSNMP5.0.1.tar.gz|tarxf

#cdNetSNMP5.0.1
#perlMakefile.PL
Youmaygetthiswarning:
Warning:prerequisiteCrypt::DES2.03notfound.
Warning:prerequisiteDigest::HMAC1.00notfound.
Warning:prerequisiteDigest::SHA11.02notfound.
Youcaneitherinstallthosemodulesaswell,orcontinuewithoutthem.
Forourinstall,wedonotneedthem,sowecontinue...
#make
#makeinstall

Installbbxsnmp
Downloadthebbxsnmppackagefromhttp://ww.deadcat.net
CopythetarfiletoyourBBHOME/extdir
e.g.
#cp./bbxsnmp1.77.tar.gz/usr/local/bbc/ext
#cd/usr/local/bbc/ext
#gunzipcbbxsnmp1.77.tar.gz|tarxf
#cpbbxsnmp1.77/bbxsnmp.pl.
#cpbbxsnmp1.77/bbxsnmptab.DIST../etc/bbxsnmptab
AddanentrylikethistoyourbbconfigfileforyourBBDISPLAYserver
ext_add:bbxsnmp.pl
e.g.
host:bbserver.mydomain.com
ip:10.0.0.1
ext_add:bbxsnmp.pl
Regeneratebb*tabfiles
#/usr/local/BBConfig/bin/bbconfigure
Edit/usr/local/bbc/etc/bbxsnmptab

AddalinelikethisforeachSNMPdeviceyouwouldliketomonitor
cisco1.mydomain.com:public:cpu
RestarttheBigBrotherclient
$/usr/local/bbc/runbb.shrestart
Ifyoufinderrorsofhavecommentsaboutthisdocumentpleasecontactusat
http://www.cookitservices.com