DM Server V8 Support des bases de données

DM Server V8 Support des bases de données

Sommaire INTRODUCTION 3 1 - CHOIX D UNE BASE DE DONNEES 3 2 - INSTALLATION SUR SQL SERVER OU MSDE 4 CHOIX DU MODE D INSTALLATION 4 CHOIX DU SERVEUR SQL 4 FOURNITURE D UN COMPTE ADMINISTRATEUR 5 FOURNITURE D UN COMPTE UTILISATEUR 6 PARAMETRAGE DE SQL SERVER 7 PROFILS DES ID/MOT DE PASSE SQL SERVER ADMINISTRATION ET UTILISATEUR 7 CREATION DES RESSOURCES PAR EXECUTION DE SCRIPTS. 8 3 - INSTALLATION SUR ORACLE SERVER 8 CHOIX DU MODE D INSTALLATION 8 CHOIX DU NOM DE SERVICE ORACLE SERVER 9 FOURNITURE D UN COMPTE ADMINISTRATEUR 10 PARAMETRES DES COMPTES UTILISATEUR 11 CREATION DES RESSOURCES PAR EXECUTION DE SCRIPTS. 11 4 - INSTALLATION MULTIPLES 12 5 - MIGRATION ACCESS VERS SQL SERVER OU ORACLE SERVER 12 1 - CREATION DES RESSOURCES 12 6 - DESCRIPTION DES CHAINES DE CONNEXION 13 FICHIER CONFIG.CFG : 13 BASE DE REGISTRE : 14

Introduction Le produit DM Server V8 d IMECOM utilise pour ses transactions des ressources stockées dans des bases de données. DM Server V8 offre le support de 3 types de bases de données : Access : 5 bases.mdb SQL Server : 5 bases SQL Oracle Server : 5 users/schemas Ce document décrit partiellement l installation de DM Server V8 par SetupSvr pour les phases concernant le paramétrage des bases de données. En particulier : le paramétrage des connexions aux différentes bases de données supportées lors de l installation ou d une migration. les différents modes d installation et de migration disponibles. le format des chaînes de connexion aux bases de données stockées dans la base de registre ou les fichiers de configuration (config.cfg). 1 - Choix d une base de données DM Server V8 supporte les bases de données de type Access, SQL Server ou Oracle Server. Le mode Access, dont l installation ne demande pas de paramétrage particulier n est pas traité dans ce document. Le choix du type de base de donnée se fait lors de la première installation de DM Server par l exécution du programme d installation SetupSvr.

Dans le cas de SQL Server et Oracle Server, ce choix est définitif. Dans le cas d Access, une migration vers SQL Server ou Oracle Server reste toutefois possible. 2 - Installation sur SQL Server ou MSDE DM Server V8 supporte les version SQL Server 2000, 2003 ainsi que MSDE «MS Desktop Engine». Choix du mode d installation Trois modes d installation sont disponibles : 1. Création des bases SQL et des ressources : Le programme d installation va créer les bases ainsi que les ressources nécessaires au fonctionnement de DM Server 2. Création des ressources seules (tables, procédures). Le programme d installation va créer les ressources nécessaires au fonctionnement de DM Server. Les bases doivent être crées par un Administrateur SQL Server avant exécution du programme d installation SetupSvr. 3. Aucune modification des bases de données. Les bases doivent être crées par un Administrateur SQL Server et les ressources doivent être créées par exécution de scripts SQL fournis, avant exécution du programme d installation SetupSvr. Choix du serveur SQL Le programme d installation détecte automatiquement la liste des SQL Server disponibles sur le réseau. Si leur nombre est trop important il est nécessaire de spécifier le nom du SQL Server manuellement.

Fourniture d un compte Administrateur Dans le cas des modes d installation 1 et 2 une Authentification Administrateur SQL Server est nécessaire au programme d installation pour pouvoir créer les bases et ressources utilisées par DM Server V8. Si la fourniture d un ID/mot de passe Administrateur au programme d installation pose des problèmes de sécurité, il est toujours possible d utiliser le mode d installation 3. Les bases de données et ressources doivent alors être créées au préalable par un Administrateur SQL Server par exécution des scripts fournis (Voir création des ressources par exécution de scripts). Authentification Administrateur «trusted connection» : l authentification se fait par le compte NT sous lequel l utilisateur s est connecté.

