Rational Developer for System z

Distribution de mises à jour de produit

Rational Developer for System z inclut des outils destinés aux administrateurs système permettant de créer des mises à jour d'installation de produit et d'inviter les postes de travail client à installer les mises à jour lorsqu'ils se connectent à un système distant.

Avant de commencer

Cette rubrique explique comment distribuer des mises à jour de produit une fois que Rational Developer for System z a été installé et configuré sur un système distant. Pour effectuer les tâches décrites dans cette rubrique, le fichier pushtoclient.properties de Rational Developer for System z doit avoir été configuré pour distribuer des mises à jour de produit. Pour plus d'informations sur la configuration push-to-client, voir le document IBM® Rational Developer for System z - Guide de configuration de l'hôte (SC11-6285).
Lors de l'exécution des tâches décrites dans cette rubrique, il peut être nécessaire de créer ou de mettre à jour les fichiers suivants. Les procédures de cette rubrique décrivent le mode de mise à jour des fichiers.
  • Fichier de réponses IBM Installation Manager. Ce fichier permet aux postes de travail d'effectuer une installation de produit sans surveillance. Pour obtenir des instructions sur la création d'un fichier de réponses, voir le document IBM Rational Developer for System z - Guide d'installation (GI11-7243).
  • Fichier de kit d'activation de produit IBM Installation Manager. Les mises à jour de produit peuvent requérir un kit d'activation pour les principales mises à jour de version. Si la mise à jour de produit requiert un kit d'activation de produit, vous pouvez placer ce dernier à un emplacement réseau et faire référence à cet emplacement dans le fichier de réponses.
  • Fichier de mappage de clés. Ce fichier définit l'emplacement d'autres fichiers, tels les fichiers de réponses d'installation et les fichiers de configuration, qui sont automatiquement distribués aux postes de travail client. Le fichier de mappage de clés s'appelle keymapping.xml. Son emplacement par défaut sur le système z/OS est /var/rdz/pushtoclient.
  • Fichier de configuration d'installation. Ce fichier définit les ID d'offre de produits, plusieurs versions de Rational Developer for System z et le nom du fichier de réponses requis pour l'installation de la mise à jour du produit. Rational Developer for System z recherche dans le fichier de configuration d'installation un ID d'offre de produit applicable et une version installée. Une fois cet élément trouvé, il lance Installation Manager avec le fichier de réponses spécifié. Le fichier de configuration d'installation se nomme installconfig.xml et se trouve dans le chemin indiqué par la balise <fileId>com.ibm.ftt.resources.zos.install.configuration</fileId> du fichier de mappage de clés.
  • Fichier de propriétés push-to-client, appelé pushtoclient.properties. Ce fichier définit l'emplacement du fichier de mappage de clés. L'emplacement par défaut du fichier pushtoclient.properties sur le système z/OS est /etc/rdz/. Pour plus d'informations sur le fichier pushtoclient.properties, voir le document IBM Rational Developer for System z - Guide de configuration de l'hôte (SC11-6285).

Pourquoi et quand exécuter cette tâche

Lorsqu'un poste de travail client se connecte à un système distant qui a été configuré pour distribuer des mises à jour de produit, Rational Developer for System z compare la version du produit client à plusieurs versions définies dans le fichier de configuration d'installation. Si la version installée correspond à un de ces produits, Rational Developer for System z arrête le plan de travail et démarre IBM Installation Manager en utilisant un fichier de réponses téléchargé à partir du système distant.

Cette rubrique décrit comment mettre à jour le fichier de configuration d'installation et le fichier de mappage de clés pour la distribution des mises à jour de produit.

Procédure

Pour créer et distribuer les mises à jour de produit, procédez comme suit :

  1. Créez un fichier de réponses IBM Installation Manager pour l'installation de produit à distribuer. Pour obtenir des instructions sur la création d'un fichier de réponses, voir le document IBM Rational Developer for System z - Guide d'installation (GI11-7243).
    Important : Si l'authentification utilisateur est requise pour l'accès au référentiel de code lors de la mise à jour, les utilisateurs doivent alors enregistrer l'ID utilisateur de le mot de passe dans IBM Installation Manager.
  2. Créez ou mettez à jour le fichier de configuration d'installation afin d'indiquer la plage de versions de produit qui déclenchent une mise à jour et le fichier de réponses pour l'installation de la mise à jour. Pour obtenir des instructions sur la création ou la mise à jour du fichier de configuration d'installation, voir Mise à jour du fichier de configuration d'installation dans cette rubrique.
  3. Mettez à jour le fichier de mappage de clés afin de désigner le fichier de configuration d'installation et le fichier de réponses. Pour obtenir des instructions de mise à jour du fichier de mappage de clés, voir Mise à jour du fichier de mappage de clés dans cette rubrique.

