White Paper. dbwatch 11.0 Server installation. dbwatch 11.0 Server installation on Linux

Transcription

1 White Paper dbwatch 11.0 Server installation dbwatch 11.0 Server installation on Linux Per Christopher Undheim Product specialist dbwatch AS February 2014 Version 1.3 This whitepaper describes the specifications, setup and tuning of a dbwatch 11.0 Server installation on Linux CentOS bit.

2 Contents Introduction... 2 Document changes... 3 Hardware requirements... 4 Software requirements... 5 OS installation... 6 After install configuration Update the hosts file with this hosts entry Prepare the install directory Install missing 32 bit libraries and executables Changes made to the OS Download dbwatch dbwatch installation Setup dbwatch after install Configure automatic startup and shutdown Adjust Java memory size for large environments Tuning task-executor-max-concurrent-instances

3 Introduction This white paper instructs users on hardware requirements, installations procedures, tuning and requirements for setting up a dbwatch 11.0 Server on Linux. One of the key benefits with dbwatch is the ability to monitor many databases regardless of platform or database type. Any combination of supported database types or platforms can be used in the same database server. For large environments it is possible to use more than one dbwatch Server and the client software supports connecting to multiple dbwatch Servers from the same interface. This setup is tested for monitoring up to 500 database instances from one server when memory is tuned. 2

4 Document changes V1.0: V1.1: V1.2: V1.3: Initial version of this document Changes to requirements; setting minimum requirements Correcting url changes Correcting ulimit p to ulimit n and added info about memory tuning 3

5 Hardware requirements For this installation we are installing dbwatch 11.0 Server on a machine with the following hardware specifications: HP Proliant DL120 G7 1 x Xeon E Ghz 4 core 250 GB hard disk 4 GB RAM Minimum requirements: Pentium 4 or higher; 1Ghz or higher 500 MB free hard disk space 1 GB RAM Installation on VmWare is also supported. Similar hardware requirements apply. 4

6 Software requirements We are using CentOS bit for this install. The hostname we have chosen for this example machine is dbwatch. Pictures from the installation are from a similar installation of a host on VmWare ESXi. 5

7 OS installation We do a step by step installation guide on the basic OS installation with screen shots of all the windows we encounter. Some choices may be different, such as network configuration or country or language variables. CentOS bit can be downloaded from The ISO image used for this install is also available on bin-dvd1.iso Select Install or upgrade an existing system and press enter. 6

8 We choose to Skip checking our CD for errors. It is voluntary to check your CD for errors, but if you are uncertain of the state of your installation media, you should check before you continue the installation, to make sure there will be no problems with reading files from it. 7

9 The start of the installation. Use your mouse to navigate, and click on Next to continue the installation. 8

10 Choosing your language for the installation process. The choice here depends on your personal preferences. We choose English (English) here and click Next. 9

11 Choosing your keyboard layout. This choice is also depending on personal preferences. We choose Norwegian here, and click Next. 10

12 The choice of installation media. We are using local harddisks in our setup to limit the number of variables in tuning. Select Basic Storage Devices and click Next. 11

13 Store devices are detected. We will use the entire disk on this machine. We select Yes, discard any data. 12

14 The hostname of the machine. The name given here should be different in your setup. We choose dbwatch.local.dbwatch.com. After you have entered the hostname that is correct for you, click on Configure Network. 13

15 Configure network. Select System eth0 and click on Edit. 14

16 Edit System eth0. Click on IPv4 Settings. 15

17 Edit System eth0. Click on Automatic (DHCP). There is a pull down menu, and you need to change this to Manual. 16

18 Edit System eth0. Add an IP address to the interface. We have a network IP of , 24 bit netmask and as the gateway. We also use as our DNS server and local.dbwatch.com as Search domains. Your settings are most likely different. Click Apply when you are done. 17

19 Back to Network Connections. Click Close. 18

20 Back to the window were you typed the hostname. Click Next. 19

21 Select your time zone. We selected Europe/Oslo, your settings might differ. Click Next. 20

22 Chose root password. This needs to be a good one, and one not based upon a dictionary word. When you are satisfied with the password. Click Next. 21

23 Installation type. Chose to Use All Space. Click Next. 22

24 Chose Write changes to disk. Click on Next. 23