Authentification Administrateur ID/mot de passe : l authentification se fait par la fourniture d un ID/mot de passe type Administrateur déclaré dans l administration SQL Server. Fourniture d un compte Utilisateur Dans tous les modes d installation une Authentification Utilisateur SQL Server est nécessaire aux services DM Server V8 pour pouvoir se connecter a leurs bases et ressources. Authentification Utilisateur «trusted connection» : l authentification se fait par le compte NT affecté aux services NT DM Server V8. Authentification Utilisateur ID/mot de passe : l authentification se fait par la fourniture d un ID/mot de passe. Cet ID peut avoir été crée par un Administrateur SQL Server avant lancement de l installation de DM Server V8 par SetupSvr, ou sera automatiquement crée par SetupSvr s il n existe pas. Lors de sa création

Paramétrage de SQL Server Dans le cas d une Authentification par ID/mot de passe Administrateur ou Utilisateur, faire la sélection dans les propriétés de sécurité du SQL Server de l Authentification mixte SQL Server et Windows. Pour changer le mode d'authentification de MSDE, modifier la base de registre : HKLM\Software\Microsoft\MSSQLSERVER\MSSQLSERVER LoginMode REG_DWORD 0x1=Authentification Windows, 2= Authentification mixte Profils des ID/mot de passe SQL Server Administration et Utilisateur Pour pouvoir créer les bases et ressources de DM Server V8, l ID/mot de passe Administrateur doit avoir les caractéristiques suivantes : Rôle du serveur «System Administrator». Accès aux bases master et InterchangeXXX Pour pouvoir se connecter aux bases de données, l ID/mot de passe Utilisateur doit avoir les caractéristiques suivantes : Aucun rôle du server.

Accès aux bases MiCom, MiXpeFtp, Imebase, Ifcomsvc, DMArch, avec pour chacune des bases les rôles public et db_owner. Important : Si l ID/mot de passe Utilisateur SQL Server est créé par SetupSvr, il possèdera à la fin de l installation le rôle du Serveur «System Administrator». Ce rôle peut être désactivé. Création des ressources par exécution de scripts. Dans le cadre de l installation de DM Server V8 en mode 2 ou 3 sous SQL Server, les bases et/ou les ressources doivent exister avant l exécution de SetupSvr. En mode 2 (Création des ressources seules) : Existence préalable des 5 bases de données (dont les noms par défaut sont Imebase, Ifcomsvc, MiCom, DMArch, MiXpeFtp) créées par un DBA SQL Server, par utilisation de «Enterprise Manager» ou «Query Analyser». En mode 3 : Existence préalable des 5 bases, idem mode 2. Existence préalable des ressources créées par un DBA SQL Server, par exécution de 5 scripts (Imebase.sql, Ifcomsvc.sql, MiCom.sql, DMArch.sql, MiXpeFtp.sql) sous «Query Analyser» ou l utilitaire Imecom DBUpdate. 3 - Installation sur Oracle Server DM Server V8 supporte les versions Oracle Server à partir de la version 8i. La connectivité client doit être installé sur la machine supportant DM Server 8. Choix du mode d installation Trois modes d installation sont disponibles :

1. Création des schemas(oracle Server) et des ressources : Le programme d installation va créer les users/schemas ainsi que les ressources nécessaires au fonctionnement de DM Server. 2. Création des ressources seules (tables, procédures). Le programme d installation va créer les ressources nécessaires au fonctionnement de DM Server. Les users/schemas doivent être crées par un Administrateur Oracle Server avant exécution du programme d installation SetupSrv. 3. Aucune modification des bases de données. Les users/schemas et les ressources doivent être créés par un Administrateur Oracle Server avant exécution du programme d installation SetupSvr. Choix du nom de service Oracle Server Le programme d installation détecte automatiquement la liste des Drivers ODBC installés par la connectivité client Oracle Server. Le nom de service réseau est un profil destiné à pouvoir joindre le serveur Oracle Server à partir d un poste client. Ces noms sont gérés par l Assistant Configuration Oracle Net.

Le nom de service réseau est en général fourni par le DBA du serveur Oracle. Fourniture d un compte Administrateur Dans le cas des modes d installation 1 et 2 une Authentification Administrateur Oracle Server est nécessaire au programme d installation pour pouvoir créer les users/schemas et ressources utilisées par DM Server V8. Le compte Administrateur doit avoir le Rôle DBA.