Mise à jour du fichier de configuration d'installation

Procédure

Pour créer ou mettre à jour le fichier de configuration d'installation, procédez comme suit :

  1. Créez ou éditez le fichier installconfig.xml. Si ce fichier existe déjà, vous pouvez ajouter des entrées à ce fichier pour l'installation. S'il n'existe pas, vous pouvez copier le fichier de configuration d'installation exemple présenté à la fin de cette procédure, modifiez-le pour votre installation et enregistrez-le sur le serveur z/OS. Le fichier de configuration d'installation est un fichier XML codé UTF-8.
  2. Spécifiez les valeurs suivantes pour les balises :
    <installedOffering id="installedOfferingID">
    Spécifiez l'ID offre du produit pour lequel vous souhaitez distribuer des mises à jour. Vous pouvez indiquer un ID offre pour tout produit installé dans le même groupe de packages que Rational Developer for System z. L'ID offre est enregistré dans la balise <offering> du fichier de réponses. Vous trouverez ci-dessous un exemple de cette balise :
    <offering id='com.ibm.rational.developer.systemz.v80' version='8.0.1.20101014_0505' profile='IBM Software Delivery Platform' features='listOfInstalledFeatures'/>
    Spécifiez la valeur dans l'attribut id de la balise offering pour l'attribut id dans <installedOffering id="installedOfferingID">.
    <install installedVersion="[minimumVersionInclusive, maximumVersionInclusive] | (minimumVersionExclusive, maximumVersionExclusive)" responsefile="fileName">
    Spécifiez une plage de versions de produit à mettre à jour et le nom du fichier de réponses requis pour l'installation de la mise à jour de produit.

    Vous pouvez spécifier la valeur de l'élément installedVersion en tant que plage inclusive, exclusive ou mixte :

    • Pour spécifier une plage de versions de produit qui inclut les versions minimale et maximale, utilisez des crochets. installedVersion="[8.0.1, 8.0.2]" invite une mise à jour d'installation à utiliser les versions de produit 8.0.1, 8.0.2 et toutes les versions comprises dans cette plage.
    • Pour spécifier une plage de versions de produit qui exclut les versions minimale et maximale, utilisez des parenthèses. installedVersion="(8.0.1, 8.0.2)" invite une mise à jour d'installation à utiliser des versions de produit ultérieures à 8.0.1 mais antérieures à 8.0.2.
    • Vous pouvez utiliser à la fois des crochets et des parenthèses pour spécifier une plage qui inclut une extrémité de la plage mais exclut l'autre :
      • installedVersion="(8.0.1, 8.0.2]" invite une mise à jour d'installation à utiliser des versions de produit ultérieures à 8.0.1 mais antérieures ou égales à 8.0.2.
      • installedVersion="[8.0.1, 8.0.2)" invite une mise à jour d'installation à utiliser des versions de produit ultérieures ou égales à 8.0.1 mais antérieures à 8.0.2.
    Si la version actuellement installée sur un poste de travail client est comprise dans la plage installedVersion, Rational Developer for System z lance Installation Manager en utilisant le fichier de réponses spécifié dans l'attribut responseFile.
    Les numéros de version doivent inclure au moins le numéro de version principal. Ils peuvent inclure une version mineure, une version micro et un qualificateur : major[.minor[.micro[.qualifier]]] Les exemples suivants présentent des numéros de version valides pour l'attribut installedVersion :
    8
    8.0
    8.0.0
    8.0.0.20100607_1333
  3. Placez le fichier de configuration d'installation et le fichier de réponses sur le serveur z/OS et désignez cet emplacement dans le fichier de mappage de clés.

Exemple

Le fichier de configuration d'installation est un fichier XML codé UTF-8 qui contient un ou plusieurs ensembles de balises <installedOffering> qui définissent un ID d'offre de produits cible et une ou plusieurs paires de plage de versions installées et de noms de fichiers de réponses. Rational Developer for System z traite le fichier de configuration d'installation exemple de la manière suivante :
  • Recherche dans le fichier un ID d'offre de produit qui correspond à l'ID de tout produit installé dans le même groupe de packages que la version en cours d'exécution de Rational Developer for System z. Par exemple, si un client a installé et exécuté Rational Developer for System z dans le même groupe de packages que Rational Team Concert, alors l'ID d'offre correspondant peut être com.ibm.team.install.rtc.client.eclipse ou com.ibm.rational.developer.systemz.java.v80.
  • Si la version de produit en cours de l'ID offre correspondant est comprise dans la plage fournie dans une des paires d'attributs <installedVersion> et <responseFile>, Rational Developer for System z lance Installation Manager en utilisant le fichier de réponses. Si la version Rational Team Concert, par exemple, est supérieure ou égale à 3.0.0 et inférieure à 3.0.1, Rational Developer for System z lance Installation Manager en utilisant le fichier de réponses update_rtc_from_300_to_301.xml.
