Général:InstallationSocle

Sommaire

1 Généralités
- 1.1 Limites de cette section
- 1.2 Rappel de la structure de l’outil
2 Installation de l’infrastructure centrale

Généralités

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 https://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 Rocky Linux 9.3 64bits sur une VM (2 vCPU et 4 Go de RAM) avec 100 Go de disque (Permet de tenir 2 ans d'historique pour une centaine d'instances). 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.

Anciennes versions :

Lien vers le socle CentOS 7
Lien vers le socle Rocky 8

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>=5.6 ou MariaDB>=10.1, MariaDB 10.11 conseillé)
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), MySQL (mysql) et PostgreSQL (postgres).
N’utilisez que les commandes pour le(s) SGBD qui vous intéresse et/ou adaptez les commandes pour les autres SGBD.

Caractéristiques de la VM

Rocky Linux release 9.3 (Green Obsidian) 64 bits.

Dimensionnement VM:

   2 vCPU
   4 Go de RAM
   2 Go de swap
 100 Go de disque

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
Rocky Linux release 9.3 (Blue Onyx)

Configuration disque :

[root@vmsqwarebox ~]# vgs
  VG      #PV #LV #SN Attr   VSize   VFree
  data_vg   1   5   0 wz--n- <60.91g  20.83g
  root_vg   1   4   0 wz--n-  37.50g <20.48g

[root@vmsqwarebox ~]# df -h
Filesystem                   Size  Used Avail Use% Mounted on
devtmpfs                     1.9G     0  1.9G   0% /dev
tmpfs                        1.9G     0  1.9G   0% /dev/shm
tmpfs                        1.9G  8.7M  1.9G   1% /run
tmpfs                        1.9G     0  1.9G   0% /sys/fs/cgroup
/dev/mapper/root_vg-root      10G  1.7G  8.4G  17% /
/dev/sda2                   1014M  245M  770M  25% /boot
/dev/sda1                    599M  5.8M  594M   1% /boot/efi
/dev/mapper/root_vg-var      5.0G  379M  4.7G   8% /var
/dev/mapper/data_vg-applis   5.0G   69M  5.0G   2% /applis
/dev/mapper/data_vg-data      15G  140M   15G   1% /data
/dev/mapper/data_vg-home      10G  105M  9.9G   2% /home
/dev/mapper/data_vg-backups   10G  105M  9.9G   2% /backups
tmpfs                        374M     0  374M   0% /run/user/0

[root@vmsqwarebox ~]# free
              total        used        free      shared  buff/cache   available
Mem:        3825740      314080     1493080        8868     2018580     3237608
Swap:       2097148           0     2097148

Mettre l’OS à la dernière version de patch :

[root@vmsqwarebox ~]# dnf update

Desactivation FW et SELinux :

# Desactivation du FW !
systemctl disable firewalld
systemctl stop firewalld

# Desactivation SELINUX
#Verif
/usr/sbin/getenforce
Enforcing

vi /etc/sysconfig/selinux
SELINUX=enforcing => SELINUX=disabled (reboot)
shutdown -r now

#Sans reboot
/usr/sbin/setenforce 0

#Verif
/usr/sbin/getenforce
Disabled

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) :

#Si besoin installation des locales
dnf install langpacks-en glibc-all-langpacks -y

#Passage en anglais (plus facile pour les messages !)
localectl
localectl set-locale LANG=en_US.UTF-8

localectl
   System Locale: LANG=fr_FR.UTF-8
       VC Keymap: fr-oss
      X11 Layout: fr
     X11 Variant: oss
localectl set-locale LANG=en_US.UTF-8
localectl
   System Locale: LANG=en_US.UTF-8
       VC Keymap: fr-oss
      X11 Layout: fr
     X11 Variant: oss

#Clavier fr (temp)
loadkeys fr

#Une petite astuce, si votre clavier est en QWERTY, tapez les touches suivantes de votre clavier
loqdeys fr

localectl status
localectl list-keymaps | grep fr

localectl set-keymap fr
localectl set-x11-keymap fr

localectl status
   System Locale: LANG=en_US.UTF-8
       VC Keymap: fr
      X11 Layout: fr

#Vous pouvez vérifier si vous avez le bon fuseau horaire
timedatectl
               Local time: Wed 2024-04-24 07:19:51 EDT
           Universal time: Wed 2024-04-24 11:19:51 UTC
                 RTC time: Wed 2024-04-24 11:19:51
                Time zone: America/New_York (EDT, -0400)
