Présentation de System z Jazz Gateway

Avec Jazz Gateway, vous pouvez extraire par programme les numéros et le statut des éléments de travail du référentiel Rational Team Concert for System z.

Jazz Gateway s'exécute en tant que démon du serveur sous z/OS, Windows®, Linux® et d'autres plateformes pour l'authentification SSL sur un référentiel Jazz. Il transmet un numéro d'élément de travail dans un URI REST au référentiel Jazz afin d'obtenir le XML de l'élément de travail et renvoie ensuite le statut ou le XML complet de l'élément de travail au client.

Mode de communication entre Jazz Gateway et le référentiel Jazz

Le démon du serveur Jazz Gateway communique avec un port particulier afin d'extraire des requêtes. Sous z/OS, vous lancez ces requêtes en soumettant un travail du serveur System z Jazz Gateway. Vous pouvez modifier votre client REXX afin de spécifier un port particulier de manière à ce que le client et le démon du serveur System z Jazz Gateway puissent communiquer l'un avec l'autre via une connexion de socket.

  1. Pour appeler le client REXX, utilisez un EXEC REXX tel qu'un EXEC autonome ou un exit utilisateur SCLM pour configurer les paramètres requis tels que les suivants :
    • userid
    • password
    • Jazz repository URL
    • port number
    • work item number
  2. Le client REXX transmet ces informations au démon du serveur System z Jazz Gateway et attend une réponse.
  3. Le démon du serveur System z Jazz Gateway s'authentifie auprès du référentiel Jazz et transmet la demande d'élément de travail via un URI REST.
  4. Le serveur Jazz Gateway renvoie les informations d'élément de travail dans le XML et le démon du serveur exécute l'une des opérations suivantes :
    • Il extrait le statut de l'élément de travail du XML.
    • Il renvoie le XML complet au client REXX qui lui-même le renvoie à l'EXEC appelant.

Installation de Jazz Gateway

Jazz Gateway est installé sous z/OS par le biais de SMP/E avec le composant Build System Toolkit for System z. Si vous voulez installer Jazz Gateway sur les plateformes distribuées prises en charge, vous devez télécharger le fichier .zip depuis la section Rational Team Concert for System z All Downloads du site Jazz.net.

Prérequis pour l'installation de Jazz Gateway sous UNIX et Windows
  • IBM Java software development kit (SDK) 1.5 doit être installé
  • La variable d'environnement JAVA_HOME doit avoir pour valeur le répertoire qui contient le kit SDK Java 1.5
  • Le fichier java.exe doit être ajouté à PATH
Pour plus d'informations, voir Detailed System Requirements for the Rational Team Concert for System z 2.0 server environments.

Installation de Jazz Gateway sous UNIX

Exécutez les étapes suivantes pour installer Jazz Gateway sous UNIX :
  1. Téléchargez le fichier RTCz-JazzRestGateway-2.0.0.2.zip depuis la section Rational Team Concert for System z All Downloads du site Jazz.net : https://jazz.net/downloads/rational-team-concert-z/releases/2.0.0.2.
  2. Décomprimez les fichiers .jar suivants dans votre répertoire d'installation de Jazz Gateway :
    • RTCz-JazzGateway-<buildID>.jar
    • log4j-1.2.12.jar
    • com.ibm.team.repository.common_1.0.1.I200909060153.jar
    • org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar
    • commons-httpclient-3.0.jar

Appel deJazz Gateway sous UNIX à l'aide de Java

Exécutez les étapes suivantes pour appeler Jazz Gateway sous UNIX :
  1. Ouvrez un terminal de shell.
  2. Accédez au répertoire d'installation des fichiers Gateway.
  3. Entrez la commande suivante :
    java -cp .\RTCz-JazzGateway-<buildID>.jar;.\log4j-1.2.12.jar;
    .\com.ibm.team.repository.common_0.6.1.I200810072228.jar;.\org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.\commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway 6666 
    Remarque : Dans cet exemple, 6666 correspond au numéro de port utilisé par Gateway.
  4. Appuyez sur les touches CTRL+C pour arrêter Gateway.

Exemple de script de shell UNIX

