V8 Bases Version 8 docref : 0/fr Prologue - www.prologue.fr Tel : +33 01 69 29 39 39 Pour nous constacter au sujet de ce document : support@prologue.fr Fax : +33 01 69 29 90 43
Table des matières 1 - Généralités... p.3 1.1 - Copyright... p.3 1.2 - A propos... p.3 1.3 - Convention de typographie... p.3 2 - Introduction... p.4 3 - Choix d'une base de données... p.5 4 - Installation sur SQL Server ou MSDE... p.6 5 - Installation sur Oracle Server... p.13 6 - Installation Multiples... p.17 7 - Migration Access vers SQL Server ou Oracle Server... p.18 8 - Description des chaînes de connexion... p.19 V8 Bases V8 2/22
1 - Généralités 1.1 - Copyright Tous droits réservés. Aucune partie de cette documentation ne peut être reproduite, stockée sur un système d'archivage ou transmise à quelque fin ou par quelque moyen que ce soit, sans la permission écrite préalable de l'éditeur, sauf s'il s'agit de courtes citations reprises dans des articles ou des critiques. Toutes les marques citées dans ce manuel sont les propriétés de leurs auteurs respectifs. Au cours de la préparation de cette documentation, les auteurs et l'éditeur ont particulièrement veillé à l'exactitude de son contenu. Toutefois ces informations sont fournies sans garantie, expresse ou implicite. Les auteurs, les revendeurs et les distributeurs ne peuvent pas être tenus pour responsables des dommages éventuellement causés ou censés avoir été causé, de manière directe ou indirecte par cette documentation. Les informations contenues dans ce document pourront faire l'objet de modifications sans préavis. Sauf mention contraire, les sociétés, les noms et données utilisés dans les exemples sont fictifs. 1.2 - A propos Avant de commencer le mise en place du produit, assurez vous de bien lire les instructions de configuration, les conseils ainsi que toute autre information essentielle contenue dans ce guide. 1.3 - Convention de typographie Ce guide s'appuie sur les conventions suivantes : Caractères gras Caractères italiques Caractères espacement fixe Puce Remarque : à Attention : indique les précautions à prendre Libellés des champs et des boîtes de dialogue. Nom des touches. Commandes et boutons à utiliser Titres des autres parties, chapitres et sections du manuel. Titres des autres manuel. Noms de logiciels Prologue et d'autres éditeurs. Exemples de syntaxe de codes, de clés et d'instructions. Procédure courte ou sous-procédure étape par étape. Les remarques contiennent des informations importantes mises en exergue par rapport au texte. Les messages de ce type indiquent les précautions que vous devez observer pour éviter une erreur ou un problème risquant de porter à conséquence. V8 Bases V8 3/22
2 - Introduction utilise pour ses transactions des ressources stockées dans des bases de données. 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 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). V8 Bases V8 4/22
3 - Choix d'une base de données 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 Use It Messaging 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. V8 Bases V8 5/22
4 - Installation sur SQL Server ou MSDE supporte les version SQL Server 2000, 2003 ainsi que MSDE «MS Desktop Engine». Choix du mode d'installation Trois modes d'installation sont disponibles : 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 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. 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. V8 Bases V8 6/22
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é. V8 Bases V8 7/22
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. V8 Bases V8 8/22
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. V8 Bases V8 9/22
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. V8 Bases V8 10/22
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 V8 Bases V8 11/22
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. V8 Bases V8 12/22
5 - Installation sur Oracle Server 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 : Création des schémas(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. 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. 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. V8 Bases V8 13/22
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. V8 Bases V8 14/22
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 : Céés en mode 1 par SetupSvr, Créés par un DBA en utilisant les scripts fournis en mode 2 et 3. V8 Bases V8 15/22
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. V8 Bases V8 16/22
6 - 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. V8 Bases V8 17/22
7 - 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 V8 Bases V8 18/22
8 - 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 Uniquement SQL. Nom du serveur SQL Uniquement Oracle Server. Nom du driver ODBC Oracle Server OracleService Uniquement Oracle Server. Nom du service réseau pour la connexion au serveur Oracle SQLSecurity Dans le cas de SQL Server, 0=Authentification par compte NT, 1=Authentification par ID/mot de passe SQLLogin SQLPwd 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é. DBName Nom de la ressource,.en mode Access=fichier mdb, en mode SQL=nom de base, en mode Oracle=nom de user/schema SqlConnect Trusted_Connection SqlDataType Exemple d'une connexion à Imebase en mode Access 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 V8 Bases V8 19/22
[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 Nom de la ressource,.en mode Access=fichier mdb, en mode SQL=nom de base, en mode Oracle=nom de user/schema V8 Bases V8 20/22
Connect Uniquement Access, Chaîne complète de connexion SqlDataType 0=Access, 1=SQL, Oracle=2 Backup 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 Backup REG_SZ \WBERNIERGXP\NetRootPath$\ImeMail\IMEML 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 V8 Bases V8 21/22
DBName REG_SZ Imebase SQLConnect REG_SZ DRIVER={Oracle dans OraHome92}; DBQ=dbtest; UID=Imebase; PWD=a86 4a h6o6>7@7b6q6f V8 Bases V8 22/22