Installation d'agents depuis la ligne de commande

L'installation d'un agent depuis la ligne de commande implique l'exécution d'un fichier de commandes ou d'un script de shell et la spécification d'informations sur la façon dont l'agent se connecte au serveur.

Avant de commencer

Pour les environnements de production, créez un compte utilisateur dédié à l'exécution de l'agent sur le système sur lequel l'agent est installé.

Vérifiez que l'ordinateur sur lequel vous installez l'agent dispose de la version 7 ou ultérieure de Java™ Runtime Environment (JRE) ou de Java Development Kit (JDK).

Si l'ordinateur cible dispose du JRE ou du JDK IBM®, mettez à niveau ce programme vers la version 7.0.0 SR4 avec le niveau d'actualisation de service spécifié ou ultérieur :

Pourquoi et quand exécuter cette tâche

Les agents qui s'exécutent sur des systèmes UNIX peuvent être installés directement depuis l'application Web d'IBM UrbanCode Deploy. Voir Installation d'agent à distance.

Pour de simples évaluations, l'administrateur peut exécuter l'agent sur le système sur lequel se trouve le serveur. Cependant, si vous prévoyez d'exécuter des déploiements sur plusieurs systèmes, installez un agent distinct sur chaque système. Par exemple, si votre environnement de test comporte trois systèmes, installez l'agent sur chaque système. Suivez la même procédure pour chaque environnement que l'application utilise.

