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.
- 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
- Le client REXX transmet ces informations au démon du serveur System z Jazz Gateway et attend une réponse.
- 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.
- 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.
Installation de Jazz Gateway
sous UNIX
Exécutez les étapes suivantes pour installer Jazz Gateway sous UNIX :
- 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.
- 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 :
- Ouvrez un terminal de shell.
- Accédez au répertoire d'installation des fichiers Gateway.
- 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.
- 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 :
- 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.
- 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 :
- Ouvrez une fenêtre d'invite de commande.
- Accédez au répertoire d'installation des fichiers Gateway.
- 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 :
- Ouvrez une invite de commande et accédez au répertoire bin qui contient le fichier jsl.ini.
- Modifiez le fichier jsl.ini dans le répertoire bin :
- 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
- Corrigez toute erreur éventuelle avant de continuer.
- 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.
- 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 :
- A partir de l'invite de commande, accédez au répertoire jsl bin.
- Exécutez jsl -install.
- Ouvrez le panneau de configuration des services Windows (Démarrer > Exécuter
> services.msc).
- Recherchez le service IBM Jazz Gateway (ou tout autre nom affecté à ce service dans le fichier .ini).
- Cliquez dessus avec le bouton droit de la souris et sélectionnez Démarrer.
- Demandez des générations pour vous assurer que le moteur de génération traite correctement les demandes de génération.
- 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 :
- Ouvrez le panneau de configuration des services Windows (Démarrer > Exécuter
> services.msc).
- Recherchez le service IBM Jazz Gateway (ou tout autre nom affecté à ce service dans le fichier .ini).
- 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 :
- Ouvrez le panneau de configuration des services Windows (Démarrer > Exécuter
> services.msc).
- Recherchez le service IBM Jazz Gateway (ou tout autre nom affecté à ce service dans le fichier .ini).
- Cliquez dessus avec le bouton droit de la souris et sélectionnez Arrêter.
- A partir de l'invite de commande, accédez au répertoire jsl bin.
- Exécutez jsl -remove.