General:Commissioning vmsqwarebox

From Wiki_dbSQWare
Revision as of 12:05, 9 April 2025 by Ymauger (talk | contribs) (Generalty)
Jump to: navigation, search

Work In Progress

Generalty


Nuvola apps important.png
Warning:
Before anything, don't go further if you don't have read the first section "dbSQWare Concepts " !.

Limitations of this section

This section shows you how to put into service the pre-configured dbSQWare VM delivered in the form of an ovf.
The vmsqwarebox aims to save you time on installing the central base.

Find the vmsqwarebox download link on the support site, ticket id=95.

VM Features

The vmsqwarebox is configured with IP 192.168.230.28 by default.
This is a Rocky Linux release 64 bits.

Dimensionnement VM:

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


Le mdp de tous les comptes unix et bdd sont à la valeur unique de sqw (pas d'interface graphique !).

Configuration

Système

Modification du nom de la machine (facultatif) :

hostnamectl set-hostname "vmsqwarebox"


Modification de l'IP + DNS :

#Voir les adresses
ip addr

#Modif cartes réseau (IP + DNS)
nmtui


Modification du fichier hosts (conserver l'entree vmsqwarebox avec la bonne IP pour ne pas avoir à tout modifier !) :

vi /etc/hosts


Redémarrer le service réseau :

#CentOS 7
systemctl restart network

Rocky Linux 8 et 9
systemctl restart NetworkManager


Vérifier que tout fonctionne bien avant d'aller plus loin :

#redémarrage de la VM
shutdown -r now


Puis:

  1. Modifier la conf postfix pour quelle soit compatible avec votre environnement
  2. configurer vos DNS pour résoudre l'alias vmsqwarebox ou le nom que vous aurez donné à la VM
  3. vérifiez que l'URL http://vmsqwarebox ou https://vmsqwarebox (le nom que vous aurez donné à la VM) fonctionne


Le user par défaut d'accès à la console est admin et son mdp sqw (n'oubliez pas de le changer !).

Mots de passe + licence

Licence

Effacer les anciens fichiers pour générer la nouvelle clé

Ménage :
dbsqware@vmsqwarebox:/home/dbsqware $ rm -f /home/dbsqware/dbSQWare/SQWareCentral/etc_cust/*.valid
dbsqware@vmsqwarebox:/home/dbsqware $ rm -f /home/dbsqware/dbSQWare/SQWareCentral/etc_cust/*.invalid
dbsqware@vmsqwarebox:/home/dbsqware $ rm -f /home/dbsqware/dbSQWare/SQWareCentral/etc_cust/*.lic

Génération de la nouvelle clé :
$ dbspatch

$ ls -l /home/dbsqware/dbSQWare/SQWareCentral/etc_cust/*.lic
-rw-r--r-- 1 dbsqware dba 295 Dec  8 17:07 /home/dbsqware/dbSQWare/SQWareCentral/etc_cust/yc2eaada-qaba-abav-msqw-areboxqc5edj.lic

=> Donnez le nom de cette clé au support pour qu'il vous transmette une clé valide pour votre environnement !

Comptes unix

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

=> sécurisez en particulier le compte dbsqware car c'est lui qui va pouvoir se connecter sur les autres en ssh

MariaDB

Le compte d'accès MariaDB (user admin, équivalent à root) :

SET PASSWORD FOR 'mysql'@'localhost' = PASSWORD('newpass');
SET PASSWORD FOR 'mysql'@'%' = PASSWORD('newpass');


Le fichier de conf pour le user unix mysql :

echo "[client]
password = newpass
" > $HOME/.my.cnf


Personnalisation

SQWareRepository

Le compte d'accès MariaDB pour remontée des indicateurs :

SET PASSWORD FOR 'dbsqware_user'@'localhost' = PASSWORD('newpassWeb');
SET PASSWORD FOR 'dbsqware_user'@'%' = PASSWORD('newpassWeb');


Si vous changez le nom de la VM et/ou les passwd etc ..., modifiez le fichier suivant :

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


SQWareWeb

Remplacez le fichier suivant par votre logo :

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


Personnaliser l'accès à la db :

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


SQWareProduction

Personnalisation globale a la norme du parc (mail, path, ...) :

/home/dbsqware/dbSQWare/SQWareProduction/generic/etc_cust/sqwgen_GlobalVar.cfg
/home/dbsqware/dbSQWare/SQWareProduction/oracle/etc_cust/sqwora_GlobalVar.cfg
/home/dbsqware/dbSQWare/SQWareProduction/mssql/etc_cust/sqwmsq_GlobalVar.cfg
/home/dbsqware/dbSQWare/SQWareProduction/postgres/etc_cust/sqwpg_GlobalVar.cfg
/home/dbsqware/dbSQWare/SQWareProduction/mysql/etc_cust/sqwmys_GlobalVar.cfg
...

SQWareCentral

Depuis la version 2025.02 vous avez à votre disposition plusieurs prompts que vous pouvez mettre en place par utilisateur.

Augmentation de l'espace

Lorsque vous mettez en place la vmsqwarebox, la machine est taillée au minimum, nous vous conseillons d'augmenter les espaces.
FAQ : Augmentation d'un FS sur la VM CentOS 7

Accès aux bdd clientes

Configurer les flux FW si nécessaire (voir la section « dbSQWare Concepts » qui explique la matrice des flux):

vmsqwarebox => bdd clientes en SQL (classiquement: 1521 pour Oracle, 1433 pour MsSql, 3306 pour MySQL, ...), si besoin, obligatoire pour mssql
vmsqwarebox => hosts des bdd sous unix (ssh port 22) pour avoir 100% des fonctionnalités (inutile pour mssql)


Voici les prérequis pour les machines sur lesquelles on fera tourner SQWareProduction en local (Unix only) :

- vérifier que bash installé
- vérifier que rsync installé
	# il existe des packages pour la plupart des plateformes
	# vérifier qu'il est accéssible par le chemin /usr/bin/rsync (faire un lien symbolique si nécessaire)
- vérifier que sendmail/postfix est paramétré et démarré


Soit en résumé (sous RH ou CentOS):

yum install bash rsync

Soit en résumé (sous Debian ou Ubuntu):

apt install bash rsync