Modification des paramètres Java

Cette section décrit les procédures impliquées dans la modification des paramètres connexes à Java pour une configuration sélectionnée. Consultez les liens suivants :

• Modification des paramètres généraux

• Modification des paramètres du chemin

• Modification des paramètres JVM

• Modification des options JVM

• Ajout de profileurs JVM

• Ajout d'un nouveau profileur JVM

• Déboguez des paramètres Java.

• Activation du débogage JVM

• Modification des paramètres des ressources

• Ressources JDBC

• Pilotes JDBC courants

• Ajout d'une ressource JDBC

• Ressources personnalisées

• Ajout d'une ressource personnalisée

• Propriétés des ressources personnalisées

• Ressources JNDI externes

• Ajout d'une ressource JNDI externe

• Propriétés des ressources JNDI externes

• Ressources de messagerie

• Ajout d'une nouvelle ressource de messagerie

• Propriétés de la ressource de messagerie

• Cycle de vie du serveur

• Ajout d'un nouveau module de cycle de vie

• Suppression d'un module de cycle de vie

• Modification des modules de cycle de vie

• Modification des paramètres d'authentification

• Propriétés obligatoires pour un domaine d'authentification

• Modification des paramètres du conteneur de servlet

• Paramètres du conteneur de servlet

• Modification des paramètres de réplication de session

• Paramètres de réplication de session

• Modification des paramètres d'authentification SOAP

• Paramètres du fournisseur d’authentification SOAP

Modification des paramètres généraux

Cette section permet d'activer Java et de définir une variable Accueil Java pour la configuration sélectionnée.

Modification des paramètres généraux Java

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configuration pour obtenir la liste des configurations disponibles.

2. Cliquez sur Java > onglet Généraux.

Champs des paramètres généraux Java

Le tableau suivant décrit les paramètres disponibles lorsque vous configurez les paramètres généraux Java.

Tableau 23 Description des champs > Paramètres généraux Java

Modification des paramètres du chemin

Cette section permet d'ajouter un chemin de classe JVM pour la configuration sélectionnée.

Modification des paramètres du chemin

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configuration pour obtenir la liste des configurations disponibles.

2. Cliquez sur Java > onglet Généraux. Allez dans la section Paramètres du chemin.

Champs des paramètres du chemin

Le tableau suivant décrit les paramètres disponibles lorsque vous modifiez les paramètres du chemin JVM de la configuration.

Tableau 24 Description des champs > Paramètres du chemin

Modification des paramètres JVM

Pour définir des options de ligne de commande JVM dans l'interface d'administration, effectuez les tâches suivantes :

Modification des paramètres JVM

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configuration pour obtenir une liste.

2. Cliquez sur les onglets Java > Paramètres JVM.

Modification des options JVM

Vous pouvez ajouter/supprimer des options JVM de ligne de commande en spécifiant ici les valeurs correspondantes. Cliquez sur le bouton Ajouter une option JVM pour ajouter une option JVM.

Voici quelques exemples d'options JVM : -Djava.security.auth.login.config=login.conf, -Djava.util.logging.manager=com.iplanet.ias.server.logging.ServerLogManager and -Xms128m -Xmx256m

Ajout de profileurs JVM

Le profileur JVM permet de détecter et de résoudre les fuites de mémoire et les problèmes liés aux performances, au multithreading et à l'utilisation des ressources système dans vos applications Java afin de garantir le meilleur niveau de stabilité et d'évolutivité possible pour ces applications.

Vous pouvez utiliser un profileur pour effectuer un profilage distant sur Sun Java System Web Server pour rechercher les goulots d'étranglement dans les performances côté serveur.

Ajout d'un nouveau profileur JVM

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configurations pour obtenir la liste des configurations disponibles.

2. Cliquez sur les onglets Java > Paramètres JVM.

3. Cliquez sur le bouton Nouveau sous la section Profileurs.

