Procédure serveur : gestion des environnements X3 et bases de données ORACLE
LUIS Maxime
Un environnement X3 se définit en plusieurs parties selon le schéma suivant :
L’oracle Listener gère notamment les problèmes d’impressions et d’états (les outils extérieurs à X3).
L’adxadmin est le seul à pouvoir mettre en cohérence la base de donnée oracle avec l’application X3.
Nous travaillerons sur l’environnement x3tv6.
Base de donnée ORACLE
Application X3 Serveur Traitement
Listener CONSOLE X3
Adxadmin
Le fichier initORASID.ora (D :Sage\x3tv6\Database\Scripts) permet par le control_files (première ligne du fichier incluant le chemin du fichier de contrôle de la base) de modifier les paramètres
d’initialisation de la base de données.
Lancement de X3 sous DOS :
-Démarrez l’invite de commandes dans le menu démarrer du serveur.
-Allez dans le dossier bin de X3 à l’aide de la commande cd (cd Sage\x3tv6\Runtime\bin) sur le disque D.
-Tapez la commande env
-Connectez- vous à SQLPLUS à l’aide de la commande sqlplus\nolog
-Connectez-vous ensuite à la base de donnée X3 : connect user/tiger (exemple : connect DEMO/tiger)
Remarque : pour arrêter la base, il suffit de faire la commande shutdown immediate et pour quitter l’interface SQLPLUS, utilisez la commande exit.
A partir d’ici nous sommes connectés au dossier DEMO de l’environnement x3tv6, nous pouvons alors effectuer des commandes SQL en rapport à ce dossier, exemple avec l’instruction « desc ITMMASTER ; » qui permet d’afficher tous les champs de la table ITMMASTER, leurs types et leurs valeurs d’initialisation.
Un autre exemple avec un affichage basique des références articles de la table ITMMASTER, à noter que pour la base de donnée oracle, les champs sont dimensionnés donc il est nécessaire d’appeler son champ en finissant par « _0 », commande SQL : select ITMREF_0 from ITMMASTER ;
Erreurs ORACLE : Un fichier est mis à disposition dans Sage\x3tv6\Database\dump
Le fichier alert_x3tv6 est un historique de toutes les erreurs oracle rencontrées. Il peut être utile lorsqu’on rencontre un problème dont la signification est peu parlante.
Définitions :
-Tablespace : Un lieu de stockage logique pour des données.
-Segment : Un segment contient toutes les données pour une structure spécifique à l’intérieur d’un tablespace : une table, un index, une partition d’une table… Il est composé d’un ou plusieurs extents.
La base de données tourne sur deux Tablespaces essentielles au bon déroulement du dossier X3. Ce fonctionnement se déroule selon le schéma suivant :
Ces deux fichiers contiennent des données très sensibles de la base de données et sont situés dans les dossiers D:\Database\x3tv6\dat et D:\Database\x3tv6\idx. Voici où se trouve par exemple la tablescpace demo_dat :
Dossier DEMO
DEMO_DAT
dat1DEMO_X3TV6.dbf
DEMO_IDX
idxDEMO_X3TV6.dbf
Tablespace
Une table se compose de segments et de blocs de fichiers physiques qui forment des extents, une base de données ORACLE fonctionne comme suit (source : http://perso.telecom-
paristech.fr/~talel/cours/bda/stockage_oracle.pdf):
Sauvegarde :
Tout d’abord, il faut sauvegarder des fichiers physiques contenant l’arborescence en isolant le répertoire DEMO de X3_PUB et dans Dossier sur un support quelconque.
Export ORACE :
Les fichiers .bat permettants un export oracle sont situés dans Sage\Commun\Bin\Exports_Oracle
La commande de l’export ORACLE se fait via l’invite de commande : exp
nom_du_dossier/mot_de_passe file=nom_du_dossier.dmp log=nom_du_dossier.log consistent= y compress=n statistics=none
L’exportation va alors débuter et vous aurez une suite d’instructions comme celle-ci :
L’exportation s’est passée sans problème.
Les fichiers d’exportations sont un .dmp et un .log situés dans le répertoire d’exécution de la commande (ici nous étions dans x3tv6\Runtime\bin donc ces fichiers sont bien présents dans ce répertoire) :
Le fichier DEMO.log est un historique de la commande exécutée :
La commande devrait s’exécuter normalement dans le répertoire Sage\x3tv6\Dossiers\DEMO\SVG, je vais donc déplacer ces deux fichiers dans ce répertoire.
Le fichier de sauvegarde est prêt il suffit d’importer les données à présent.
Import de la base :
Il existe deux façons d’importer notre base de données Sage X3, la première consiste à utiliser la Console X3 et c’est la manière la plus simple mais la plus lente. Pour des soucis d’optimisation, certains préfèrent l’import manuel qui reprend toutes les étapes de la console mais manuellement.
Cette solution est beaucoup plus complexe mais plus efficace par rapport aux gains de temps.
Etapes de la console :
Après avoir démarré la console, allez dans « Importer une solution » et entrez les informations de votre ou de vos serveurs afin de communiquer d’un environnement à un autre (ici de l’X3PV6 à l’X3TV6). Entrez le port 8850 (celui de l’adxadmin) et comme mot de passe « ymclcmvd » pour robsage1.robert.fr
1 • adcrapora nom_du_dossier
2 • valfil nom_du_dossier (structure tables)
3
• drop sequence (supprime les sequences)
• drop index (supprime les index)
4 • Imp data / Imp index (importation des deux tablespace)
5 • Valfil -r (réorganise les droits correctement)
6 • Trigger (historique des valeurs d'un champs)
7 • Création de la fiche dossier dans X3
Cliquez sur suivant et normalement votre serveur est bien accessible dans l’écran de gauche Répétez la même étape pour le serveur robado.robert.fr avec comme mot de passe « ****** » Sur votre écran de gauche, vous pourrez désormais naviguez sur les dossiers de vos deux serveurs et choisir l’importation à effectuer grâce au bouton import :
Choisissez votre dossier à importer et le répertoire dans lequel sont contenues toutes les données à importer qui sont vos données exportées précédemment (donc ici le dossier SVG).
Ici le mot de passe est « ***** ».
Les étapes de l’importation commencent, vous pouvez les suivre en cliquant sur détails :
