Pour exécuter la grille de données dans un profil Liberty, vous devez configurer les serveurs WebSphere eXtreme Scale afin qu'ils utilisent les fichiers de configuration de profil Liberty.
Pourquoi et quand exécuter cette tâche
Cette étape doit être définie de façon appropriée.
Procédure
- Configurez un serveur de catalogue avec des paramètres par défaut en utilisant les attributs suivants dans le fichier server.xml, qui indique à eXtreme Scale qu'il doit créer et démarrer un serveur de catalogue :
<server description="eXtreme Scale Catalog Server with default settings">
<!-- Enable features -->
<featureManager>
<feature>eXtremeScale.server-1.0</feature>
</featureManager>
<com.ibm.ws.xs.server.config catalogServer="true" listenerPort="${com.ibm.ws.xs.server.listenerPort}" />
<logging traceSpecification="*=info" maxFileSize="200" maxFiles="10" />
</server>
Notez que l'élément listenerPort est référencé dans le fichier server.xml mais que vous configurez cette valeur dans le fichier bootstrap.properties.
Il peut être utile de séparer les éléments tels que les numéros de port dans le fichier server.xml afin que plusieurs processus qui s'exécutent avec une configuration identique puissent partager le même fichier server.xml, tout en conservant des paramètres uniques.
- Configurez l'attribut listenerPort dans le fichier bootstrap.properties.
Dans l'exemple précédent, le traçage est spécifié dans la configuration de profil Liberty et l'attribut listenerPort définit une variable. Cette variable est configurée dans le fichier bootstrap.properties dans le répertoire de configuration du serveur, wlp_install_root/usr/server/serverName.
Voici un exemple de fichier bootstrap.properties :
# Eléments sous licence - Propriété d'IBM
#
# "Eléments IBM à usage restreint"
#
# Copyright IBM Corp. 2011 All Rights Reserved.
#
# US Government Users Restricted Rights - Use, duplication or
# disclosure restricted by GSA ADP Schedule Contract with
# IBM Corp.
#
# -------------------------------------------------------------------------------------------------
#
# port for the OSGi console
# osgi.console=5678
com.ibm.ws.xs.server.listenerPort=2809
Dans cet exemple, le port osgi.console est mis en commentaire, ce qui signifie que le profil Liberty écoute sur le port spécifié les clients telnet à connecter à une console OSGi. Ce comportement est utile pour diagnostiquer les erreur liées à OSGi.
- Configurez le fichier server.xml en utilisant la même configuration que celle que vous utiliseriez pour une configuration de serveur autonome. Dans le fichier server.xml, indiquez le chemin d'accès au fichier properties dans un attribut serverProps au sein de l'élément com.ibm.ws.xs.server.config. Voici un exemple de fichier server.xml :
<server>
...
<com.ibm.ws.xs.server.config ... serverProps="/path/to/myServerProps.properties" ... />
</server>
Restriction : Le modèle de configuration Liberty comporte des restrictions concernant la façon dont les propriétés sont spécifiées. Par conséquent, si vous avez besoin des propriétés suivantes, vous devez les spécifier dans le fichier de propriétés du serveur :
- foreignDomain.endpoints
- Indique les noms des domaines de service de catalogue auxquels vous souhaitez
vous lier dans une topologie de réplication multimaître.
- xioChannel.xioContainerTCPNonSecure.Port
- Indique le numéro de port d'écoute non sécurisé de eXtremeIO sur le serveur. Si
vous ne définissez pas de valeur, un port éphémère est utilisé. Cette propriété est
utilisée uniquement lorsque la propriété transportType a la valeur TCP/IP.
xioChannel.xioContainerTCPSecure.Port.
Certaines propriétés qui étaient auparavant configurables dans un environnement autonome doivent à présent être configurées à l'aide de la configuration de profil Liberty et non à l'aide des mécanismes de configuration
eXtreme Scale.
- Les paramètres de consignation et de traçage doivent être spécifiés à l'aide de l'élément de consignation (logging) dans le fichier server.xml et non dans le fichier de propriétés du serveur eXtreme Scale ou dans l'élément com.ibm.ws.xs.server.config.
- Le répertoire de travail, tout comme les paramètres de consignation et de traçage, est un paramètre de niveau serveur et doit donc être spécifié au niveau serveur.
Si les paramètres précédents sont mentionnés de façon incorrecte,
eXtreme Scale consigne un message d'avertissement qui indique que les paramètres vont être ignorés.