For LINUX platformsFor Windows platforms

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
action peut recevoir les valeurs et variables suivantes :
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 :

  1. Créez une application Node.js.
  2. 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.
  3. Pour inclure des dépendances, exécutez la commande npm install dans le répertoire de l'application.
  4. 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]
action peut recevoir les valeurs et variables suivantes :
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

Icône indiquant le type de rubrique Rubrique de référence

Nom du fichier : rwlp_command_nodejs.html