25 Chose Minimal Desktop. dbwatch Server is possible to install and run on machines without X using a desktop using X11 or X11 emulator remotely, but the setup of X11 remotely is not covered here. Click Next. 24

26 Installation is complete. Click on Reboot. 25

27 After reboot. Click Forward. 26

28 Click Yes, I agree to the License Agreement and click on Forward. 27

29 Create user. We create the dbwatch user on the machine. We give it a username: dbwatch. Full name: dbwatch sw owner and a secure password. Click Forward. 28

30 Date and time. Click on Syncronize date and time over the network. DbWatch depends on correct time on the host running dbwatch Server. 29

31 Date and time. In this setup we use the default time servers for centos. You might use your own local time servers is this is available. Click Forward. 30

32 Kdump. We use the default settings here. Click Finish. 31

33 Kdump. Using Kdump requires reboot. Click Yes. 32

34 Kdump. Reboot will take place. Click Ok. 33

35 After install configuration There are some steps required after installing CentOS that are required before you install and use dbwatch Server. Update the hosts file with this hosts entry Change user credentials to that of root user. Find out the hostname set for this machine. Our machine is dbwatch.local.dbwatch.com. Also find out the IP address of this machine. Our IP address is Then add an entry in the /etc/hosts file with the command: echo dbwatch.local.dbwatch.com >> /etc/hosts 34

36 Prepare the install directory Change privileges to that of root user. Create the install directory /usr/local/dbwatch. Change owner to dbwatch and group to dbwatch. Set access mode to 750 for this directory. su mkdir p /usr/local/dbwatch chown dbwatch.dbwatch /usr/local/dbwatch chmod 750 /usr/local/dbwatch 35

37 Install missing 32 bit libraries and executables Change privileges to that of root user. Use yum to install the missing files. This will also install some dependencies needed to install. Answer Y to all questions. su yum install libldb.i686 36

38 It should look like this when its done. 37

39 Installing 32 bit version of libxp. Change privileges to that of root user. Use yum to install the package libxp.i686. Answer Y to all questions. su yum install libxp.i686 38

40 It should look like this when its done. 39

41 Installing libxtst 32 bit version. Change privileges to that of root user. Use yum to install the package libxtst.i686. Answer Y to all questions. su yum install libxtst.i686 40

42 Should look like this when you are done. 41

43 Installing libgcc 32 bit version. Change privileges to that of root user. Use yum to install the package libgcc.i686. Answer Y to all questions. su yum install libgcc.i686 42

44 Should look like this when you are done. 43

45 Installing libxrender 32 bit version. Change privileges to that of root user. Use yum to install the package libxrender.i686. Answer Y to all questions. su yum install libxrender.i686 44

46 Should look like this when you are done. 45

47 Changes made to the OS Disable IPV6 Echo net.ipv6.conf.all.disable_ipv6 = 1 >> /etc/sysctl.conf Open port in iptables for dbwatch iptables -I INPUT -p tcp --dport j ACCEPT service iptables save Set file limit higher In /etc/security/limits.conf dbwatch hard nofile dbwatch hard nproc Also in the shell script for startup ulimit -n ulimit -u

48 Download dbwatch You can register to download dbwatch here: You will then receive a download link on the you registered with. 47

49 dbwatch installation dbwatch is available for Linux as either a.zip file or a.sh file. The zip file contains the.sh file. Make sure that you verify the md5 signature of the.sh file before continuing the installation, to make sure it is the correct file and that no corruption has occurred during download. For dbwatch_unix_11_0.sh the correct md5sum checksum is: 08a5e745ec0e4d22b464a49ee2bc8253 Unzip your.zip file if you have it, and check the md5 checksum: unzip dbwatch_unix_11_0.zip md5sum dbwatch_unix_11_0.sh 48

50 The executable needs execute permissions to run. You must install dbwatch as user root, but we will change the user owning the dbwatch directories and the user dbwatch runs under later. chmod +x dbwatch_unix_11_0.sh su c dbwatch_unix_11_0.sh Start the program, and you will get the following window. A graphical installation dbwatch on Linux/Unix requires Xwindows. 49

51 Click Next to start the installation. 50

52 Please select the destination folder you desire. Default location on Linux is /usr/local/dbwatch/11.0/. Click Next when you have selected the right destination folder. 51