System clock synchronized: yes
              NTP service: active
          RTC in local TZ: no

#Si vous voulez le changer
rm -rf /etc/localtime
timedatectl set-timezone Europe/Paris

timedatectl
               Local time: Wed 2024-04-24 13:20:44 CEST
           Universal time: Wed 2024-04-24 11:20:44 UTC
                 RTC time: Wed 2024-04-24 11:20:44
                Time zone: Europe/Paris (CEST, +0200)
System clock synchronized: yes
              NTP service: active
          RTC in local TZ: no

Install et activation du NTP (on utilise Chrony):

#Install et activation de Chrony
dnf install -y chrony

#Check config of chronyd (old ntpd)
cat /etc/chrony.conf

#Utilisez un pool de serveurs proche, ex:
pool 0.europe.pool.ntp.org iburst

#Start et activation du démarrage auto
systemctl enable --now chronyd

#If Firewalld is running, allow NTP service. NTP uses [123/UDP].
firewall-cmd --add-service=ntp
success
firewall-cmd --runtime-to-permanent
success

#On relance le service
systemctl restart chronyd

#Vérifier le status du service
systemctl is-enabled chronyd
enabled

systemctl status chronyd
  chronyd.service - NTP client/server
   Loaded: loaded (/usr/lib/systemd/system/chronyd.service; enabled; vendor preset: enabled)
...

Installation de RPM qui vont servir par la suite !

Many EPEL packages require the CodeReady Builder (CRB) repository.
It is recommended that you run /usr/bin/crb enable to enable the CRB repository.

dnf install -y open-vm-tools
dnf install -y nmap bind-utils ksh rsync openssh-server openssl-devel openssl
dnf install -y epel-release binutils net-tools telnet control-center gcc gcc-c++ glibc glibc-common libstdc++ libstdc++-devel make sysstat s-nail postfix cyrus-sasl cyrus-sasl-lib cyrus-sasl-plain cyrus-sasl-scram cyrus-sasl-md5  cyrus-sasl-ntlm

## Pour client Oracle 19c (mais pas que !)
dnf install -y zip unzip git wget mlocate nano binutils.x86_64 gcc.x86_64 gcc-c++.x86_64 glibc.i686 glibc.x86_64 glibc-devel.i686 glibc-devel.x86_64 ksh libaio.i686 libaio.x86_64 libaio-devel.i686 libaio-devel.x86_64 libgcc.i686 libgcc.x86_64 libstdc++.i686 libstdc++.x86_64 libstdc++-devel.i686 libstdc++-devel.x86_64 libXi.i686 libXi.x86_64 libXtst.i686 libXtst.x86_64 make.x86_64 sysstat.x86_64

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.
Exemple de commande de vérification :

$ rpm -q gcc
gcc-11.4.1-2.1.el9.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-11.4.1-2.1.el9 (x86_64)

Ou directement dans la ligne de commande :

$ rpm -q gcc --queryformat '%{name}-%{release}  %{version}  (%{arch})\n'
gcc-2.1.el9  11.4.1  (x86_64)

Exemple de sortie lorsqu’un RPM manque :

[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 /]# dnf install libXpm-devel ksh binutils gcc gcc-c++ glibc glibc-common libstdc++ libstdc++-devel make sysstat

##Conf et activation du mail (modif relayhost)
vi /etc/postfix/main.cf
systemctl start postfix
systemctl enable postfix
systemctl status postfix

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/bash -d /home/dbsqware dbsqware
useradd -g dba -s /bin/bash -d /home/oracle oracle
useradd -g dba -s /bin/bash -d /home/sybase sybase
useradd -g dba -s /bin/bash -d /home/mssql mssql
useradd -g dba -s /bin/bash -d /home/mysql mysql
useradd -g dba -s /bin/bash -d /home/postgres postgres

Affectation d’un mot de passe aux users :

passwd dbsqware
passwd oracle
passwd sybase
passwd mssql
passwd mysql
passwd postgres

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 postgres

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 postgres dba 4096 mai 13 21:54 postgres
drwxr-x--- 3 sybase   dba 4096 mai 13 21:54 sybase

Mettre le user dbsqware en 'sudo ALL' pour faciliter la mise en œuvre et l'exploitation :

## Add sudo
cp -p /etc/sudoers /etc/sudoers.back
vi /etc/sudoers

