Général:InstallationSocle

De WikiFr

Généralités


Attention.png
Warning:
Avant toutes choses, n'allez pas plus loin si vous n'avez pas lu la section "Concepts dbSQWare" !.


Limites de cette section

Cette section n’a pas la prétention de traiter tous les cas possibles d’installation et de paramétrage de dbSQWare.
Il ne faut pas perdre de vue qu’il s’agit d’un outil très souple qui est capable de s’adapter à bon nombre d’architectures.
Cette section est réservée à des DBA qui maîtrisent bien la partie Linux/Unix et le ksh. Il s’agit d’un guide à l’installation pour une personne déjà à l’aise avec ces parties.
Avant de dire « ça ne fonctionne pas », lisez bien le message d’erreur et réfléchissez à ce dont vous avez besoin au niveau du socle pour que les scripts fonctionnent. Par exemple, si vous n’arrivez pas à faire un sqlplus en ligne de commande pour vous connecter à votre instance Oracle, il n’y a pas de raison pour que les scripts arrivent à le faire (il n’y a rien de magique) !

Si un des chapitre ne fonctionne pas, n'allez pas plus loin, il faut d'abord corriger avant de continuer !

Nous vous conseillons de faire appel à un spécialiste de l’outil afin de définir avec vous quelle est la meilleure architecture d’installation adaptée à votre parc et à votre organisation du travail http://www.dbsqware.com. Des formations sont également disponibles chez des partenaires pour approfondir les différentes parties et les différentes configurations possibles.

Cette section se base sur une installation du point central sous CentOS 6.7 64bits sur une VM (2 vCPU et 2 Go de RAM) avec 10 Go de disque (50 Go si vous souhaitez historiser les AWR d’une centaine d’instances Oracle sur 60j). Vous pouvez évidemment l’installer sur un autre type de Linux/Unix, il vous faudra alors adapter les commandes système proposées si nécessaire.
Il ne traite que de l’installation du socle central, pour les autres paramétrages, reportez-vous aux sections adéquates.

Rappel de la structure de l’outil

dbSQWare™ est composé de quatre modules complémentaires :

