Installer et configurer un injecteur de charge

Pour savoir comment installer et configurer un injecteur de charge pour qu'il se connecte à NeoLoad Web, voir Configuration de la plateforme pour le runtime.

Une fois que vous avez connecté un injecteur de charge à NeoLoad Web, seul NeoLoad Web peut l'utiliser. Si vous souhaitez désactiver cette mesure de sécurité, éditez la clé [Network]agent.accept.only=ALL dans le fichier <Load Generator>/conf/agent.properties.

Configurer un agent d'injecteur de charge

Les paramètres d'accès à NeoLoad Web peuvent être configurés en lançant le fichier ".exe" de l'agent de l'injecteur de charge à partir du dossier "bin" de NeoLoad. Un clic droit sur l'Agent permet de sélectionner l'option de NeoLoad Web settings.

NLW-LGAgentSettings

La section Deployment vous permet de sélectionner la manière dont NeoLoad Web est déployé dans votre infrastructure. NeoLoad Web peut être déployé soit :

  • En mode SaaS, ou bien,

  • Sur site

Lorsque NeoLoad Web est déployé sur site, vous devez entrer l'URL qui permettra à l'agent de l'injecteur de charge de se connecter à NeoLoad Web. Le port requis est le port de connexion NeoLoad.

Par défaut, l'URL est "http://nlweb.<your company>.com:8080". Pour connaître l'URL utilisée dans votre déploiement, contactez votre administrateur informatique NeoLoad Web. Pour plus d'informations, consultez la section Configuration initiale.

Nota :

  • En ligne de commande, l'argument -nlwebAPIURL spécifie l'URL de l'API NeoLoad afin de se connecter à NeoLoad Web lorsqu'il est déployé sur site. Cet argument surcharge toute variable d'environnement précédemment définie. Pour plus d'informations, consultez la liste des arguments.

  • La variable d'environnement NLWEB_API_URL permet de spécifier l'URL de l'API NeoLoad afin de se connecter à NeoLoad Web lorsqu'il est déployé sur site. Elle peut être utilisée comme suit : NLWEB_API_URL={nlweb-onpremise-apiurl:port}

La section Authentication vous permet de vous authentifier auprès de NeoLoad Web à l'aide d'un jeton.

L'authentification par jeton sécurise une application basée sur les jetons d'accès que vous pouvez générer pour permettre à d'autres utilisateurs de se connecter à l'application. De cette manière, vous pouvez autoriser l'accès à des partenaires sans communiquer votre mot de passe. Vous pouvez changer votre mot de passe sans mettre à jour vos jetons d'accès et supprimer les jetons dont vous n'avez plus besoin sans changer votre mot de passe.

Access token : Le jeton d'accès généré dans NeoLoad Web peut être collé dans ce champ.

En ligne de commande, l'argument -nlwebToken active la connexion avec NeoLoad Web et déclare un jeton d'accès. Cet argument surcharge toute variable d'environnement précédemment définie. Pour plus d'informations, consultez la liste des arguments.

Hostname : Le champ doit être rempli avec le nom de la machine où se trouve l'agent de l'injecteur de charge.

La variable d'environnement LG_HOST permet de modifier l'adresse IP de l'hôte auquel l'injecteur de charge peut être joint. Elle peut être utilisée comme suit : LG_HOST={lg.mycompany}.

Port : Le champ doit être rempli avec le numéro de port pour accéder à l'agent de l'injecteur de charge.

La variable d'environnement LG_PORT permet de modifier le port de l'hôte sur lequel l'injecteur de charge G peut être atteint. Elle peut être utilisée comme suit : LG_PORT={7100}.

Zone identifier : Pour associer un agent d'injecteur de charge à une zone que vous avez créée, l'identifiant de la zone doit être copié et collé dans ce champ. Pour plus d'informations, voir Gérer les zones. Nota :

  • En ligne de commande, l'argument -nlwebZoneId permet de remplacer la zone. Cet argument surcharge toute variable d'environnement précédemment définie. Pour plus d'informations, consultez la liste des arguments.

  • La variable d'environnement ZONE permet de spécifier la zone de l'injecteur de charge à utiliser. Elle peut être utilisée comme suit : ZONE={zone-id}.

