Den Proxy-Server für die Edge Encryption installieren (Befehlszeilen-Installationsprogramm)

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer

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

    Vorbereitungen

    Erforderliche Rolle: admin

    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 edgeencryption-<version>-all.jar -m install -n <ProxyName> --instancehost <host> -p <InstancePort> --protocol https
      Option Variable Beschreibung
      Keine Version Versionsnummer des Edge Encryption Proxy, der zur Ausführung der aktuellen Operation verwendet wird.
      -m Modus Die Operation oder der Modus, in dem ausgeführt werden soll (Installation oder Dist-Upgrade).
      -n ProxyName Der Name der Verschlüsselungs-Proxy-Instanz. Verwenden Sie einen eindeutigen ProxyName, um bestimmte Proxy-Instanzen identifizieren zu können.
      --instancehost host Der Hostname Ihrer ServiceNow-Instanz (z. B. mycompany.service-now.com).
      -p InstancePort Der Port Ihrer Instanz. Bei Protokoll https ist der Port normalerweise 443.
      --protocol protocol Das für den Zugriff auf Ihre ServiceNow-Instanz verwendete Protokoll (in der Regel https).
      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 ohne Argumente aus: java -jar edgeencryption-<version>-all.jar

    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.