Ce chapitre se compose des rubriques suivantes :
Présentation de l'installation de la mise à jour 2 de OpenSSO 8.0
Comparaison d'un fichier WAR OpenSSO et de son fichier manifest interne
Mise à jour 2 de OpenSSO 8.0 est disponible sous forme de patch TBS.
Avant d'installer la mise à jour 2 de OpenSSO 8.0 (ou des patches ultérieurs), vérifiez les informations sur les nouvelles fonctions, les exigences matérielles et logicielles, ainsi que les problèmes et solutions dans ce document.
La mise à jour 2 de OpenSSO 8.0 comprend un fichier opensso.war que vous pouvez installer à l'aide des méthodes suivantes :
Appliquez un patch à un déploiement de OpenSSO 8.0 existant : utilisez l'utilitaire ssopatch de la mise à jour 2 pour appliquer un patch à un déploiement de OpenSSO 8.0 existant, tel que décrit dans ce chapitre.
Note : Oracle prend en charge l'application de patch uniquement sur les versions de OpenSSO 8.0. Par exemple, l'application de patch sur OpenSSO 8.0 avec la mise à jour 2 de OpenSSO 8.0 est prise en charge.
Installez un nouveau déploiement de la mise à jour 2 de OpenSSO 8.0 : installez et configurez le fichier opensso.war de la mise à jour 2 de OpenSSO 8.0, tel que décrit dans le Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide.
Créez un nouveau fichier WAR spécialisé : utilisez le script createwar pour créer un des nouveaux fichiers WAR suivants à partir du fichier opensso.war de la mise à jour 2 :
WAR de la console d'administration OpenSSO uniquement
WAR du serveur de l'IU d'authentification distribuée
WAR du serveur OpenSSO uniquement, sans la console d'administration
WAR du service de détection du fournisseur d'identités
Pour en savoir plus, consultez le Chapitre 4, Creating a Specialized OpenSSO Enterprise 8.0 Update 1 WAR File du Sun OpenSSO Enterprise 8.0 Update 1 Release Notes.
Appliquez un patch à un fichier WAR OpenSSO spécialisé existant : utilisez l'utilitaire ssopatch de la mise à jour 2 pour appliquer un patch à un fichier WAR OpenSSO 8.0 spécialisé existant, tel que décrit dans leChapitre 23, Patching OpenSSO Enterprise 8.0 du Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide
Si vous exécutez Access Manager 7.1 ou Access Manager 7 2005Q4 et que vous voulez effectuer une mise à niveau vers la mise à jour 2, procédez aux étapes suivantes :
Mettez à niveau Access Manager 7.x vers OpenSSO 8.0, tel que décrit dans le Sun OpenSSO Enterprise 8.0 Upgrade Guide.
Appliquez le patch de la mise à jour 2, tel que décrit dans ce chapitre.
Sun sort régulièrement des patches pour la mise à jour 2 de OpenSSO 8.0. Pour en savoir plus sur ces patches, consultez régulièrement cette section.
Lisez la Présentation de l'utilitaire ssopatch .
Installez l'utilitaire de patch pour votre plate-forme, tel que décrit dans Installation de l'utilitaire ssopatch.
Obtenez des informations sur votre fichier WAR existant, afin de déterminer s'il a été personnalisé ou modifié, tel que décrit dans Comparaison d'un fichier WAR OpenSSO et de son fichier manifest interne.
Comparez votre fichier WAR existant et le fichier WAR de la mise à jour 2, pour retourner les fichiers personnalisés dans le WAR d'origine, les fichiers mis à jour dans le nouveau fichier WAR et les fichiers ajoutés ou supprimés entre les deux versions du WAR, tel que décrit dans Comparaison de deux fichiers WAR OpenSSO.
Sauvegardez et archivez votre fichier WAR OpenSSO existant, tel que décrit dans Sauvegarde d'un fichier WAR OpenSSO.
Appliquez un patch à votre fichier WAR OpenSSO, tel que décrit dans Application de patch à un fichier WAR OpenSSO.
Exécutez le script updateschema, tel que décrit dans Exécution du script updateschema.
Note : si vous appliquez un patch à un fichier WAR spécialisé que vous avez généré à partir d'un opensso.war, tel qu'un serveur OpenSSO uniquement, une console d'administration uniquement, un serveur d'IU d'authentification distribuée ou un WAR de service de détection de fournisseur d'identités, consultez Application de patch à un WAR OpenSSO spécialisé.
L'utilitaire ssopatch est un utilitaire de ligne de commande Java disponible sur les systèmes Solaris et Linux sous la forme ssopatch et sur Windows sous la forme ssopatch.bat.
Note : la syntaxe de ssopatch dans la mise à jour 2 de OpenSSO 8.0 a subi des modifications considérables depuis la sortie de OpenSSO 8.0. Pour connaître la nouvelle syntaxe, consultez Exécution du script updateschema.
L'utilitaire de patch ssopatch effectue les fonctions suivantes :
Comparer un fichier WAR OpenSSO à son fichier manifest d'origine, afin de déterminer s'il a été personnalisé ou modifié
Comparer deux fichiers WAR OpenSSO, pour déterminer les différences entre les deux, notamment toute personnalisation apportée au fichier WAR d'origine et toute modification dans le nouveau fichier WAR
Générer une zone de transit des fichiers devant générer un nouveau fichier WAR OpenSSO auquel on a appliqué un patch
Après avoir téléchargé et décompressé le fichier ZIP de la mise à jour 2 de OpenSSO 8.0 (opensso_80U2.zip ), les utilitaires de patch et fichiers associés seront disponibles dans le fichier ssoPatchTools.zip, dans le répertoire zip-root/opensso/tools , où zip-root correspond à l'emplacement où vous avez décompressé opensso_80U2.zip.
L'utilitaire ssopatch utilise un fichier global pour déterminer le contenu d'un fichier WAR OpenSSO spécifique. Un fichier global est un fichier texte ASCII qui contient :
une chaîne qui identifie la version spécifique du fichier WAR OpenSSO
tous les fichiers individuels dans le fichier WAR OpenSSO, avec des informations sur la somme de contrôle pour chaque fichier
Le fichier global est généralement nommé OpenSSO.manifest et est stocké dans le répertoire META-INF du fichier WAR OpenSSO.
L'utilitaire ssopatch envoie ses résultats vers la sortie standard (stdout). Si vous préférez, vous pouvez capturer la sortie ssopatch en redirigeant la sortie vers un fichier. Si ssopatch se termine correctement, il retourne un code de sortie de zéro (0). En cas d'erreur, ssopatch retourne un code de sortie autre que zéro.
Avant d'installer l'utilitaire ssopatch :
Téléchargez et décompressez le fichier ZIP de la mise à jour 2 de OpenSSO 8.0 (opensso_80U2.zip ).
Paramétrez votre point de variable d'environnement JAVA_HOME à JDK 1.5 ou une version ultérieure.
Localisez le fichier ssoPatchTools.zip dans le répertoire zip-root/opensso/tools, où zip-root correspond à l'emplacement où vous avez décompressé opensso_80U2.zip .
Créez un nouveau répertoire pour décompresser le fichier ssoPatchTools.zip. Par exemple : ssopatchtools
Décompressez le fichier ssoPatchTools.zip dans le nouveau répertoire.
Si vous souhaitez exécuter l'utilitaire ssopatch à partir d'un répertoire autre que son répertoire actuel, sans fournir le chemin d'accès complet, ajoutez l'utilitaire à votre variable PATH.
Le tableau suivant décrit les fichiers du ssoPatchTools.zip.
Fichier ou répertoire |
Description |
---|---|
LISEZMOI |
Fichier LisezMoi qui décrit ssopatch |
/lib |
Fichiers JAR ssopatch requis |
/patch |
Scripts updateschema et updateschema.bat et fichiers XML associés |
/resources |
Fichiers de propriétés requis |
ssopatch et ssopatch.bat |
Utilitaires pour les systèmes Solaris, Linux et Windows |
Avant de commencer, sauvegardez votre fichier WAR OpenSSO existant et vos données de configuration :
Copiez votre fichier WAR OpenSSO existant dans un emplacement sûr. Puis, si vous devez sauvegarder la mise à jour 2 pour une raison quelconque, vous pouvez redéployer votre copie de sauvegarde du fichier WAR.
Sauvegardez vos données de configuration, tel que décrit dans le Chapitre 15, Backing Up and Restoring Configuration Data du Sun OpenSSO Enterprise 8.0 Administration Guide.
ssopatch --help|-? [--locale|-l] ssopatch --war-file|-o [--manifest|-m] [--locale|-l] ssopatch --war-file|-o --war-file-compare|-c [--staging|-s] [--locale|-l] [--override|-r] [--overwrite|-w] |
où les options sont :
-war-file|-o indique un chemin d'accès à un fichier WAR (tel que opensso.war) déployé auparavant.
-manifest|-m indique le chemin d'accès au fichier global que vous souhaitez créer. Le fichier global sera généré à partir du fichier WAR indiqué par -war-file|-o si cette option est offerte.
-war-file-compare|-c indique un chemin d'accès à un fichier WAR à comparer avec le fichier WAR indiqué par -war-file|-o .
-staging|-s indique un chemin d'accès à la zone de transit où les fichiers d'un WAR OpenSSO seront inscrits.
-locale|-l indique la langue à utiliser. Si cette option n'est pas précisée, ssopatch utilise la langue du système par défaut.
-override|-r écrase le contrôle des révisions pour les deux fichiers WAR. Le contrôle des révisions détermine les versions des fichiers WAR et continue uniquement si les versions sont compatibles. Cette option vous permet d'ignorer ce contrôle.
La valeur par défaut est false (contrôle des révisions effectué).
-overwrite|-w écrase les fichiers de la zone de transit existante. La valeur par défaut est false (les fichiers ne sont pas écrasés).
Utilisez cette procédure pour déterminer si un fichier WAR OpenSSO a été personnalisé ou modifié depuis son téléchargement.
L'utilitaire ssopatch génère un nouveau fichier manifest interne, puis le compare au fichier manifest stocké dans le fichier WAR OpenSSO d'origine dans le répertoire META-INF.
Exécutez ssopatch pour comparer le fichier WAR OpenSSO à son fichier manifest interne. Par exemple :
./ssopatch -o /zip-root/opensso/deployable-war/opensso.war Generating Manifest for: /zip-root/opensso/deployable-war/opensso.war Comparing manifest of Internal (Enterprise 8.0 Build 6(200810311055)) against /zip-root/opensso/deployable-war/opensso.war (generated-200905050855) File not in original war (images/login-origimage.jpg) File updated in new war (images/login-backimage.jpg) File updated in new war (WEB-INF/classes/amConfigurator.properties) Differences: 3 |
Cet exemple montre les modifications apportées au fichier WAR d'origine :
images/login-origimage.jpg est dans opensso.war mais pas dans le fichier manifest d'origine.
images/login-backimage.jpg a été personnalisé dans opensso.war à partir du fichier manifest d'origine.
Le fichier WEB-INF/classes/amConfigurator.properties a été personnalisé dansopensso.war à partir du fichier manifest d'origine.
Utilisez cette procédure pour comparer deux fichiers WAR, pour montrer les fichiers qui ont été :
personnalisés dans un fichier WAR OpenSSO d'origine
mis à jour dans un nouveau fichier WAR OpenSSO
ajoutés ou supprimés entre les deux versions de WAR OpenSSO
Exécutez ssopatch pour comparer les deux fichiers WAR. Dans l'exemple, l'option -override est utilisée pour écraser le cotnrôle des révisions entre les deux fichiers WAR :
./ssopatch -o /zip-root/opensso/deployable-war/opensso.war -c /u1/opensso/deployable-war/opensso.war --override Generating Manifest for: /zip-root/opensso/deployable-war/opensso.war Original manifest: Enterprise 8.0 Build 6(200810311055) New manifest: Enterprise 8.0 Update 2 Build 6.1(200904300525) Versions are compatible Generating Manifest for: /u1/opensso/deployable-war/opensso.war Comparing manifest of /zip-root/opensso/deployable-war/opensso.war (generated-200905050919) against /u1/opensso/deployable-war/opensso.war (generated-200905050920) File updated in new war(WEB-INF/classes/amClientDetection_en.properties) File updated in new war(WEB-INF/classes/fmSAMLConfiguration_fr.properties) ... Differences: 1821 Customizations: 3 |
Cet exemple montre les fichiers qui ont été mis à jour et personnalisés dans le nouveau fichier WAR.
Utilisez cette procédure pour créer une nouvelle zone de transit, où un fichier WAR d'origine est fusionné à un nouveau fichier WAR.
Cette opération permet de comparer les fichiers manifest pour chaque fichier WAR et indique :
les fichiers personnalisés dans le fichier WAR d'origine
les fichiers mis à jour dans un nouveau fichier WAR
les fichiers ajoutés ou supprimés entre les deux versions de fichiers WAR
Le ssopatch copie alors les fichiers appropriés dans un répertoire de transit, où vous devez ajouter toute personnalisation avant de créer et de déployer le nouveau fichier WAR auquel on a appliqué un patch.
Bien que le ssopatch ne modifie pas votre fichier opensso.war d'origine, il est recommandé de le sauvegarder, au cas où vous devriez supprimer le fichier opensso.war auquel un patch a été appliqué.
Exécutez ssopatch pour créer la zone de transit. Par exemple :
./ssopatch -o /zip-root/opensso/deployable-war/opensso.war -c /u1/opensso/deployable-war/opensso.war --override -s /tmp/staging Generating Manifest for: /zip-root/opensso/deployable-war/opensso.war Original manifest: Enterprise 8.0 Build 6(200810311055) New manifest: Enterprise 8.0 Update 2 Build 6.1(200904300525) Versions are compatible Generating Manifest for: /u1/opensso/deployable-war/opensso.war Comparing manifest of /zip-root/opensso/deployable-war/opensso.war (generated-200905051031) against /u1/opensso/deployable-war/opensso.war (generated-200905051032) File was customized in original, but not found in new war. Staging area using original war version (samples/saml2/sae/header.jsp) File was customized in original, but not found in new war. Staging area using original war version (WEB-INF/template/opends/config/upgrade/config.ldif.4517) File was customized in original, but not found in new war. Staging area using original war version (WEB-INF/template/opends/config/upgrade/schema.ldif.4517) Differences: 1813 Customizations: 0 |
Dans cet exemple, /tmp/staging correspond à la zone de transit où ssopatch copie les fichiers.
Mettez les fichiers à jour si nécessaire dans la zone de transit, à l'aide des résultats de l'étape précédente.
Utilisez le tableau suivant pour déterminer la mesure à prendre pour chaque fichier avant de générer un nouveau fichier WAR auquel o na appliqué un patch.
Résultats de ssopatch |
Explication et action requise |
---|---|
Fichier pas dans le WAR d'origine filename |
Le fichier indiqué n'existe pas dans le fichier WAR d'origine mais se trouve dans la dernière version du fichier WAR. Action : aucune |
Fichier mis à jour dans le nouveau WAR filename |
Le fichier indiqué existe dans les fichiers WAR d'origine et nouveau et a été mis à jour dans la dernière version du fichier WAR. Aucune personnalisation n'a été effectuée dans le fichier WAR d'origine. Action : aucune |
Fichier personnalisé filename |
Le fichier indiqué existe dans les deux fichiers WAR, a été personnalisé dans la version originale du fichier WAR, mais n'a pas été mis à jour dans la dernière version du fichier. Action : aucune |
Il se peut qu'une personnalisation manuelle soit nécessaire filename |
Le fichier existe dans les deux fichiers WAR, a été personnalisé dans la version originale du fichier WAR, et a été mis à jour dans la dernière version du fichier. Action : si vous souhaitez que vos personnalisations apparaissent dans le fichier, vous devez les ajouter manuellement au nouveau fichier mis à jour dans le répertoire de transit. |
Le fichier a été personnalisé dans la version originale, mais est introuvable dans le nouveau fichier WAR |
Le fichier existait dans le fichier WAR d'origine, mais n'est pas dans le nouveau. Action : aucune. |
Etapes suivantes
Créez un nouveau fichier WAR OpenSSO à partir des fichiers de la zone de transit. Par exemple :
cd /tmp/staging jar cvf /patched/opensso.war * |
où /patched/opensso.war correspond au nouveau fichier WAR OpenSSO auquel un patch a été appliqué
Redéployez le fichier /patched/opensso.war sur le conteneur Web à l'aide de l'URI de déploiement d'origine. Par exemple, /opensso
Modifications de configuration de OpenSSO. Un nouveau fichier WAR OpenSSO peut comporter des modifications de configuration qui ne figuraient pas dans votre fichier WAR d'origine. Toute modification de configuration, le cas échéant, sera documentée séparément pour chaque patch. Consultez la documentation sur les patches ainsi que les Sun OpenSSO Enterprise - 8.0 - notes de version pour en savoir plus sur les modifications de configuration. (La chaîne de version du fichier global OpenSSO sera modifiée, même s'il n'y a aucune modification de configuration dans le nouveau fichier WAR.)
Si vous devez supprimer votre version avec patch, annulez le déploiement du fichier WAR avec patch, puis redéployez votre fichier WAR d'origine.
Un fichier global OpenSSO est un fichier texte qui identifie tous les fichiers individuels d'un fichier WAR pour une version spécifique, avec des informations sur la somme de contrôle pour chaque fichier.
Utilisez cette procédure pour créer un fichier global que vous pouvez inclure dans un WAR OpenSSO spécialisé, comme un WAR de serveur OpenSSO uniquement, console d'administration uniquement, serveur d'IU d'authentification distribuée ou du service de détection de fournisseur d'identités
Exécutez ssopatch pour créer le fichier global OpenSSO. Par exemple :
./ssopatch -o zip-root/opensso/deployable-war/opensso.war --manifest /tmp/manifest |
où opensso.war est un fichier WAR OpenSSO existant.
L'utilitaire ssopatch crée un nouveau fichier global nommé manifest dans le répertoire /tmp.
Pour permettre au fichier WAR de se voir appliquer un patch, copiez ce nouveau fichier global dans le répertoire META-INF à l'intérieur du fichier opensso.war . Par exemple :
mkdir META-INF cp /tmp/manifest META-INF jar uf opensso.war META-INF/manifest |
Si vous avez précédemment créé un WAR OpenSSO spécialisé, comme un WAR serveur OpenSSO uniquement, console d'administration uniquement, serveur IU d'authentification distribuée ou service de détection de fournisseur d'identités, vous pouvez y appliquer un patch à l'aide de l'utilitaire ssopatch .
Créez un fichier global pour votre WAR OpenSSO spécialisé, tel que décrit dans Création d'un fichier global WAR OpenSSO.
Note : créez le fichier global basé sur le fichier opensso.war OpenSSO 8.0 d'origine, comme le fournit Sun, avant toute personnalisation. Si le fichier manifest est créé après les personnalisations, ssopatch peut utiliser les fichiers de la mise à jour 2, plutôt que vos personnalisations, vous devriez alors refaire vos personnalisations après l'application des patches.
Générez le fichier WAR OpenSSO spécialisé à partir du fichier opensso.war de la mise à jour 2 de OpenSSO 8.0, tel que décrit dans le Chapitre 4, Creating a Specialized OpenSSO Enterprise 8.0 Update 1 WAR File du Sun OpenSSO Enterprise 8.0 Update 1 Release Notes.
Utilisez l'utilitaire ssopatch pour comparer vos ancien et nouveau fichiers WAR.
Générez une zone de transit pour le nouveau fichier WAR spécialisé, tel que décrit dans Pour créer une zone de transit pour appliquer un patch à un fichier WAR OpenSSO .
Redéployez le nouveau fichier WAR spécialisé.
Après avoir exécuté ssopatch, exécutez le updateschema.sh sur les systèmes Solaris ou Linux ou updateschema.bat sous Windows. Le script met à jour la version du serveur OpenSSO, ajoute de nouvelles propriétés serveur par défaut, ajoute de nouveaux schémas d'attributs requis pour les correctifs de bogues et les améliorations dans la mise à jour 2. Vous devez exécuter updateschema afin de mettre à jour la version du serveur.
Le script updateschema.sh ou updateschema.bat nécessite la version de la mise à jour 2 (ou une version ultérieure) de l'utilitaire de ligne de commande ssoadm . Par conséquent, avant d'exécuter ce script, installez les outils d'administration de la mise à jour 2, tel que décrit dans le Chapitre 3, Installing the OpenSSO Enterprise 8.0 Update 1 Admin Tools du Sun OpenSSO Enterprise 8.0 Update 1 Release Notes.
Le script updateschema.bat exécute plusieurs commandes ssoadm. Par conséquent, avant d'exécuter updateschema.bat sous Windows, créez un fichier de mots de passe qui contient l'utilisateur du mot de passe en texte clair pour l'utilisateur amadmin. Le script updateschema.bat vous invite à indiquer le chemin d'accès au fichier de mots de passe. Avant la fin du script, le fichier de mots de passe est supprimé.
Passez au répertoire patch-tools/patch , où patch-tools correspond à l'emplacement où vous avez décompressé ssoPatchTools.zip.
Exécutez updateschema.sh ou updateschema.bat . Par exemple, sur les systèmes Solaris :
./updateschema.sh
Lorsque les scripts vous y invitent, indiquez les informations suivantes :
Chemin d'accès complet vers l'utilitaire ssoadm (à l'exclusion de ssoadm lui-même). Par exemple : /opt/ssotools/opensso/bin
mot de passe amadmin
Le script updateschema.sh ou updateschema.bat écrit des messages ou erreurs à la sortie standard.
Redémarrez le conteneur Web de la mise à jour 2 de OpenSSO 8.0.
Si vous devez supprimez l'installation de votre patch, redéployez simplement le fichier opensso.war d'origine (ou le fichier WAR spécialisé).