wrapper.port

Compatibilité :1.0.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

AVERTISSEMENT

NE MODIFIEZ PAS ces paramètres sans avoir lu la description de cette propriété. Des paramètres incorrects peuvent empêcher le Wrapper de fonctionner comme prévu.

Le Wrapper utilise un socket pour communiquer avec son composant Java s'exécutant dans une JVM. Cette propriété permet de configurer ce port.

Lorsqu'un port « 0 » (zéro) est spécifié, le Wrapper le traitera comme si la propriété n'avait pas été spécifiée et choisira son propre port dans la plage des propriétés wrapper.port.min - wrapper.port.max. Pour la plupart des applications, ce paramètre par défaut est suffisant.

Si aucun port n'a été spécifié pour cette propriété, ou si le port spécifié est déjà utilisé, le Wrapper utilisera alors la plage des propriétés wrapper.port.min - wrapper.port.max pour lier un port.

Si un port spécifique doit être utilisé, n'importe quel port dans la plage 1 - 65535 peut être spécifié. Notez que sur les systèmes UNIX, les numéros de port inférieurs à 1024 nécessiteront très probablement un accès root pour être définis. Si le port spécifié est utilisé, le Wrapper affichera un avertissement dans le journal et, comme dans le cas par défaut, recherchera le premier port disponible.

Lorsque le Wrapper lance une instance de JVM, il ouvrira un socket serveur à l'écoute sur ce port lié à l'adresse localhost. La JVM lancée recevra une clé qu'elle devra utiliser pour pouvoir se reconnecter au processus Wrapper. Une fois la JVM connectée, le Wrapper n'acceptera plus de connexions supplémentaires. La manière dont cela est réalisé ne devrait soulever aucun problème de sécurité.

Exemple :
wrapper.port=0

Contrôle de la plage de ports

Compatibilité :3.2.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

"wrapper.port.min" et "wrapper.port.max" :

Dans certains cas, il est nécessaire de contrôler la plage de ports que le Wrapper utilisera lors du choix d'un port. Les valeurs par défaut ont été choisies de façon à rendre très improbable tout conflit avec des numéros de ports connus (de 0 à 1023, généralement attribués sur la plupart des systèmes). Si la plage par défaut 32000-32999 pose des problèmes, elle peut être modifiée à l'aide des propriétés wrapper.port.min et wrapper.port.max. Si celles-ci sont utilisées, veillez à fournir une plage suffisamment large pour qu'il soit peu probable que tous les ports soient occupés lorsque le Wrapper tente de démarrer.

Exemple :
wrapper.port.min=32000
wrapper.port.max=32999

Contrôle de l'adresse à laquelle le port sera lié

Compatibilité :3.5.18 (No longer supported as of 3.6.3)
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Propriété "wrapper.port.address" :

AVERTISSEMENT

Cette propriété n'est plus prise en charge depuis la version 3.6.3. Le socket serveur écoutera toujours sur l'adresse de boucle locale. Si l'adresse de boucle locale ne peut pas être utilisée pour une raison quelconque, envisagez d'utiliser le type de backend PIPE.

Lorsque wrapper.backend.type est défini sur AUTO et que wrapper.port.address est défini, le Wrapper consignera un avertissement et basculera automatiquement en mode PIPE.

Cette propriété permet de spécifier l'interface à laquelle le ou les ports doivent être liés pour la communication entre le Wrapper et la JVM. Chaque machine fournit plusieurs interfaces réseau virtuelles et physiques auxquelles un port peut être lié. Avant l'introduction de cette propriété, le Wrapper utilisait toujours l'interface de boucle locale (localhost, 127.0.0.1) pour lier un port, si un socket était utilisé pour la communication backend.

Il a été observé que, sur certaines machines, une politique de sécurité très stricte n'autorise potentiellement pas la liaison d'un port à l'interface de boucle locale. Cela rendait inutilisable la communication backend par socket et, comme solution de contournement, le type de backend PIPE devait être utilisé.

La valeur de la propriété est une adresse IP d'une interface disponible sur le serveur. La valeur par défaut de cette propriété est l'adresse IP de l'interface de boucle locale, c'est-à-dire 127.0.0.1.

Exemple :
wrapper.port.address=192.168.0.2

Référence : Port