Administration du serveur sous i5/OS

Lorsque vous installez WebSphere Business Integration Server Express sous i5/OS, un grand nombre d'objets i5/OS est créé dans le système i5/OS. Le tableau ci-dessous décrit ces objets :

Tableau 5. Objets i5/OS
Elément Nom Description
Profil utilisateur QWBISVR44 Profil utilisateur par défaut qui possède l'ensemble du contenu installé et sous lequel les travaux sont exécutés.
Bibliothèque QWBISVR44 Contient tous les objets natifs i5/OS.
Descriptions des travaux QWBIxxxx, où xxxx est une valeur unique spécifique à chaque processus. Permet d'identifier les travaux s'exécutant dans le sous-système et peut être personnalisé pour chaque travail. Pour visualiser les descriptions des travaux, utilisez la commande WRKJOBD JOBD(QWBISVR44/*ALL).
Instance d'Interchange Server Express QWBIDFT44 L'installation entraîne la création, la configuration et le déploiement du modèle de collaboration CollaborationFoundation sur le serveur, ainsi que du contenu permettant d'exécuter les exemples installés.
Gestionnaire de files d'attente MQ QWBIDFT44.QUEUE.MANAGER L'installation entraîne la création d'un gestionnaire de files d'attente, ainsi que d'un programme d'écoute MQ sur le port par défaut.
Base de données DB2/400 QWBIDFT44 Référentiel du serveur InterChange Server QWBIDFT44.
Description du sous-système QWBISVR44/QWBISVR44 Contient les attributs du sous-système QWBISVR44 dans lequel s'exécutent les processus i5/OS.
Serveur avec démarrage automatique TCP/IP QWBISVR44 Démarre automatiquement le sous-système en activant les serveurs avec démarrage automatique TCP/IP.
Travail d'auto-démarrage QWBITNAMES Serveur de noms requis pour qu'InterChange Server, les adaptateurs et les outils puissent communiquer entre eux. Le port par défaut est utilisé pour le serveur de noms.
Travail d'auto-démarrage QWBIDFT44 Démarre le serveur InterChange Server installé.
HTTP Server et WebSphere Application Server ICSMON44 Instances de HTTP Server et de WebSphere Application Server.

Exécution du serveur sous i5/OS

La prise en charge de i5/OS s'exécute dans le sous-système QWBISVR44, sous le nom de profil utilisateur QWBISVR44. i5/OS affecte un objet unique de description du travail pour chacun des composants suivants :

Remarques relatives aux travaux

Pour rechercher un travail, utilisez la commande WRKACTJOB SBS (QWBISVR44). Pour chaque composant, les noms des travaux sont identiques aux noms des descriptions de travaux.

Il existe plusieurs travaux, associés aux travaux nommés du sous-système, ne requérant aucune gestion comme, par exemple, QP0ZSPWP, QP0ZSPWT et QZSHSH.

D'autres travaux, tels QWBIDFT44, vérifient l'état du serveur et d'un adaptateur, tel QWBIJTEXTC pour l'adaptateur JText. Il est recommandé, mais non nécessaire, de créer différents noms et descriptions de travaux pour chaque instance d'un adaptateur si vous exécutez plusieurs instances d'un même adaptateur, par exemple deux instances d'adaptateur JText.

Sous i5/OS, tous les travaux s'exécutent à l'aide du CCSID du profil utilisateur QWBISVR44 correspondant à la valeur système QCCSID. Si votre système exécute les CCSID japonais 5026 ou 290, vous devez remplacer le paramètre CCSID du profil utilisateur QWBISVR44 par la valeur 5035 pour que le produit fonctionne correctement.

Suppression de QWBISVR44 en tant que serveur avec démarrage automatique TCP

Si vous ne souhaitez pas que WebSphere Business Integration Server Express démarre automatiquement lorsque TCP/IP démarre sur votre système, utilisez la commande RMVTCPSVR SVRSPCVAL(*QWBISVR44) pour supprimer QWBISVR44 en tant que serveur avec démarrage automatique TCP.

Suppression des serveurs InterChange Server démarrés automatiquement

Si vous ne souhaitez pas que le sous-système démarre automatiquement lorsque TCP/IP démarre sur votre système et ne voulez pas que le serveur QWBIDFT44 démarre automatiquement, utilisez le script remove_autostart_server.sh pour supprimer de votre sous-système le serveur InterChange Server automatiquement démarré.

Avant d'exécuter ce script, exécutez d'abord la commande CL QSH pour accéder à l'environnement QShell. Utilisez la syntaxe suivante pour le script remove_autostart_server.sh :

/QIBM/ProdData/WBIServer44/bin/remove_autostart_server.sh QWBIDFT44

Démarrage automatique du serveur de noms

Il est recommandé de conserver le serveur de noms en tant que travail de démarrage automatique dans le sous-système. Le fait de démarrer ce travail automatiquement permet à un moniteur de détecter tout arrêt contrôlé du système ou du sous-système. Sans ce moniteur, un arrêt contrôlé n'arrêterait pas le sous-système QWBISVR44 et ses travaux.

Démarrage automatique d'InterChange Server, des agents d'adaptateur et des agents ODA

Pour démarrer automatiquement InterChange Server, les agents d'adaptateur et les agents ODA (Object Discovery Agents), exécutez le script start_server.sh (pour InterChange Server), les scripts spécifiques aux adaptateurs, comme start_JText.sh ou ceux spécifiques aux agents ODA, par exemple start_JDBCODA.sh, directement avec le sous-système QWBISVR44.

Tous les fichiers exécutables, la base de données de référentiel et les fichiers spécifiques sont exclusivement associés au profil utilisateur, il est donc important d'utiliser le sous-système QWBISVR44. En outre, vous devez toujours exécuter InterChange Server sous le profil utilisateur QWBISVR44 afin d'éviter tout incident inattendu en matière de droits d'accès.

Pour exécuter un travail d'un agent d'adaptateur sous un autre profil utilisateur, remplacez le paramètre utilisateur figurant dans la description du travail issue du sous-système QWBISVR44 par cet autre profil utilisateur. Cette fonction s'avère particulièrement utile lorsqu'il est nécessaire d'interdire au profil utilisateur QWBISVR44 d'accéder à des données d'application sécurisées par un autre profil utilisateur.

Remarque :
Il est conseillé de ne pas utiliser QSHell dans l'entrée de commande i5/OS pour exécuter ces scripts, car cela entraînerait l'exécution des travaux dans le sous-système QINTER, sous le profil utilisateur utilisé lors de l'ouverture de session.

Changement de port ORB IBM

Appliquez la procédure suivante pour changer de port ORB IBM :

  1. Ouvrez le fichier /QIBM/UserData/WBIServer44/bin/CWSharedEnv.sh.
  2. Pour ORB_PORT, remplacez la valeur 14500 par le numéro de port approprié.
  3. Arrêtez le sous-système.
  4. Redémarrez le sous-système en utilisant le nouveau port.

Si vous utilisez des outils client Windows, vous devez modifier le fichier CWSharedEnv.bat situé dans le répertoire du produit, arrêter tous les outils actifs puis les redémarrer.

Remarque :
Si nécessaire, vous pouvez également désigner un alias hôte ou système différent pour ORB_HOST.

Changement de port du programme d'écoute MQ

Lors de la création d'une instance de serveur, vous pouvez spécifier le port du programme d'écoute MQ à l'aide du script create_instance.sh. Appliquez la procédure suivante pour changer le port du programme d'écoute MQ :

  1. Ouvrez le fichier /QIBM/UserData/WBIServer44/Nom_Instance/InterchangeSystem.cfg.
  2. Modifiez la valeur du port du programme d'écoute MQ, par exemple dans les lignes ci-dessous, remplacez la valeur 1416 par le nouveau numéro de port.
    <tns:name>PORT</tns:name>
    <tns:value xml:space="preserve">1416</tns:value>
    Remarque :
    Modifiez ce fichier avec prudence car une mauvaise manipulation risquerait d'empêcher InterChange Server de démarrer.
  3. Remplacez le port RQSDTA mentionné dans la description du travail par le numéro de port 1417, par exemple :
    CHGJOBD JOBD(QWBISVR44/QWBIDFT44) RQSDTA('QSYS/CALL
    PGM(QWBISVR44/QWBIDFT44) PARM(QWBIDFT44 ''1417'')')
    Remarque :
    Par défaut, ce port partage un nom avec InterChange Server et réside dans la bibliothèque QWBISVR44.

Modification du nom du référentiel d'InterChange Server

Lors de la création d'une instance de serveur, vous pouvez spécifier le nom du référentiel d'InterChange Server à l'aide du script create_instance.sh. Appliquez la procédure suivante pour modifier le nom du référentiel :

Remarque :
Si vous modifiez le nom du référentiel d'Interchange Server pour une instance de serveur, le script delete_instance.sh ne supprimera pas la base de données du référentiel de l'Interchange Server. Vous devrez supprimer manuellement le référentiel à l'aide de la commande SQL drop collection.

  1. Importez le référentiel du serveur dans un projet de System Manager.
  2. Arrêtez le sous-système QWBISVR44.
  3. Exécutez la commande STRSQL à partir de l'entrée de commande i5/OS.
  4. Exécutez la commande CREATE COLLECTION(nouveau_nom), où nouveau_nom correspond au nouveau nom du référentiel.
    Remarque :
    Le profil STRSQL dispose du droit *RWX sur le nouveau référentiel. Utilisez la commande EDTOBJAUT et le droit d'accès *RWX pour définir le profil QWBIDFT44 comme nouveau profil propriétaire.
  5. Editez DATA_SOURCE_NAME dans trois emplacements (jdbc:db2:localhost/Nouveau_Nom) dans le répertoire /QIBM/UserData/WBIServer44/nomInstance/InterchangeSystem.cfg, où Nouveau_Nom correspond au nouveau nom du référentiel.
  6. Arrêtez l'instance du serveur de noms utilisant System Manager à l'aide du script stop_server_gracefully.sh ou en arrêtant le sous-système QWBISVR44.
  7. Démarrez le serveur SQL et exécutez le script drop collection Nom_Instance, où Nom_Instance correspond au nom du serveur InterChange Server.
  8. Ne tenez pas compte des éventuels messages CPA7025 que vous recevez.
  9. Exécutez le script submit_ics_server.sh pour démarrer le serveur.

Modification du nom d'un gestionnaire de files d'attente

Lors de la création d'une instance de serveur, vous pouvez spécifier le nom du gestionnaire de files d'attente à l'aide du script create_instance.sh. Appliquez la procédure suivante pour modifier le nom d'un gestionnaire de file d'attente :

  1. Entrez la commande CHGJOBD JOBD(QWBISVR44/QWBIDFT44) et cliquez sur F4 pour afficher les paramètres.
  2. Editez la valeur RQSDTA pour remplacer la valeur du gestionnaire de files d'attente existant. Par exemple, le nom du gestionnaire de file d'attente pour l'instance par défaut est QWBIDFT44.QUEUE.MANAGER. Remplacez le nom du gestionnaire de files d'attente existant par le nouveau nom, en préservant les espaces à la fin du nom du gestionnaire de files d'attente, si nécessaire, de telle sorte que la chaîne du nom comporte 48 caratères ou plus.
  3. Remplacez le nom du gestionnaire de files d'attente dans /QIBM/UserData/WBIServer44/Nom_Instance/InterchangeSystem.cfg par son nouveau nom.
  4. Arrêtez l'instance du serveur de noms utilisant System Manager à l'aide du script stop_server_gracefully.sh ou en arrêtant le sous-système QWBISVR44.
  5. Utilisez les commandes ENDMQM et DLTMQM pour arrêter ou supprimer le gestionnaire de files d'attente Nom_Instance.QUEUE.MANAGER.
  6. Exécutez le script submit_ics_server.sh pour démarrer le serveur.

Scripts i5/OS

WebSphere Business Integration Server Express est fourni avec un grand nombre de scripts spécifiques à i5/OS. Ces scripts sont situés dans le répertoire /QIBM/ProdData/WBIServer44/bin.

Les sections suivantes décrivent chaque script en détail.

add_autostart_adapter.sh

Ce script permet de déployer automatiquement l'agent d'adaptateur dès qu'InterChange Server est démarré avec le sous-système QWBISVR44. Il ajoute également des informations relatives au travail de démarrage automatique à l'attention de l'instance du serveur, permettant à cette dernière de soumettre un travail à l'agent d'adaptateur.

Syntaxe

La syntaxe ci-dessous correspond au script add_autostart_adapter.sh :

add_autostart_adapter.sh Nom_Adaptateur Nom_Instance Script_Démarrage Description_Travail

où :

Exemple

L'exemple suivant correspond à l'adaptateur JText :

add_autostart_adapter.sh JText QWBIDFT44 /QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/start_JText.sh QWBIJTEXTC

add_autostart_server.sh

Ce script permet de configurer InterChange Server pour qu'il démarre automatiquement avec le sous-système. Lors de la création d'une instance de serveur à l'aide du script create_instance.sh, l'instance est configurée pour démarrer automatiquement avec le sous-système. Si vous supprimez cette fonctionnalité à l'aide du script remove_autostart_server.sh, utilisez le script add_autostart_server.sh pour rétablir le démarrage automatique initial.

Syntaxe

La syntaxe ci-dessous correspond au script add_autostart_server.sh :

add_autostart_server.sh Nom_Serveur Description_Travail,

où :

create_instance.sh

Ce script permet de créer une nouvelle instance d'Interchange Server, ainsi que des nouveaux répertoires dans /QIBM/UserData/WBIServer44 pour InterChange Server. Il copie également les adaptateurs installés dans ce répertoire, crée une base de données de référentiel DB2/400 et une file d'attente MQ portant le même nom que l'instance, crée un programme d'écoute MQ pour cette file d'attente MQ avec le numéro de port spécifié et ajoute un travail de démarrage automatique au sous-système QWBISVR44 pour le nouveau serveur InterChange Server.

Syntaxe

La syntaxe ci-dessous correspond au script create_instance.sh :

create_instance.sh [ -rNom_Référentiel ] [ -qNom_Gestionnaire_Files [ -exists ] ] [ -uuser -ppassword ] [ -dsystème -nUtilisateur_BD -wMot_Passe_BD ] Nom_Serveur Numéro_Port_MQ Numéro_Port_HTTP

delete_instance.sh

Ce script permet de supprimer une instance d'Interchange Server, ainsi que les répertoires associés au serveur dans /QIBM/UserData/WBIServer44, qui est la base de données de référentiel DB2/400 associée au serveur, et le travail de démarrage automatique du serveur figurant dans la description du sous-système QWBISVR44. Ce script ne supprime pas le gestionnaire de files d'attente existant associé au serveur.

Remarque :
Si vous modifiez le nom du référentiel d'Interchange Server pour une instance de serveur, le script delete_instance.sh ne supprimera pas la base de données du référentiel de l'Interchange Server. Vous devrez supprimer manuellement le référentiel à l'aide de la commande SQL drop collection.
Syntaxe

La syntaxe ci-dessous correspond au script delete_instance.sh :

delete_instance.sh Nom_Instance,

où :

remove_autostart_adapter.sh

Ce script permet de supprimer la désignation de démarrage automatique d'un agent d'adaptateur faisant actuellement l'objet d'un démarrage automatique avec une instance de serveur. Il permet également d'éditer un travail de démarrage automatique associé à l'instance d'InterChange Server et de supprimer les instructions chargées de soumettre le travail de l'agent d'adaptateur.

Syntaxe

La syntaxe ci-dessous correspond au script remove_autostart_adapter.sh :

remove_autostart_adapter.sh Nom_Adaptateur Nom_Instance,

où :

remove_autostart_server.sh

Ce script permet de supprimer la désignation de démarrage automatique d'une instance d'InterChange Server, ainsi que de supprimer du sous-système QWBISVR44 le travail de démarrage automatique associé à l'instance d'InterChange Server.

Syntaxe

La syntaxe ci-dessous correspond au script remove_autostart_adapter.sh :

remove_autostart_server.sh Nom_Instance,

où :

set_ics_server_mode.sh

Ce script définit le mode d'InterChange Server. Il applique le nouveau mode (design, production, testOn ou testOff) au prochain démarrage d'InterChange Server.

Syntaxe

La syntaxe ci-dessous correspond au script set_ics_server_mode.sh :

set_ics_server_mode.sh Nom_Instance mode,

où :

stop_server_gracefully.sh

Ce script permet d'arrêter InterChange Server avec dégradation progressive à partir d'un programme CL ou d'une entrée de commande sur i5/OS ; il équivaut à une commande d'arrêt avec dégradation progressive émise par System Manager ou System Monitor.

Syntaxe

La syntaxe ci-dessous correspond au script stop_server_gracefully.sh :

stop_server_gracefully.sh Nom_Instance,

où :

Remarque :
Si RBAC est activé, stop_server_gracefully.sh requiert également les paramètres
-uusername et -ppassword.

stop_adapter.sh

Ce script permet d'arrêter un travail d'agent d'adaptateur avec dégradation progressive lorsqu'il n'est pas pratique d'utiliser System Manager ou System Monitor.

Syntaxe

La syntaxe ci-dessous correspond au script stop_adapter.sh :

stop_adapter.sh Nom_Instance Nom_Adaptateur,

où :

Exemple

L'exemple suivant correspond à l'adaptateur JText :

stop_adapter.sh QWBIDFT44 JText

submit_adapter.sh

Ce script permet de soumettre un travail d'agent d'adaptateur pour qu'il s'exécute dans le sous-système QWBISVR44. Vous devez démarrer le sous-sytème QWBISVR44 avant d'utiliser cette commande.

Syntaxe

La syntaxe ci-dessous correspond au script submit_adapter.sh :

submit_adapter.sh adapterName instanceName startScript jobDescription [parm5] [parm6] [parm7],

où :

Exemple

L'exemple suivant correspond à l'adaptateur JText :

submit_adapter.sh JText QWBIDFT44 /QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/start_JText.sh QWBIJTEXTC -c/ QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/JText.cfg

submit_ics_server.sh

Ce script permet de soumettre un travail d'instance d'InterChange Server pour qu'il s'exécute dans le sous-système QWBISVR44, en fournissant la logique nécessaire à l'exécution d'un travail par lots à l'aide du script start_server.sh. Ce script inclut les paramètres facultatifs 2 à 6, qui permettent de transmettre des paramètres au script start_server.sh.

Syntaxe

La syntaxe ci-dessous correspond au script submit_ics_server.sh :

submit_ics_server.sh Nom_Instance [parm2] [parm3] [parm4] [parm5] [parm6],

où :

submit_name_server.sh

Ce script permet de soumettre le travail du serveur de noms pour qu'il s'exécute dans le sous-système QWBISVR44.

submit_oda.sh

Ce script permet de soumettre un travail d'agent ODA (Object Discovery Agent) pour qu'il s'exécute dans le sous-système QWBISVR44, en fournissant la logique nécessaire à la soumission d'un travail dans le sous-système QWBISVR44 en vue d'exécuter le nom de script transmis en tant que paramètre 1.

Syntaxe

La syntaxe ci-dessous correspond au script submit_oda.sh :

submit_oda.sh scriptDémarrageODA Description_Travail,

où :

Exemple

L'exemple suivant correspond à l'agent ODA JDBC :

submit_oda.sh /QIBM/ProdData/WBIServer44/product/oda/JDBC/start_JDBCODA.sh QWBIJDBODA

Sécurité du profil utilisateur pour i5/OS

Pour des raisons de sécurité, il peut être nécessaire de changer le profil utilisateur sous lequel les processus de l'agent d'adaptateur s'exécutent, par exemple, les droits d'accès à la base de données JDBC ou les répertoires et fichiers JText. La modification du profil utilisateur interdit au profil utilisateur QWBISVR44 d'accéder à ces processus d'adaptateur.

Pour modifier le profil utilisateur, procédez comme suit :

  1. Utilisez la commande CHGJOBD CL pour modifier la description du travail pour l'agent d'adaptateur. Définissez le paramètre USER au nouveau profil utilisateur.
  2. Utilisez la commande GRTOBJAUT CL pour accorder au nouveau profil utilisateur le droit d'accès à la description du nouveau travail, en attribuant au paramètre USER la valeur du nouveau profil utilisateur et au paramètre AUT la valeur *READ ou *EXECUTE.
  3. Utilisez la commande GRTOBJAUT CL pour accorder au nouveau profil utilisateur le droit d'accès à la bibliothèque QWBISVR44, en attribuant au paramètre USER la valeur du nouveau profil utilisateur et au paramètre AUT la valeur *READ ou *EXECUTE.
  4. Utilisez la commande GRTOBJAUT CL pour accorder au nouveau profil utilisateur le droit d'accès à la description du sous-système QWBISVR44, en attribuant au paramètre USER la valeur du nouveau profil utilisateur et au paramètre AUT la valeur *READ ou *EXECUTE.
  5. Utilisez la commande GRTOBJAUT CL pour accorder au nouveau profil utilisateur le droit d'accès à la classeQWBISVR44, en attribuant au paramètre USER la valeur du nouveau profil utilisateur et au paramètre AUT la valeur *READ ou *EXECUTE.
  6. Utilisez la commande CHGAUT CL pour accorder au nouveau profil utilisateur le droit d'accès au répertoire contenant le connecteur dans Integrated File System en attribuant au paramètre USER la valeur du profil du nouvel utilisateur et au paramètre DTAAUT la valeur *RWX.

Arrêt du sous-système avec i5/OS

Lorsque vous arrêtez le sous-système à l'aide d'i5/Os, le code inclut un gestionnaire de fonctions sigaction qui contrôle l'action ENDSBS *CNTRLD. Ce gestionnaire permet au sous-système QWBISVR44 de s'arrêter de façon contrôlée en arrêtant InterChange Server avec dégradation progressive, ainsi que tous les travaux ou adaptateurs en cours d'exécution sur le système local. Une fois ce processus terminé, le gestionnaire s'arrête automatiquement.

Copyright IBM Corp. 2004, 2005