<?xml version="1.0" encoding="UTF-8"?>
<installConfig>
   <installedOffering id="com.ibm.rational.developer.systemz.java.v80">
      <install
         installedVersion="[8.0.1, 8.0.2)"
         responseFile="update_rdzjava_from_801_to_802.xml">
      </install>
      <install
         installedVersion="[8.1.0, 8.1.1)"
         responseFile="update_rdzjava_from_810_to_811.xml">
      </install>
   </installedOffering>
   <installedOffering id="com.ibm.team.install.rtc.client.eclipse">
      <install
         installedVersion="[3.0.0, 3.0.1)"
         responseFile="update_rtc_from_300_to_301.xml">
      </install>
   </installedOffering>
   <installedOffering id="com.ibm.teamz.rdz.ext">
      <install
         installedVersion="[3.0.0, 3.0.1)"
         responseFile="update_rtcrdzext_from_300_to_301.xml">
      </install>
   </installedOffering>
</installConfig>

Mise à jour du fichier de mappage de clés

Procédure

Vous pouvez mettre à jour le fichier de mappage de clés en utilisant l'assistant d'exportation ou en l'éditant manuellement. Pour obtenir des instructions concernant l'utilisation de l'assistant d'exportation, voir Exportation des fichiers de configuration push-to-client. Pour mettre à jour le fichier de mappage de clés en l'éditant manuellement, procédez comme suit :

  1. Créez ou éditez le fichier /var/rdz/pushtoclient/keymapping.xml. Si ce fichier existe déjà, vous pouvez ajouter des entrées à ce fichier pour la mise à jour du produit. S'il n'existe pas, vous pouvez copier le fichier de mappage de clés exemple présenté à la fin de cette procédure et l'enregistrer à l'emplacement indiqué par la propriété pushtoclient.folder du fichier pushtoclient.properties. Le fichier de mappage de clés est un fichier XML codé UTF-8.
  2. Incluez un ensemble de balises <location> pour chaque fichier de configuration d'installation et chaque fichier de réponses auxquels vous souhaitez faire référence.
  3. Spécifiez les valeurs suivantes pour les balises :
    <fileId>
    Spécifiez com.ibm.ftt.resources.zos.install.configuration pour le fichier de configuration d'installation et com.ibm.ftt.resources.zos.install.response pour le fichier de réponses.
    <containerPath>
    Spécifiez l'emplacement du fichier de configuration d'installation ou du fichier de réponses sur le serveur z/OS.
    <fileMask>
    Spécifiez le nom du fichier de configuration d'installation ou du fichier de réponses.
    <encoding>
    Spécifiez le codage du fichier de configuration d'installation ou du fichier de réponses.
  4. Enregistrez le fichier de mappage de clés à l'emplacement indiqué par la propriété pushtoclient.folder du fichier pushtoclient.properties.

Exemple

Le fichier de mappage de clés est un fichier XML codé UTF-8 qui stocke les noms, les emplacements et les codages de caractère des fichiers de configuration utilisés dans un environnement de configuration push-to-client Rational Developer for System z. Dans le fichier de mappage de clés exemple, l'administrateur a placé installconfig.xml dans le répertoire /var/rdz/pushtoclient/install et les fichiers de réponses dans le répertoire /var/rdz/pushtoclient/install/responsefiles du serveur z/OS.

<?xml version="1.0" encoding="UTF-8"?>
 <configuration-system>
   <location-list>
	   <location>
   		<fileId>com.ibm.ftt.resources.zos.install.configuration</fileId>
  		<containerPath>/var/rdz/pushtoclient/install</containerPath>
  		<fileMask>installconfig.xml</fileMask>
  		<encoding>UTF-8</encoding>
   	</location>
	  <location>
		  <fileId>com.ibm.ftt.resources.zos.install.response</fileId>
		  <containerPath>/var/rdz/pushtoclient/install/responsefiles</containerPath>
		  <fileMask>update_*.xml</fileMask>
		  <encoding>UTF-8</encoding>
	  </location>
   </location-list>
 </configuration-system>

Conditions d'utilisation | Commentaires

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)