La section Proxy permet de sélectionner le proxy que vous souhaitez utiliser pour vous connecter à NeoLoad Web en mode HTTP ou HTTPS. Pour plus d'informations, voir Ajouter un proxy. Nota :

  • En ligne de commande, l'argument -nlwebProxy permet de connecter NeoLoad Web en utilisant un proxy. Cet argument surcharge toute variable d'environnement précédemment définie. Pour plus d'informations, consultez la liste des arguments.

  • La variable d'environnement NLWEB_PROXY permet de se connecter à NeoLoad Web en utilisant un proxy. Elle peut être utilisée comme suit : NLWEB_PROXY=http://{login:password}@{myproxy}.

Dans la section Check connection, utilisez le bouton Test pour vérifier la connexion (configuration du serveur, informations d'authentification, paramètres proxy le cas échéant, référentiel le cas échéant).

Astuce : Pour plus d'informations sur la configuration de l'agent de l'injecteur de charge avec Docker, reportez-vous à la documentation Dockerhub.

Définir un agent d'injecteur de charge en tant que service

Les agents du contrôleur et de l'injecteur de charge peuvent être installés en tant que services ou lancés de manière ad hoc - en exécutant l'exécutable lorsque cela est nécessaire. La première approche (En tant qu'Administrateur) est cohérente avec une approche à long terme et durable, car les agents exécutés en tant que services sont lancés une fois pour toutes et seront automatiquement redémarrés à chaque redémarrage de la machine. La seconde (Pour un utilisateur spécifique), bien que moins intrusive et plus facile à mettre en œuvre, a du sens lorsqu'elle ne vise qu'une utilisation occasionnelle.

En tant qu'Administrateur

L'agent d'injecteur de charge peut être défini en tant que service Windows, c'est-à-dire lancé et arrêté à chaque fois que Windows démarre et s'arrête. Pour plus d'informations, voir la procédure plus bas.

Pour définir l'agent d'injecteur de charge en tant que service sous Windows, procédez comme suit :

  1. Lancez le fichier "LoadGeneratorAgent.exe" se trouvant dans le répertoire "bin" de vos répertoires d'installation de NeoLoad.

  2. Copiez le fichier "agent_user.properties" situé dans C:\Users\<username>\AppData\Roaming\Neotys\NeoLoad\v7.11\conf.

  3. Collez-le dans C:\Windows\System32\config\systemprofile\AppData\Roaming\ après avoir créé les dossiers "Neotys", "NeoLoad", "v7.11" et "conf".

  4. Cliquez avec le bouton droit de la souris sur la barre des tâches, sélectionnez Task Manager puis l'onglet Services.

  5. Dans la liste des services, cliquez avec le bouton droit de la souris sur NeoLoad Load Generator Agent et sélectionnez Open Services. Faites un clic droit sur NeoLoad Controller Agent et sélectionnez Properties.

  6. Dans la liste déroulante Startup type, sélectionnez "Automatique".

  7. Cliquez sur OK.

Pour définir l'agent d'injecteur de charge en tant que service sous Linux, procédez comme suit :

  1. Ouvrez le fichier "agent_user.properties" situé dans /home/<USERNAME>/.neotys/neoload/v2025.2/conf/

    • Sans proxy :

      [Web]
      neoload.web.onpremise.secretToken=mytoken
      neoload.web.deployment.type=ONPREMISE
      neoload.web.onpremise.url=http\://"myserver-nlw-onpremise.com"\:8080
      neoload.web.resource.zone=myzone
      #neoload.web.resource.address.host="My-LG-Agent-host-name"
      #neoload.web.resource.address.port=7100

    • Avec proxy :

      #Agent user properties
      #Thu May 17 15:26:59 CEST 2018
      [Proxy]
      neoloadwebproxy.autoconfurl=
      neoloadwebproxy.password=/WW/6DOGK7o\=
      neoloadwebproxy.https.host=
      neoloadwebproxy.mode=GLOBAL_CACHE_MODE
      neoloadwebproxy.http.host=
      neoloadwebproxy.ftp.host=
      neoloadwebproxy.https.port=443
      neoloadwebproxy.js.engine.class=
      neoloadwebproxy.http.port=80
      neoloadwebproxy.ftp.port=21
      neoloadwebproxy.autodiscover=Disabled
      neoloadwebproxy.manualconf=Disabled
      neoloadwebproxy.id=neoload web proxy
      neoloadwebproxy.exclusionlist=
      neoloadwebproxy.login=
      neoloadwebproxy.autoconf=Disabled
      [Web]
      neoload.web.onpremise.secretToken=mytoken
      neoload.web.deployment.type=ONPREMISE
      neoload.web.onpremise.url=http\://"myserver-nlw-onpremise.com"\:8080
      neoload.web.resource.zone=myzone
      #neoload.web.resource.address.host="My-LG-Agent-host-name"
      #neoload.web.resource.address.port=7100

Pour un utilisateur spécifique

L'agent d'injecteur de charge peut être défini en tant que service pour un utilisateur spécifique.

Pour définir un agent de génération de charge pour un utilisateur spécifique sous Windows, procédez comme suit :

  1. Changez l'utilisateur utilisé pour démarrer le service. Dans Windows, allez dans Run et entrez "services.msc".

    NLW-LGAgentService

  2. Cliquez avec le bouton droit de la souris sur NeoLoad Load Generator Agent et sélectionnez Properties.

  3. Dans l'onglet LogOn, sélectionnez l'option This account. Entrez le nom d'utilisateur de l'utilisateur qui a configuré l'Agent et son mot de passe.

  4. Dans l'onglet General, cliquez sur la liste déroulante Startup type et sélectionnez Automatic.

Le fichier de configuration se trouve ici :

  • /home/<USERNAME>/.neotys/neoload/v7.11/conf/agent_user.properties

Attention : La procédure ci-dessous n'est applicable que pour CentOS 7.

Pour définir un agent de génération de charge pour un utilisateur spécifique sous Linux, procédez comme suit :

  1. Installez NeoLoad avec l'utilisateur "root".

  2. Accordez les permissions d'exécution au dossier d'installation de NeoLoad (opt/NeoLoad7.11 par défaut) :
    “chmod -R +x /opt/NeoLoad7.11”

  3. Si nécessaire, créez un dossier "logs" dans le répertoire d'installation.

  4. Après l'installation, les fichiers exécutables se trouvent dans /etc/init.d

  5. Éditez /opt/NeoLoad7.11/bin/LoadGeneratorAgentService.vmoptions :
    Ajoutez la ligne : -Djava.awt.headless=true

  6. Éditez /opt/NeoLoad7.11/bin/LoadGeneratorAgent.vmoptions :
    Ajoutez la ligne : -Djava.awt.headless=true

  7. Créez un fichier "LoadGeneratorAgentService.service" dans /etc/systemd/system :
    [Unit]
    Description=Load Generator Agent Service
    After=network.target

    [Service]
    User=<USERNAME>
    Type=forking
    WorkingDirectory=/home/<USERNAME>
    ExecStart=/etc/init.d/LoadGeneratorAgentService start
    ExecStop=/etc/init.d/LoadGeneratorAgentService stop

    [Install]
    WantedBy=multi-user.target

  8. Créez un lien symbolique dans /etc/systemd/user :
    ln -s LoadGeneratorAgentService.service /usr/lib/systemd/user/LoadGeneratorAgentService.service

  9. Rechargez la configuration des services :
    systemctl daemon-reload

  10. Activez le service "LoadGeneratorAgentService" au démarrage du système :
    systemctl enable LoadGeneratorAgentService.service

  11. Démarrez manuellement le service :
    systemctl start LoadGeneratorAgentService.service

  12. Obtenez l'état du service :
    systemctl status LoadGeneratorAgentService.service