Installer le serveur proxy Chiffrement Edge (programme d’installation de ligne de commande)

  • Rversion finale: Yokohama
  • Mis à jour 20 févr. 2025
  • 3 minutes de lecture

    • Installez un Chiffrement Edge proxy sur un ordinateur Windows ou Linux 64 bits.

    Avant de commencer

    Rôle requis : admin

    La version Java 11.0.6 ou ultérieure de la série de versions 11.x est requise pour exécuter le programme d’installation.

    Pourquoi et quand exécuter cette tâche

    Installez le Chiffrement Edge serveur proxy sur un ordinateur de votre réseau à l’aide de la commande appropriée pour votre ordinateur cible. Si vous installez le Chiffrement Edge serveur proxy sur un ordinateur Windows, vous devez également installer le serveur proxy en tant que service Windows.

    Lorsque vous mettez à niveau le serveur proxy Chiffrement Edge, le système sauvegarde l’ancien proxy dans le répertoire backup.dist-upgrade-<timestamp> sous le répertoire d’installation actuel. Le répertoire de sauvegarde est généré pendant le processus de mise à niveau et stocke les anciennes informations du proxy.

    Lorsque vous exécutez une mise à niveau via la ligne de commande, une dist-upgrade.log peut être générée dans le répertoire où la commande s’exécute. La dist-upgrade.log contient des journaux pour le processus de mise à niveau.

    En cas d’échec d’une mise à niveau, le système crée un répertoire failed-backup.dist-upgrade-<timestamp> . De plus, les journaux/wrapper.log dans le répertoire proxy d’origine peuvent également contenir des informations sur les défaillances.

    Procédure

    1. Créez le répertoire d’installation.
    2. Téléchargez le fichier d’archive Chiffrement Edge proxy dans le répertoire d’installation.
    3. Ouvrez le terminal et accédez au répertoire d’installation.
      Remarque :
      Si vous effectuez l’installation sur un ordinateur Windows, vous devez démarrer l’invite de commandes Windows avec les privilèges d’administrateur.
    4. Exécutez cette commande pour la machine cible et modifiez les variables en fonction de votre configuration : java -jar edgeencryption-<version>-all.jar -m install –n <proxy_name> --instancehost <host> -p <port> --protocol https –s <install_path>
      Option Variable Description
      aucun version Numéro de version du Chiffrement Edge proxy utilisé pour effectuer l’opération en cours.
      -m Mode Mode d’exécution. Les options sont « installer » pour un nouveau serveur proxy Edge ou « dist-upgrade » pour mettre à niveau un serveur proxy Edge existant.
      -n proxy_name Nom du serveur proxy installé Chiffrement Edge . Utilisez une proxy_name unique pour pouvoir identifier des instances proxy spécifiques.
      --instancehost hôte Le nom d’hôte de votre instance ServiceNow (par exemple, mycompany.service-now.com).
      -p port Port sur lequel votre ServiceNow instance écoute. En général, les connexions HTTPS sécurisées écoutent sur le port 443 et les connexions HTTP écoutent sur le port 80.
      --protocole protocol Protocole utilisé par le proxy Edge installé lors de la connexion à l’hôte back-end ServiceNow . Il s’agit généralement de HTTPS (préféré pour les connexions TLS sécurisées) ou HTTP (connexions sans TLS) selon le protocole pris en charge par l’instance hôte.
      Remarque :
      Ne copiez pas et ne collez pas de commandes à partir du navigateur. Parfois, les opérations de copier/coller entraînent le collage de caractères inattendus sur la machine cible et entraînent une exécution incorrecte de la commande. Il est préférable de taper la commande à la main en utilisant la documentation comme référence.

      Pour afficher l’écran d’aide, exécutez cette commande avec l’option –aide : java -jar edgeencryption-<version>-all.jar --help

    5. En cas d’installation sur un ordinateur Windows, installez le Chiffrement Edge proxy en tant que service Windows.
      1. Facultatif : Modifiez le nom du service en ouvrant le fichier conf/wrapper.conf sur le nouveau proxy et en définissant les propriétés dans la table suivante.
        Propriété Description
        wrapper.ntservice.name Nom unique du Chiffrement Edge service proxy.
        Wrapper.NTSERVICE.DisplayName Chiffrement Edge Nom d’affichage du service proxy.
        wrapper.ntservice.description (facultatif) Description du serveur proxy.

        Si cette étape n’est pas effectuée, le Chiffrement Edge service proxy est installé sous le nom de Chiffrement Edge.

      2. Enregistrez et fermez le fichier.
      3. Ouvrez l’invite de commande Windows et cd to ServerName_port/bin.
      4. Exécutez edgeencryption.bat installation.

    Résultats

    Le répertoire ProxyName_port est créé dans le répertoire actuel. Le fichier edgeencryption.properties est mis à jour avec les valeurs d’hôte, de port et de protocole de la ligne de commande.