Déploiement de regroupements OSGi dans un serveur JVM

Pour déployer une application Java™ sur un serveur JVM, vous devez installer des regroupements OSGi pour l'application dans l'infrastructure OSGi du serveur JVM cible.

Avant de commencer

Les regroupements CICS contenant des regroupements OSGi pour l'application doivent être déployés dans zFS. Le serveur JVM cible doit être en cours d'exécution dans une infrastructure OSGi et être activé dans la région CICS. Vous devez être connecté à la région CICS en utilisant CICS Explorer pour créer les ressources CICS.

Pourquoi et quand exécuter cette tâche

Un regroupement CICS peut contenir un ou plusieurs regroupements et services OSGi. Etant donné que le regroupement CICS correspond à l'unité de déploiement, tous les regroupements et services OSGi sont gérés ensemble comme faisant partie de la ressource du regroupement. L'infrastructure OSGi gère aussi le cycle de vie des regroupements et services OSGi, notamment la gestion des dépendances et des versions.

Il est recommandé de vérifier que tous les regroupements OSGi contenant un composant d'application Java sont déployés dans le même regroupement CICS. S'il existe des dépendances entre les regroupements OSGi, déployez-les dans le même regroupement CICS. Lorsque vous installez la ressource de regroupement CICS, CICS s'assure que toutes les dépendances entre les regroupements OSGi sont résolues.

S'il existe des dépendances dans un regroupement OSGi contenant une bibliothèque de code commun, il est recommandé de créer un regroupement CICS distinct pour la bibliothèque. Dans ce cas, il est important d'installer la ressource du regroupement CICS contenant d'abord la bibliothèque. Si vous installez l'application Java avant les regroupements CICS dont elle dépend, l'infrastructure OSGi ne peut pas résoudre les dépendances de l'application Java.

Procédure

  1. Créez une ressource de regroupement indiquant le répertoire du regroupement dabs zFS :
    1. Dans la perspective CICS SM, cliquez sur Définitions > Définitions de regroupements dans la barre de menus CICS Explorer pour ouvrir la vue Définitions de regroupements.
    2. Cliquez avec le bouton droit de la souris n'importe où dans la vue, puis sur Nouveau pour ouvrir l'assistant Nouvelle définition de regroupement. Saisissez les détails de la ressource de regroupement dans les zones de l'assistant.
    3. Installez la ressource de regroupement. Vous pouvez installer la ressource avec le statut Activé ou Désactivé :
      • Si vous installez la ressource avec le statut Désactivé (DISABLED), CICS installe les regroupements OSGi dans l'infrastructure et résout les dépendances, mais n'essaie pas de démarrer les regroupements.
      • Si vous installez la ressource avec le statut Activé (ENABLED), CICS installe les regroupements OSGi, résout les dépendances et démarre les regroupements OSGi. Si le regroupement OSGi contient un activateur de regroupement à la demande, l'infrastructure OSGi n'essaie pas de démarrer le regroupement avant qu'il ne soit d'abord appelé par un autre regroupement OSGi.
  2. Facultatif : Activez la ressource de regroupement pour démarrer les regroupements OSGi dans l'infrastructure si la ressource n'affiche pas déjà le statut Activé (ENABLED).
  3. Cliquez sur Opérations > Regroupements dans la barre de menus CICS Explorer pour ouvrir la vue Regroupements. Vérifiez le statut de la ressource de regroupement.
    • Si la ressource de regroupement affiche le statut Activé (ENABLED), CICS est parvenu à installer toutes les ressources dans le regroupement.
    • Si la ressource de regroupement affiche l'état Désactivé (DISABLED), CICS n'est pas parvenu à installer une ou plusieurs ressources dans le regroupement.
    Si l'installation de la ressource de regroupement a échoué dans le statut Activé (Enabled), vérifiez les composants de regroupement de la ressource BUNDLE. Si l'un des composants de regroupement affiche le statut Inutilisable (UNUSABLE), CICS n'a pas pu créer les regroupements OSGi. En général, ce statut indique la présence d'un problème avec le regroupement CICS dans zFS. Vous devez supprimer la ressource de regroupement, corriger le problème, puis réinstaller la ressource de regroupement.
  4. Cliquez sur Opérations > Java > Regroupements OSGi dans la barre de menus CICS Explorer pour ouvrir la vue Regroupements OSGi. Vérifiez le statut des regroupements et services OSGi installés dans la structure OSGi. La table suivante récapitule les statuts suivants :
    BUNDLEPART OSGIBUNDLE OSGISERVICE
    ENABLED STARTING N/A
    ENABLED ACTIVE ACTIVE
    ENABLED ACTIVE INACTIVE
    DISABLED RESOLVED N/A
    DISABLED INSTALLED N/A
    UNUSABLE N/A N/A
    • Si le regroupement OSGi affiche le statut Démarrage en cours (STARTING), l'activateur de regroupement a été appelé, mais pas encore renvoyé. Si le regroupement OSGi dispose d'une règle d'activation à la demande, le regroupement conserve ce statut jusqu'à ce qu'il soit appelé dans l'infrastructure OSGi.
    • Si les regroupements OSGi et les services OSGi sont actifs, l'application Java est prête.
    • Si le service OSGi est inactif, CICS a détecté qu'il existe déjà un service OSGi du même nom dans l'infrastructure OSGi.
    • Si vous désactivez la ressource BUNDLE, le regroupement OSGi se déplace vers l'état RESOLVED.
    • Si le regroupement OSGi est à l'état INSTALLED, soit il n'a pas démarré soit le démarrage a échoué parce que les dépendances dans le regroupement OSGi n'ont pas pu être résolues.

Résultats

La ressource de regroupement est activée, les regroupements OSGi sont correctement installés dans l'infrastructure OSGi et tous les services OSGi sont actifs. Les regroupements et services OSGi sont disponibles pour d'autres regroupements dans l'infrastructure.