Installation du consignateur de base de données autonome MFT

Procédez comme suit pour installer et configurer le consignateur de base de données autonome.

1. Installez votre logiciel de base de données à l'aide de la documentation de votre base de données.
   Si la prise en charge de JDBC est un composant facultatif pour votre base de données, vous devez installer ce composant.
2. Exécutez la commande fteCreateLogger en définissant le paramètre -loggerType sur DATABASE pour créer votre consignateur de base de données autonome. Pour plus d'informations, voir fteCreateLogger
   Le nom de schéma par défaut est FTELOG. Si vous utilisez un nom de schéma autre que FTELOG, vous devez éditer le fichier SQL fourni correspondant à votre base de données, ftelog_tables_db2.sql ou ftelog_tables_oracle.sql, pour refléter ce nom de schéma avant de passer à l'étape suivante. Pour plus d'informations, voir wmqfte.database.schema dans les propriétés de configuration du consignateur MFT.
3. Créez les tables de base de données requises à l'aide des outils de votre base de données.

   Sur Multiplatforms, les fichiers ftelog_tables_db2.sql et ftelog_tables_oracle.sql contiennent des commandes SQL que vous pouvez exécuter pour créer les tables.

   Sous z/OS®, le fichier que vous devez exécuter dépend de la version de Db2® for z/OS que vous utilisez:

   • Pour Db2 for z/OS 9.0 et les versions antérieures, exécutez le fichier ftelog_tables_zos.sql pour créer les tables. Ce fichier crée les tables à l'aide d'un type de données INTEGER pour les zones qui indiquent les tailles des fichiers transférés et l'ID de table associé à chaque transfert.
   • Pour Db2 for z/OS 9.1 et les versions ultérieures, exécutez le fichier ftelog_tables_zos_bigint.sql pour créer les tables. Ce fichier crée les tables à l'aide d'un type de données BIGINT pour les zones qui indiquent les tailles des fichiers transférés et l'ID de table associé à chaque transfert.
4. Si vous utilisez une base de données Oracle, ajoutez USE_SID_AS_SERVICE_listener_name=on à votre fichier listener.ora, où listener_name est le nom du listener sur votre serveur de base de données. Redémarrez ensuite l'auditeur
   Ce paramètre spécifie que la connexion à la base de données traite l'Oracle identifiant du système (SID) comme le nom de service de la base de données. Ce paramètre est nécessaire car l'enregistreur de base de données MFT se connecte aux bases de données Oracle uniquement en utilisant un SID, alors que les bases de données ultérieures Oracle (à partir de la version 12c) utilisent un nom de service. Pour plus d'informations, consultez la documentation relative à votre version d'Oracle, par exemple Oracle Net Listener Parameters in the listener listener.ora File. Si vous ne modifiez pas le fichier listener.ora, vous risquez de voir le message suivant lorsque vous lancez le logger :

   ORA-12505, TNS:listener does not currently know of SID given in connect descriptor

5. Exécutez les commandes MQSC, fournies par la commande fteCreateLogger , sur votre gestionnaire de files d'attente de commandes de consignateur pour créer les files d'attente de consignateur. Le consignateur de base de données autonome utilise deux files d'attente sur le gestionnaire de file d'attente de coordination. La première file d'attente est une file d'attente de commandes dans laquelle sont placés les messages permettant de contrôler le fonctionnement du consignateur de base de données autonome. Le nom par défaut de cette file d'attente de commandes est SYSTEM.FTE.LOG.CMD.nom_journal. La deuxième file d'attente est une file d'attente de rejet. Etant donné que le consignateur de base de données autonome ne supprime jamais les messages de journal, si le consignateur rencontre un message qu'il ne peut pas traiter, il place le message dans la file d'attente de rejet pour examen et le retraite éventuellement. Il n'est pas recommandé d'utiliser la file d'attente des messages non livrés du gestionnaire de files d'attente à cette fin, car les messages rejetés n'ont pas d'en-tête DLH et les messages rejetés ne doivent pas être combinés avec les messages placés dans la file d'attente des messages non livrés pour d'autres raisons. Le nom par défaut de la file d'attente de rejet est SYSTEM.FTE.LOG.RJCT.nom_journal. Ces deux files d'attente sont définies dans les fichiers script MQSC générés par la commande fteCreateLogger .
6. Choisir un utilisateur et configurer les autorisations
7. Facultatif: Vous pouvez configurer davantage le consignateur de base de données autonome en éditant le fichier logger.properties créé par la commande fteCreateLogger à l'étape 2. Ce fichier est un fichier de propriétés Java qui se compose de paires clé-valeur. Le fichier logger.properties se trouve dans le répertoire MQ_DATA_PATH/mqft/config/coordination_qmgr_name/loggers/logger_name . Pour plus d'informations sur les propriétés disponibles et leurs effets, voir Propriétés de configuration du consignateurMFT.
8. En option : Si vous utilisez un système Windows, vous pouvez exécuter l'enregistreur de base de données autonome en tant que service Windows Exécutez la commande fteModifyLogger avec le paramètre -s . Pour plus d'informations, voir fteModifyLogger
9. Facultatif: Si la base de données utilisée est Oracle ou si vous vous connectez à une base de données Db2 à distance, vous devez spécifier un nom d'utilisateur et un mot de passe que le consignateur utilisera pour s'authentifier auprès de votre serveur de base de données. Ce nom d'utilisateur et ce mot de passe sont spécifiés dans un fichier de données d'identification conforme au format défini par le schéma MQMFTCredentials.xsd . Pour plus d'informations, voir Format de fichier des données d'identification MFT. Après avoir créé le fichier de données d'identification, vous devez spécifier l'emplacement du fichier de données d'identification dans le fichier logger.properties à l'aide de la propriété wmqfte.database.credentials.file .
10. Démarrez le consignateur de base de données autonome à l'aide de la commande fteStartLogger . Par défaut, le consignateur de base de données autonome s'exécute en arrière-plan et le consignateur de base de données autonome place la sortie dans un fichier du répertoire logs . Si vous souhaitez exécuter le consignateur de base de données autonome en avant-plan et générer une sortie dans la console ainsi que dans le fichier journal, ajoutez le paramètre -F à la commande fteStartLogger .

    Si vous avez effectué l'étape précédente et utilisé la commande fteModifyLogger avec le paramètre -s sous Windows, le consignateur de base de données autonome démarre en tant que service Windows .