
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 nom_serveurLa 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 nom_serveurLa 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 répertoire_à_compresserLa 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": "nom_cluster", "contextRoot": "racine_contexte", "appPort":"entier", "adminPort":"entier" }- 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 nom_serveur nom_fichier_tgzLa 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 nom_serveur [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 nom_serveur --host=hôte_contrôleur_collectivité --port=port_HTTPS_contrôleur_collectivité --user=ID_administrateur_contrôleur_collectivité --password=mot_de_passe_contrôleur_collectivité --keystorePassword=mot_de_passe_fichier_clés_généréSpécifiez également, le cas échéant, une ou plusieurs des options facultatives suivantes :- --autoAcceptCertificates
- Indique de se fier automatiquement aux certificats SSL.
- --rpcUser
- Nom d'utilisateur pour accès distant à l'hôte sur lequel réside l'application. Par exemple, SSH. --rpcUser reçoit par défaut le nom de l'utilisateur actuel.
- --rpcUserPassword
- Si --rpcUser est spécifié, mot de passe de cet utilisateur pour accès distant à l'hôte sur lequel réside l'application.
- --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_rsaSi vous spécifiez --rpcUser et --rpcUserPassword, ne spécifiez pas --sshPrivateKey.
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 nom_serveur --host=hôte_contrôleur_collectivité --port=port_HTTPS_contrôleur_collectivité --user=ID_administrateur_contrôleur_collectivité --password=mot_de_passe_administrateur_contrôleur_collectivité --autoAcceptCertificatesLa 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 --rpcUserPassword=osUserPassword --autoAcceptCertificatesLa 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 --rpcUserPassword=osUserPassword --autoAcceptCertificatesLa 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
Rubrique de référence