Si la fourniture Login/mot de passe Administrateur au programme d installation pose des problèmes de sécurité, il est toujours possible d utiliser le mode d installation 3. Les users/schemas et ressources doivent alors être créées au préalable par un DBA Oracle Server par exécution des scripts fournis (Voir création des ressources par exécution de scripts). Paramètres des comptes Utilisateur Par défaut, DM Server possède 5 utilisateurs pour se connecter au serveur Oracle (Ifcomsvc, Imebase, MiCom, DMArch, MiXpeFtp). Ces utilisateurs sont : créés en mode 1 par SetupSvr, créés par un DBA en utilisant les scripts fournis en mode 2 et 3. Tous ces utilisateurs ont le même mot de passe. Les comptes Utilisateurs doivent avoir le Rôle CONNECT et RESOURCE. Création des ressources par exécution de scripts. Dans le cadre de l installation de DM Server V8 en mode 2 ou 3 sous Oracle Server, l ensemble des bases et ressources doivent exister avant l exécution de SetupSvr. En mode 2 (Création des ressources seules) : Existence préalable des 5 users/schemas (dont les noms par défaut sont Imebase, Ifcomsvc, MiCom, DMArch, MiXpeFtp) créés par un DBA Oracle Server, par exécution sous SQLPlus de 5 scripts (create_ifcomsv_user.sql, ) pouvant être modifiés selon la stratégie appliquée (TABLE_SPACE, DATAFILE.). En mode 3 (Aucune modification des bases de données) : Existence préalable des 5 users/schemas, idem mode 2 ci-dessus Existence préalable des ressources créées par un DBA SQL Oracle, par exécution de 5 scripts (create_imebase.sql, create_ifcomsvc.sql, create_micom.sql, create_dmarch.sql, create_mixpeftp.sql) sous «Query Analyser» ou l utilitaire Imecom DBUpdate.

Il est conseillé de créer un TABLE_SPACE dédié à chaque user/schema de taille supérieure ou égale à 200 MO chacun et assortie d une possibilité d AUTOEXTEND. Le pourcentage utilisé de chaque TABLE_SPACE devra être vérifié périodiquement. 4 - Installation Multiples Les installations multiples permettent de partager un Server SQL ou Oracle Server par plusieurs configurations DM Server V8. Pour procéder à une installation multiple, changer à partir de la seconde installation les noms par défaut des 5 bases ou users/schemas (Imebase, Ifcomsvc MiXpeFtp, MiCom, DMArch) par des noms différents. Après la création de l arborescence Imecom par Setup.exe et avant exécution de SetupSvr pour procéder à l installation, ajouter au nouveau config.cfg vierge les 5 sections contenant les nouveaux noms dans les valeurs DBName : [Database.Imebase] DBName=Imebase_2 [Database.Ifcomsvc] DBName=Ifcomsvc_2 [Database.DMArch] DBName=DMArch_2 [Database.MiXpeFtp] DBName=MiXpeFtp_2 [Database.MiCom] DBName=MiCom_2 Note : Il est possible pour résoudre d éventuels conflits de noms de changer les noms par défaut des 5 bases ou users/schemas dès la première installation 5 - Migration Access vers SQL Server ou Oracle Server La migration du support de base de type Access vers SQL Server ou Oracle Server se fait en 2 temps : 1 - Création des ressources : La création des bases ou users/schemas et leurs ressources est la même que pour une installation nouvelle par SetupSvr. Deux programmes d installation Mdb2Ora et Mdb2SQL procède à ces créations selon les mêmes procédures décrites ci-dessus dans ce document. Note : A l issue de l exécution de Mdb2Ora ou Mdb2SQL : Le support de base est toujours Access, SQLDataType=0 Une valeur SQLMigration=1 (SQL Server) ou 2 (Oracle Server) est créée afin de permettre à DBUpdate de poursuivre la migration. 2 - Mise à jour : L utilitaire Imecom DBUpdate effectue : Une recopie du contenu des bases originales Access vers les nouvelles bases ou user/schema. Un filtre est disponible pour effectuer des recopies sélectives sur une liste de table donnée. La commutation de SQLDataType=0 vers 1 (SQL Server) ou 2 (Oracle Server).

Remarques : La migration doit se faire hors activité (services et clients) En cas d échec il est possible de revenir en mode Access en repositionnant toutes les valeurs SQLDataType=0 6 - Description des chaînes de connexion Les informations concernant les bases de données utilisées par DM Server V8 sont inscrites dans le fichier config.cfg situé à la racine de l arborescence partagée Imecom, puis dans la base de registre de chaque nouvelle passerelle installée. Fichier config.cfg : Il contient dans la section Databases la liste des sections de chaque base ou user/schema : [Databases] Base1=Imebase Base2=Ifcomsvc Base3=Micom Base4=MiXpeFtp Base5=Dmarch Il contient pour chaque base ou user/schema une section contenant les valeurs suivantes : Server OracleDriver OracleService SQLSecurity SQLLogin SQLPwd DBName SqlConnect Trusted_Connection SqlDataType Uniquement SQL. Nom du serveur SQL Uniquement Oracle Server. Nom du driver ODBC Oracle Server Uniquement Oracle Server. Nom du service réseau pour la connexion au serveur Oracle Dans le cas de SQL Server, 0=Authentification par compte NT, 1=Authentification par ID/mot de passe ID utilisé pour la connexion en SQL Server en mode ID/mot de passe et Oracle Server Mot de passe utilisé pour la connexion en SQL Server en mode ID/mot de passe et Oracle Server. Attention le contenu est chiffré. Nom de la ressource,.en mode Access=fichier mdb, en mode SQL=nom de base, en mode Oracle=nom de user/schema Chaîne complète de connexion ODBC Uniquement dans le cas SQL Server avec Authentification par du compte NT 0=Access, 1=SQL, Oracle=2 Exemple d une connexion à Imebase en mode Access [DataBase.Imebase] Server= SQLSecurity=0 SQLLogin= SQLPwd= DBName=Imebase SqlConnect= SqlDataType=0 Exemple d une connexion à Imebase en mode SQL Trusted_Connection)