53 If the machine you are installing dbwatch on will act as a dbwatch Server, you should select all the components available. If the machine you are installing on is a workstation that will connect to a dbwatch Server elsewhere, you should select Monitor. Click Next when you have selected the appropriate components for your setup. 52

54 Please read the license agreement carefully before accepting the agreement. Click the radio button next to I accept the agreement before clicking Next. 53

55 Please enter the license information you have received from dbwatch when you bought your license, or simply accept the automatically generated demo license for a 10-day trial. If the key you have received is not working, please contact support on support@dbwatch.com and you will receive a valid license from support. There is also support available from our wiki pages ( Click "Next". 54

56 Configure the listener port for dbwatch Server. Default port is You can also enable Autodiscover instances, which will look for instances on your subnet that can be added to dbwatch. 55

57 dbwatch 11.0 supports Active Directory integration. You can choose to either use dbwatch for your authentication or Active Directory. If you use dbwatch, you need to set a password for the admin user, which is the default administration user in dbwatch. You can also change to Active Directory authentication at a later stage. This is described on our wiki pages ( ). 56

58 You are now ready to install the product. Click Next. 57

59 The installation should only take a few minutes. Please wait. 58

60 When the installation successfully completes you get this informational window. Click Next. 59

61 You have now completed the installation wizard. We will start the Click Finish to close the window. 60

62 Setup dbwatch after install Configure automatic startup and shutdown One way to configure automatic startup and shutdown that is quite universal for all Linux distributions are by using startup scripts. There is a startup script provided as dbwatchservice10.0, but this runs as the user that starts the script, and in case of automatic startup, this normally is root. We don t recommend running dbwatch as the root user, and as we have installed dbwatch as user dbwatch, we have made a startup script that will change user as it starts dbwatch. #! /bin/sh # chkconfig: #################################### # Start og Stop script for dbwatch 11 #################################### # # # Config DBW_USER=dbwatch DBW_PATH=/usr/local/dbWatch/11.0 case "$1" in start) esac exit 0 echo "start" su - $DBW_USER -c "$DBW_PATH/dbWatchService11.0 start" ;; stop) echo "stop" su - $DBW_USER -c "$DBW_PATH/dbWatchService11.0 stop" ;; restart) echo "restart" su - $DBW_USER -c "$DBW_PATH/dbWatchService11.0 stop" su - $DBW_USER -c "$DBW_PATH/dbWatchService11.0 start" ;; *) echo "Usage: $0 {start stop restart }" exit 1 61

63 This script needs to be placed in /etc/init.d directory as dbwatch11. Then link it in at the appropriate runlevel. You can find the current runlevel by issuing the runlevel command in your prompt. We are running on runlevel 5, and we place a startup and shutdown link to our script. ln s /etc/init.d/dbwatch11 /etc/rc5.d/s99dbwatch11 ln s /etc/init.d/dbwatch11 /etc/rc0.d/k01dbwatch11 ln s /etc/init.d/dbwatch11 /etc/rc6.d/k01dbwatch11 chmod a+x /etc/init.d/dbwatch11 62

64 Adjust Java memory size for large environments dbwatch is by default limited to use maximum 512 MB memory on the server. This is not enough for the monitoring of an environment with as many as 500 instances. Therefore a small change in the startup files are required. We recommend configuring dbwatch to be allowed to use 2048 MB memory on the server. A parameter to the startup specifying max memory usage is by default set to "-Xmx512m" and need to be set to "-Xmx2048m". This must be changed once in dbwatchconsole11.0 and three times in dbwatchservice11.0. These files are located in the root of the dbwatch installation, by default /usr/local/dbwatch/11.0. You can use the editor you prefer, for instance vi. 63

65 Tuning task-executor-max-concurrent-instances In server_configuration.xml there are several parameters governing the behavior of dbwatch. By default the task-executor-max-concurrent-instances is set to 30. <task-executor-max-concurrent-instances>30</task-executor-max-concurrent-instances> This setting controls the internal timing mechanism in dbwatch that controls scheduling. This mechanism will run every 10 second to verify that everything that should be run, has been run. This setting can be tuned up if you experience problems with tasks not being run, and down if you have problems with high thread and memory usage. If this number is set to 30 when you have 500 instances, the tasks that are scheduled to run every minute will run every 3 minutes approximately. We recommend this setting to be the number of instances being monitored / 6. So for a full 500 instance setup, a setting of 85 will be correct. 64