4. Spécifiez des valeurs pour les paramètres suivants :

   • Nom – Indiquez un nom court pour le nouveau profileur JVM.

   • Activé – Détermine si le profileur est activé à l'exécution.

   • Chemin de classe – Indiquez une classe valide pour le profileur. (facultatif).

   • Chemin de bibliothèque native – Indiquez un chemin de bibliothèque native valide. (facultatif).

   • Options JVM – Vous pouvez spécifier d'autres options JVM pour l'interface de ligne de commande.

     Par exemple, –Xrunhprof:file=log.txt,options

     HPROF est un agent de profileur simple fourni avec Java 2 SE. Il s'agit d'une bibliothèque liée de façon dynamique qui permet d'interagir avec la JVMPI (Java Virtual Machine Profiler Interface) et d'écrire des informations de profilage dans un fichier ou un socket en format binaire ou ASCII. Ces informations peuvent être ensuite traitées par un outil frontal du profileur.

     Pour plus d'informations sur les divers profileurs commerciaux et leurs options, reportez-vous au Guide développeur de Sun Java System Web Server 7.0 pour les applications Web Java.

Déboguez des paramètres Java.

La JVM peut être lancée en mode débogage et être associée avec un débogueur JPDA (Java Platform Debugger Architecture). Lorsque vous activez le débogage, vous activez le débogage local et distant.

Le débogage de Sun Java System Web Server se trouve sur le logiciel JPDA. Pour activer le débogage, effectuez les tâches suivantes :

Activation du débogage JVM

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configurations pour obtenir la liste des configurations disponibles.

2. Cliquez sur les onglets Java > Paramètres JVM.

3. Cochez la case Activer le débogage sous Déboguer les paramètres Java.

4. Indiquez les options JVM si nécessaire en cliquant sur le bouton Nouveau.

   Les options JPDA par défaut sont les suivantes :

   -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7.0896

   
   

   Si vous remplacez suspend=y, la JVM démarre en mode suspendu et conserve ce mode jusqu'à ce qu'un débogueur lui soit associé. Cela s'avère pratique si vous souhaitez lancer le débogage au démarrage de la JVM. Pour spécifier le port à utiliser lors de l'association d'un débogueur à la JVM, spécifiez address=port_number . Consultez la documentation JPDA pour obtenir une liste des options de débogage.

Modification des paramètres des ressources

Cette page permet de configurer et de gérer les ressources JDBC, de messagerie, JNDI et autres ressources Java.

Les applications Web peuvent accéder à une grande variété de ressources telles que les gestionnaires de ressources, les sources de données (par exemple, les sources de données SQL), les sessions de messagerie et les fabriques de connexion URL. La plate-forme J2EE expose ces ressources aux applications via le service JNDI (Java Naming and Directory Interface).

Sun Java System Web Server vous permet de créer et de gérer les ressources Java EE suivantes :

• Sources de données JDBC.

• Pools de connexions JDBC.

• Sessions de messagerie Java.

• Ressources personnalisées.

• Ressources JNDI externes.

Ressources JDBC

Une source de données JDBC est une ressource Java EE que vous pouvez créer et gérer à l'aide de Sun Java System Web Server.

L'API JDBC est l'API de connectivité avec des systèmes de bases de données relationnels. L'API JDBC comprend deux parties :

• Une interface au niveau de l'application utilisée par les composants de l'application pour accéder aux bases de données.

• Une interface de fournisseur de services servant à associer un pilote JDBC à la plate-forme Java EE.

Un objet Source de données JDBC représente une implémentation d'une source de données dans le langage de programmation Java. En termes simples, une source de données est une installation permettant le stockage des données. Elle peut être aussi sophistiquée qu'une base de données complexe d'une grande entreprise ou aussi simple qu'un fichier constitué de lignes et de colonnes. Une source de données JDBC est une ressource Java EE qui peut être créée et gérée à l'aide de Sun Java System Web Server.

L'API JDBC fournit un ensemble de classes pour Java, ainsi qu'une interface d'accès aux bases de données SQL standard qui assurent un accès uniforme à une grande variété de bases de données relationnelles.

