Installation de relais d'agent

Un relais d'agent est un proxy de communication pour les agents qui se trouvent derrière un pare-feu ou à un autre emplacement réseau.

Avant de commencer

Pourquoi et quand exécuter cette tâche

S'il existe au moins une connexion de réseau étendu à bande passante faible entre le serveur et les agents distants, le serveur IBM UrbanCode Deploy peut envoyer du travail aux agents qui se trouvent ailleurs géographiquement via le relais. Pour un relais d'agent, il suffit qu'un serveur unique sur le réseau distant prenne contact avec le serveur. D'autres agents distants communiquent avec le serveur via le relais d'agent. L'intégralité de la communication entre les agents et le serveur provenant du réseau distant passe par le relais.

Procédure

  1. Téléchargez le programme d'installation du relais d'agent et procédez à son extraction sur l'ordinateur sur lequel installer le relais d'agent :
    • Pour télécharger le programme d'installation depuis le serveur, cliquez sur le bouton Aide dans le coin supérieur droit de la page, puis cliquez sur Outils. Ensuite, cliquez sur Relais d'agent IBM UrbanCode Deploy et téléchargez et extrayez le fichier.
    • Pour rechercher le programme d'installation sur le serveur avec la ligne de commande, accédez à l'emplacement suivant et copiez le fichier sur le système cible : dossier_installation/opt/tomcat/webapps/ROOT/tools/agent-relay.zip
  2. Développez le fichier d'installation compressé.
  3. Depuis le répertoire agent-relay-install développé, exécutez le script install.cmd (Windows) ou le fichier install.sh (Linux ou UNIX).
  4. Le programme d'installation vous invite à entrer les informations ci-après. Vous pouvez accepter les valeurs par défaut (affichées entre crochets) en appuyant sur Entrée. Si deux options sont indiquées, par exemple Y/n, l'option en majuscule est la valeur par défaut.
    Please enter the directory where you would like to install the agent relay.
    Entrez le répertoire du relais. Si vous entrez un répertoire existant, le programme vous invite à mettre à niveau le relais. Pour des informations sur la mise à niveau, voir Mise à niveau d'IBM UrbanCode Deploy.
    Please enter your java home
    Spécifiez le répertoire dans lequel Java est installé. Vérifiez que la variable d'environnement JAVA_HOME désigne ce répertoire.
    Enter the name of this relay.
    Entrez le nom du relais d'agent. Chaque relais doit avoir un nom unique. Le nom par défaut est agent-relay.
    Enter the IP or hostname which this Agent Relay should use.
    Entrez l'adresse IP ou le nom d'hôte d'écoute du relais. Dans la plupart des cas, l'agent est à l'écoute sur toutes les adresses IP disponibles pour l'ordinateur ; dans ce cas, spécifiez 0.0.0.0.
    Enter the port which this Agent Relay should proxy HTTP requests on.
    Entrez le port sur lequel le relais d'agent est à l'écoute des demandes HTTP entrantes provenant des agents. La valeur par défaut est 20080.
    Enter the port which this Agent Relay should use for communication.
    Entrez le port que le relais d'agent utilise pour les communications reposant sur JMS avec les agents distants. La valeur par défaut est 7916.
    Connect the agent relay to a central server?
    Indiquez si le relais doit se connecter au serveur IBM UrbanCode Deploy.
    Enter the IP or hostname of your central server.
    Si vous avez indiqué que le relais doit se connecter à un serveur, spécifiez l'adresse IP ou le nom d'hôte permettant au relais de contacter le serveur. Si le relais se connecte à des serveurs en cluster, spécifiez le nom d'hôte de l'équilibreur de charge. Si vous spécifiez un nom d'hôte, assurez-vous que l'ordinateur du relais peut résoudre le nom d'hôte en adresse IP via le système DNS.
    Enter the port which the central server uses for communication.
    Si vous avez indiqué que le relais doit se connecter à un serveur, entrez le port que le serveur utilise pour communiquer avec les agents. La valeur par défaut est 7918.
    Use mutual authentication between the agent, relay and server.
    Si l'authentification mutuelle est requise, entrez Y. Voir Configuration SSL pour des informations sur l'activation de l'authentification mutuelle.
    Cache files on the relay which have been downloaded by any connected agents?
    Si vous voulez mettre le fichier en cache sur le relais d'agent, entrez Y.
    What user would you like to use to run the agent relay?
    Sur les systèmes Linux ou UNIX, spécifiez l'utilisateur qui exécute le relais d'agent.
    What group would you like to use to run the agent relay?
    Sur les systèmes Linux ou UNIX, spécifiez le groupe à associer au relais d'agent.
    Install the Agent Relay as Windows service?
    Si vous installez le relais sous Windows, vous pouvez l'installer en tant que service Windows. La valeur par défaut est N.

Que faire ensuite

Si vous devez modifier le relais, vous pouvez éditer ces propriétés dans le fichier agentrelay.properties dans le répertoire relay_installation\conf.
Pour démarrer le relais d'agent, accédez au dossier d'installation du relais et exécutez la commande suivante :
bin/agentrelay start

Commentaires en retour