L'exemple suivant est un script de shell permettant d'arrêter et de démarrer Jazz Gateway. Vous pouvez le personnaliser en fonction de votre environnement et modifiant la valeur de JAVA_HOME et GTW_DIR.
#! /bin/sh
#
# RTCzGateway-daemon:       Démarrage/arrêt de Jazz Gateway
#
#              
name="IBM Jazz Gateway"
export JAVA_HOME=<Java_sdk_directory>
export GTW_DIR=<Jazz_gateway_directory>

port=${2:-3456}
PID=GtwPid.$port
cmd="$JAVA_HOME/bin/java -classpath $GTW_DIR/RTCz-JazzGateway-I20090929-1150.jar:$GTW_DIR/log4j-1.2.12.jar:$GTW_DIR/com.ibm.team.repository.common_1.0.1.I200909060153.jar:$GTW_DIR/org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar:$GTW_DIR/commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway $port"

Start() {

   if [ -f $PID ] 
   then
      echo "$name $port already started"
   else
      echo "Starting $name $port daemon... "
       $cmd >$PID.log 2>&1& 
      echo $! >$PID
   fi
}


Stop() {
   if [ -f $PID ] 
   then
           echo "Shutting down $name $port daemon: "
      kill -9 `cat $PID`
      rm $PID
   else
           echo "$name $port daemon not started "
   fi
}

Restart() {
   Stop
   Début
}

# See how we were called.
case "$1" in
  start)
   Début
   ;;
  stop)
   Stop
   ;;
  restart)
   Restart
   ;;
  *)
   echo $"Usage: $0 {start|stop|restart} <port_number>"
   exit 1
esac

exit $?
Ce script peut servir de script d'initialisation du système. L'administration de ces types de scripts de shell ne s'effectue pas de la même manière sur chaque plateforme UNIX ou Linux sur laquelleJazz Gateway est pris en charge. Le tableau suivant indique l'emplacement des scripts d'initialisation système de chaque système :
Système Emplacement
AIX /etc/rc.d
Red Hat /etc/rc.d/init.d
SUSE /etc/init.d
Solaris /etc/init.d

Installation de Jazz Gateway sous Windows

Exécutez les étapes suivantes pour installer Jazz Gateway sous Windows :
  1. Téléchargez le fichier RTCz-JazzRestGateway-2.0.0.2.zip depuis la section Rational Team Concert for System z All Downloads du site Jazz.net : https://jazz.net/downloads/rational-team-concert-z/releases/2.0.0.2.
  2. Décomprimez les fichiers .jar suivants dans votre répertoire d'installation de Jazz Gateway :
    • RTCz-JazzGateway-<buildID>.jar
    • log4j-1.2.12.jar
    • com.ibm.team.repository.common_1.0.1.I200909060153.jar
    • org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar
    • commons-httpclient-3.0.jar

Appel de Jazz Gateway sous Windows à l'aide de Java

Exécutez les étapes suivantes pour appeler Jazz Gateway sous Windows :
  1. Ouvrez une fenêtre d'invite de commande.
  2. Accédez au répertoire d'installation des fichiers Gateway.
  3. Entrez la commande suivante :
    java -cp .\RTCz-JazzGateway-<buildID>.jar;.\log4j-1.2.12.jar;.\com.ibm.team.repository.common_0.6.1.I200810072228.jar;.\org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.\commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway 6666 
    Remarque : Dans cet exemple, 6666 correspond au numéro de port utilisé par Gateway.
Vous pouvez utiliser le fichier de commande startgw.cmd pour démarrer Gateway. Il convient au préalable de mettre à jour la variable JAVA_HOME dans le script.

Exemple de configuration d'un service Windows

Jazz Gateway étant une application Java, son exécution en tant que service Windows n'est pas directement prise en charge. Toutefois, plusieurs encapsuleurs de service sont disponibles. Cet exemple utilise Java Service Launcher, utilitaire distinct non inclus avec Rational Team Concert for System z, mais disponible en ligne. Vous pouvez modifier cet exemple en fonction de l'encapsuleur que vous utilisez.

Configuration de Java Service Launcher