À l'aide de JDBC, des instructions SQL peuvent être envoyées à quasiment tous les systèmes de gestion de base de données (SGBD). Cette ressource sert d'interface à la fois pour les SGBD relationnels et d'objets.

Pilotes JDBC courants

Le tableau suivant présente une liste des pilotes JDBC courants et de leurs propriétés qui doit être configurée lorsque vous ajoutez une nouvelle ressource JDBC. Voir Ajout d'une ressource JDBC.

Remarque – La liste suivante n'est qu'un sous-ensemble de tous les pilotes JDBC pris en charge.

Tableau 25 Liste des pilotes JDBC courants et pris en charge

Ajout d'une ressource JDBC

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configurations pour obtenir la liste.

2. Cliquez sur Java > onglet Ressources.

3. Sous la section Ressources JDBC, cliquez sur le bouton Nouveau.

4. Sélectionnez le fournisseur de pilotes.

   Spécifiez une valeur unique pour le nom JNDI, puis sélectionnez le fournisseur de pilotes dans la liste disponible.

5. Indiquez les propriétés de la ressource JDBC.

   En fonction du fournisseur de pilotes JDBC sélectionné à l'étape précédente, le nom de classe du pilote et les propriétés de la ressource JDBC sont automatiquement renseignés. Pour obtenir une liste des propriétés suggérées pour certains pilotes JDBC courants, reportez-vous à la section Pilotes JDBC courants.

6. Affichez le résumé.

   Affichez le résumé et cliquez sur Terminer pour créer la nouvelle ressource JDBC.

Ressources personnalisées

Vous pouvez utiliser cette option pour enregistrer une ressource personnalisée avec l'instance de la configuration.

Ajout d'une ressource personnalisée

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configurations pour obtenir la liste.

2. Cliquez sur Java > onglet Ressources.

3. Sous la section Ressources personnalisées, cliquez sur le bouton Nouveau.

Propriétés des ressources personnalisées

Le tableau suivant décrit les propriétés disponibles pour créer une ressource personnalisée.

Tableau 26 Description des champs > Ressources personnalisées

Ressources JNDI externes

Cette option permet de créer une ressource JNDI (Java Naming and Directory Interface). Vous devez disposer d'une ressource JNDI externe pour accéder aux ressources stockées dans un référentiel JNDI interne.

Ajout d'une ressource JNDI externe

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configurations pour obtenir la liste.

2. Cliquez sur Java > onglet Ressources.

3. Sous la section Ressources JNDI externes, cliquez sur le bouton Nouveau.

Propriétés des ressources JNDI externes

Le tableau suivant décrit les propriétés disponibles lors de l'ajout d'une nouvelle ressource JNDI externe.

Tableau 27 Description des champs > Ressources JNDI externes

Ressources de messagerie

Les destinations JMS sont des ressources Java EE qui peuvent être créées et gérées à l'aide de Sun Java System Web Server.

Dans de nombreuses applications Internet, il est nécessaire de pouvoir envoyer des notifications par e-mail ; c'est pourquoi la plate-forme Java EE inclut l'API JavaMail, ainsi qu'un fournisseur de services JavaMail, qui permet à un composant d'envoyer des messages électroniques.

Ajout d'une nouvelle ressource de messagerie

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configurations pour obtenir la liste.

2. Cliquez sur Java > onglet Ressources.

3. Sous la section Ressources de messagerie, cliquez sur le bouton Nouveau.

Propriétés de la ressource de messagerie

Le tableau suivant décrit les propriétés disponibles lors de l'ajout d'une nouvelle ressource de messagerie.

Tableau 28 Description des champs > Propriétés de la ressource de messagerie

Cycle de vie du serveur

• Initialisation – Cette phase inclut la lecture de la configuration, l'initialisation des sous-systèmes intégrés, les services de nommage, de sécurité et de journalisation et la création du conteneur Web.

• Démarrage – Cette phase inclut le chargement et l'initialisation des applications déployées.

• Service – Le serveur est prêt à traiter les requêtes.

