Vous pouvez déployer le serveur Design Management Server sur WebSphere Application Server à la place du serveur Apache Tomcat qui accompagne le serveur. Les instructions sont fondées sur
WebSphere Application Server version
8.0, avec de légères variantes pour les versions 7.0 et 6.1.
Avant de commencer
Important : L'utilisation de WS-Security expose à des risques de sécurité,
avec la possibilité pour un utilisateur d'acquérir des privilèges de haut niveau et avec des impacts
sur les applications faisant intervenir JAX-WS et JAX-RPC.
Pour tout détail concernant les modalités
d'obtention et d'installation de ce correctif de sécurité, lisez ce
flash d'information. Par ailleurs, vous aurez tout intérêt à vous abonner aux mises à jour
WebSphere Application Server
via Mes notifications. Vous recevrez ainsi des consignes de sécurité pour les mises à jour et les correctifs.
Assurez-vous que votre environnement est configuré correctement :
- WebSphere Application Server est installé.
Jazz Team
Server,
qui sert de base au serveur
Design Management Server, nécessite
WebSphere Application Server version
8.0.0.3 ou WebSphere Application Server
version 7.0, ou encore
WebSphere Application Server version 6.1
avec le Fixpack 27.
- Si vous utilisez une base de données autre que Apache Derby, la base de données est configurée comme décrit dans la section
Configuration de la base de données.
- Design Management Server est
installé comme décrit dans la section Installation de Design Management.
Procédure
- Dans la console d'administration WebSphere Application Server, spécifiez les paramètres de sécurité suivants :
- Désactivez la sécurité Java™ 2 en cliquant sur et en désélectionnant la case à cocher
Utiliser la sécurité Java 2 pour limiter l'accès aux applications par les ressources locales.
- Dans la zone Définition du domaine en cours, assurez-vous que le domaine de sécurité approprié est configuré et défini comme domaine en cours. Cochez ensuite les cases Activer la sécurité administrative et Activer la sécurité des applications.
- Cliquez sur et cochez la case Utiliser les données d'authentification disponibles quand un URI protégé est accédé.
- Spécifiez les paramètres de machine virtuelle Java pour WebSphere Application Server :
- Dans la console d'administration, cliquez sur , puis cliquez sur votre serveur. Par défaut, le serveur est intitulé server1.
- Sous Infrastructure du serveur, cliquez sur .
- Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java.
- Dans la zone Taille de pile initiale, entrez 100.
- Dans la zone Taille de pile maximale, indiquez l'espace mémoire maximal du serveur en Mo. Pour les ordinateurs 64 bits, indiquez un espace mémoire approprié pour votre environnement, par exemple
4096 pour 4 Go de mémoire.
- Dans la zone Arguments JVM génériquess, ajoutez
-Xgcpolicy:gencon -Xmn1g -Xcompressedrefs -Xgc:preferredHeapBase=0x100000000
-XX:MaxPermSize=128M -Xms8G -Xmx8G
- Pour les systèmes d'exploitation Solaris uniquement, dans la zone Arguments JVM génériques,
ajoutez -XX:MaxPermSize=384m.
Pour plus d'informations sur la configuration d'un environnement Solaris pour WebSphere Application Server,
reportez-vous au chapitre 2 du Redbook IBM WebSphere Application Server V6.1 on the Solaris 10 Operating System.
- Cliquez sur Appliquer.
- Sur la page Machine virtuelle Java, sous Propriétés supplémentaires, cliquez sur Propriétés personnalisées.
- Cliquez sur Nouveau, puis spécifiez la propriété JAZZ_HOME, qui identifie l'emplacement des fichiers de configuration du serveur Design Management Server, y compris les dossiers jts et dm.
Cette propriété utilise un URI plutôt qu'un chemin de fichier simple et commence toujours par
file:///. L'emplacement par défaut sur un système Windows est le suivant :
file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf
Sur un système
Linux, l'emplacement par défaut est le suivant :
file:///opt/ibm/JazzTeamServer/server/conf
Remarque : Pour éviter des problèmes, n'utilisez pas d'espace dans les chemins de fichier. Pour les dossiers Program
Files sur les installations 32 bits de Windows, vous pouvez utiliser PROGRA~1 et, pour les dossiers Program Files (x86) sur les installations 64 bits de Windows, vous pouvez utiliser PROGRA~2.
- Cliquez à nouveau sur Nouveau et définissez une propriété nommée log4j.configuration. Utilisez comme valeur l'emplacement du fichier startup_log4j.properties. Cette propriété utilise le même format que la propriété JAZZ_HOME.
Dans la plupart des cas, ce fichier se trouve dans le dossier JAZZ_HOME.
La valeur par défaut sur un système Windows est la suivante :
file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf/startup_log4j.properties
La valeur par défaut sur un système Linux est la suivante :
file:///opt/ibm/JazzTeamServer/server/conf/startup_log4j.properties
Remarque : Les paramètres de startup_log4j.properties sont utilisés lors des premières étapes du processus de démarrage pour transmettre des messages au fichier SystemOut.log.
Après les premières étapes, chaque application utilise les paramètres spécifiques à l'application extraits du fichier server/conf/<contexte_app>/log4j.properties.
- Cliquez de nouveau sur Nouveau, puis affectez à la propriété java.awt.headless la valeurtrue.
- Cliquez de nouveau sur Nouveau, puis affectez à la propriété org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin la valeurtrue.
- Si vous utilisez une base de données SQL Server, cliquez une nouvelle fois sur Nouveau et spécifiez une propriété nommée SQLSERVER_JDBC_DRIVER_FILE avec l'emplacement du fichier sqljdbc4.jar.
- Si vous utilisez une base de données Oracle, cliquez une nouvelle fois sur Nouveau et spécifiez une propriété nommée ORACLE_JDBC_DRIVER_FILE avec l'emplacement du fichier ojdbc5.jar.
Les propriétés personnalisées sont similaires à celles de la figure ci-dessous.
Il est à noter que certaines propriétés sont présentes par défaut en sus des propriétés que vous ajoutez.
- Enregistrez les modifications dans la configuration principale, puis redémarrez WebSphere Application Server.
A présente, le serveur est prêt à déployer les fichiers d'application
Design Management Server.
Remarque : Sur un système UNIX ou Linux, si WebSphere Application Server est installé dans un environnement non root, l'utilisateur installant le serveur Design Management Server doit avoir accès en lecture et écriture au répertoire d'installation et tous ses sous-répertoires.
- Installez l'application JazzTeam Server :
- Dans la console d'administration, cliquez sur . (Pour WebSphere Application Server 6.1, cliquez sur . )
- Sous Chemin de la nouvelle application, cliquez sur Parcourir pour indiquer l'emplacement
du fichier jts.war
et cliquez sur Suivant. Si vous n'avez pas installé Apache Tomcat lors de l'installation du serveur Design Management Server, l'emplacement par défaut de ce fichier est rép_install/server/webapps.
Si vous avez installé Tomcat, l'emplacement par défaut est rép_install/server/tomcat/webapps.
- Sous How do you want to install the application?, cliquez sur Fast Path puis cliquez sur Suivant.
- Sur la page Step 1: Select installation options, acceptez les options par défaut et cliquez sur Suivant.
- Sur la page Etape 2: Mappage des modules vers les serveurs, cochez la case en regard de jts.war, vérifiez que le serveur ou le cluster cible est correct, puis cliquez sur Suivant.
- Sur la page Etape 3 : Mappage des hôtes virtuels des modules Web, cochez la case en regard de jts.war, puis cliquez sur Suivant.
- Sur la page Etape 4 : Mappage des racines de contexte des modules Web, paramétrez Racine du contexte sur /jts, puis cliquez sur Suivant.
- Cliquez sur Terminer.
- Répétez les étapes d'installation pour les fichiers war suivants et les racines de contexte correspondantes :
| Option |
Description |
| dm.war |
/dm |
| admin.war |
/admin |
| vvc.war |
/vvc |
| rdmhelp.war |
/rdmhelp |
| clmhelp.war |
/clmhelp |
- Mappez les rôles de sécurité de l'application JazzTeam Server aux utilisateurs et aux groupes de votre domaine de sécurité. La configuration de la sécurité n'entre pas dans le cadre de cette tâche mais, dans la plupart des cas où le domaine de sécurité globale utilise un registre LDAP, vous mappez les groupes du registre LDAP aux rôles de sécurité suivants pour l'application :
- JazzAdmins
- JazzDWAdmins
- JazzProjectAdmins
- JazzGuests
- JazzUsers
- Cliquez sur .
- Sous Propriétés détaillées, cliquez sur Mappage rôle de sécurité-utilisateur/groupe. Cette page présente les groupes d'utilisateurs du serveur Design Management Server que vous devez mapper aux utilisateurs ou aux groupes de votre domaine de sécurité.
- Sélectionnez un rôle, puis cliquez sur Mappage des groupes pour mapper ce rôle à un groupe de votre domaine de sécurité.
Remarque : N'activez pas l'option Tous les utilisateurs authentifiés ?.
- Vérifiez que les applications sont correctement installées, puis enregistrez les modifications dans la configuration principale de WebSphere Application Server.
- Après la sauvegarde dans la configuration principale, arrêtez et redémarrez le serveur.
- Dans la console d'administration de
WebSphere Application Server, cliquez
sur pour vérifier que
toutes les applications sont en cours d'exécution.
Résultats
Des flèches vertes apparaissent en regard des applications pour indiquer qu'elles ont correctement démarré. La page
Applications d'entreprise ressemble à la figure suivante :
Que faire ensuite
Vous pouvez désormais configurer le serveur
Design Management Server comme décrit dans la section
Configuration du serveur Design Management Server.