[DataBase.Imebase] Server=WBERNIERGTEST SQLSecurity=0 SQLLogin= SQLPwd= DBName=Imebase SqlConnect=DRIVER={SQL SERVER}; SERVER=WBERNIERGTEST; DATABASE=Imebase; Trusted_Connection=yes SqlDataType=1 Exemple d une connexion à Imebase en mode SQL ID/mot de passe [DataBase.Imebase] Server=WBERNIERGTEST SQLSecurity=1 SQLLogin=faxuser SQLPwd=7a2 2# _6C6>7E7B7@6B7? DBName=Imebase SqlConnect=DRIVER={SQL SERVER}; SERVER=WBERNIERGTEST; DATABASE=Imebase; UID=faxuser; PWD=7a2 2# _6C6>7E7B7@6B7? SqlDataType=1 Exemple d une connexion à Imebase en mode Oracle [DataBase.Imebase] OracleDriver=Oracle dans OraHome92 OracleService=dbtest SQLPwd=a96 cc h6o6>7@7b6q6f DBName=Imebase SQLLogin=Imebase SqlConnect=DRIVER={Oracle dans OraHome92}; DBQ=dbtest; UID=Imebase; PWD=a96 cc h6o6>7@7b6q6f SqlDataType=2 Base de registre : Lors de l installation d une passerelle, la base de registre reprend selon le type de serveur de bases utilisé certaines valeurs du fichier config.cfg : DBName Connect SqlDataType Backup Nom de la ressource,.en mode Access=fichier mdb, en mode SQL=nom de base, en mode Oracle=nom de user/schema Uniquement Access, Chaîne complète de connexion 0=Access, 1=SQL, Oracle=2 Uniquement Access, nom d un fichier de sauvegarde de la base.mdb Pour chaque base ou user/schema, ces valeurs sont disponibles sous les clés : HKEY_LOCAL_MACHINE\SOFTWARE\imecom\Imemail\Version5\Default\Databases\Controller HKEY_LOCAL_MACHINE\SOFTWARE\imecom\Imemail\Version5\Default\Databases\DMArch HKEY_LOCAL_MACHINE\SOFTWARE\imecom\Imemail\Version5\Default\Databases\IFCOMSVC HKEY_LOCAL_MACHINE\SOFTWARE\imecom\Imemail\Version5\Default\Databases\MICOM HKEY_LOCAL_MACHINE\SOFTWARE\imecom\Imemail\Version5\Default\Databases\XPEDITE Uniquement pour Ifcomsvc, ces valeurs sont disponibles sous la clé : HKEY_LOCAL_MACHINE\SOFTWARE\imecom\IFCOMSVC Exemple d une connexion à Imebase en mode Access

SqlDataType REG_DWORD 0x0 Connect REG_SZ DSN=MS Access Databases;DBQ=\\WBERNIERGXP\NetRootPath$\ImeMail\IMEML1\imebase.md b; Backup REG_SZ \\WBERNIERGXP\NetRootPath$\ImeMail\IMEML1\imebasebak.mdb Exemple d une connexion à Imebase en mode SQL Trusted_Connection) SqlDataType REG_DWORD 0x1 SQLConnect REG_SZ DRIVER={SQL SERVER}; SERVER=WBERNIERGTEST; DATABASE=Imebase; Trusted_Connection=yes Backup REG_SZ Exemple d une connexion à Imebase en mode SQL ID/mot de passe SqlDataType REG_DWORD 0x1 SQLConnect REG_SZ DRIVER={SQL SERVER}; SERVER=WBERNIERGTEST; DATABASE=Imebase; UID=faxuser; PWD=38b 2c h6c6>7e7b7@6b7? Backup REG_SZ Exemple d une connexion à Imebase en mode Oracle Server SqlDataType REG_DWORD 0x2 DBName REG_SZ Imebase SQLConnect REG_SZ DRIVER={Oracle dans OraHome92}; DBQ=dbtest; UID=Imebase; PWD=a86 4a h6o6>7@7b6q6f