• Arrêt – Cette phase arrête et supprime les applications chargées. Le système se prépare à l'arrêt.

• Fin – Cette phase met fin aux sous-systèmes intégrés et à l'environnement d'exécution du serveur. Il n'y aura plus aucune activité à l'issue de cette phase.

• Reconfiguration – État transitoire du serveur dans lequel un thread de serveur subit une reconfiguration dynamique (pendant que le serveur est en phase de service). Cette phase peut survenir plusieurs fois au cours du cycle de vie du serveur.

Ajout d'un nouveau module de cycle de vie

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste des configurations. Pour afficher la liste des configurations, cliquez sur l'onglet Configurations.

2. Cliquez sur les onglets Java > Modules de cycle de vie.

3. Cliquez sur le bouton Nouveau.

   Spécifiez des valeurs pour les paramètres suivants :

   • Nom – Indiquez un nom unique valide pour le nouveau module de cycle de vie.

   • Activé – Utilisez cette option pour activer ce module de cycle de vie.

   • Nom de classe – Nom de classe Java complet. La classe doit implémenter l'interface LifecycleListener. Pour plus d'informations sur l'utilisation de cette interface, reportez-vous au Guide du développeur.

   • Chemin de classe – Facultatif. Vous pouvez spécifier un chemin pour la classe du module d'écoute.

   • Ordre de chargement — > 100. Ordre de chargement des modules d'écoute des événements de cycle de vie, par ordre numérique. Il est recommandé de choisir un ordre de chargement supérieur ou égal à 100 pour éviter des conflits avec les modules de cycle de vie internes.

   • Échec lors du chargement – Si cette option est activée, le serveur ne traite pas les exceptions générées par les classes de module d'écoute comme fatales et poursuit normalement le démarrage. Option désactivée par défaut.

   • Description – Fournissez une brève description du module de cycle de vie.

   • Propriétés – Les propriétés peuvent servir à transmettre des arguments à un module de cycle de vie Java. Pour ajouter une nouvelle propriété, cliquez sur le bouton Ajouter une propriété, puis saisissez un nom, une valeur et une description.

   ---

   Attention – Les classes du module d'écoute de cycle de vie du serveur sont invoquées de manière synchrone à partir du thread du serveur principal et, par conséquent, des précautions supplémentaires doivent être prises pour garantir que les classes du module d'écoute ne bloquent pas le serveur. Les classes du module d'écoute peuvent créer des threads si nécessaire, mais doivent être arrêtées lors des phases d'arrêt ou de fin.

   ---

Suppression d'un module de cycle de vie

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste des configurations. Pour afficher la liste des configurations, cliquez sur l'onglet Configurations.

2. Cliquez sur les onglets Java > Modules de cycle de vie.

3. Sélectionnez le module de cycle de vie, puis cliquez sur le bouton Supprimer un module de cycle de vie.

Modification des modules de cycle de vie

Les modules de cycle de vie Java Server sont des classes Java qui observent les événements du cycle de vie du serveur afin d'exécuter certaines tâches lors d'arrêts ou de démarrages du serveur.

Le serveur prend en charge l'exécution de tâches Java de courte ou longue durée dans l'environnement du serveur Web. Ces tâches sont automatiquement lancées au démarrage du serveur et notifiées à l'arrêt du serveur. Vous pouvez donc désormais associer des tâches comme l'instanciation des singletons, de serveurs RMI, etc.

Une brève description du cycle de vie du serveur est présentée ci-dessous :

Modification des paramètres d'authentification

À partir de cette page, vous pouvez ajouter et supprimer des domaines d'authentification. Le modèle de sécurité Java EE fournit des domaines de sécurité qui identifient et authentifient les utilisateurs.

Le processus d’authentification vérifie les utilisateurs via un domaine Java. Un domaine représente un ensemble d'utilisateurs, de mappages de groupes facultatifs et de logique d'authentification qui permet de valider les demandes d'authentification. Lorsqu'une demande d'authentification est validée par un domaine configuré et que le contexte de sécurité est établi, cette identité est appliquée à toutes les décisions d'autorisation ultérieures.

