Configuration de WebSphere Application Server

La configuration de WebSphere Application Server inclut la définition d'un profil, d'une source de données, d'un nombre de serveurs, ainsi que la configuration de paramètres de sécurité et JMS. Toutes ces tâches peuvent être effectuées via l'exécution de la cible configure fournie par SDEJ.

Le profil créé par la cible configure prend les valeurs par défaut suivantes, sauf si elles ont été explicitement remplacées lors de l'appel de la cible.

profile.name=AppSvr01
cell.name=${node.name}Cell

La commande build configure doit être exécutée à partir du répertoire <SERVER_DIR> pour appeler une configuration automatique. Cette cible nécessite que les fichiers AppServer.properties et Bootstrap.properties soient présents dans le répertoire <SERVER_DIR>/project/properties¹. Consultez le manuel Cúram Server - Guide de développement pour plus d'informations sur la configuration de Bootstrap.properties. Configuration de WebSphere Application Server présente un exemple de contenu du fichier AppServer.properties.

Figure 1. Exemple de propriétés AppServer

## APPLICATION SERVER PROPERTIES

# Property to indicate WebSphere is installed.
as.vendor=IBM

# The username and encrypted password for admin server.
security.username=<e.g. websphere>
security.password=<encrypted password>

# The name of the WebSphere Node
node.name=MyNode

# The name of the server on which the application will be hosted.
curam.server.name=CuramServer
curam.server.port=2809

#####################################################
## THE FOLLOWING PROPERTIES ARE FOR WebSphere ONLY ##
#####################################################
# The alias that should be used for the database authorization
curam.db.auth.alias=databaseAlias

# HTTP Port for the server on which the client
# will be accessed
curam.client.httpport=9044

# HTTP Port for the server on which the Web services
# will be accessed
curam.webservices.httpport=9082

# Property to set JVM initial and maximum heap size.
curam.server.jvm.heap.size=1024

Par défaut, la cible configure établit une source de données Type 4 Universal Driver (XA). Toutefois, vous pouvez configurer une source de données Type 2 Universal Driver (XA) en définissant la propriété curam.db.type2.required du fichier AppServer.properties.

Par défaut, la cible configure définit la taille de segment de mémoire initiale et maximale de machine virtuelle Java sur "1024" Mo. Toutefois, vous pouvez remplacer la taille de segment de mémoire initiale et maximale par défaut de machine virtuelle Java en définissant la propriété curam.server.jvm.heap.size du fichier AppServer.properties.

Remarque :

La configuration du segment de mémoire Java décrite dans l'exemple Configuration de WebSphere Application Server et définie par les scripts de configuration est fournie à titre d'information. Selon la taille de votre application personnalisée, stratégie de déploiement, etc., ces paramètres peuvent être trop faibles ou trop élevés. La valeur optimale doit être déterminée via le contrôle des performances de votre serveur en termes de mémoire.
Des problèmes de mémoire ont été détectés avec les pilotes de base de données encapsulés WebSphere Application Server lors de la récupération d'objets CLOB et BLOB (3MB+) importants depuis la base de données. Ces problèmes peuvent être résolus en augmentant le paramètre JVM de taille de segment de mémoire maximale de manière appropriée sur le serveur déployé.
La cible configure ne peut pas être exécutée lorsqu'une base de données H2 est en cours d'utilisation.²

¹ Il est possible de remplacer cet emplacement par défaut pour les fichiers de propriétés en indiquant

-Dprop.file.location=<new location> lors de l'exécution de la cible configure.

² Pour plus d'information sur la base de données H2, consultez le manuel Cúram Third-Party Tools - Guide d'installation pour Windows.