Installieren Sie den Edge Encryption-Proxyserver (Befehlszeilen-Installationsprogramm).

  • Freigeben Version: Yokohama
  • Aktualisiert 20. Februar 2025
  • 2 Minuten Lesedauer

    • Installieren Sie einen Edge Encryption Proxy auf einem 64-Bit-Windows- oder Linux-Computer.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Zum Ausführen des Installationsprogramms ist Java Version 11.0.6 oder höher in der 11.x-Versionsserie erforderlich.

    Warum und wann dieser Vorgang ausgeführt wird

    Installieren Sie den Edge Encryption Proxy-Server auf einem Computer in Ihrem Netzwerk mit dem entsprechenden Befehl für Ihren Zielcomputer. Bei der Installation des Edge Encryption Proxy-Servers auf einem Windows-Computer muss der Proxy-Server zusätzlich als Windows-Service installiert werden.

    Wenn Sie den Proxy-Server der Edge Encryption aktualisieren, sichert das System den alten Proxy im Verzeichnis backup.dist-upgrade-<timestamp> unter dem aktuellen Installationsverzeichnis. Das Sicherungsverzeichnis wird während des Upgrade-Vorgangs erstellt und speichert die alten Proxy-Informationen.

    Wenn Sie ein Upgrade über die Befehlszeile ausführen, kann eine dist-upgrade.log in dem Verzeichnis erstellt werden, in dem der Befehl ausgeführt wird. Das dist-upgrade.log enthält Protokolle für den Upgrade-Vorgang.

    Bei einem fehlgeschlagenen Upgrade erstellt das System ein Verzeichnis failed-backup.dist-upgrade-<timestamp>. Zusätzlich kann logs/wrapper.log im ursprünglichen Proxy-Verzeichnis auch Fehlerinformationen enthalten.

    Prozedur

    1. Erstellen Sie das Installationsverzeichnis.
    2. Laden Sie die Edge Encryption Proxy-Archivdatei in das Installationsverzeichnis herunter.
    3. Öffnen Sie das Terminal und wechseln Sie in das Installationsverzeichnis.
      Hinweis:
      Bei der Installation auf einem Windows-Computer müssen Sie die Windows-Eingabeaufforderung mit Administratorrechten starten.
    4. Führen Sie diesen Befehl für den Zielcomputer aus, und ändern Sie die Variablen entsprechend Ihrer Konfiguration: Java -Jar Edgencryption-<version> -all.jar -m Installation –n<proxy_name> --instancehost<host> -S<port> --protocol https – s<install_path>
      Option Variable Beschreibung
      Keine Version Versionsnummer des Edge Encryption Proxy, der zur Ausführung der aktuellen Operation verwendet wird.
      -m Modus Laufzeitmodus. Optionen sind „install“ für einen neuen Edge-Proxy-Server oder „dist-upgrade“ für das Upgrade eines vorhandenen Edge-Proxy-Servers.
      -n proxy_name Name des installierten Edge Encryption -Proxy-Servers. Verwenden Sie einen eindeutigen proxy_name, um bestimmte Proxy-Instanzen identifizieren zu können.
      --instancehost host Der Hostname Ihrer ServiceNow-Instanz (z. B. mycompany.service-now.com).
      -p port Port, an dem Ihre Instanz ServiceNow lauscht. Normalerweise lauschen sichere HTTPS-Verbindungen an Port  443, HTTP-Verbindungen an Port  80.
      --protocol protocol Protokoll, das der installierte Edge-Proxy für die Verbindung mit dem Back-End-Host ServiceNow verwendet. Dies ist normalerweise HTTPS (bevorzugt für sichere TLS-Verbindungen) oder HTTP (Verbindungen ohne TLS), je nachdem, welches Protokoll die Hostinstanz unterstützt.
      Hinweis:
      Kopieren Sie keine Befehle aus dem Browser. Gelegentlich führen Kopier- / Einfügevorgänge dazu, dass unerwartete Zeichen auf dem Zielcomputer eingefügt werden und der Befehl falsch ausgeführt wird. Es ist am besten, den Befehl von Hand anhand der Dokumentation als Referenz einzugeben.

      Um den Hilfebildschirm anzuzeigen, führen Sie diesen Befehl mit der Option –Hilfe aus: Java -Jar Edgencryption-<version> -all.jar --help

    5. Beim Installieren auf einem Windows-Computer installieren Sie den Edge Encryption Proxy als Windows-Dienst.
      1. Wahlweise: Ändern Sie den Namen des Service, indem Sie die Datei conf/wrapper.conf auf dem neuen Proxy öffnen und die Eigenschaften in der folgenden Tabelle festlegen.
        Eigenschaft Beschreibung
        wrapper.ntservice.name Eindeutiger Name des Edge Encryption Proxy-Service.
        wrapper.ntservice.displayname Anzeigename des Edge Encryption Proxy-Service.
        wrapper.ntservice.description (optional) Beschreibung des Proxy-Server.

        Bei Nichtausführung dieses Schrittes wird der Edge Encryption Proxy-Service unter dem Namen Edge Encryption installiert.

      2. Speichern und schließen Sie die Datei.
      3. Öffnen Sie die Windows-Eingabeaufforderung und cd zu ServerName_port/bin.
      4. Führen Sie edgeencryption.bat installieren aus.

    Ergebnisse

    Das Verzeichnis ProxyName_port wird im aktuellen Verzeichnis erstellt. Die Datei edgeencryption.properties wird mit den Host-, Port- und Protokollwerten über die Befehlszeile aktualisiert.