Présentation du fichier sdd.xml de niveau composant

Pour la plupart des scénarios d'installation, la génération du fichier sdd.xml de niveau de composant est automatisée. Cependant, il pourra être nécessaire de le créer manuellement dans certains cas. Le fichier sdd.xml de niveau composant contient les informations relatives à l'installation des artefacts du composant. Il répertorie les points d'extension qui doivent être traités. Les points d'extension permettent de s'assurer que les ressources peuvent être installées et configurées sur le serveur. Le travail de déploiement et de configuration est effectué par les tâches Ant.

Echantillon de fichier sdd.xml

<iudd:iudd
	xmlns:iudd="http://www.ibm.com/xmlns/prod/autonomic/solutioninstall/IUDD"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:OSRT="http://www.ibm.com/xmlns/prod/autonomic/resourcemodel/OS/resourcetypes"
	xmlns:OSAT="http://www.ibm.com/xmlns/prod/autonomic/resourcemodel/OS/artifacttypes"
	xmlns:J2EERT="http://www.ibm.com/xmlns/prod/autonomic/resourcemodel/J2EE/resourcetypes"
	xsi:schemaLocation="http://www.ibm.com/xmlns/prod/autonomic/solutioninstall/IUDD 

../iudd/iudd.xsd"
	schemaVersion="2.0.0" buildID="112220" buildDate="2006-01-19T12:00:00">
 
	<packageIdentity contentType="Component">
		<name>components/componentN</name>
		<version>8.0.0.0</version>
		<displayName key="d0001" default="components/componentN" />
		<manufacturer>
			<displayName key="AC_01" default="IBM" />
		</manufacturer>
	</packageIdentity>
 
	<topology>
		<resource type="OSRT:OperatingSystem" id="OS" />
	</topology>
 
	<content xsi:type="iudd:RootIUContent">
		<rootIU id="components/componentN">
			<variables>
				<parameters>
					<parameter name="installLocation" 

defaultValue="/usr/dummy.offr.1" />
			<parameter name="FunctionalArea" defaultValue="featurepackSI" />
				</parameters>
			</variables>
 
			<SCU id="deploy-portlets-applySIFeaturePack" targetRef="OS">
				<identity>
					<name>Do Configuration Task</name>
					<version>8.0.0.0</version>
					<displayName key="keyInBundle"
						default="Executes Configuration for this component" />
					<description key="keyInBundle"
						default="This section runs configuration for this component" />
				</identity>
				<unit>
					<configArtifact type="ConfigEngine">
						<parameters>
							<parameter name="targetName" value="deploy-portlets-applySIFeaturePack" />
						</parameters>
					</configArtifact>
				</unit>
			</SCU>
			<SCU id="remove-portlets-applySIFeaturePack" targetRef="OS">
				<identity>
					<name>Do Configuration Task</name>
					<version>1.0.0.0</version>
					<displayName key="keyInBundle"
						default="Executes Configuration for this component" />
					<description key="keyInBundle"
						default="This section runs configuration for this component" />
				</identity>
				<unit>
					<configArtifact type="ConfigEngine">
						<parameters>
							<parameter name="targetName" value="remove-portlets-applySIFeaturePack" />
						</parameters>
					</configArtifact>
				</unit>
			</SCU>
		</rootIU>
	</content>
 
</iudd:iudd>

Voir la section Fichier sdd.xml de niveau de composant pour plus d'informations sur l'édition du fichier sdd.xml.

Informations de syntaxe pour les noms de composant

La syntaxe de dénomination du composant est importante. Dans le fichier PAA, des dépendances déterminent une partie du nom de composant enregistré dans le fichier sdd.xml. Vous pouvez choisir librement le nom de vos composants ; cependant, les noms de composant doivent être uniques. ConfigEngine et, par extension, Solution Installer, impose une restriction selon laquelle un nom de composant ne doit pas entrer en conflit avec un composant existant dans le registre ConfigEngine. Cette restriction ne se limite pas à un assemblage mais s'étend à l'échelle du registre. Par conséquent, si un composant a le nom d'un composant existant, il n'est pas automatiquement installé. Si l'utilisateur veut installer ce nouveau composant il peut utiliser la tâche update-paa-components. Cette tâche supprime la version existante et installe le nouveau composant dans le cadre du nouvel assemblage.