Chaque agent requiert les droits appropriés pour communiquer avec le serveur IBM UrbanCode Deploy (si l'agent communique avec IBM UrbanCode Deploy via un relais d'agent, voir Installation d'agent à distance).

Au minimum, chaque agent doit disposer des droits permettant de :

Procédure

  1. Téléchargez le programme d'installation de l'agent et procédez à son extraction sur l'ordinateur sur lequel installer l'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 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/ibm-ucd-agent.zip
      Remarque : Si vous installez l'agent sous z/OS, le codage de caractères pour plusieurs fichiers de type texte dans le package d'installation doit être converti en codage IBM-1047 pour que les fichiers puissent être utilisés. Procédez à l'extraction des fichiers d'installation et convertissez les fichiers suivants dans le codage IBM-1047 :
      • install-agent.sh
      • install.with.groovy.xml
      • opt/apache-ant-1.8.4/bin/ant
      • opt/apache-ant-1.8.4/bin/antRun
      • opt/groovy-1.8.8/bin/groovy
      • opt/groovy-1.8.8/bin/startGroovy
      • install/AgentInstaller.groovy
      Pour convertir les fichiers, émettez des commandes similaires aux suivantes dans une invite de commande :
      iconv -f UTF-8 -t IBM-1047 nom_fichier >nom_fichier.bac
      mv nom_fichier.bac nom_fichier
      Après avoir converti les fichiers, déplacez les fichiers d'installation sous z/OS et procédez à l'installation.
  2. Après avoir téléchargé et développé le package d'installation, ouvrez le répertoire du programme d'installation.
  3. Depuis ce répertoire, exécutez install-agent.bat (Windows) ou install-agent.sh (UNIX ou Linux).
    Remarque : Si vous installez l'agent en tant que service Windows, le compte utilisateur doit disposer des privilèges suivants :
    • SE_INCREASE_QUOTA_NAME "Adjust memory quotas for a process"
    • SE_ASSIGNPRIMARYTOKEN_NAME "Replace a process level token"
    • SE_INTERACTIVE_LOGON_NAME "Logon locally"
    Le programme d'installation d'agent d'IBM UrbanCode Deploy s'affiche et vous invite à fournir 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.
    Enter the directory where agent should be installed.
    Exemple : C:\Program Files\IBM\UCDeploy-agent (Windows) ou /opt/IBM/ibm-ucd/agent (UNIX). Si le répertoire n'existe pas, entrez Y pour que le programme d'installation le crée pour vous. Si vous entrez un répertoire existant, le programme vous propose de mettre à niveau l'agent. Pour des informations sur la mise à niveau, voir Mise à niveau d'IBM UrbanCode Deploy.
    Remarque : N'utilisez pas d'extensions de shell ou d'abréviations, comme le caractère tilde (~).
    Please enter the home directory of the JRE/JDK used to run the agent.
    Si Java est déjà installé, IBM UrbanCode Deploy suggère l'emplacement Java comme valeur par défaut. Pour accepter la valeur par défaut, appuyez sur Entrée. Sinon, remplacez la valeur par défaut et entrez le chemin correct.
    Will the agent connect to a agent relay instead of directly to the server?
    La valeur par défaut est N. Si vous spécifiez Y, vous êtes invité à configurer les paramètres suivants :
    hostname or address of the agent relay the agent will connect to
    Entrez le nom d'hôte ou l'adresse IP du relais d'agent. Indiquez la valeur que vous avez utilisée lorsque vous avez installé le relais d'agent.
    agent communication port for the agent relay
    Entrez le port que l'agent utilise pour les communications reposant sur JMS avec le relais d'agent. La valeur par défaut est 7916.
    HTTP proxy port for the agent relay
    Entrez le port que l'agent utilise pour les communications HTTP avec le relais d'agent. La valeur par défaut est 20080.
    Remarque : Vous pouvez spécifier un autre relais à utiliser au cas où le premier échouerait. Configurez des relais de basculement en ajoutant des relais supplémentaires au paramètre locked/agent.brokerUrl=failover\: dans le fichier /agent-install/conf/agent/installed.properties. La syntaxe de configuration de relais est IP_ou_nom_hôte_agent\:port_JMS. Séparez les relais par une virgule. L'exemple suivant illustre le paramètre configuré pour deux relais : locked/agent.brokerUrl=failover\:(ah3\://relay1\:7916,ah3\://relay2\:7916). On suppose que tous les relais utilisent le même port proxy HTTP. Au départ, le paramètre contient l'emplacement du relais configuré au cours de l'installation de l'agent.
    Enter the host name or address of the server the agent will connect to.
    La valeur par défaut est localhost. Si l'agent se connecte à des serveurs en cluster, spécifiez le nom d'hôte de l'équilibreur de charge.
    Enter the agent communication port for the server
    La valeur par défaut est 7918.
    Does the server agent communication use mutual authentication with SSL?
    La valeur par défaut est N.

    Si vous utilisez le protocole SSL, désactivez-le pour le serveur également, ou l'agent ne pourra pas se connecter au serveur. Il en va de même si vous utilisez l'authentification mutuelle. Si vous changez les numéros de port pour la communication de l'agent, vous devez les indiquer lorsque vous installez les agents.

    Enter the name for this agent.
    Entrez un nom unique. Le serveur utilise ce nom pour identifier cet agent. Les noms ne peuvent pas comporter plus de 256 caractères et ne peuvent pas être modifiés.
    Enter teams to add this agent to, separated by commas.
    La valeur par défaut est AUCUNE.

    Les agents peuvent être ajoutés à des équipes lorsqu'ils se connectent au serveur pour la première fois. A sa première connexion au serveur, l'agent est affecté aux équipes spécifiées. Séparez plusieurs équipes par une virgule ; les espaces de fin sont ignorés. Les noms d'équipe qui n'existent pas sont également ignorés.

    Do you want to install the Agent as Windows service?
    (Windows uniquement). La valeur par défaut est N. Lorsqu'il est installé en tant que service, IBM UrbanCode Deploy capture seulement la valeur de la variable PATH. Les valeurs qui sont capturées au cours de l'installation sont toujours utilisées, même si vous les changez ultérieurement. Pour des versions récentes de Windows, vous devez exécuter la commande en tant qu'administrateur.

Que faire ensuite

Démarrez l'agent comme décrit dans Démarrage des agents. Si l'agent est configuré correctement, IBM UrbanCode Deploy le reconnaît automatiquement ; il n'est pas nécessaire d'effectuer des opérations supplémentaires pour pouvoir l'utiliser.

Commentaires en retour