root@vmsqwarebox:/root # grep wheel /etc/sudoers
## Allows people in group wheel to run all commands
# %wheel        ALL=(ALL)       ALL
%wheel  ALL=(ALL)       NOPASSWD: ALL

id dbsqware
uid=1000(dbsqware) gid=1000(dba) groups=1000(dba)

usermod -a -G wheel dbsqware
id dbsqware
uid=1000(dbsqware) gid=1000(dba) groups=1000(dba),10(wheel)

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
mkdir -p /applis/postgres
chown postgres:dba /applis/postgres

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
mkdir -p /data/postgres
chown postgres:dba /data/postgres
mkdir -p /data/dbsqware/admin/AsynchronousFiles /data/dbsqware/admin/AsynchronousFilesTmp /data/dbsqware/admin/AsynchronousFilesArch
chown -R dbsqware:dba /data/dbsqware/admin
# 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
mkdir -p /backups/dbsqware
chown dbsqware:dba /backups/dbsqware
mkdir -p /backups/postgres
chown postgres:dba /backups/postgres

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
drwxr-xr-x 2 postgres dba 4096 mai 14 04:06 postgres
[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
drwxr-xr-x 2 postgres dba 4096 mai 14 04:06 postgres
[root@vmsqwarebox /]# ls -l /backups
total 32
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
drwxr-xr-x 2 postgres dba 4096 mai 14 04:06 postgres

Clés ssh

Préparation des clés ssh pour dbsqware
Directement depuis le user root :

su - dbsqware -c "
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 postgres'`
do
su - $lvsqw_User -c "
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
ssh-keygen -t rsa -N '' -f $HOME/.ssh/id_rsa
chmod go-w $HOME
echo "$lvsqw_SshKey_dbsqware" >>$HOME/.ssh/authorized_keys
chmod 700 $HOME/.ssh
chmod 600 $HOME/.ssh/authorized_keys

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

[root@vmsqwarebox home]# su - dbsqware
$ id
uid=1000(dbsqware) gid=1000(dba) groupes=1000(dba),10(wheel)
$ ssh oracle@vmsqwarebox
$ id
uid=1001(oracle) gid=1000(dba) groupes=1000(dba)
$ 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=1001(oracle) gid=1000(dba) groupes=1000(dba)
$ exit
Connection to vmsqwarebox closed.
$ exit
Connection to vmsqwarebox closed.

Les fichiers d’environnement

Mise en place d'un .bash_profile et .bashrc pour tous les users :

cat <<EOFCAT >/tmp/.vimrc
syntax off
set mouse-=a
set noai
EOFCAT
cat <<EOFCAT >/tmp/.bash_profile
# .bash_profile

# Get the aliases and functions
if [ -f ~/.bashrc ]; then
	. ~/.bashrc
fi

# User specific environment and startup programs
export PATH=/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:/usr/ccs/bin:/usr/local/sbin:/usr/openwin/bin
EOFCAT
cat <<EOFCAT >/tmp/.bashrc
# Source global definitions
# if [ -f /etc/bashrc ] && [ \$(ps -p \$\$|grep -c 'bash') -ne 0 ] ; then
	# . /etc/bashrc
# fi
unalias ls 2>/dev/null
alias ll='ls -al'
alias lt='ls -alrt'
set -o vi
EOFCAT
chmod 777 /tmp/.bash_profile /tmp/.bashrc /tmp/.vimrc

for lvsqw_User in `echo 'dbsqware oracle sybase mssql mysql postgres root'`
do
su - $lvsqw_User -c "
cp /tmp/.vimrc \$HOME/.
cp /tmp/.bash_profile \$HOME/.
cp /tmp/.bashrc \$HOME/.
cd
ln -s .bash_profile .profile
chmod 640 \$HOME/.vimrc
chmod 640 \$HOME/.bash_profile
chmod 640 \$HOME/.bashrc"
done
rm -f /tmp/.bash_profile /tmp/.bashrc

cat <<EOCAT >> $HOME/.bashrc
export PS1="\`id| cut -d')' -f1| cut -d'(' -f2\`@\$(hostname|cut -d '.' -f1):"'\$PWD # '
EOCAT

for lvsqw_User in `echo 'oracle sybase mssql mysql postgres'`
do
su - $lvsqw_User -c "
ln -s /home/dbsqware/dbSQWare/SQWareProduction \$HOME/SQWareProduction"
done

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 .bashrc
-rw-r----- 1 dbsqware dba    13 May 14 05:30 .bash_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 .bashrc
-rw-r----- 1 mssql dba    13 May 14 05:30 .bash_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 .bashrc
-rw-r----- 1 mysql dba    13 May 14 05:30 .bash_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 .bashrc
-rw-r----- 1 oracle dba    13 May 14 05:30 .bash_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 .bashrc
-rw-r----- 1 sybase dba    13 May 14 05:30 .bash_profile
drwx------ 2 sybase dba  4096 May 14 05:16 .ssh

/home/postgres:
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 .bashrc
-rw-r----- 1 sybase dba    13 May 14 05:30 .bash_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 postgres'`
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"
elif [ "$TrigrammeSgbd" = "Pos" ]
then
TrigrammeSgbd="Pg"
lvsqw_tmp="pg"
fi
echo "Traitement du SGBD: '$lvsqw_Sgbd', '$TrigrammeSgbd'"
cat <<EOFCAT >> /home/$lvsqw_Sgbd/.bash_profile

# env dbSQWare pour $lvsqw_Sgbd, must stay at end of .bash_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

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 12
lrwxrwxrwx  1 dbsqware dba   24 Apr 15 13:04 generic -> SQWareProduction/generic
drwxr-x--- 16 dbsqware dba 4096 Apr 15 13:04 SQWareCentral
drwxr-x--- 15 dbsqware dba  192 Apr 15 13:04 SQWareProduction
drwxr-x--- 17 dbsqware dba 4096 Apr 15 13:04 SQWareRepository
drwxr-x--- 11 dbsqware dba  185 Apr 15 13:04 SQWareWeb
-rwxr-x---  1 dbsqware dba    9 Apr 15 13:04 SQW_VERSION

Configuration du profile du user dbsqware pour SQWareCentral

Mise en place des conf par defaut:

cat <<EOFCAT >/home/dbsqware/dbSQWare/SQWareCentral/etc_cust/sqwctl_GlobalVar.cfg
export gvsqw_AsynchronousFilesDir="/data/dbsqware/admin/AsynchronousFiles"
export gvsqw_AsynchronousFilesDirTmp="/data/dbsqware/admin/AsynchronousFilesTmp"
export gvsqw_AsynchronousFilesDirArch="/data/dbsqware/admin/AsynchronousFilesArch"
EOFCAT
chmod 750 /home/dbsqware/dbSQWare/SQWareCentral/etc_cust/sqwctl_GlobalVar.cfg

#Mettre la bonne adresse mail !
cat <<EOFCAT >/home/dbsqware/dbSQWare/SQWareProduction/generic/etc_cust/sqwgen_GlobalVar.cfg
#Put NoNail in gvsqw_GlobalMail if you don't want to send mail on error
export gvsqw_GlobalMail='dba@mydomane.com'

#for SQWareWeb
export gvsqw_WebDbaURL="https://$(hostname)"
export gvsqw_WebDbaUser='dbsqware@$(hostname)'

EOFCAT
chmod 750 /home/dbsqware/dbSQWare/SQWareProduction/generic/etc_cust/sqwgen_GlobalVar.cfg

ln -s /data/dbsqware/admin/AsynchronousFilesArch /home/dbsqware/dbSQWare/SQWareWeb/sqw_logdir
ln -s /data/mysql/SlowQuery sqw_mysql_slow
ln -s /data/oracle/awr sqw_oracle_awr

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

dbsqware@vmsqwarebox:/home/dbsqware $ cat .bash_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 .bash_profile du user et vous devez avoir un résultat de ce type:

dbsqware@vmsqwarebox:/home/dbsqware $ . ~/.bash_profile
     _ _    ____   _____        __
  __| | |__/ ___| / _ \ \      / /_ _ _ __ ___
 / _` | '_ \___ \| | | \ \ /\ / / _` | '__/ _ \
| (_| | |_) |__) | |_| |\ V  V / (_| | | |  __/
 \__,_|_.__/____/ \__\_\ \_/\_/ \__,_|_|  \___|

###################################################################
# SQWareCentral module of dbSQWare
# Copyright (C) 2010-2024, dbSQWare (www.dbsqware.com)
# dbSQWare is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# CGU/CGA for more details.
# You should have received a copy of the CGU/CGA
# along with this program.  If not, see <https://www.dbsqware.com/licenses/>.
# For information : contact@dbsqware.com or www.dbsqware.com
###################################################################
# SqwVersion=2024.03

# 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 MariaDB>=10.1 ... (MariaDB 10.11 recommandé et sur la sqwarebox fournie)
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 15 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 MariaDB

Ce chapitre part du principe que vous avez déjà un client MySQL/MariaDB 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 MariaDB » 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 -uroot -pPassMys
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 5
Server version: 10.6.12-MariaDB-log MariaDB Server

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

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

 (root@localhost) [(none)]> create database dbsqware_db;
Query OK, 1 row affected (0.00 sec)

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

 (root@localhost) [(none)]> exit
Bye
mysql@vmsqwarebox:/home/mysql () $ exit
logout
[root@vmsqwarebox ~]# exit
logout

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 à MariaDB/MySQL.

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

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

chmod 640 /home/dbsqware/dbSQWare/SQWareCentral/etc_cust/.my_SQWareRepository.cnf

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

dbsqware@vmsqwarebox:/home/dbsqware $ mysql --defaults-file='/home/dbsqware/dbSQWare/SQWareCentral/etc_cust/.my_SQWareRepository.cnf'
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 4
Server version: 11.4.2-MariaDB-log MariaDB Server

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

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

MariaDB [dbsqware_db]> show databases;
+--------------------+
| Database           |
+--------------------+
| dbsqware_db        |
| information_schema |
+--------------------+
2 rows in set (0.001 sec)

Installation du référentiel :

dbsqware@vmsqwarebox:/home/dbsqware $ dbspatch


     _ _    ____   _____        __
  __| | |__/ ___| / _ \ \      / /_ _ _ __ ___
 / _` | '_ \___ \| | | \ \ /\ / / _` | '__/ _ \
| (_| | |_) |__) | |_| |\ V  V / (_| | | |  __/
 \__,_|_.__/____/ \__\_\ \_/\_/ \__,_|_|  \___|

###################################################################
# SQWareCentral module of dbSQWare
# Copyright (C) 2010-2024, dbSQWare (www.dbsqware.com)
# dbSQWare is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# CGU/CGA for more details.
# You should have received a copy of the CGU/CGA
# along with this program.  If not, see <https://www.dbsqware.com/licenses/>.
# For information : contact@dbsqware.com or www.dbsqware.com
###################################################################
# SqwVersion=2024.03

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


Create tree for custom dir ...
create directory /home/dbsqware/dbSQWare/SQWareCentral/../SQWareWeb/exploit/bin/../../custom
create directory /home/dbsqware/dbSQWare/SQWareCentral/../SQWareWeb/exploit/bin/../../custom/images

Copy ref files to custom if not exists ...
copy /home/dbsqware/dbSQWare/SQWareCentral/../SQWareWeb/exploit/bin/../../custom_ref/authentication_custom.php on /home/dbsqware/dbSQWare/SQWareCentral/../SQWareWeb/exploit/bin/../../custom/authentication_custom.php
copy /home/dbsqware/dbSQWare/SQWareCentral/../SQWareWeb/exploit/bin/../../custom_ref/images/client.png on /home/dbsqware/dbSQWare/SQWareCentral/../SQWareWeb/exploit/bin/../../custom/images/client.png
copy /home/dbsqware/dbSQWare/SQWareCentral/../SQWareWeb/exploit/bin/../../custom_ref/GlobalHead.html on /home/dbsqware/dbSQWare/SQWareCentral/../SQWareWeb/exploit/bin/../../custom/GlobalHead.html
copy /home/dbsqware/dbSQWare/SQWareCentral/../SQWareWeb/exploit/bin/../../custom_ref/sqwareweb.ini on /home/dbsqware/dbSQWare/SQWareCentral/../SQWareWeb/exploit/bin/../../custom/sqwareweb.ini
Sourcing sqwctl_Global.lib v2024.03 SQWareCentral (dbSQWare) ...
touch: cannot touch '/.sqw': Permission denied


eval global vars:
gvsqw_RsyncDefaultUser="$gvsqw_UserExec@RsyncHost" => gvsqw_RsyncDefaultUser=dbsqware@RsyncHost

Checks before install:
SQWareRepository source to install: /home/dbsqware/dbSQWare/SQWareRepository
Connect string to repository:
MySQL_Command="mysql --defaults-file='/home/dbsqware/dbSQWare/SQWareCentral/etc_cust/.my_SQWareRepository.cnf'"
[client]
host = vmsqwarebox
port = 3306
database = dbsqware_db
user = dbsqware_user
10.6.12-MariaDB-log
Major version of Repository, 106, 10.6.12

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

...
...
...

Job Install SQWareRepository proceeded successfully

Begining     : 2024-04-15 12:13:31
End          : 2024-04-15 12:15:04
Duration     : 00:01:33

Installation/configuration de SQWareWeb

Ce chapitre présente l’installation et la configuration de SQWareWeb.
Nous partons du principe que apache et PHP 8.2 sont installés et opérationnels pour se connecter à MariaDB/MySQL (PHP >= 7.4 et 8.x fonctionnent également en principe).
Pour déployer apache et PHP 8.2, vous pouvez regarder l'annexe « Installation rapide de apache et PHP 8.2 ». Attention, il ne s’agit que d’un exemple, reportez-vous aux sites officiels des outils pour plus d’information https://httpd.apache.org/ et https://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 24
drwxr-x---  2 dbsqware dba   70 Nov 29 19:46 css
drwxr-xr-x  3 dbsqware dba   64 Dec  8 14:50 custom
drwxr-x---  3 dbsqware dba   64 Nov 29 19:46 custom_ref
drwxr-x---  6 dbsqware dba   60 Nov 29 19:46 exploit
drwxr-x--- 19 dbsqware dba  322 Nov 29 19:46 htdocs
drwxr-x---  2 dbsqware dba 8192 Nov 29 19:46 images
drwxr-x--- 14 dbsqware dba  177 Nov 29 19:46 jobs_help
drwxr-x---  5 dbsqware dba  239 Nov 29 19:46 js
drwxr-x---  3 dbsqware dba 4096 Nov 29 19:46 lib
-rwxr-x---  1 dbsqware dba   22 Nov 29 19:46 phpinfo.php
lrwxrwxrwx  1 dbsqware dba   42 Dec  8 14:54 sqw_logdir -> /data/dbsqware/admin/AsynchronousFilesArch
lrwxrwxrwx  1 dbsqware dba   21 Dec  8 14:54 sqw_mysql_slow -> /data/mysql/SlowQuery
lrwxrwxrwx  1 dbsqware dba   16 Dec  8 14:54 sqw_oracle_awr -> /data/oracle/awr
drwxr-x---  2 dbsqware dba  214 Nov 29 19:46 templates
-rwxr-x---  1 dbsqware dba 1274 Nov 29 19:46 test.php

Conf http

Mettez en place le VirtualHost apache pour le site (si vous ne tournez qu'en http). 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
    Require all granted
</Directory>
<Directory "/data/oracle/awr">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>
<VirtualHost *:80>
    DocumentRoot /home/dbsqware/dbSQWare/SQWareWeb
    ServerName vmsqwarebox
    ServerAlias vmsqwarebox vmsqwareboxRocky9 webdba
</VirtualHost>

[root@vmsqwarebox ~]# systemctl restart httpd

Conf https (attention, vous devez mettre un certificat ssl en place)

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


## Generate SSL Certificate : To generate a new self-signed certificate with 365 days expiry, run:
[root@vmsqwarebox ~]# openssl req -newkey rsa:2048 -nodes -keyout /etc/pki/tls/private/dbsqware_selfsigned.key -x509 -days 3650 -out /etc/pki/tls/certs/dbsqware_selfsigned.crt

Generating a RSA private key
........................................................................................................................................+++++
...............................+++++
writing new private key to '/etc/pki/tls/private/dbsqware_selfsigned.key'
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
# Country Name (2 letter code) [XX]:Fr
# State or Province Name (full name) []:France
# Locality Name (eg, city) [Default City]:Gardanne
# Organization Name (eg, company) [Default Company Ltd]:dbSQWare - self-signed
# Organizational Unit Name (eg, section) []:SQWareWeb SSL
# Common Name (eg, your name or your server's hostname) []:webdba
# Email Address []:myadress@mydomain

[root@vmsqwarebox ~]# ls -l /etc/pki/tls/private/dbsqware_selfsigned.key /etc/pki/tls/certs/dbsqware_selfsigned.crt
-rw-r--r--. 1 root root 1497 Apr 19 15:32 /etc/pki/tls/certs/dbsqware_selfsigned.crt
-rw-------. 1 root root 1704 Apr 19 15:31 /etc/pki/tls/private/dbsqware_selfsigned.key

## Installation de mod_ssl
[root@vmsqwarebox ~]# dnf install mod_ssl

## activation du module 'mod_ssl' module
[root@vmsqwarebox ~]# systemctl restart httpd

## verification
[root@vmsqwarebox ~]# httpd -t -D DUMP_MODULES| grep ssl
 ssl_module (shared)

## To Redirect All HTTP Traffic To HTTPS
[root@vmsqwarebox ~]# cat /etc/httpd/conf.d/redirect_http.conf
<VirtualHost _default_:80>
    ServerName vmsqwarebox
    ServerAlias vmsqwarebox vmsqwareboxRocky9 webdba
	Redirect permanent / https://webdba/
</VirtualHost>

## vhost https
[root@vmsqwarebox ~]# cat /etc/httpd/conf.d/httpd-vhosts.conf
<Directory "/home/dbsqware/dbSQWare/SQWareWeb">
	Options Indexes FollowSymLinks
	AllowOverride All
	Require all granted
</Directory>
<Directory "/data/oracle/awr">
	Options Indexes FollowSymLinks
	AllowOverride All
	Require all granted
</Directory>
<VirtualHost *:443>
	DocumentRoot /home/dbsqware/dbSQWare/SQWareWeb
	ServerName vmsqwarebox
	ServerAlias vmsqwarebox VMsqwareboxRockyLinux9 webdba
	SSLEngine on
	SSLCertificateFile /etc/pki/tls/certs/dbsqware_selfsigned.crt
	SSLCertificateKeyFile /etc/pki/tls/private/dbsqware_selfsigned.key
</VirtualHost>

[root@vmsqwarebox ~]# systemctl reload httpd

Personnalisation

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

vi /home/dbsqware/dbSQWare/SQWareWeb/custom/sqwareweb.ini
[db]
MysqlHost="localhost"
MysqlUser="dbsqware_user"
MysqlPass="PassMys"

Remplacez le fichier suivant par votre logo :

/home/dbsqware/dbSQWare/SQWareWeb/custom/images/client.png

Vous devez maintenant pouvoir afficher la page web suivante https://vmsqwarebox (avec votre logo) :

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

User = default_admin
Pass = YBHim9Ty_PSOvahtSxAU_5SX3QSoNFaC

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 sqwareweb.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)

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 :

https://vmsqwarebox/admin/all/access/adminAccessLogins_general.html

Soit en cliquant sur l'icône « admin » :

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, authentication_type)
values ('viewer', 'Viewer', 'Viewer', SHA1('View!Sec@'), now(), now(), now(), 'init', 'internal');

