

Commandes apiconnect-collective-member wlpn-server et wlpn-collective
Exécutez des commandes wlpn-server pour démarrer ou arrêter des applications Node.js décompressées et comprimer ou décomprimer des applications. Exécutez des commandes wlpn-collective pour adjoindre une application Node.js en tant que membre d'une collectivité Liberty ou pour retirer un membre de collectivité Node.js de cette collectivité. Exécutez les commandes apiconnect-collective-member depuis le répertoire ${wlpn.usr.dir} (par défaut, /home/nom_utilisateur/wlpn).
Bien que vous exécutiez des commandes wlpn-server pour démarrer et arrêter une application Node.js décompressée et une commande wlpn-collective pour l'adjoindre comme membre à une collectivité Node.js, une application Node.js n'est pas un serveur. Il s'agit d'une application. Toutefois, une application Node.js décompressée dans un répertoire utilisateur wlpn connu d'un contrôleur de collectivité peut être gérée par celui-ci comme un serveur de membre de collectivité. Un membre de collectivité Node.js est quelquefois dénommé serveur Node.js dans cette documentation.
Syntaxe des commandes wlpn-server
La syntaxe des commandes wlpn-server est la suivante :
wlpn-server action variable | variable
- help
- Affiche des informations sur les commandes wlpn-server.
wlpn-server help
- start
- Démarre une application Node.js décompressée. Pour nom_serveur, indiquez dans la commande le nom de l'application
Node.js décompressée à démarrer.
wlpn-server start server_name
La commande lance le processus serveur et consigne un fichier PID dans le répertoire du serveur (par défaut, /home/nom_utilisateur/wlpn/nom_serveur).
- stop
- Arrête une application Node.js décompressée. Pour nom_serveur, indiquez dans la commande le nom de l'application Node.js décompressée à
arrêter.
wlpn-server stop server_name
La commande arrête le processus serveur et supprime du répertoire le fichier PID.
- pack
- Crée une archive TAR compressée avec l'extension .tgz pour déploiement d'une
application sur le système de fichiers. Indiquez dans la commande le répertoire à compresser.
wlpn-server pack directory_to_pack
La commande compresse le répertoire spécifié et crée un fichier .tgz dans le répertoire en cours.
La procédure ci-après décrit comment préparer et compresser un répertoire :
- Créez une application Node.js.
- Eventuellement, créez un fichier server.json et placez-le dans le même répertoire que le fichier package.json. Le
contenu du fichier server.json devrait être similaire à cet exemple :
{ "clusterName": "cluster name", "contextRoot": "context root", "appPort":"integer", "adminPort":"integer" }
- nom_cluster reçoit par défaut la valeur de nom_serveur.
- racine_contexte est facultatif et reçoit par défaut la valeur de nom_serveur.
- Pour appPort, entier est le numéro de port pour le trafic d'application et reçoit par défaut la valeur 9080.
- Pour adminPort, entier est le numéro de port pour le trafic d'administration et reçoit par défaut la valeur 9443.
- Pour inclure des dépendances, exécutez la commande npm install dans le répertoire de l'application.
- Pour compresser le répertoire, exécutez la commande wlpn-server pack.
- unpack
- Décompresse sur disque une application, en créant un répertoire serveur. Indiquez dans la commande le nom du serveur à créer et le nom du fichier
TAR ) à décompresser.
wlpn-server unpack server_name tgz_file_name
La commande développe le fichier .tgz sous l'emplacement ${wlpn.usr.dir}/nom_serveur (par défaut, le répertoire /home/nom_utilisateur/wlpn). Si le répertoire wlpn n'existe pas, la commande le crée.
Syntaxe
Les exemples suivants montrent la syntaxe correcte :
wlpn-server help
wlpn-server start myServer
wlpn-server stop myServer
wlpn-server pack example-app
wlpn-server unpack myServer example-app.tgz
Syntaxe des commandes wlpn-collective
La syntaxe des commandes wlpn-collective est la suivante :
wlpn-collective action server_name [options]
- help
- Affiche des informations sur les commandes wlpn-collective.
wlpn-collective help
- join
- Adjoint une application Node.js décompressée en tant que membre d'une collectivité Liberty. Indiquez dans la commande le nom de l'application
Node.js décompressée, l'hôte du contrôleur de collectivité, le port, l'utilisateur, le mot de passe, ainsi que le mot de passe du fichier de clés.
wlpn-collective join server_name --host=collectiveControllerHost --port=collectiveControllerHTTPSPort --user=collectiveControllerAdminUserID --password=collectiveControllerAdminUserPassword --keystorePassword=generatedKeystorePassword
Spécifiez également, le cas échéant, une ou plusieurs des options facultatives suivantes :- --autoAcceptCertificates
- Indique de se fier automatiquement aux certificats SSL.
- --sshPrivateKey
- La commande wlpn-collective
join génère une paire de clés SSH unique pour authentification auprès du serveur SSH d'un ordinateur hôte spécifié. Si vous enregistrez un hôte distant pour lequel une paire de clés SSH est déjà générée,
vous devez spécifier le chemin du fichier de clé privée SSH. La commande suivante
suppose que la clé SSH privée réside sur l'ordinateur du contrôleur local sous l'emplacement /home/user1/.ssh/id_rsa. L'autre fichier
de la paire de clés SSH est le fichier de clé publique /home/user1/.ssh/authorized_keys
sur l'hôte cible distant.
wlpn-collective join myServer --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --sshPrivateKey=/home/user1/.ssh/id_rsa
- --genDeployVariables
- Alloue des variables de déploiement (ports) lorsque vous adjoignez une application Node.js décompressée en tant que membre d'une collectivité Liberty. L'option genDeployVariables enregistre les variables de déploiement auprès du référentiel de la collectivité et génère des variables de déploiement au membre. Pour un exemple d'instructions deployVariable qui définissent des variables de déploiement dans un fichier server.xml du contrôleur, reportez-vous à l'étape 3 dans Déploiement des serveurs Node.js à l'aide des API REST de déploiement.
La commande adjoint l'application Node.js à la collectivité et crée des fichiers de configuration SSL sur le système de fichiers depuis lequel a été exécutée la commande. Elle crée également le fichier join.json sur le système de fichiers sous le répertoire ${wlpn.usr.dir}/nom_serveur. Le fichier join.json est distinct du fichier server.json et il est utilisé pour les collectivités. Le fichier join.json contient le nom d'hôte du contrôleur, le numéro de port et l'intervalle de signal de présence.
- remove
- Supprime un serveur de membre de collectivité Node.js d'une collectivité Liberty. Indiquez dans la commande le nom du serveur
Node.js, l'hôte du contrôleur de collectivité, le port, l'utilisateur, le mot de passe, ainsi que le paramètre --autoAcceptCertificates.
wlpn-collective remove server_name --host=collectiveControllerHost --port=collectiveControllerHTTPSPort --user=collectiveControllerAdminUserID --password=collectiveControllerAdminUserPassword --autoAcceptCertificates
La commande supprime le serveur Node.js de la collectivité et efface la configuration SSL et les fichiers join.json.
- registerHost
- Enregistre auprès du contrôleur de collectivité l'hôte sur lequel vous désirez installer un serveur Node.js.
Indiquez dans la commande le nom de l'hôte cible, l'hôte du contrôleur de collectivité, le port, l'utilisateur, le mot de passe, ainsi que le paramètre
--autoAcceptCertificates.
wlpn-collective registerHost targetHost --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --rpcUser=osUser --rpcPassword=osUserPassword --autoAcceptCertificates
La commande autorise le contrôleur de collectivité à accéder aux fichiers, aux commandes, ainsi qu'à d'autres ressources sur l'hôte.
- updateHost
- Modifiez les valeurs des paramètres d'enregistrement de l'hôte sur lequel un serveur Node.js réside.
Indiquez dans la commande le nom de l'hôte cible, l'hôte du contrôleur de collectivité, le port, l'utilisateur, le mot de passe, ainsi que le paramètre
--autoAcceptCertificates.
wlpn-collective updateHost targetHost --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --rpcUser=osUser --rpcPassword=osUserPassword --autoAcceptCertificates
La commande met à jour l'enregistrement de l'hôte.
Syntaxe
Les exemples suivants montrent la syntaxe correcte :
wlpn-collective help
wlpn-collective join myServer --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --autoAcceptCertificates
wlpn-collective remove myServer --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --autoAcceptCertificates