SQWareProduction	=> scripts shell d’exploitation (souvent en local sur la machine hébergeant le SGBD à gérer
SQWareRepository	=> référentiel et stockage des indicateurs (database MySQL)
SQWareCentral		=> centralisation des sources et lancement des commandes
SQWareWeb		=> interface graphique de restitution


Installation de l’infrastructure centrale

Pour rappel, ce document ne présente qu’une façon d’installer l’outil. Il existe de multiples configurations possibles.
Cette section présente une installation « compacte », c’est-à-dire l’installation des modules SQWareCentral, SQWareRepository et SQWareWeb sur la même machine que nous appellerons vmsqwarebox. Cette machine hébergera également les sources de SQWareProduction.
Pour l’exploitation de MsSql, nous installerons également SQWareProduction MsSql (et FreeTds) sur cette même machine.
Vous pouvez évidemment l’installer sur un autre type de Linux/Unix, il vous faudra alors adapter les commandes système proposées. L’installation peut également être réalisée en mode « distribué », c’est-à-dire chaque module sur sa propre machine ; il faudra alors adapter les configurations.
Nous allons voir l’installation pour Oracle (oracle), Sybase (sybase), Sql-Server (mssql) et MySQL (mysql). N’utilisez que les commandes pour le(s) SGBD qui vous intéresse et/ou adaptez les commandes pour les autres SGBD.

Vérification / mise en place des pré-requis

La majorité des commandes de ce chapitre sont passées avec le user unix root, soit parce que c’est nécessaire pour des installations « système », soit parce que l’on utilise des bouts de scripts qui passent les commandes en boucle sur tous les utilisateurs.
Adaptez les commandes si vous souhaitez faire l’installation pas à pas en vous connectant à chaque fois avec le bon utilisateur.
Il est primordial de suivre les commandes dans l’ordre et de vérifier à chaque fois que le résultat attendu est bien présent avant de passer à l’étape suivante, sinon, cela risque de bloquer et vous allez avoir du mal à trouver où.
En principe, toutes les commandes ont été testées et vous pouvez donc utiliser la bonne vieille méthode du copier/coller dans la majorité des cas.

Vérifications système

Vérification de la version de l’OS

[root@vmsqwarebox ~]# cat /etc/redhat-release
CentOS release 6.7 (Final)
[root@vmsqwarebox ~]# uname -a
Linux vmsqwarebox 2.6.32-573.el6.x86_64 #1 SMP Thu Jul 23 15:44:03 UTC 2015 x86_64 x86_64 x86_64 GNU/Linux


Vérification que ksh est bien installé (et que ce n’est pas juste un lien vers bash !) :

[root@vmsqwarebox /]# type ksh
ksh is /bin/ksh
[root@vmsqwarebox /]# ll /bin/ksh
lrwxrwxrwx 1 root root 21 Nov 15 09:56 /bin/ksh -> /etc/alternatives/ksh
[root@vmsqwarebox /]# ll /etc/alternatives/ksh
lrwxrwxrwx 1 root root 10 Nov 15 09:56 /etc/alternatives/ksh -> /bin/ksh93
[root@vmsqwarebox /]# ll /bin/ksh93
-rwxr-xr-x 1 root root 1507648 Sep 22 16:58 /bin/ksh93


Préférez un serveur paramétré en anglais, c’est plus facile pour les messages d’erreur (au lieu du classique fr_FR.UTF-8) :

$ cat /etc/sysconfig/i18n
LANG="en_US.UTF-8"
SYSFONT="latarcyrheb-sun16"


Un certain nombre de RPM sont nécessaires pour l’installation d’Oracle, il convient donc de vérifier leur présence et de les installer si nécessaire.
Attention, la liste peut ne pas être exhaustive, à vous d’adapter les commandes à votre situation.
Liste des RPM connus comme étant nécessaires :

  • binutils
  • gcc
  • gcc-c++
  • glibc
  • glibc-common
  • libstdc++
  • libstdc++-devel
  • make
  • pdksh
  • sysstat
  • compat-db


Exemple de commande de vérification :

$ rpm -q gcc
gcc-4.4.7-4.el6.x86_64


Il peut être utile de connaitre l'architecture des RPM installés (x86_64 et i386 par exemple). Pour ce faire, il suffit de modifier le format d'affichage par défaut en éditant le fichier ~/.rpmmacros .

$ echo '%_query_all_fmt %%{name}-%%{version}-%%{release} (%%{arch})' >>~/.rpmmacros
$ rpm -q gcc
gcc-4.el6  4.4.7  (x86_64)


Ou directement dans la ligne de commande :

$ rpm -q gcc --queryformat '%{name}-%{release}  %{version}  (%{arch})\n'
gcc-4.el6  4.4.7  (x86_64)


Exemple de sortie lorsqu’un RPM manque :

[root@vmsqwarebox /]# rpm -q libXpm-devel
le paquetage libXpm-devel n'est pas installé
[root@vmsqwarebox /]# unset LANG
[root@vmsqwarebox /]# rpm -q libXpm-devel
package libXpm-devel is not installed


Exemple d’installation d’un RPM manquant :

[root@vmsqwarebox /]# rpm -ivh libXpm-devel-3.5.5-3.x86_64.rpm
warning: libXpm-devel-3.5.5-3.x86_64.rpm: Header V3 DSA signature: NOKEY, key ID 37017186
Preparing...                ########################################### [100%]
   1:libXpm-devel           ########################################### [100%]


Le plus simple, installation directe avec yum (nécessite un repo) :

[root@vmsqwarebox /]# yum install ksh binutils compat-db gcc gcc-c++ glibc glibc-common gnome-libs libstdc++ libstdc++-devel make pdksh sysstat

Gestion des users unix

Création des groups et users unix avec ksh comme shell par défaut (à adapter si vous souhaitez par exemple fixer les uid et gid) :

groupadd dba
useradd -g dba -s /bin/ksh -d /home/dbsqware dbsqware
useradd -g dba -s /bin/ksh -d /home/oracle oracle
useradd -g dba -s /bin/ksh -d /home/sybase sybase
useradd -g dba -s /bin/ksh -d /home/mssql mssql
useradd -g dba -s /bin/ksh -d /home/mysql mysql


Affectation d’un mot de passe aux users :

passwd dbsqware
passwd oracle
passwd sybase
passwd mssql
passwd mysql


Exemple de sortie :

[root@vmsqwarebox /]# passwd dbsqware
Changing password for user dbsqware.
New UNIX password:
Retype new UNIX password:
passwd: all authentication tokens updated successfully.
[root@vmsqwarebox /]# passwd oracle
Changing password for user oracle.
New UNIX password:
Retype new UNIX password:
passwd: all authentication tokens updated successfully.
...


Modification des droits sur leur home directory :

cd /home
chmod 750 dbsqware oracle sybase mssql mysql


Vérification des home directories  :

[root@vmsqwarebox /]# ls -l /home/
total 32
drwxr-x--- 3 dbsqware dba 4096 mai 13 21:54 dbsqware
drwxr-x--- 3 mssql    dba 4096 mai 13 21:54 mssql
drwxr-x--- 3 mysql    dba 4096 mai 13 21:54 mysql
drwxr-x--- 3 oracle   dba 4096 mai 13 21:54 oracle
drwxr-x--- 3 sybase   dba 4096 mai 13 21:54 sybase


Mise en place des arborescences

Préparation des arborescences /applis pour installation des binaires applicatifs (si nécessaire) :

mkdir -p /applis/oracle
chown oracle:dba /applis/oracle
mkdir -p /applis/sybase
chown sybase:dba /applis/sybase
mkdir -p /applis/mssql
chown mssql:dba /applis/mssql
mkdir -p /applis/mysql
chown mysql:dba /applis/mysql
mkdir -p /applis/dbsqware
chown dbsqware:dba /applis/dbsqware


Préparation des arborescences /data pour stocker les données (si nécessaire) :

mkdir -p /data/oracle
chown oracle:dba /data/oracle
mkdir -p /data/sybase
chown sybase:dba /data/sybase
mkdir -p /data/mssql
chown mssql:dba /data/mssql
mkdir -p /data/mysql
chown mysql:dba /data/mysql
mkdir -p /data/dbsqware
chown dbsqware:dba /data/dbsqware
# Spécifique pour les rapports AWR et/ou Statspack
mkdir -p /data/oracle/awr
chown oracle:dba /data/oracle/awr
# Spécifique pour les slow query files
mkdir -p /data/mysql/SlowQuery
chown mysql:dba /data/mysql/SlowQuery


Préparation des arborescences /backups pour stocker les backups (si nécessaire) :

mkdir -p /backups/oracle
chown oracle:dba /backups/oracle
mkdir -p /backups/sybase
chown sybase:dba /backups/sybase
mkdir -p /backups/mssql
chown mssql:dba /backups/mssql
mkdir -p /backups/mysql
chown mysql:dba /backups/mysql


Vérification des arborescences :

[root@vmsqwarebox /]# ls -l /applis
total 40
drwxr-xr-x 2 dbsqware dba 4096 mai 14 04:06 dbsqware
drwxr-xr-x 2 mssql    dba 4096 mai 14 04:06 mssql
drwxr-xr-x 2 mysql    dba 4096 mai 14 04:06 mysql
drwxr-xr-x 2 oracle   dba 4096 mai 14 04:06 oracle
drwxr-xr-x 2 sybase   dba 4096 mai 14 04:06 sybase
[root@vmsqwarebox /]# ls -l /data
total 40
drwxr-xr-x 2 dbsqware dba 4096 mai 14 04:06 dbsqware
drwxr-xr-x 2 mssql    dba 4096 mai 14 04:06 mssql
drwxr-xr-x 2 mysql    dba 4096 mai 14 04:06 mysql
drwxr-xr-x 2 oracle   dba 4096 mai 14 04:06 oracle
drwxr-xr-x 2 sybase   dba 4096 mai 14 04:06 sybase
[root@vmsqwarebox /]# ls -l /backups
total 32
drwxr-xr-x 2 mssql  dba 4096 mai 14 04:06 mssql
drwxr-xr-x 2 mysql  dba 4096 mai 14 04:06 mysql
drwxr-xr-x 2 oracle dba 4096 mai 14 04:06 oracle
drwxr-xr-x 2 sybase dba 4096 mai 14 04:06 sybase


Clés ssh

Préparation des clés ssh et ménage pour dbsqware.
En se connectant avec le user dbsqware :

su – dbsqware
rm -f $HOME/.bash* $HOME/.zshrc $HOME/.emacs
rm -rf $HOME/.mozilla
ssh-keygen -t rsa -N '' -f $HOME/.ssh/id_rsa
chmod go-w $HOME
cat $HOME/.ssh/id_rsa.pub >>$HOME/.ssh/authorized_keys
chmod 700 $HOME/.ssh
chmod 600 $HOME/.ssh/authorized_keys

Generating public/private rsa key pair.
Created directory '/home/dbsqware/.ssh'.
Your identification has been saved in /home/dbsqware/.ssh/id_rsa.
Your public key has been saved in /home/dbsqware/.ssh/id_rsa.pub.
The key fingerprint is:
d6:68:27:1f:32:0c:89:54:c5:e4:69:75:ac:6a:aa:b9 dbsqware@vmsqwarebox


Ou directement depuis le user root :

su - dbsqware -c "rm -f \$HOME/.bash* \$HOME/.zshrc \$HOME/.emacs
rm -rf \$HOME/.mozilla
ssh-keygen -t rsa -N '' -f \$HOME/.ssh/id_rsa
chmod go-w \$HOME
cat \$HOME/.ssh/id_rsa.pub >>\$HOME/.ssh/authorized_keys
chmod 700 \$HOME/.ssh
chmod 600 \$HOME/.ssh/authorized_keys"


Si tout a fonctionné correctement, le user dbsqware doit être capable de se connecter en ssh sur lui-même (ceci pour plus de souplesse dans certains cas de paramétrages).
Test si cela fonctionne :

[root@vmsqwarebox home]# su - dbsqware
$ ssh dbsqware@vmsqwarebox
The authenticity of host 'vmsqwarebox (85.31.222.135)' can't be established.
RSA key fingerprint is bd:e1:d0:d3:c5:2d:94:8f:df:f0:a2:50:42:8d:ad:1d.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added ' vmsqwarebox,bbb.xx.aaa.yyy' (RSA) to the list of known hosts.
Last login: Mon May 14 04:33:25 2012 from vmsqwarebox
$ exit
Connection to vmsqwarebox closed.


Pour chacun des users unix que vous avez créés précédemment, vous devez répéter la même opération mais en autorisant également le user dbsqware à se connecter sur eux (pour lancer les scripts en automatique).
De la même façon que tout à l’heure, soit vous le faites sur chaque user à la main, soit vous utilisez le bout de script suivant en tant que root :

lvsqw_SshKey_dbsqware=$(cat /home/dbsqware/.ssh/id_rsa.pub)
for lvsqw_User in `echo 'oracle sybase mssql mysql'`
do
	su - $lvsqw_User -c "rm -f \$HOME/.bash* \$HOME/.zshrc \$HOME/.emacs
		rm -rf \$HOME/.mozilla \$HOME/.gnome2
		ssh-keygen -t rsa -N '' -f \$HOME/.ssh/id_rsa
		chmod go-w \$HOME
		cat \$HOME/.ssh/id_rsa.pub >>\$HOME/.ssh/authorized_keys
		echo '$lvsqw_SshKey_dbsqware' >>\$HOME/.ssh/authorized_keys
		chmod 700 \$HOME/.ssh
		chmod 600 \$HOME/.ssh/authorized_keys"
done


Test si cela fonctionne (exemple pour le user oracle à répéter pour tous les users) :

[root@vmsqwarebox home]# su - dbsqware
$ id
uid=500(dbsqware) gid=500(dba) groupes=500(dba) context=...
$ ssh oracle@vmsqwarebox
$ id
uid=501(oracle) gid=500(dba) groupes=500(dba) context=user_u:system_r:unconfined_t
$ ssh oracle@vmsqwarebox
The authenticity of host 'vmsqwarebox (85.31.222.135)' can't be established.
RSA key fingerprint is bd:e1:d0:d3:c5:2d:94:8f:df:f0:a2:50:42:8d:ad:1d.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'vmsqwarebox,bbb.xx.aaa.yyy' (RSA) to the list of known hosts.
Last login: Mon May 14 05:07:47 2012 from vmsqwarebox
$ id
uid=501(oracle) gid=500(dba) groupes=500(dba) context=user_u:system_r:unconfined_t
$ exit
Connection to vmsqwarebox closed.
$ exit
Connection to vmsqwarebox closed.


Les fichiers d’environnement

Mise en place d'un .profile et .kshrc pour tous les users :

cat <<EOFCAT >/tmp/.profile
ENV='.kshrc'
EOFCAT
cat <<EOFCAT >/tmp/.kshrc
alias ll='ls -al'
alias lt='ls -alrt'
set -o vi
EOFCAT
chmod 777 /tmp/.profile /tmp/.kshrc
for lvsqw_User in `echo 'dbsqware oracle sybase mssql mysql'`
do
	su - $lvsqw_User -c "cp /tmp/.profile \$HOME/.
		cp /tmp/.kshrc \$HOME/.
		chmod 640 \$HOME/.profile
		chmod 640 \$HOME/.kshrc"
done
rm -f /tmp/.profile /tmp/.kshrc


Vérification que tous les fichiers ont été créés :

[root@vmsqwarebox ~]# ls -al /home/*
/home/dbsqware:
total 56
drwxr-x--- 3 dbsqware dba  4096 May 14 05:30 .
drwxr-xr-x 7 root     root 4096 May 14 03:57 ..
-rw-r----- 1 dbsqware dba    48 May 14 05:30 .kshrc
-rw-r----- 1 dbsqware dba    13 May 14 05:30 .profile
-rw------- 1 dbsqware dba   746 May 14 05:26 .sh_history
drwx------ 2 dbsqware dba  4096 May 14 04:37 .ssh
-rw------- 1 dbsqware dba   922 May 14 05:23 .viminfo

/home/mssql:
total 40
drwxr-x--- 3 mssql dba  4096 May 14 05:30 .
drwxr-xr-x 7 root  root 4096 May 14 03:57 ..
-rw-r----- 1 mssql dba    48 May 14 05:30 .kshrc
-rw-r----- 1 mssql dba    13 May 14 05:30 .profile
drwx------ 2 mssql dba  4096 May 14 05:16 .ssh

/home/mysql:
total 40
drwxr-x--- 3 mysql dba  4096 May 14 05:30 .
drwxr-xr-x 7 root  root 4096 May 14 03:57 ..
-rw-r----- 1 mysql dba    48 May 14 05:30 .kshrc
-rw-r----- 1 mysql dba    13 May 14 05:30 .profile
drwx------ 2 mysql dba  4096 May 14 05:16 .ssh

/home/oracle:
total 48
drwxr-x--- 3 oracle dba  4096 May 14 05:30 .
drwxr-xr-x 7 root   root 4096 May 14 03:57 ..
-rw-r----- 1 oracle dba    48 May 14 05:30 .kshrc
-rw-r----- 1 oracle dba    13 May 14 05:30 .profile
-rw------- 1 oracle dba    76 May 14 05:12 .sh_history
drwx------ 2 oracle dba  4096 May 14 05:16 .ssh

/home/sybase:
total 40
drwxr-x--- 3 sybase dba  4096 May 14 05:30 .
drwxr-xr-x 7 root   root 4096 May 14 03:57 ..
-rw-r----- 1 sybase dba    48 May 14 05:30 .kshrc
-rw-r----- 1 sybase dba    13 May 14 05:30 .profile
drwx------ 2 sybase dba  4096 May 14 05:16 .ssh


Ajout de la partie source de l’environnement SQWareProduction dans le .profile de tous les users :

for lvsqw_Sgbd  in `echo 'oracle sybase mssql mysql'`
do
	lvsqw_tmp=$(echo "$lvsqw_Sgbd"|sed 's,\([a-z][a-z][a-z]\)[a-z]*,\1,')
	lvsqw_tmp1=$(echo "$lvsqw_tmp"|sed 's,\([a-z]\)[a-z]*,\1,'|tr '[a-z]' '[A-Z]')
	lvsqw_tmp2=$(echo "$lvsqw_tmp"|sed 's,[a-z]\([a-z][a-z]\)[a-z]*,\1,')
	TrigrammeSgbd="${lvsqw_tmp1}$lvsqw_tmp2"
	if [ "$TrigrammeSgbd" = "Mss" ]
	then
		TrigrammeSgbd="Msq"
		lvsqw_tmp="msq"
	fi
	echo "Traitement du SGBD: '$lvsqw_Sgbd', '$TrigrammeSgbd'"
	cat <<EOFCAT >> /home/$lvsqw_Sgbd/.profile
# env dbSQWare pour $lvsqw_Sgbd, doit rester en fin de .profile
export gvsqw_Env='PRD'
export gvsqw_${TrigrammeSgbd}Bin=\$HOME/SQWareProduction/$lvsqw_Sgbd/bin
lvsqw_IsTerminal=\$(tty 2>&1 >/dev/null;echo \$?)
if [ "\$lvsqw_IsTerminal" = "0" ] && [ -r \$gvsqw_${TrigrammeSgbd}Bin/../etc/.profile_confort ]
then
   . \$gvsqw_${TrigrammeSgbd}Bin/../etc/.profile_confort
fi
EOFCAT
done


Vérification de la mise à jour du .profile (exemple pour le user oracle à répéter pour tous les users) :

[root@vmsqwarebox ~]# cat ~oracle/.profile
ENV='.kshrc'
# env dbSQWare pour oracle, doit rester en fin de .profile
export gvsqw_Env='PRD'
export gvsqw_OraBin=$HOME/SQWareProduction/oracle/bin
lvsqw_IsTerminal=$(tty 2>&1 >/dev/null;echo $?)
if [ "$lvsqw_IsTerminal" = "0" ] && [ -r $gvsqw_OraBin/../etc/.profile_confort ]
then
   . $gvsqw_OraBin/../etc/.profile_confort
fi

Installation des sources sur vmsqwarebox

La majorité des commandes de ce chapitre sont passées avec le user unix dbsqware.
Il est primordial de suivre les commandes dans l’ordre et de vérifier à chaque fois que le résultat attendu est bien présent avant de passer à l’étape suivante, sinon, cela risque de bloquer et vous allez avoir du mal à trouver où. Vérifiez également que tous les points précédents ont été exécutés sans erreur.

Nous allons dans cette partie déployer l’ensemble des scripts de dbSQWare.
Il y aura :

  • SQWareCentral, qui servira notamment à l’exécution automatique de scripts sur l’ensemble du parc.
  • SQWareProduction, il s’agit en fait du référentiel de source de ce module. Il faudra le paramétrer aux normes de votre parc pour ensuite le déployer.
  • SQWareRepository, il s’agit des scripts sql vous permettant de créer le repository.
  • SQWareWeb, c’est la partie de restitution graphique fonctionnant avec apache et PHP, à déployer sur la même machine que SQWareCentral où à déplacer sur une autre, c’est au choix.


Extraction de l’archive

Récupérez les sources et placez-les dans /tmp :

[root@vmsqwarebox ~]# su - dbsqware
$ cd
$ tar zxvf /tmp/dbSQWare_full_latest.tgz
dbSQWare/
dbSQWare/SQWareProduction/
dbSQWare/SQWareProduction/ingres/
dbSQWare/SQWareProduction/ingres/tools/
...
dbSQWare/SQWareProduction/oracle/
dbSQWare/SQWareProduction/oracle/tools/
dbSQWare/SQWareProduction/oracle/tools/sqwora_RmanConfigure.ksh
...
dbSQWare/SQWareCentral/
dbSQWare/SQWareCentral/lib/
dbSQWare/SQWareCentral/lib/sqwctl_MenuAction.lib
...
dbSQWare/SQWareWeb/custom_ref/
dbSQWare/SQWareWeb/custom_ref/ingres/
...
<br>
Vérification que l’on a bien les quatre modules installés :
<pre>
$ ls -l ~dbsqware/dbSQWare
total 32
drwxr-x--- 3 dbsqware dba 4096 avr 29 14:48 SQWareCentral
drwxr-x--- 7 dbsqware dba 4096 avr 29 14:48 SQWareProduction
drwxr-x--- 7 dbsqware dba 4096 avr 29 14:48 SQWareRepository
drwxr-x--- 3 dbsqware dba 4096 avr 29 14:48 SQWareWeb


Configuration du profile du user dbsqware pour SQWareCentral

Ajoutez les lignes suivantes dans le .profile du user unix dbsqware afin qu’il source l’environnement de SQWareCentral.

dbsqware@vmsqwarebox:/home/dbsqware $ cat .profile
## SQWareCentral
export gvsqw_Env='PRD'
export gvsqw_SQWareCentralPath=$HOME/dbSQWare/SQWareCentral
export gvsqw_SQWareProductionPath=$HOME/dbSQWare/SQWareProduction
. $gvsqw_SQWareCentralPath/etc/.profile


Pour vérifier si tout est OK, sourcez le .profile du user et vous devez avoir un résultat de ce type:

dbsqware@vmsqwarebox:/home/dbsqware $ . ~/.profile

# SQWareCentral module of dbSQWare is developped with GPL License 3.0
# Copyright (C) 2010-2017  dbSQWare SAS
# This program comes with ABSOLUTELY NO WARRANTY.
# This is free software, and you are welcome to redistribute it
# under certain conditions; type 'show l' for details.
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http:/www.gnu.org/licenses/>.
# For information : contact@dbsqware.com or www.dbsqware.com

# SqwVersion=3.1.04

# For help type 'show <-h|-help|--help>'


Installation/configuration de SQWareRepository

Ce chapitre présente la création du référentiel, il s’agit d’une database unique sous MySQL depuis la version v3.0 de dbSQWare.
La volumétrie va dépendre du nombre d’instances traitées, et de certains autres paramétrages comme la profondeur d’historique ou le nombre de lignes de logs remonté en base. Dans la majorité des cas, pour une centaine d’instances gérées et les paramètres par défaut de dbSQWare, la volumétrie ne devrait pas excéder 2 Go en pleine charge (données purement indicatives).

Les installations vont se faire à partir des scripts sql se trouvant dans :

~dbsqware/dbSQWare/SQWareRepository/$TypeSgbd/sql/*.sql


Installation de la database MySql

Ce chapitre part du principe que vous avez déjà un client MySql installé sous le user mysql. Ce client servira également au module SQWareCentral pour se connecter à SQWareRepository et générer les listes d’instances à traiter, par exemple.
Pour exemple, vous pouvez regarder l'annexe « Installation rapide d’une instance MySql » afin de créer l’instance qui hébergera le référentiel sur le point central. Attention, il ne s’agit que d’un exemple, celui-ci peut être créé n’importe où.
On part du principe que nous sommes connectés sous unix avec le user mysql pour ce chapitre.

Création de la database et des users (exemple) :

[root@vmsqwarebox ~]# su - mysql
$ mysql -S /var/lib/mysql/mysql.sock -uroot -PassMys
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 2
Server version: 5.6.27 MySQL Community Server (GPL)

Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> create database dbsqware_db;
Query OK, 1 row affected (0.00 sec)

mysql> GRANT ALL PRIVILEGES ON dbsqware_db.* TO 'dbsqware_user'@'localhost' IDENTIFIED BY 'PassMys';
Query OK, 0 rows affected (0.01 sec)

mysql> GRANT ALL PRIVILEGES ON dbsqware_db.* TO 'dbsqware_user'@'%' IDENTIFIED BY 'PassMys';
Query OK, 0 rows affected (0.00 sec)


Création des objets

La création des objets va se faire à partir du user unix dbsqware. Pour cela, il faut tout d’abord créer le fichier de paramétrage pour l’accès à MySQL.

Voici le contenu que doit avoir le fichier (adaptez-le avec vos credentials) :

dbsqware@vmsqwarebox:/home/dbsqware $ cat /home/dbsqware/dbSQWare/SQWareProduction/generic/etc_cust/.my_SQWareRepository.cnf
[client]
host = vmsqwarebox
port = 3306
database = dbsqware_db
user = dbsqware_user
password = PassMys


Test de connexion au référentiel (avec le fichier) :

dbsqware@vmsqwarebox:/home/dbsqware $ mysql --defaults-file='/home/dbsqware/dbSQWare/SQWareCentral/menu/../../generic/etc_cust/.my_SQWareRepository.cnf'
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 3
Server version: 5.6.27 MySQL Community Server (GPL)

Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> show databases;


Installation du référentiel :

dbsqware@vmsqwarebox:/home/dbsqware $ $gvsqw_SQWareCentralPath/menu/sqwctl_InstallFullRepository.ksh

Sourcing sqwctl_Global.lib v3.1.03 SQWareCentral (dbSQWare GPL v3) ...

eval global vars:
gvsqw_MySqlCnfFile="$gvsqw_GenPath/../../generic/etc_cust/.my_SQWareRepository.cnf" => gvsqw_MySqlCnfFile=/home/dbsqware/dbSQWare/SQWareCentral/menu/../../generic/etc_cust/.my_SQWareRepository.cnf

Checks before install:
SQWareRepository source to install: /home/dbsqware/dbSQWare/SQWareRepository
Connect string to repository:
MySQL_Command="mysql --defaults-file='/home/dbsqware/dbSQWare/SQWareCentral/menu/../../generic/etc_cust/.my_SQWareRepository.cnf'"
[client]
host = vmsqwarebox
port = 3306
database = dbsqware_db
user = dbsqware_user

5.6.27
Major version of Repository, 56, 5.6.27

Checks for install mode (full or patch):
You will make a full install.

Do you want to full install SQWareRepository [y-Y-o-O-n-N]?
Tapez y

...
...
...

Treatment Install SQWareRepository proceeded successfully

Begining     : 16/11/2015 18:25:45
End          : 16/11/2015 18:26:27


Installation/configuration de SQWareWeb

Ce chapitre présente l’installation et la configuration de SQWareWeb.
Nous partons du principe que apache et PHP 5.3 sont installés et opérationnels pour se connecter à MySQL (PHP 5.4 fonctionne également).
Pour déployer apache et PHP 5.3, vous pouvez regarder l'annexe « Installation rapide de apache et PHP5.3 ». Attention, il ne s’agit que d’un exemple, reportez-vous aux sites officiels des outils pour plus d’information http://httpd.apache.org/ et http://www.php.net/.

On part du principe que nous sommes connectés sous unix avec le user dbsqware pour ce chapitre. Nous allons voir une installation de SQWareWeb sur la même machine que SQWareCentral, mais ceci n’est pas une obligation.

Mise en place

Nous avons vu lorsque nous avons déployé les sources de dbSQWare que nous possédions l’arborescence /home/dbsqware/dbSQWare/SQWareWeb. Celle-ci contient les sources du site que nous allons mettre en place.

Vérification des arborescences :

$ cd /home/dbsqware/dbSQWare/SQWareWeb
$ ls -l
total 96
drwxr-x--- 3 dbsqware dba 4096 avr 29 14:48 cache
drwxr-x--- 2 dbsqware dba 4096 avr 29 14:48 css
drwxr-x--- 8 dbsqware dba 4096 avr 29 14:48 custom_ref
drwxr-x--- 6 dbsqware dba 4096 avr 29 14:48 exploit
drwxr-x--- 7 dbsqware dba 4096 avr 29 14:48 htdocs
drwxr-x--- 3 dbsqware dba 4096 avr 29 14:48 images
drwxr-x--- 7 dbsqware dba 4096 avr 29 14:48 js
drwxr-x--- 3 dbsqware dba 4096 avr 29 14:48 lib
-rwxr-x--- 1 dbsqware dba   22 avr 29 14:48 phpinfo.php
drwxr-x--- 2 dbsqware dba 4096 avr 29 14:48 scripts
drwxr-x--- 2 dbsqware dba 4096 avr 29 14:48 templates
-rwxr-x--- 1 dbsqware dba 1509 avr 29 14:48 test.php


Mettez en place le VirtualHost apache pour le site. Encore une fois, il ne s’agit ici que d’un exemple que vous pouvez customiser (avec le user root, adaptez si besoin).

$ cat /etc/httpd/conf.d/httpd-vhosts.conf
<Directory "/home/dbsqware/dbSQWare/SQWareWeb">
    Options Indexes FollowSymLinks
    AllowOverride All
    Order allow,deny
    Allow from all
</Directory>
<Directory "/data/oracle/awr">
    Options Indexes FollowSymLinks
    AllowOverride All
    Order allow,deny
    Allow from all
</Directory>
<VirtualHost *:80>
    DocumentRoot /home/dbsqware/dbSQWare/SQWareWeb
    ServerName vmsqwarebox
    ServerAlias vmsqwarebox webdba
</VirtualHost>
[root@vmsqwarebox ~]# service httpd restart
Arrêt de httpd :                                           [  OK  ]
Démarrage de httpd :                                       [  OK  ]


Mettez en place l’arborescence de customisation par défaut.

$ cd /home/dbsqware/dbSQWare/SQWareWeb/exploit/bin
$ ./PatchCustom.ksh
$ cd /home/dbsqware/dbSQWare/SQWareWeb/custom
$ ls -l
total 92
drwxr-xr-x 2 dbsqware dba 4096 Jun 16 07:19 cassandra
drwxr-xr-x 2 dbsqware dba 4096 Sep  2  2014 db2
drwxr-xr-x 2 dbsqware dba 4096 Sep  2  2014 generic
-rwxr-x--- 1 dbsqware dba   32 Jul 20  2014 GlobalHead.html
drwxr-xr-x 2 dbsqware dba 4096 Sep  2  2014 hbase
-rwxr-x--- 1 dbsqware dba 7404 Jul 20  2014 home.html
drwxr-xr-x 2 dbsqware dba 4096 Aug 28 10:30 images
-rwxr-x--- 1 dbsqware dba  188 Aug 28 10:28 index.html
-rwxr-x--- 1 dbsqware dba 2228 Aug 28 10:27 menu.ini
...
...


Personnalisation

Paramétrez l’accès au référentiel (SQWareRepository) dans le fichier suivant :

/home/dbsqware/dbSQWare/SQWareWeb/custom/menu.ini


Exemple pour notre installation :

[db]
MysqlHost="vmsqwarebox"
MysqlUser="dbsqware_user"
MysqlPass="PassMys"
MysqlDb="dbsqware_db"
MysqlPort=3306


Commentez (mettre un ; en début de ligne) les types de SGBD que vous ne voulez pas voir apparaitre dans le menu du haut en modifiant le fichier suivant (section [menu_databases]) :

/home/dbsqware/dbSQWare/SQWareWeb/custom/menu.ini


Exemple pour ne faire apparaitre que MsSql, Oracle, Sybase et MySQL (laissez « generic » pour la vue multi-SGBD) :

[menu_databases]
db1="mssql"
db2="oracle"
db3="sybase"
db4="mysql"
;db5="ingres"
;db6="postgres"
;db7="db2"
db8="generic"
;db9="sybrep"
;db10="mongodb"
;db11="cassandra"
;db12="hbase"

Remplacez le fichier suivant par votre logo :

/home/dbsqware/dbSQWare/SQWareWeb/custom/images/client.png
Vous pouvez personnaliser le message de la page d’accueil en modifiant le fichier suivant :
<pre>
/home/dbsqware/dbSQWare/SQWareWeb/custom/index.html

Vous devez maintenant pouvoir afficher la page web suivante http://vmsqwarebox (avec votre logo) :
SQWareWeb.png
Cet affichage vous permet de valider si le socle est paramétré correctement pour le web.

En cas d’erreur, vous pouvez jouer avec les paramètres de « debug » du menu.ini afin de tenter de trouver le problème :

;debug=true
;debug_before_connectdb=true
;debug_connectdb_error=true


Paramétrages spécifiques

Pour Oracle

Si vous mettez en place la génération des rapports AWR avec SQWareProduction (attention aux licences), vous devez créer un lien symbolique à la racine du site vers le répertoire contenant les rapports statiques (paramétré dans SQWareProduction pour Oracle).

$ cd /home/dbsqware/dbSQWare/SQWareWeb
$ ln -s /data/oracle/awr sqw_oracle_awr
$ ls -l sqw_oracle_awr
lrwxrwxrwx 1 dbsqware dba 16 jun 12 19:01 sqw_oracle_awr -> /data/oracle/awr


Pour MySql

Si vous mettez en place la rotation des fichiers SlowQuery avec SQWareProduction (uniquement disponible sous unix), vous devez créer un lien symbolique à la racine du site vers le répertoire contenant les rapports statiques (paramétré dans SQWareProduction pour MySql).

$ cd /home/dbsqware/dbSQWare/SQWareWeb
$ ln -s /data/mysql/SlowQuery sqw_mysql_slow
$ ls -l sqw_mysql_slow
lrwxrwxrwx 1 dbsqware dba 21 jun 12 19:05 sqw_mysql_slow -> /data/mysql/SlowQuery


Droits d’accès à SQWareWeb

Pour accéder à la console SQWareWeb, vous devez paramétrer les droits d’accès.
Il existe trois niveaux d’accès :

  • En lecture (accès uniquement aux indicateurs)
  • En admin (accès avec droits de modification du paramétrage SQWareRepository)
  • En lecture/admin (accès en lecture seule au paramétrage SQWareRepository)


Un compte d’admin est créé par défaut à l’installation :

User = default_admin
Pass = OctopusDBA.001


Vous avez deux façons de gérer les droits, par l’interface d’admin de SQWareWeb avec un user possédant le droit admin ou directement par ordres sql en database.

Par la console d’admin

Allez dans la console d’admin, soit directement :

http://vmsqwarebox/templates/adminAccessLogins_general.html

Soit en cliquant sur le petit icône entre « is connected » et « (log off) » :

AdminConsole.png
Puis « Access » et « Login » …

Directement en sql

Suppression du user d’admin par défaut :

delete from tsqw_AdminLoginsPrivs where id_usr_grantee=1;
delete from tsqw_AdminLogins where username='default_admin';

Création d’un user de visu :
insert into tsqw_AdminLogins (username,lastname,firstname,passwd, cre_date, upd_date, pwd_date, dbaname)
values ('viewer', 'Viewer', 'Viewer', SHA1('View!Sec@'), now(), now(), now(), 'init');

Création d’un user d’admin :
insert into tsqw_AdminLogins (username,lastname,firstname,passwd, cre_date, upd_date, pwd_date, dbaname)
values ('myadmin', 'Adm', 'My', SHA1('P@dm!n'), now(), now(), now(), 'init')
;
insert into tsqw_AdminLoginsPrivs (id_usr_grantee,id_grp_granted,dbaname,comments,upd_date)
select id_usr_grantee, id_grp_granted, dbaname, comments, upd_date
from
	(select id_usr as id_usr_grantee from tsqw_AdminLogins where username='myadmin') gadm,
	(select id_grp as id_grp_granted from tsqw_AdminGroups where groupname='DBA') gdba,
	(select 'myadmin' as dbaname, 'Init dbSQWare' as comments, now() as upd_date from dual) com
;

Crontab du user dbsqware unix pour SQWareCentral

Voici la cron classique que l’on met en place sur le user dbsqware :

############
### Generic cron for SQWareCentral
############
# Generate all ref files (RefFileInstances,RefFileDb,RefFileCMDB,...)
00 02,08    * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_GenRef_AllFiles.ksh 2>&1 >$HOME/admin/SQWareCentral/logs/sqwctl_GenRef_AllFiles.log'
# Check indicators
00 07       * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_CheckIndicators.ksh 2>&1 >$HOME/admin/SQWareCentral/logs/sqwctl_CheckIndicators.log'
# Gather indicators
00 03       * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_GatherIndicators.ksh 2>&1 >$HOME/admin/SQWareCentral/logs/sqwctl_GatherIndicators.log'
# Retry gather indicators if not exists
00 09,12,17 * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_GatherIndicators.ksh Repind 2>&1 >$HOME/admin/SQWareCentral/logs/sqwctl_GatherIndicators_Repind.log'

Voir le contenu du fichier suivant :
/home/dbsqware/dbSQWare/SQWareCentral/action/generic/etc/CrontabRef.cfg