Création d’un user d’admin :
insert into tsqw_AdminLogins (username,lastname,firstname,passwd, cre_date, upd_date, pwd_date, dbaname, authentication_type)
values ('myadmin', 'Adm', 'My', SHA1('P@dm!n'), now(), now(), now(), 'init', 'internal')
;
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

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

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

###########################
## mm(0-59) hh(0-23) dd(1-31) MM(0-12) DAY(0-sunday, 1-monday, ...) command
## Generic cron for SQWareCentral (dbSQWare)
############
# 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 -NoMail 2>&1 >$HOME/admin/SQWareCentral/logs/sqwctl_GatherIndicators_Repind.log'
############
# Retrieve async files from a dir (configure sqwctl_LoopRetrieveAsynchronousFilesGlobal.cfg in cetc)
20 *        * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_LoopRetrieveAsynchronousFilesGlobal.ksh 2>&1 >$HOME/admin/SQWareCentral/logs/sqwctl_LoopRetrieveAsynchronousFilesGlobal.log'
# Retrieve async files from all instances
15 *        * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_LoopRetrieveAsynchronousFiles.ksh 2>&1 >$HOME/admin/SQWareCentral/logs/sqwctl_LoopRetrieveAsynchronousFiles.log'
45 07,08,09,10,11,12,13,14,15,16,17,18  * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_LoopRetrieveAsynchronousFiles.ksh 2>&1 >$HOME/admin/SQWareCentral/logs/sqwctl_LoopRetrieveAsynchronousFiles.log'
# Exec async files from all instances
30 *        * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_LoopExecAsynchronousFiles.ksh 2>&1 >$HOME/admin/SQWareCentral/logs/sqwctl_LoopExecAsynchronousFiles.log'
10,50 07,08,09,10,11,12,13,14,15,16,17,18  * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_LoopExecAsynchronousFiles.ksh 2>&1 >$HOME/admin/SQWareCentral/logs/sqwctl_LoopExecAsynchronousFiles.log'
########################################################################################################################
### Gather Structures (dbSQWare)
############
## Structures Oracle
#00 05       * * * ksh -c '. ~/.profile 2>&1 >/dev/null;export gvsqw_JobName="Structure";$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T oracle -A GatherStructureOn -F GenLstInstanceOn_SpecJob -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/GatherStructureOracle.log'
## Structures MySQL
#15 05       * * * ksh -c '. ~/.profile 2>&1 >/dev/null;export gvsqw_JobName="Structure";$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T mysql -A GatherStructureOn -F GenLstInstanceOn_SpecJob -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/GatherStructureMySQL.log'
## Structures PostgreSQL
#30 05       * * * ksh -c '. ~/.profile 2>&1 >/dev/null;export gvsqw_JobName="Structure";$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T postgres -A GatherStructureOn -F GenLstInstanceOn_SpecJob -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/GatherStructurePostgreSQL.log'
## Structures MsSql
#45 05       * * * ksh -c '. ~/.profile 2>&1 >/dev/null;export gvsqw_JobName="Structure";$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T mssql -A GatherStructureOn -F GenLstInstanceOn_SpecJob -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/GatherStructureMsSql.log'
## Structures Sybase
#00 06       * * * ksh -c '. ~/.profile 2>&1 >/dev/null;export gvsqw_JobName="Structure";$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T sybase -A GatherStructureOn -F GenLstInstanceOn_SpecJob -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/GatherStructureSybase.log'
########################################################################################################################
### Specific cron for Oracle (dbSQWare)
############
## Check started instances Oracle
#00 06       * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T oracle -A sqwora_StartedInstancesOn.ksh -F GenLstUniqueOn -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/StartedInstancesOracle.log'
## Generate Awr reports in distant mode
#10 09 * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T oracle -A sqwora_GenerateAwrDist.ksh -F sqwora_GenLstInstanceAwrAll.sql -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/ind_ora_awr_dist.log'
## Monitor Awr reports in distant mode
#05 * * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T oracle -A sqwora_MonitorHourlyAwrDist.ksh -F sqwora_GenLstInstanceAwrAll.sql -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/ind_ora_awr_monitor_dist.log'
## Generate Statspack reports in distant mode
#10 09 * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T oracle -A sqwora_GenerateStatspackOld.ksh -F Liste9iStatspack.sql -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/ind_Statspack_awr_old.log'
## Monitor Statspack reports in distant mode
#05 * * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T oracle -A sqwora_MonitorStatspackOld.ksh -F Liste9iStatspack.sql -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/ind_ora_Statspack_monitor_old.log'
########################################################################################################################
### Specific cron for MySql (dbSQWare)
############
## Rotate slow query
#00 07 * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T mysql -A sqwmys_SlowQuery.ksh -F GenLstInstanceOn -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/mysql_slowquery.log'
## Async Rotate slow query
#00 07 * * * ksh -c '. ~/.profile 2>&1 >/dev/null;export gvsqw_JobName="AsyncRotateLog";$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T mysql -A sqwmys_SlowQueryAsync.ksh -F GenLstInstanceOn_SpecJob -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/mysql_Async_slowquery.log'
## Rotate error log
#00 08 * * 6 ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T mysql -A sqwmys_PurgeAlert.ksh -F GenLstInstanceOn -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/mysql_errorlog.log'
########################################################################################################################
### Specific cron for MsSql (dbSQWare)
############
## Rotate errorlog
#01 23 * * * ksh -c '. ~/.profile 2>&1 >/dev/null;$gvsqw_SQWareCentralPath/bin/sqwctl_TrtAuto.ksh -T mssql -A sqwmsq_RotateLog.ksh -F GenLstInstanceOn -Exec 2>&1 >$HOME/admin/SQWareCentral/logs/MssqlRotateLog.log'
########################################################################################################################
### Specific cron for update GLPI (dbSQWare)
############
## Update GLPI MYS_GLPI_PRD
#10 10    * * * ksh -c '. ~/.profile 2>&1 >/dev/null;/home/dbsqware/dbSQWare/SQWareProduction/mysql/tools/sqwmys_UpdateGLPI.ksh -I MYS_GLPI_PRD -D glpi -F /home/dbsqware/dbSQWare/SQWareCentral/etc_cust/RefFileCMDB.csv -Dist 2>&1 >$HOME/admin/SQWareCentral/logs/MajGLPI_PRD_PRD'