WebSphere Dashboard Framework - Guide d`installation

Transcription

WebSphere WebSphere Dashboard Framework
®
Version 6.1.5
Guide d’installation
WebSphere WebSphere Dashboard Framework
®
Version 6.1.5
Guide d’installation
Important
Avant d’utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à la
section «Remarques», à la page 19.
Première édition - avril 2010
LE PRESENT DOCUMENT EST LIVRE EN L’ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM
DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE
CONTREFACON AINSI QU’EN CAS DE DEFAUT D’APTITUDE A L’EXECUTION D’UN TRAVAIL DONNE.
Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui y
sont fournies sont susceptibles d’être modifiées avant que les produits décrits ne deviennent eux-mêmes
disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou
services non annoncés dans ce pays. Cela ne signifie cependant pas qu’ils y seront annoncés.
Pour plus de détails, pour toute demande d’ordre technique, ou pour obtenir des exemplaires de documents IBM,
référez-vous aux documents d’annonce disponibles dans votre pays, ou adressez-vous à votre partenaire
commercial.
Vous pouvez également consulter les serveurs Internet suivants :
v http://www.fr.ibm.com (serveur IBM en France)
v http://www.can.ibm.com (serveur IBM au Canada)
v http://www.ibm.com (serveur IBM aux Etats-Unis)
Compagnie IBM France
Direction Qualité
17, avenue de l’Europe
92275 Bois-Colombes Cedex
© Copyright IBM France 2010. Tous droits réservés.
© Copyright International Business Machines Corporation 2007, 2010.
Table des matières
Avis aux lecteurs canadiens . . . . . . v
Chapitre 1. Installation de WebSphere
Dashboard Framework . . . . . . . . 1
Chapitre 2. Configuration logicielle
requise . . . . . . . . . . . . . . . 3
Chapitre 3. Installation et configuration
de WebSphere Dashboard Framework. . 5
Installation de WebSphere Dashboard Framework
sous Windows . . . . . . . . . . . . . .
Installation de WebSphere Dashboard Framework
sous Linux . . . . . . . . . . . . . . .
Installation dans Rational Application
Developer/Rational Software Architect sur Linux .
Configuration de votre environnement après
l’installation . . . . . . . . . . . . . .
IBM WebSphere Portal . . . . . . . . . .
Apache Tomcat . . . . . . . . . . . .
Configuration d’un environnement de serveur de test
imbriqué. . . . . . . . . . . . . . . .
Désactivation de la validation . . . . . . .
© Copyright IBM Corp. 2007, 2010
5
6
8
8
9
9
9
9
Configuration du serveur de test . . .
Modification du paramètre classPath du
compilateur de méthode . . . . . .
Configuration de la prise en charge de votre
nationale . . . . . . . . . . . .
.
.
. 10
. . . 10
langue
. . . 11
Chapitre 4. Migration. . . . . . . . . 13
Migration vers une version plus récente de
WebSphere Dashboard Framework . . . . . .
Mise à niveau d’un projet depuis la version 6.0 ou
une version ultérieure . . . . . . . . . . .
Mise à niveau d’annotations depuis la version 6.0
Mise à niveau des portlets vers l’API Java Standard
Portlet . . . . . . . . . . . . . . . .
13
13
14
15
Chapitre 5. Suppression d’IBM
WebSphere Dashboard Framework . . 17
Windows .
Linux . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 17
. 17
Annexe. Remarques . . . . . . . . . 19
Marques
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
iii
iv
WebSphere Dashboard Framework - Guide d’installation
Avis aux lecteurs canadiens
Le présent document a été traduit en France. Voici les principales différences et
particularités dont vous devez tenir compte.
Illustrations
Les illustrations sont fournies à titre d’exemple. Certaines peuvent contenir des
données propres à la France.
Terminologie
La terminologie des titres IBM peut différer d’un pays à l’autre. Reportez-vous au
tableau ci-dessous, au besoin.
IBM France
IBM Canada
ingénieur commercial
représentant
agence commerciale
succursale
ingénieur technico-commercial
informaticien
inspecteur
technicien du matériel
Claviers
Les lettres sont disposées différemment : le clavier français est de type AZERTY, et
le clavier français-canadien de type QWERTY.
OS/2 et Windows - Paramètres canadiens
Au Canada, on utilise :
v les pages de codes 850 (multilingue) et 863 (français-canadien),
v le code pays 002,
v le code clavier CF.
Nomenclature
Les touches présentées dans le tableau d’équivalence suivant sont libellées
différemment selon qu’il s’agit du clavier de la France, du clavier du Canada ou
du clavier des États-Unis. Reportez-vous à ce tableau pour faire correspondre les
touches françaises figurant dans le présent document aux touches de votre clavier.
v
Brevets
Il est possible qu’IBM détienne des brevets ou qu’elle ait déposé des demandes de
brevets portant sur certains sujets abordés dans ce document. Le fait qu’IBM vous
fournisse le présent document ne signifie pas qu’elle vous accorde un permis
d’utilisation de ces brevets. Vous pouvez envoyer, par écrit, vos demandes de
renseignements relatives aux permis d’utilisation au directeur général des relations
commerciales d’IBM, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7.
Assistance téléphonique
Si vous avez besoin d’assistance ou si vous voulez commander du matériel, des
logiciels et des publications IBM, contactez IBM direct au 1 800 465-1234.
vi
Chapitre 1. Installation de WebSphere Dashboard Framework
Suivez les instructions ci-dessous pour installer ou désinstaller IBM® WebSphere
Dashboard Framework.
Ce produit opère en tant que plug-in dans les environnements de développement
intégré (IDE) basés Eclipse. Si vous ne disposez pas d’un des environnements de
développement intégré pris en charge, le programme d’installation implantera sur
votre poste Eclipse.
Avant l’installation, vous devez installer WebSphere Portal ou l’un des serveurs
d’applications pris en charge. Si vous ne disposez pas de serveur d’applications, le
programme d’installation en fournit un à des fins de développement.
Pour plus d’informations sur les logiciels pris en charge, voir la configuration
logicielle requise.
1
2
Chapitre 2. Configuration logicielle requise
Avant d’installer IBM WebSphere Dashboard Framework, examinez les exigences
logicielles.
Consultez le document détaillé sur les configurations requises à l’URL suivante :
http://www.ibm.com/support
3
4
Chapitre 3. Installation et configuration de WebSphere
Dashboard Framework
La présente section décrit comment exécuter le programme d’installation et
configurer votre serveur pour prendre en charge les applications du tableau de
bord.
Pourquoi et quand exécuter cette tâche
Suivez les étapes pour installer et configurer IBM WebSphere Dashboard
Framework.
Installation de WebSphere Dashboard Framework sous Windows
Cette rubrique explique comment exécuter le programme d’installation afin de
configurer votre environnement de développement.
Procédez comme suit pour installer Portlet Factory Designer et IBM WebSphere
Dashboard Framework.
1. Lancez le programme d’installation (install.bat).
2. Lorsque vous y êtes invité, sélectionnez la langue dans laquelle vous
souhaitez utiliser le produit. Cliquez sur OK.
3. Une page d’introduction contenant notamment les informations d’avis
d’auteur s’affiche. Pour poursuivre l’installation, cliquez sur Suivant
4. Lisez le contrat de licence et sélectionnez J’accepte les dispositions du contrat
de licence pour poursuivre l’installation, puis cliquez sur Suivant.
Remarque : Si vous n’acceptez pas les dispositions du contrat de licence, vous
serez invité à quitter l’installation.
5. Les options d’installation disponibles sont les suivantes :
v L’installation standard permet de mettre à disposition tous les éléments
requis pour une mise en route rapide
Sélectionnez cette option afin d’inclure Eclipse et WebSphere Application
Server Community Edition dans votre installation Portlet Factory. Si cette
option est sélectionnée, le programme d’installation installe Eclipse, Portlet
Factory, et IBM WebSphere Application Server Community Edition (WAS
CE). Si vous sélectionnez cette option, passez à l’étape 10.
v L’installation personnalisée permet de sélectionner les fonctions et les
emplacements d’installation
Sélectionnez cette option si vous devez spécifier en détail vos options
logicielles et leur emplacement d’installation.
Dans la zone Sélectionnez le répertoire d’installation, spécifiez
l’emplacement où installer les fichiers Portlet Factory et cliquez sur Suivant.
6. Passez à l’étape suivante si vous n’avez pas besoin d’installer un serveur
Lotus Mashups en local.
5
(Facultatif) Si le programme d’installation détecte un serveur Lotus Mashups,
indiquez le nom d’utilisateur, le mot de passe et le port pour ce serveur.
Cliquez ensuite sur Suivant.
7. Dans le panneau de spécification des éléments à installer, sélectionnez un
environnement de développement intégré à utiliser avec Portlet Factory
Designer. Les options d’installation disponibles sont les suivantes :
v Installer Designer avec une nouvelle copie d’Eclipse
Sélectionnez cette option si vous ne disposez pas encore d’un
environnement de développement intégré. Si cette option est sélectionnée, le
programme d’installation installe Eclipse et Portlet Factory Designer.
Remarque : Si vous sélectionnez cette option ainsi qu’un répertoire
contenant une installation existante d’Eclipse, un message
d’avertissement s’affiche. Sélectionnez un autre répertoire pour
continuer l’installation.
v Installer dans la version existante d’IBM Rational Application Developer
Sélectionnez cette option si vous souhaitez utiliser un environnement de
développement Rational que vous avez déjà installé. Le programme
d’installation ajoute les éléments de menu Portlet Factory à la version en
cours de votre environnement de développement Rational.
v Installer dans la version existante d’Eclipse
Sélectionnez cette option pour utiliser une version de l’environnement de
développement intégré Eclipse déjà installée. Le programme d’installation
ajoute à la version en cours de votre environnement de développement
intégré Eclipse des éléments de menu spécifiques à Portlet Factory.
8. Dans l’écran de spécification de l’environnement de développement intégré,
indiquez l’emplacement de l’environnement de développement intégré, puis
cliquez sur Suivant. Si vous avez besoin de rechercher l’emplacement, cliquez
sur Sélectionner.
9. L’option d’installation d’IBM WebSphere Application Server Community
Edition (WAS CE) s’affiche. WAS CE est un serveur d’application J2EE (Java™
2 Platform Enterprise Edition) à source ouverte basé sur Apache Geronimo.
Vous pouvez utiliser WAS CE pour activer le développement et le test
d’applications simplement et rapidement. Si vous souhaitez installer WAS CE,
cliquez sur Installer WASCE en tant que serveur de test de développement
et sélectionnez l’emplacement d’installation.
10. Consultez les informations du panneau Récapitulatif des opérations de
pré-installation. Si toutes les informations sont correctes, cliquez sur Installer.
Un panneau de progression de l’installation s’affiche, puis, une fois celle-ci
achevée, un écran indiquant Installation terminée.
11. Cliquez sur Terminé pour fermer le programme d’installation.
A l’issue de l’installation, un journal d’installation est créé à l’emplacement
d’installation (par exemple, c:\IBM\Dashboard Framework).
Tâches associées
Chapitre 4, «Migration», à la page 13
Suivez la procédure d’installation d’une version plus récente de IBM WebSphere
Dashboard Framework
Installation de WebSphere Dashboard Framework sous Linux
6
Prérequis Avant d’installer IBM WebSphere Dashboard Framework, vous devez
installer :
v Un serveur d’applications tel que Tomcat, WAS CE ou IBM WebSphere Portal
v Une version prise en charge d’Eclipse avec des outils Web Tools, comme il est
décrit dans Configuration logicielle requise.
Droits d’accès et IBM WebSphere Portal
Si vous effectuez le déploiement sur WebSphere Portal, vous devez effectuer les
étapes suivantes :
1. Créez un groupe pour votre utilisateur, ″wdfDev″ par exemple. Ce groupe aura
des droits d’accès en écriture sur les répertoires WebSphere.
2. Lorsque WebSphere Application Server est en cours d’exécution, ouvrez la
console d’administration et accédez à : Serveurs d’applications →
WebSphere_Portal → Exécution des processus. Remplacez la valeur de umask
par 002. Remplacez la valeur ’exécuter comme groupe’’ par wdfDev. Effectuez la
même étape pour server1. Cela vous permet de modifier les droits d’accès au
fichier pour le serveur de portail. Tous les fichiers écrits par le serveur de
portail auront désormais des droits d’exécution en lecture/écriture pour
l’utilisateur de portail et le groupe auquel il appartient.
3. Arrêtez le serveur WebSphere Portal.
4. Faites en sorte d’être un membre du groupe venant d’être créé (wdfDev dans
cet exemple).
5. Sur une ligne de commande, exécutez les commandes suivantes en tant
qu’utilisateur root :
chgrp -R wdfDev <WP_INSTALL_DIR>/AppServer/
chgrp -R wdfDev <WP_INSTALL_DIR>/PortalServer/
Si les répertoires ne sont pas inscriptibles par groupe, exécutez les commandes
suivantes :
chmod -R g+w <WP_INSTALL_DIR>/AppServer/
chmod -R g+w <WP_INSTALL_DIR>/PortalServer/
Cela permet d’accéder en écriture à ces dossiers une fois les fichiers WAR
déployés.
6. Redémarrez le serveur WebSphere Portal.
Installation sous Linux®
1. Définissez les droits utilisateur permettant d’exécuter le fichier WDF.bin du
programme d’installation.
2. Lancez le programme d’installation : ./WDF.bin. Le programme d’installation
vérifie l’espace disponible et les autres conditions requises, puis affiche le
premier panneau.
3. Lorsque vous y êtes invité, sélectionnez la langue dans laquelle vous souhaitez
utiliser le produit. Cliquez sur OK
4. Une page d’introduction contenant notamment les informations d’avis d’auteur
s’affiche. Pour poursuivre l’installation, cliquez sur Suivant
5. Lisez le contrat de licence et sélectionnez J’accepte les dispositions du contrat
de licence pour poursuivre l’installation, puis cliquez sur Suivant.
Chapitre 3. Installation et configuration de WebSphere Dashboard Framework
7
6.
7.
8.
9.
Remarque : Si vous n’acceptez pas les dispositions du contrat de licence, vous
serez invité à quitter l’installation.
Dans l’écran Sélection du dossier d’installation, indiquez l’emplacement
d’installation des fichiers puis cliquez sur Suivant.
Indiquez l’emplacement où Eclipse est installé, puis cliquez sur Suivant.
Vérifiez que les informations indiquées dans l’écran Récapitulatif des
opérations de pré-installation sont correctes puis, le cas échéant, cliquez sur
Installer. Un écran indiquant le déroulement de l’installation s’affiche, et une
fois l’installation terminée, l’écran Installation terminée s’affiche à son tour.
Cliquez sur Terminé pour quitter le programme d’installation.
A l’issue de l’installation, un journal d’installation est créé à l’emplacement
d’installation (par exemple, /root/IBM/).
Installation dans Rational Application Developer/Rational
Software Architect sur Linux
Si vous installez WebSphere Dashboard Framework dans une installation existante
de Rational Application Developer/Rational Software Architect installation sous
Linux, vous devez exécuter la procédure suivante :
1. Installez Portlet Factory avec le compte de l’utilisateur Portlet Factory.
L’emplacement d’installation Eclipse doit être un répertoire sur lequel le
compte utilisateur possède des droits en écriture. Vous devrez peut-être
sélectionner un emplacement différent de celui où Rational Application
Developer est installé. Une installation Eclipse existante à cet emplacement
n’est pas nécessaire.
2. Si vous choisissez d’installer Eclipse à l’emplacement d’installation de Rational
Application Developer à l’étape précédente, ignorez cette étape. A l’aide d’un
compte disposant des droits en écriture sur l’emplacement d’installation de
Rational Application Developer, copiez le répertoire links créé par le
programme d’installation dans le répertoire approprié à l’emplacement
d’installation de Rational Application Developer. Le dossiers des liens doit être
situé à la racine du répertoire d’installation de Rational Application Developer.
Vous pouvez également copier le répertoire de fichiers de liens Portlet Factory
dans un répertoire de liens précédemment créé dans Rational Application
Developer.
3. Démarrez Rational Application Developer avec l’option -clean comme racine
(ou le propriétaire Rational Application Developer) et vérifiez que Portlet
Factory est installé. Utilisez Aide → A propos de pour vérifier que le bouton
Portlet Factory s’affiche.
4. Redémarrez Rational Application Developer avec l’option -clean comme
utilisateur Portlet Factory, s’il n’est pas utilisateur à l’étape précédente, et
effectuez la même vérification qu’à l’étape précédente.
5. Redémarrez Rational Application Developer normalement, en tant qu’utilisateur
Portlet Factory. Vous n’avez pas besoin d’utiliser l’option -clean à ce stade.
Configuration de votre environnement après l’installation
Certaines étapes supplémentaires sont requises pour configurer votre
environnement après l’installation d’IBM WebSphere Dashboard Framework.
8
Suivez les étapes appropriées pour configurer la plateforme de votre serveur.
IBM WebSphere Portal
Les configurations supplémentaires suivantes sont requises pour WebSphere Portal.
1. Configuration de la taille de pile -- Par défaut, WebSphere Portal 6 définit la
taille de pile maximale permise à 512 Mo. Cette taille maximale doit être portée
à 1 Go. Utilisez la console d’administration de WebSphere pour définir la taille
de pile. Pour plus d’informations sur cette opération, consultez l’aide de la
console d’administration de WebSphere.
2. Mise à jour du chemin de cookie - Les paramètres par défaut de WebSphere
Portal n’incluent pas le répertoire racine de WebSphere Dashboard Framework
dans le chemin de cookie. Si vous utilisez une configuration de développement
sur WebSphere Portal, le répertoire racine doit être ajouté au chemin de cookie
en vue de mémoriser vos informations de session.
Vous pouvez rencontrer des difficultés avec la régénération et la mise en cache
de pages Web jusqu’à ce que vous mettiez à jour le chemin de cookie. Vous ne
pourrez pas exécuter correctement les tutoriels si vous n’avez pas modifié le
chemin de cookie. Utilisez la console d’administration WebSphere pour
remplacer ″/ wps ″ par ″/″ dans votre chemin de cookie.
Apache Tomcat
Après la création d’un nouveau projet IBM WebSphere Portlet Factory, redémarrez
Tomcat. Ceci permet de garantir que toutes les bibliothèques soient chargées
correctement.
Configuration d’un environnement de serveur de test imbriqué
L’installation dans un environnement de serveur de test imbriqué nécessite
certaines étapes et procédures supplémentaires au terme de l’installation.
Si vous effectuez une installation sur IBM Rational Development Environment
Studio Application Developer dans un environnement de test imbriqué (serveur
d’application ou de portail), exécutez les procédures suivantes.
Désactivation de la validation
La validation de tous les fichiers HTML et XML d’un projet peut prendre beaucoup
de temps. Dans ce cas, vous souhaiterez peut être désactiver la validation avant de
régénérer votre projet. Cette procédure s’applique à tous les projets de l’espace de
travail. Pour restreindre sa portée aux seuls projets de WebSphere Dashboard
Framework, désactivez les paramètres mentionnés ci-dessous.
Pour désactiver cette validation, procédez comme suit :
1. Dans Rational Developer, sélectionnez Fenêtre → Préférences.
9
2. Sélectionnez Validation et cliquez sur Désélectionner tout.
3. Cliquez sur Appliquer.
4. Dans le panneau de gauche, sélectionnez Outils Web → Liens → Validation →
Restructuration.
5. Décochez la case Activer LinksBuilder.
6. Cliquez sur Appliquer.
7. Cliquez sur OK pour fermer la fenêtre Préférences.
Configuration du serveur de test
Cette étape publie l’application et lance le serveur de test.
1. Cliquez avec le bouton droit de la souris sur le projet d’application Web et
sélectionnez Exécuter sur le serveur.
2. Sélectionnez la version et la configuration WebSphere Application Server de
votre choix, puis cliquez sur OK. Si vous n’avez pas spécifié de configuration
de serveur, celle par défaut de WebSphere Application Server peut être utilisée.
Remarque : Le rattachement à un serveur distant n’a pas été testé.
Modification du paramètre classPath du compilateur de
méthode
Pour utiliser des générateurs faisant appel au code de fichiers JAR provenant
d’éditeurs tiers, il se peut que vous deviez modifier la propriété
bowstreet.methods.classPath dans votre fichier cluster.properties.
Pour modifier cette propriété, procédez comme suit :
1. Dans un éditeur de texte, ouvrez le fichier nom_projet/ WebContent
/WEB-INF/config/cluster.properties.
2. Identifiez la propriété intitulée bowstreet.methods.classPath.
3. Ajoutez à la valeur de cette propriété le chemin d’accès au fichier j2ee.jar
approprié.
Pour utiliser, par exemple, le fichier j2ee12.jar livré avec Portlet Factory, ajoutez
à cette propriété la chaîne suivante : ${ bowstreet.rootDirectory} / clientLibs
/j2ee12.jar. (Ce fichier est situé sous le répertoire : bowstreet_root_directory
/WEB-INF/ clientlibs.)
4. Enregistrez et fermez le fichier cluster.properties.
5. Redémarrez Rational Application Developer pour que les modifications
apportées à cette propriété prennent effet.
Ouverture et exécution d’un modèle
Après avoir exécuté toutes les étapes ci-dessus, vous pouvez commencer à utiliser
Portlet Factory pour exécuter des applications sur le serveur de test imbriqué.
1. Effectuez un double clic sur un modèle du répertoire WebContent\WEB-INF\
models pour l’ouvrir dans Portlet Factory Designer.
2. Sélectionnez Exécuter → Exécuter le dernier lancé ou cliquez dans la barre
d’outils sur l’icône ″Exécuter″ pour exécuter le modèle.
10
Que faire ensuite
Lorsque vous exécutez un modèle, le serveur imbriqué que vous avez configuré est
utilisé.
Configuration de la prise en charge de votre langue nationale
Pour configurer l’utilisation d’une langue autre que l’anglais, installez le module
de langues d’Eclipse.
WebSphere Dashboard Framework gère les langues rattachées au groupe 1, à
savoir : allemand, espagnol, français, italien, japonais, coréen, portugais (Brésil),
chinois traditionnel et chinois simplifié. Pour utiliser une autre langue que
l’anglais, vous devez télécharger un module de langues à partir du site Web
d’Eclipse et l’installer dans votre environnement de développement intégré Eclipse.
Pour activer la prise en charge d’une autre langue, procédez comme suit :
1. Vérifiez que Microsoft® Windows® est configuré pour utiliser une langue du
groupe 1 autre que l’anglais.
2. Fermez Portlet Factory Designer.
3. Ouvrez la page d’accueil du site Web Eclipse.org et accédez à : Downloads |
All Versions | 3.2 Language Packs.
4. Depuis l’écran Language Packs: 3.2, téléchargez les fichiers zip NL-1 pour la
plateforme Microsoft Windows. (Deux fichiers zip sont requis.)
5. Décompressez ces fichiers dans votre installation d’Eclipse en veillant à
respecter le niveau d’arborescence correct.
6. Démarrez Portlet Factory Designer.
Eclipse s’exécute dans la langue configurée sur le poste de travail Windows.
Remarque : Vous pouvez imposer à Eclipse de s’exécuter sous une autre
langue en ajoutant un identificateur de langue à la commande de
démarrage d’Eclipse. Par exemple, en ajoutant :
-Duser.language=es -Duser.country=ES à la commande de
démarrage, vous pouvez exécuter Eclipse en espagnol, quelle que
soit la langue définie pour le système.
11
12
Chapitre 4. Migration
Dashboard Framework
Cette section explique comment installer une version plus récente de WebSphere
Dashboard Framework puis de mise à niveau des projets et portlets existants.
Migration vers une version plus récente de WebSphere Dashboard
Framework
Cette rubrique décrit les étapes d’installation d’une version plus récente de IBM
WebSphere Dashboard Framework.
Si vous avez déjà installé Portlet Factory, n’installez pas de version plus récente sur
l’ancienne, dans le même répertoire.
Si vous souhaitez utiliser le même répertoire pour la nouvelle installation,
procédez comme suit :
1. Pensez à faire une sauvegarde de l’installation existante.
2. Sauvegardez l’ensemble des fichiers privés, tels que les bibliothèques SAP.
3. Supprimez l’ancienne version à l’aide du programme de désinstallation.
4. Installez la nouvelle version.
5. Placez les fichiers privés sauvegardés dans le répertoire approprié de la
nouvelle installation.
Tâches associées
Chapitre 5, «Suppression d’IBM WebSphere Dashboard Framework», à la page 17
Pour supprimer ce produit, désinstallez-le ainsi que les fichiers WAR de projet.
«Installation de WebSphere Dashboard Framework sous Windows», à la page 5
«Installation de WebSphere Dashboard Framework sous Linux», à la page 6
Chapitre 4, «Migration»
Dashboard Framework
Mise à niveau d’un projet depuis la version 6.0 ou une version
ultérieure
Suivez la procédure de mise à niveau des projets créés avec des versions
antérieures du produit.
13
Avant de commencer
Lorsque vous mettez à niveau des projets ’non hiérarchiques’, créez un nouveau
projet et déplacez leur contenu dans celui-ci à l’aide de la fonction d’exportation
de l’archive → WebSphere Portlet Factory. Un projet non hiérarchique est un projet
6.0 n’ayant pas de répertoire WebContent. Si vous mettez un niveau un projet non
hiérarchique, vous ne bénéficierez pas des avantages de la prise en charge de
facette.
Vous devez modifier tous les projets créés avec les anciens fichiers de plug-in, afin
que ces projets puissent inclure les modifications liées aux nouveaux fichiers de
plug-in. Pour mettre à niveau un projet, procédez comme suit :
1. Ouvrez le projet que vous souhaitez mettre à niveau dans Portlet Factory
Designer.
2. Cliquez avec le bouton droit de la souris sur le projet dans le navigateur et
cliquez sur Projet WebSphere Portlet Factory → Mettre à niveau la version de
projet.
3. Des informations récapitulatives s’affichent. Cliquez sur Suivant.
4. Si nécessaire, mettez à jour les informations sur le déploiement de ce projet.
Vérifiez la configuration du déploiement et cliquez sur Terminer dans
l’assistant de mise à niveau.
5. Avant la fin du processus de mise à niveau, il peut vous être demandé
d’écraser les fichiers dans le projet qui ont été modifiés, ceux ayant été modifiés
par une nouvelle fonctionnalité inclus, et pas nécessairement ceux que vous
avez modifiés manuellement.
6. Vous devrez redéployer le projet vers les serveurs. Cliquez sur Oui lorsque
vous êtes invité à effectuer le redéploiement.
Mise à niveau d’annotations depuis la version 6.0
Suivez la procédure de mise à niveau de la base de données dans laquelle sont
stockées les annotations.
Lorsque vous effectuez une migration vers une version plus récente, toutes les
données des versions précédentes de IBM WebSphere Dashboard Framework sont
laissées intactes. Si vous avez utilisé des annotations dans la version 6.0, la seule
modification que vous devez effectuer est d’exécuter les instructions SQL
suivantes, afin de mettre à jour les tables de la base de données pour qu’elles
correspondent précisément à cette version du produit.
ALTER TABLE IBMAN_ANNOTATION ADD "LASTMODIFIEDDATE" BIGINT
ALTER TABLE IBMAN_ATTACHMENTS ADD "DOCUMENTID" VARCHAR(256)
DROP TABLE IBMAN_DOCUMENTS;
CREATE TABLE IBMAN_DOCUMENTS(
"ID" BIGINT NOT NULL ,
"CONTENT" BLOB(1G),
PRIMARY KEY("ID")
);
Ces instructions proviennent des scripts utilisés pour les nouvelles bases de
données, qui sont stockées dans les emplacements suivants :
14
DB2 sur toutes les plateformes à l’exception de z/OS
nom_projet/WebContent/WEB-INF/solutions/annotations/db_persistence/
db2_annotation.sql
DB2 sous z/OS
nom_projet/WebContent/WEB-INF/solutions/annotations/db_persistence/zos/
db2_annotation.sql
Oracle
oracle_annotation.sql
SQL Server
sql_annotation.sql
Mise à niveau des portlets vers l’API Java Standard Portlet
Mise à niveau des portlets construits à l’aide de l’API obsolète IBM Portlet vers la
nouvelle API Java Standard Portlet.
A compter de IBM WebSphere Portal 6, une nouvelle API, Java Standard Portlet,
est destinée aux portlets. Bien que les portlets conçus pour leur utilisation dans des
versions précédentes de WebSphere Portal, et construits à l’aide de l’API IBM
Portlet, à présent obsolète, continueront à fonctionner dans WebSphere Portal 6, il
est recommandé de construire les nouveaux portlets à l’aide de l’API Java Standard
Portlet. La nouvelle norme permet aux développeurs de créer des portlets
fonctionnant sur plusieurs serveurs de portail sans requérir de modification du
code.
Vous pouvez définir une API de portlet lorsque vous configurez la configuration
de déploiement Portal Server du projet. Sélectionnez API Java standard comme
option d’API de portlet.
Pour mettre à niveau un portlet généré dans une version antérieure de Portlet
Factory pour son utilisation de la nouvelle API Java standard, procédez comme
suit :
1. Dans Portlet Factory Designer, ouvrez le projet contenant le modèle de portlet.
2. Cliquez sur le projet avec le bouton droit de la souris dans le navigateur et
sélectionnez Projet WebSphere Portlet Factory → Mettre à niveau la version de
projet.
3. Utilisez la fonction de déploiement automatique afin de déployer le fichier
WAR du portlet mis à jour sur WebSphere Portal.
4. Utilisez l’outil d’administration de WebSphere afin de placer les portlets mis à
jour sur les pages de Portal.
Chapitre 4. Migration
15
16
Chapitre 5. Suppression d’IBM WebSphere Dashboard
Framework
Pour supprimer ce produit, désinstallez-le ainsi que les fichiers WAR de projet.
Pour supprimer IBM WebSphere Dashboard Framework ainsi que les fichiers WAR
de projet, procédez comme suit :
Windows
Pour supprimer le produit d’un poste de travail Windows, suivez les étapes
ci-dessous.
1. Utilisez le Panneau de configuration de Windows pour accéder à l’outil
Ajout/Suppression de programmes.
2. Sélectionnez le produit à désinstaller et cliquez sur Modifier/Supprimer.
3. Lorsque la fenêtre de désinstallation s’affiche, cliquez sur Désinstaller.
Les fichiers du produit, les entrées du registre et les raccourcis sont alors
supprimés de votre système.
4. Utilisez les outils d’administration de votre application et du serveur de portail
pour supprimer les fichiers WAR installables et installés.
5. Le cas échéant, supprimez du système de fichiers du serveur les répertoires et
fichiers restants associés à l’application ou aux portlets.
Linux
Dans le cas d’une installation Linux, vous devrez supprimer manuellement certains
fichiers et répertoires créés par le programme d’installation.
1. Supprimez le répertoire Designer et le fichier journal situé dans le répertoire
d’installation.
2. Si vous le souhaitez, supprimez le répertoire <répertoire d’installation
d’origine>/IBM/license.
3. Utilisez les outils d’administration de votre application et du serveur de portail
pour supprimer les fichiers WAR installables et installés.
4. Le cas échéant, supprimez du système de fichiers du serveur les répertoires et
fichiers restants associés à l’application ou aux portlets.
17
18
Annexe. Remarques
Le présent document peut contenir des informations ou des références concernant
certains produits, logiciels ou services IBM non annoncés dans ce pays.
Les produits, services ou fonctions mentionnés dans ce document peuvent ne pas
être proposés par IBM dans certains pays. Pour plus de détails, référez-vous aux
documents d’annonce disponibles dans votre pays, ou adressez-vous à votre
partenaire commercial IBM. Toute référence à un produit, logiciel ou service IBM
n’implique pas que seul ce produit, logiciel ou service puisse être utilisé. Tout
autre élément fonctionnellement équivalent peut être utilisé, s’il n’enfreint aucun
droit d’IBM. Cependant, il est de la responsabilité de l’utilisateur d’évaluer et de
vérifier le fonctionnement de tout produit, programme ou service n’émanant pas
d’IBM.
IBM peut détenir des brevets ou des demandes de brevet couvrant les produits
mentionnés dans le présent document. La remise de ce document ne vous donne
aucun droit de licence sur ces brevets ou demandes de brevet. Si vous désirez
recevoir des informations concernant l’acquisition de licences, veuillez en faire la
demande par écrit à l’adresse suivante :
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
Pour le Canada, veuillez adresser votre courrier à :
IBM Director of Commercial Relations
IBM Canada Ltd.
3600 Steeles Avenue East
Markham, Ontario
L3R 9Z7
Canada
Les informations sur les licences concernant les produits utilisant un jeu de
caractères double octet peuvent être obtenues par écrit à l’adresse suivante :
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan
Le paragraphe suivant ne s’applique pas au Royaume-Uni, ni dans aucun pays
où il serait contraire aux lois locales : LE PRESENT DOCUMENT EST LIVRE «EN
L’ETAT» SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE
NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS
EN CAS DE CONTREFACON AINSI QU’EN CAS DE DEFAUT D’APTITUDE A
L’EXECUTION D’UN TRAVAIL DONNE. Certaines juridictions n’autorisent pas
l’exclusion des garanties implicites, auquel cas l’exclusion ci-dessus ne vous sera
pas applicable.
Le présent document peut contenir des inexactitudes ou des coquilles. Ce
document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises
19
à jour. IBM peut, à tout moment et sans préavis, apporter des modifications ou des
améliorations aux produits et programmes décrits dans ce document.
Les références à des sites Web non IBM sont fournies à titre d’information
uniquement et n’impliquent en aucun cas une adhésion aux données qu’ils
contiennent. Les éléments figurant sur ces sites Web ne font pas partie des
éléments du présent produit IBM et l’utilisation de ces sites relève de votre seule
responsabilité.
IBM pourra utiliser ou diffuser, de toute manière qu’elle jugera appropriée et sans
aucune obligation de sa part, tout ou partie des informations qui lui seront
fournies.
Les licenciés souhaitant obtenir des informations permettant : (i) l’échange des
données entre des logiciels créés de façon indépendante et d’autres logiciels (dont
celui-ci), et (ii) l’utilisation mutuelle des données ainsi échangées, doivent adresser
leur demande à :
IBM Corporation
Office 4360
One Rogers Street
Cambridge, MA 02142
U.S.A.
Ces informations peuvent être soumises à des conditions particulières, prévoyant
notamment le paiement d’une redevance.
Le logiciel sous licence décrit dans ce document et tous les éléments sous licence
disponibles s’y rapportant sont fournis par IBM conformément aux dispositions de
l’ICA, des Conditions internationales d’utilisation des logiciels IBM ou de tout
autre accord équivalent.
Les informations concernant des produits non IBM ont été obtenues auprès des
fournisseurs de ces produits, par l’intermédiaire d’annonces publiques ou via
d’autres sources disponibles. IBM n’a pas testé ces produits et ne peut confirmer
l’exactitude de leurs performances ni leur compatibilité. Elle ne peut recevoir
aucune réclamation concernant des produits non IBM. Toute question concernant
les performances de produits non IBM doit être adressée aux fournisseurs de ces
produits.
Autres mentions des auteurs et de leurs droits
Les mentions suivantes des auteurs et de leurs droits s’appliquent à différents
composants logiciels qui ont été inclus dans IBM WebSphere Portlet Factory mais
qui n’ont pas été créés par IBM et qui ne sont pas la propriété d’IBM.
Ce produit est basé sur la technologie provenant du projet Eclipse
(http://www.eclipse.org/).
Ce produit inclut des logiciels développés par Apache Software Foundation
(http://www.apache.org).
Des parties de ce logiciel sont fournies par JDOM. Copyright (C) 2001 Brett
McLaughlin & Jason Hunter. All rights reserved. Des parties de ce logiciel sont
fournies par les membres de la liste de diffusion XML-DEV. Vous pouvez obtenir le
statut des droits d’auteur de SAX à l’adresse http://www.megginson.com/SAX/
20
Marques
Les termes qui suivent sont des marques d’International Business Machines
Corporation aux Etats-Unis et/ou dans certains autres pays :
IBM
Lotus
WebSphere
Workplace
Portlet Factory
Microsoft et Windows sont des marques de Microsoft Corporation aux Etats-Unis
et/ou dans certains autres pays.
Java ainsi que tous les logos et toutes les marques incluant Java sont des marques
de Sun Microsystems, Inc. aux Etats-Unis et/ou dans certains autres pays.
Les autres noms de sociétés, de produits et de services peuvent appartenir à des
tiers.
Annexe. Remarques
21
22
Numéro de programme : 5724-S21

WebSphere Dashboard Framework - Guide d`installation

Transcription

Documents pareils

Developpeur JAVA J2EE Junior CANADA

Stage 4 FR_Website websphere requests

Livre blanc haute disponibilité IBM i - AS400

exploitation/pupitrage ibm i (as/400)

WebSphere Application Server V8.5 Administration

Transition vers WebSphere Application Server v8.5 pour

Virtualisation IBM websphere

Yves NICOLE Architecte / Chef de projet

Administrateur IBM WebSphere Application Server Network

SGDSN AVIS DU CERTA Gestion du document 1 Risque 2