BigSister 1 / 111 BigSister Configuring and installing BigSister BigSister 2 / 111 COLLABORATORS TITLE : REFERENCE : BigSister ACTION NAME DATE SIGNATURE WRITTEN BY Thomas Aeby, Didier October 28, 2009 Bringer, Joerg Fritsch, and Alexander Kerr REVISION HISTORY NUMBER DATE DESCRIPTION NAME 1.0 11 December 2000 Initial release. tom 1.01 March 2002 Docbook format dda 1.01 March 2002 When describing commands, I tried to write dda arguments like in any Programmation Book ie command { mandatory args } [ optional arguments ] Skins for CGI 1.5 August 2003 Done further work on the Docbook format. jf Introduced Big Sister logo. Introduced html chunks. Rewritten some parts in order to get them taylored to Big Sister rev. 0.98b3 and give the reader a better understanding. 1.5.1 August 2003 Corrected english wording, grammar and style ak 1.9 November 2005 Did some major improvements to reflect the ta current status of the project BigSister 3 / 111 Contents 1 License - The GNU General Public License1 1.1 Preamble . .1 1.2 TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION . .1 2 Installation 5 2.1 Prerequisites . .5 2.2 Big Sister Components . .5 2.3 Installing Big Sister . .7 2.3.1 Paths to files . .7 2.3.2 Installation from sources . .7 2.3.3 Installing Big Sister from the RPM-packages . .9 2.3.3.1 Fresh install . .9 2.3.3.2 Upgrading from previous versions . .9 2.3.4 Installing Big Sister on Debian . 10 2.3.4.1 Download vs. APT . 10 2.3.5 Installing Windows binary . 10 2.4 Post-installation tasks . 10 2.4.1 Configuring your webserver (Big Sister server only) . 10 2.4.2 Installing Perl modules . 11 2.4.3 Installing RRDTool . 11 2.5 Install Big Sister plugins . 12 3 Agent Configuration 13 3.1 First steps . 13 3.2 How to start the daemons at boot time . 13 3.3 Adding new hosts and services . 14 3.3.1 The uxmon-net file . 14 3.3.1.1 Multiple uxmon-net configuration files . 15 3.3.1.2 The uxmon-asroot configuration file(s) . 15 3.3.2 Network objects with simple names . 15 3.3.3 Network objects with alias names . 15 BigSister 4 / 111 3.3.4 Health checks . 16 3.3.4.1 Defining the scope of monitored systems: DESCR . 16 3.3.4.2 Common syntax . 17 3.3.4.3 Pointing the agent to your server . 17 3.3.4.4 Check frequencies . 18 3.3.4.5 Defaults . 19 3.3.5 Using self contained healthcheks: testers . 19 4 Server Configuration 20 4.1 Server security . 20 4.1.1 Server vulnerability and server access . 20 4.1.2 Server access: /etc/bigsister/permissions ........................... 20 4.1.3 Data integrity and authenticity . 21 4.1.4 Tunneling Big Sister tcp-connections through Secure Shell . 22 4.1.4.1 Agent to Server . 23 4.1.4.2 Server to Server . 23 4.2 Configure Alarming . 23 4.2.1 Rules . 23 4.2.2 Patterns - "when to do things" . 24 4.2.2.1 Simple rule . 24 4.2.2.2 Using wildcard in rules . 24 4.2.2.3 Using groups in rules . 25 4.2.2.4 Using criteria in rules . 25 4.2.3 Description - "what todo".......................................... 25 4.2.4 PAGER rules: influencing alarm delivery . 26 4.2.5 Definitions and their meaning . 26 4.3 Use and configure SLA/Availability management . 26 4.3.1 Setting it up Availability management . 28 4.3.1.1 Running the reporting tool . 29 4.3.1.2 The results . 30 4.3.1.3 Using savelogs/archivelogs and availability management . 30 4.4 Sending server commands . 30 4.4.1 Using the telnet client . 31 4.4.2 Using the bsadmin tool . 31 4.5 Configuring the Server and customizing the Display . 32 4.5.1 The main server configuration file: bb-display.cfg . 32 4.5.2 The options section . 32 4.5.3 The names and group section . 33 4.5.3.1 Defining and using groups . 33 BigSister 5 / 111 4.5.3.2 Automatically joined groups . 33 4.5.3.3 Deleting groups . 35 4.5.4 The Webpages section . 35 4.5.4.1 Skins . 37 4.5.4.2 Skins in CGI programs . 38 4.5.4.3 Frames . 38 4.5.5 Using imagemaps . 38 4.6 Deleting unused and stale network objects . 39 4.7 Attaching the Big Sister server to a database . 40 4.7.1 Enabling data logging in a database . 40 4.7.2 Data logging in MySQL database . 41 4.7.2.1 Prerequisits . 41 4.7.2.2 Creating the database and database user . 41 4.7.2.3 Configure Big Sister . ..