Pour configurer Java Service Launcher (JSL) pour Jazz Gateway, procédez comme suit :
  1. Ouvrez une invite de commande et accédez au répertoire bin qui contient le fichier jsl.ini.
  2. Modifiez le fichier jsl.ini dans le répertoire bin :
    • Définissez une variable dans la section [define] devant contenir le numéro de port utilisé par Gateway.
      • PORT= numéro_port_Gateway
    • Définissez une variable dans la section [define] devant contenir le chemin du répertoire d'installation de Gateway.
      • GTW_DIR= répertoire_Gateway
    • Remplacez appname, servicename, displayname et servicedescription par les noms et les descriptions de votre choix, par exemple IBM Jazz Gateway (%PORT%).
    • Affectez au paramètre jrepath la valeur %JAVA_HOME%.
      Remarque : Veillez à définir le paramètre jrepath dans la section [java] du fichier .ini, et non dans la section [service] qui contient un commentaire identique.
    • Affectez au paramètre useconsolehandler la valeur true pour s'assurer que le moteur de génération continuer à s'exécuter après une fermeture de session.
    • Affectez au paramètre systemout une valeur similaire à%GTW_DIR%\gtw%PORT%.out.log.
    • Affectez au paramètre systemerr une valeur similaire à %GTW_DIR%\lgtw%PORT%.err.log.
    • Dans la section [java], ajoutez les paramètres suivants à transmettre à Java :
      • params = 4
      • param00 = -cp
      • param01 = %GTW_DIR%\RTCz-JazzGateway-I20090929-1150.jar;%GTW_DIR%\log4j-1.2.12.jar;%GTW_DIR%\com.ibm.team.repository.common_0.6.1.I200810072228.jar;%GTW_DIR%\org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.\commons-httpclient-3.0.jar
      • param02 = com.ibm.teamz.jazz.gateway.JazzGateway
      • param03 = %PORT%
  3. A partir de l'invite de commande, exécutez jsl -debug pour tester votre configuration. Cela lance Jazz Gateway. Un message similaire à celui-ci doit s'afficher :
    Debugging IBM Jazz Gateway (gateway_port_number)
    Now starting JVM
    ControlHandler registered after JVM start
  4. Corrigez toute erreur éventuelle avant de continuer.
  5. Consultez le fichier journal que vous avez défini dans le paramètre systemout pour déterminer si Gateway écoute au numéro de port indiqué par la variable PORT.
  6. Appuyez sur les touches CTRL+C pour terminer le test de débogage.

Installation du service Windows et démarrage de Jazz Gateway

Exécutez les étapes suivantes pour installer le service JSL Windows et démarrer Jazz Gateway :
  1. A partir de l'invite de commande, accédez au répertoire jsl bin.
  2. Exécutez jsl -install.
  3. Ouvrez le panneau de configuration des services Windows (Démarrer > Exécuter > services.msc).
  4. Recherchez le service IBM Jazz Gateway (ou tout autre nom affecté à ce service dans le fichier .ini).
  5. Cliquez dessus avec le bouton droit de la souris et sélectionnez Démarrer.
  6. Demandez des générations pour vous assurer que le moteur de génération traite correctement les demandes de génération.
  7. Une fois l'installation initiale terminée, le service démarre automatiquement lors de l'amorçage du système en raison de la présence du paramètre starttype=auto dans le fichier .ini.
Remarque : Si vous devez changer les paramètres contenus dans ce dernier, arrêtez et désinstallez le service au préalable (voir les instructions ci-dessous). Apportez ensuite les modifications nécessaires au fichier .ini et réinstallez le service.

Arrêt du service Jazz Gateway

Pour arrêter le service Jazz Gateway, procédez comme suit :
  1. Ouvrez le panneau de configuration des services Windows (Démarrer > Exécuter > services.msc).
  2. Recherchez le service IBM Jazz Gateway (ou tout autre nom affecté à ce service dans le fichier .ini).
  3. Cliquez dessus avec le bouton droit de la souris et sélectionnez Arrêter.

Désinstallation du service Windows

Pour désinstaller le service JSL Windows, procédez comme suit :
  1. Ouvrez le panneau de configuration des services Windows (Démarrer > Exécuter > services.msc).
  2. Recherchez le service IBM Jazz Gateway (ou tout autre nom affecté à ce service dans le fichier .ini).
  3. Cliquez dessus avec le bouton droit de la souris et sélectionnez Arrêter.
  4. A partir de l'invite de commande, accédez au répertoire jsl bin.
  5. Exécutez jsl -remove.