Les domaines Java sont similaires aux auth-dbs (bases de données d'authentification) avec la seule différence que les auth-dbs sont utilisées par le moteur ACL (configuré selon les règles de votre fichier ACL), alors que les domaines Java sont utilisés par les règles de contrôle de l'accès au servlet Java (spécifiées dans chaque fichier Web.xml des applications Web).

Une instance de serveur peut comporter n'importe quel nombre de domaines configurés. Les informations configurées sont présentes dans l'élément auth-realm du fichier server.xml.

Le tableau suivant définit les différents types de domaines pris en charge dans Sun Java System Web Server 7.0

Tableau 29 Types de domaines

La section suivante décrit les étapes impliquées dans l'ajout d'un nouveau domaine d'authentification.

Ajout d'un domaine d'authentification

1. Sélectionnez la configuration.

   Sélectionnez la configuration à partir de laquelle vous devez ajouter un nouveau domaine d'authentification. Cliquez sur l'onglet Configurations et sélectionnez la configuration.

2. Cliquez sur Java > onglet Authentification.

3. Cliquez sur Nouveau sous Servlet d'Authentification.

4. Fournissez les détails du domaine.

   • Nom – Entrez un nom court pour le domaine. Ce nom est utilisé pour faire référence au domaine à partir, par exemple, du fichier Web.xml.

   • Classe – Si vous souhaitez configurer un domaine personnalisé, entrez le nom complet de classe Java, qui implémente votre domaine personnalisé. Il n'est pas nécessaire d'entrer une classe pour les domaines intégrés.

   • Type – Sélectionnez le type de domaine. Reportez-vous au Tableau 29

   • Propriétés – Ajoutez des propriétés spécifiques au domaine. Par exemple, property name="file" value="instance_dir/config/keyfile" and property name="jaas-context" value="fileRealm.

Propriétés obligatoires pour un domaine d'authentification

Chaque domaine d'authentification nécessite l'ajout de propriétés obligatoires. Le tableau ci-dessous répertorie certaines de ces propriétés.

Tableau 30 Propriétés obligatoires pour un domaine d'authentification

Modification des paramètres du conteneur de servlet

Cette section décrit la procédure de configuration du conteneur de servlet.

Modification des paramètres du conteneur de servlet

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configurations pour obtenir la liste.

2. Cliquez sur Java > Conteneur de servlet.

Paramètres du conteneur de servlet

Le tableau suivant décrit les paramètres disponibles sur le page du conteneur de servlet.

Tableau 31 Descriptions des champs > Conteneur de servlet

Modification des paramètres de réplication de session

Cette section décrit la procédure de configuration des propriétés de réplication de session pour une configuration sélectionnée.

Modification des paramètres de réplication de session

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configurations pour obtenir la liste.

2. Cliquez sur Java > Réplication de session.

Paramètres de réplication de session

Le tableau suivant décrit les paramètres disponibles sur la page de réplication de session.

Tableau 32 Description des champs > Réplication de session

Modification des paramètres d'authentification SOAP

La spécification sur l'interface de fournisseur de services d'authentification Java pour conteneurs définit une interface de fournisseur de services standard selon laquelle les fournisseurs de mécanismes d'authentification peuvent être intégrés à des conteneurs. Vous pouvez utiliser la console d'administration pour ajouter un nouveau fournisseur d'authentification SOAP.

Ajout d'un fournisseur d’authentification SOAP

1. Sélectionnez la configuration.

   Sélectionnez la configuration dans la liste de configurations. Cliquez sur l'onglet Configurations pour obtenir la liste.

2. Cliquez sur Java > onglet Authentification.

3. Sous la section Authentification SOAP, cliquez sur le bouton Nouveau.

Paramètres du fournisseur d’authentification SOAP

Le tableau suivant décrit les paramètres disponibles sur la page du nouveau fournisseur d'authentification SOAP.

Tableau 33 Description des champs > Fournisseur d'authentification SOAP