Lorsque vous enregistrez les noms dans les fichiers sdd.xml, vous devez respecter la syntaxe suivante : components/componentName. Cette syntaxe est nécessaire pour permettre à Solution Installer de résoudre le nom de composant. Elle doit contenir le chemin complet allant du répertoire contenant le fichier sdd.xml de niveau d'assemblage, généralement le répertoire racine, au fichier sdd.xml de niveau de composant.

Le fichier PortalServer_root/doc/paa-samples/sample1.paa contient un composant figurant dans le répertoire de composants appelé 'Sample1'. Par conséquent, le nom de composant apparaît dans le fichier sdd.xml comme suit : components/Sample1. Il s'agit du chemin complet relatif au répertoire contenant le fichier sdd.xml de niveau d'assemblage.

Solution Installer suit l'approche du pack de fonctions fourni par ConfigEngine pour installer chacun des composants. Cette approche offre l'avantage de permettre à ConfigEngine de gérer l'ordre d'installation de chaque composant et L'approche du pack de fonctions permet d'opérer une distinction entre les points d'extension principaux du portail et les points utilisés pour installer le contenu PAA. Cette approche permet d'éliminer le risque de voir un utilisateur supprimer accidentellement les composants principaux du portail lorsque vous supprimez un point d'extension.

ConfigEngine installe le groupe de composants en fonction du point d'extension et contrôle l'ordre dans lequel ils s'exécutent. Par exemple, tous les fichiers AR sont installés ensemble. Tous les déploiements de portlet sont effectués simultanément. S'il est nécessaire que l'artefact d'un composant soit installé avant un autre, vous devez créer une dépendance dans le fichier sdd.xml. La dépendance fonctionne sur la base d'un point d'extension en ce qu'elle permet d'indiquer que les artefacts couverts par le point d'extension peuvent avoir un ordre. Par exemple, vous pouvez indiquer que le fichier EAR du composant 1 soit installé avant le fichier EAR dans le composant 2.
Remarque : La valeur du paramètre FunctionalArea est featurepackSI. Cette valeur est importante, car elle permet à Solution Installer de déterminer que les composants soient installés à l'aide du pack de fonctions Solution Installer. Voir le fichier sdd.xml exemple, au début du fichier, pour savoir comment implémenter l'approche de module de fonctions.
Dans l'exemple de fichier sdd.xml il existe deux éléments SCU. Le premier montre comment enregistrer le point d'extension en vue de déployer un portlet et le second comment supprimer les portlets.
<SCU id="deploy-portlets-applySIFeaturePack" targetRef="OS">
	<identity>
	<name>Do Configuration Task</name>
	<version>1.0.0.0</version>
		<displayName key="keyInBundle" default="Executes Configuration for this component" />
		<description key="keyInBundle" default="This section runs configuration for this
			component" />
	</identity>
	<unit>
	<configArtifact type="ConfigEngine">
	<parameters>
		<parameter name="targetName" value="deploy-portlets-applySIFeaturePack" />
		</parameters>
		</configArtifact>
	</unit>
		<register a dependency on a previous component-->
		<requirements>
			<requirement name=" deploy-portlets-applySIFeaturePack">
			<alternative name="dependentComponent"/>
		</requirement>
		</requirements>
</SCU>

L'exemple d'élément SCU indique à Solution Installer la tâche que vous voulez exécuter. Dans ce cas, le point d'extension s'appelle deploy-portlets-applySIFeaturePack. La différence des points d'extension principaux pour le portail réside dans l'ajout de l'élément ‘applySIFeaturePack' à la fin du point d'extension. Avec une tâche de désinstallation, c'est l'élément ‘removeSIFeaturePack' qui est ajouté. Cela permet à Solution Installer d'opérer la distinction entre des tâches d'installation et de désinstallation. Ajoutez ces chaînes aux noms de points d'extension pour opérer une distinction claire entre des points d'extension principaux et les point inclus en vue de permettre à Solution Installer de gérer une distribution PAA. Solution Installer attend et exécute uniquement des points d'extension conformes à ce format.

Pour plus d'informations sur l'indication d'une tâche d'implémentation pour un point d'extension, voir Tâches d'installation pour plus d'informations.