Avant de pouvoir ajouter des actifs à une ou plusieurs
applications de niveau métier, vous devez les enregistrer en tant que
tels dans la configuration du produit. Ces actifs sont le plus
souvent des éléments de la logique métier de l'application, tels que
des archives Java EE
(Java™
Platform, Enterprise Edition), des bibliothèques et d'autres fichiers
de ressources. L'importation d'un actif l'enregistre dans la
configuration du produit.
Avant de commencer
Vous disposez d'un ou plusieurs fichiers binaires
d'application que vous souhaitez ajouter à une application de niveau métier. Vous devez enregistrer ces fichiers binaires
comme actifs avant de pouvoir les ajouter à l'application de niveau métier.
Pourquoi et quand exécuter cette tâche
Avant qu'une application de niveau métier utilisant un actif
puisse être démarrée sur l'environnement d'exécution cible, les
fichiers binaires de l'actif doivent être extraits à un emplacement
précis du système de fichiers local de cet environnement,
l'emplacement en question étant défini par le déployeur. L'emplacement d'un actif extrait les fichiers binaires de l'actif
vers un emplacement local de l'environnement d'exécution cible.
L'environnement d'exécution du serveur d'applications lisant les fichiers binaires
de l'actif lors du lancement de l'application ou lorsqu'il sert une demande de client
entrant d'un client, détermine le format d'extraction des fichiers binaire de l'actif. Le format
d'extraction peut inclure des fichiers JAR (Java archive) ou compressés (zip).
Les étapes expliquent comment importer l'actif à l'aide de la console
d'administration. Vous pouvez également utiliser l'outil wsadmin ou
une programmation.
Procédure
- Cliquez sur
dans l'arborescence de navigation de
la console.
- Sur la page de téléchargement d'actif,
spécifiez le package de l'actif à importer.
- Spécifiez le nom complet de l'actif.
- Cliquez sur Suivant.
- Dans la page Sélection d'options pour l'importation d'un actif, spécifiez les paramètres de l'actif.
Vous pouvez généralement cliquer sur
Suivant et utiliser les valeurs par défaut.
- Facultatif : Dans la zone
Description de l'actif, entrez une courte
description de l'actif.
- Facultatif : Dans la zone URL de
destination des fichiers binaires de l'actif, spécifiez
l'emplacement cible de l'actif.
Ce paramètre spécifie l'endroit où le produit place les fichiers extraits de
l'actif. Après l'importation d'un actif, le produit recherche celui-ci à cet
emplacement lorsqu'il exécute une application qui utilise l'actif en
question.
Si vous ne spécifiez pas de valeur, le produit installe
l'actif à l'emplacement par
défaut, ${racine_profil}/installedAssets/nom_actif/BASE/.
- Facultatif : Pour Asset type aspects,
examinez le type et la version du contenu de l'actif indiqués par le produit. Vous ne pouvez pas
modifier la valeur de ce paramètre.
L'aspect de type annonce généralement
le type du contenu de l'application, tel qu'une spécification sur laquelle l'application
est écrite. Par exemple, un bean enterprise (EJB) prenant en charge la spécification
EJB version 2.0 comporte les aspects type=EJB,version=2.0.
Si
l'aspect de type est none et si l'actif est un fichier JAR, le
produit associe alors par défaut un aspect de type javarchive
à l'actif.
- Pour Droits d'accès du fichier,
indiquez tous les droits d'accès aux fichiers définis sur les
fichiers binaires de l'actif afin que l'environnement d'exécution
cible puisse lire ou exécuter l'actif. L'importation de l'actif extrait ses fichiers binaires sur le disque
local de l'environnement d'exécution cible.
Essayez
d'importer l'actif en utilisant la valeur par défaut. Pour des informations détaillées sur le paramètre Droits d'accès aux fichiers, consultez l'aide en ligne de la page Sélection d'options pour l'importation d'un actif.
Restriction : Les applications OSGi n'utilisent pas de paramètre Droits d'accès
aux fichiers.
- Pour Relations actuelles de l'actif, ajoutez
les autres actifs nécessaires à l'exécution de l'actif que vous importez ou retirez ceux qui
lui sont inutiles.
Lorsque le produit importe un actif JAR, le produit
détecte des relations d'actif automatiquement en faisant correspondre les dépendances définies
dans le manifeste JAR avec les actifs déjà importés dans le domaine
administratif.
- Pour la propriété Valider l'actif, précisez si le produit
doit contrôler la validité de l'actif.
Ce paramètre est désélectionné par défaut. La valeur false (Non) est appropriée
à la plupart des actifs. Sélectionnez true (Oui)
uniquement si la validation de l'actif est nécessaire.
Le produit ne sauvegarde pas la valeur
indiquée pour Validate asset. Par conséquent, si vous choisissez
de valider l'actif maintenant (Oui) et de le mettre à jour ultérieurement, lors de sa mise à jour, vous devez activer ce paramètre à nouveau pour que le produit
puisse valider les fichier mis à jour.
Restriction : Les applications OSGi n'utilisent pas de paramètre Valider l'actif.
- Cliquez sur Suivant.
- Dans la page Récapitulatif, cliquez sur Terminer.
Résultats
Plusieurs messages s'affichent, indiquant si votre actif a été correctement
importé.
Un actif peut contenir plusieurs objets déployables définis
par le contenu de l'application de cet actif. Un objet déployable fait partie
de l'actif ; vous pouvez le mapper vers une cible de déploiement telle qu'un serveur
d'applications ou un cluster. Si le produit importe correctement
l'actif, les objets déployables appropriés sont alors identifiés dans l'actif et
sont utilisés ultérieurement lorsqu'une unité de composition est créée à partir de cet
actif.
En cas d'échec à l'importation de l'actif,
lisez les messages pour en déterminer la cause et essayez d'importer à nouveau
l'actif.
Au préalable, corrigez les valeurs indiquées dans les
messages.
Que faire ensuite
Si le produit importe correctement l'actif et affiche la liste des actifs
sur la page Actifs, cliquez sur Sauvegarder.
Ajoutez une unité de composition à une application de niveau
métier à l'aide de la ressource importée. Une ressource comprise dans une
application de niveau métier est représentée par une unité de composition.