Les propriétés d'amorce initialisent l'environnement d'exécution pour un serveur particulier.
Il s'agit généralement d'attributs qui affectent
la configuration et l'initialisation du coeur de l'environnement d'exécution.
Pourquoi et quand exécuter cette tâche
Les propriétés d'amorce sont définies dans un fichier
texte nommé bootstrap.properties. Ce fichier n'étant pas requis, il n'existe pas à moins que vous ne le créiez. Vous devez créer ce fichier sous le répertoire du serveur, lequel contient également le fichier racine de la configuration, server.xml.
Par défaut, le répertoire du
serveur est usr/servers/nom_serveur.
Vous pouvez changer le répertoire du serveur comme décrit dans Personnalisation de l'environnement Liberty.
Vous pouvez créer un fichier bootstrap.properties en utilisant l'éditeur dans WebSphere Application Server Developer Tools for Eclipse. Dans la vue Serveurs, cliquez avec le bouton droit de la souris sur le serveur que vous souhaitez configurer, puis sélectionnez successivement Nouveau,
Fichier d'environnement de serveur, bootstrap.properties. Le fichier est créé à partir du modèle et ouvert dans un éditeur. Outre les fichiers server.xml et server.env, le fichier bootstrap.properties apparaît dans la vue Serveurs sous le serveur auquel il est associé. Il peut être édité en cliquant deux fois dessus.
Vous pouvez éditer le fichier bootstrap.properties dans un éditeur de texte
ou l'éditeur de WebSphere Application Server Developer Tools for Eclipse.
Si vous mettez à jour le fichier bootstrap.properties, vous devez redémarrer le serveur pour que les modifications soient appliquées.
Le fichier
bootstrap.properties contient
deux types de propriétés :
- Un petit ensemble prédéfini de propriétés d'initialisation.
- Toute propriété personnalisée que vous choisissez de définir. Vous pouvez ensuite utiliser ces propriétés personnalisées en tant que variables dans d'autres fichiers de configuration, par exemple server.xml et les fichiers inclus.
- Utilisez des propriétés prédéfinies pour configurer la trace et la journalisation.
Pour la liste des propriétés prédéfinies de trace et de journalisation,
consultez la rubrique Journalisation et Trace.
- Utilisez des propriétés personnalisées pour les diagnostics de l'infrastructure OSGi. Par exemple, définissez le port pour la console OSGi comme suit :
osgi.console = 5678
Pour plus d'informations, voir Utilisation d'une console OSGi
- Utilisez des propriétés personnalisées pour les extensions de l'infrastructure OSGi.
Spécifiez la propriété org.osgi.framework.bootdelegation si celle-ci est requise par les outils de contrôle externes. La valeur de cette propriété est une liste délimitée par des virgules de packages.
- Utilisez des propriétés personnalisées pour le chiffrement du mot de passe de configuration. Pour plus d'informations, voir Liberty: Les limites de la protection via le chiffrement de mot de passe
- Utilisez des propriétés personnalisées pour définir les ports par défaut pour les applications Web.
Vous pouvez partager server.xml et utiliser des fichiers de configuration XML dans divers environnements de développement autorisant la personnalisation propre à un environnement ou à une machine. Exemple :
- Spécifiez les propriétés default.http.port et default.https.port dans
le fichier bootstrap.properties :
default.http.port = 9081
default.https.port = 9444
Remarque : Si vous ne spécifiez pas les propriétés, le port HTTP par défaut est 9080 et le port HTTPS par défaut est 9443.
Pour remplacer la définition du noeud final HTTP par défaut,
spécifiez defaultHttpEndpoint pour
l'attribut id de l'élément httpEndpoint dans la configuration
du serveur.
- Utilisez les propriétés suivantes dans le fichier de configuration server.xml :
<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="${default.http.port}"
httpsPort="${default.https.port}" />
Remarque : host="*" signifie écouter sur tous les adaptateurs. Par défaut, le serveur
écoute uniquement sur l'adresse 127.0.0.1/localhost. Vous pouvez aussi utiliser la propriété host pour spécifier une adresse IP unique ; le système est alors à l'écoute sur l'adaptateur spécifié.
- Utilisez des propriétés personnalisées pour définir le port de commande.
Définissez le port de commande pour permettre au script de serveur de communiquer avec le serveur Liberty en opération et de demander certaines opérations (comme l'arrêt du serveur Liberty ou la prise d'un cliché Java™). Pour
des raisons de sécurité, le port de commande n'est pas accessible à distance et les clients doivent avoir un accès en lecture et en écriture au répertoire de sortie du serveur pour être autorisé
à émettre des commandes.

Par défaut, le serveur Liberty acquiert un port temporaire destiné à son utilisation par le programme d'écoute de commandes. Vous pouvez redéfinir le comportement par défaut du serveur
Liberty à l'aide de la propriété
command.port.
- Valeurs correctes
- -1
- Le port de commande est désactivé.
- 0
- Le port temporaire est sélectionné en phase d'exécution.
- 1 à 65535
- Port spécifié par l'utilisateur.
- Valeur par défaut
- 0

Le port temporaire est sélectionné en phase d'exécution.
Remarque : 
Il est déconseillé de désactiver le port de commande. Si vous désactivez le port de commande, vous ne pouvez pas utiliser le script de serveur pour demander certaines opérations (par exemple, l'arrêt du serveur Liberty ou la prise d'un cliché Java).
- Utilisez les propriétés personnalisées pour configurer le temps d'attente de démarrage du serveur.
Vous pouvez augmenter le temps d'attente du démarrage du serveur au-delà du paramètre par défaut du produit en ajoutant la propriété server.start.wait.time au fichier boostrap.properties. La
propriété server.start.wait.time est exprimée en secondes.
- Spécifiez la propriété server.start.wait.time dans le fichier bootstrap.properties. L'exemple suivant définit le délai de démarrage du serveur à 25 secondes.
server.start.wait.time = 25
Ce paramètre signifie que lorsque le serveur démarre, le mécanisme de génération de rapports du serveur tente de générer un rapport sur les phases terminées du démarrage. Si le mécanisme de
rapport du serveur ne peut pas exécuter sa fonction dans un délai de 25 secondes, une erreur 22 est générée.
Si vous n'ajoutez pas la propriété server.start.wait.time au fichier bootstrap.properties, le temps d'attente du démarrage du serveur par défaut
est défini de manière interne sur 30 secondes.
Utilisez les propriétés personnalisées pour définir le nom d'ange.
Utilisez les propriétés prédéfinies pour indiquer à quel processus ange le serveur doit se connecter. Par défaut, le serveur se connecte au processus ange non nommé par défaut si ce processus
ange est disponible.
- Pour vous connecter à un ange nommé spécifique, définissez la propriété com.ibm.ws.zos.core.angelName sur l'ange nommé.
com.ibm.ws.zos.core.angelName=named_angel
Utilisez une propriété personnalisée pour que le serveur doive être connecté à un processus ange en cours pour pouvoir démarrer. Par défaut, le serveur n'a pas besoin d'un processus ange pour démarrer. Cependant, si aucun processus ange n'existe, certains services du système ne sont pas disponibles. .
- Pour indiquer qu'un processus ange est nécessaire pour le démarrage du serveur, définissez la propriété com.ibm.ws.zos.core.angelRequired sur true.
com.ibm.ws.zos.core.angelRequired=true
- Pour appliquer les modifications, redémarrez le serveur.