Edge Encryption プロキシサーバーをインストールする (コマンド ライン インストーラー)

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む4読むのに数分
  • 64 ビットの Windows または Linux コンピューターに エッジ暗号化 プロキシをインストールします。

    始める前に

    必要なロール:管理者

    インストーラーを実行するには、11.x バージョンシリーズの Java バージョン 11.0.6 以降が必要です。

    このタスクについて

    ターゲット マシンに適したコマンドを使用して、ネットワークのマシンに エッジ暗号化 プロキシサーバーをインストールします。エッジ暗号化 プロキシサーバーを Windows マシンにインストールする場合は、プロキシサーバーを Windows サービスとしてさらにインストールする必要があります。

    Edge Encryption プロキシサーバーをアップグレードすると、現在のインストール ディレクトリー配下の backup.dist-upgrade-<タイムスタンプ> ディレクトリーに、古いプロキシのバックアップが格納されます。このバックアップ ディレクトリーはアップグレード プロセス中に生成されるもので、古いプロキシの情報が格納されます。

    コマンド ラインからアップグレードを実行すると、コマンドを実行したディレクトリーに dist-upgrade.log が生成されることがあります。dist-upgrade.log には、アップグレード プロセスのログが記録されています。

    アップグレードに失敗した場合は、failed-backup.dist-upgrade-<timestamp> というディレクトリーが作成されます。また、元のプロキシ ディレクトリーの logs/wrapper.log にも、失敗に関する情報が格納される場合があります。

    手順

    1. インストール ディレクトリーを作成します。
    2. エッジ暗号化 プロキシのアーカイブ ファイルをインストール ディレクトリーにコピーします。
    3. ターミナルを開き、インストール ディレクトリーに移動します。
      注:
      Windows マシンにインストールする場合は、Windows コマンド プロンプトを管理者権限で起動する必要があります。
    4. ターゲット マシンに対してコマンド java -jar edgeencryption-<version>-all.jar -m install -n <ProxyName> --instancehost <host> -p <InstancePort> --protocol https を実行し、設定に応じて変数を変更します。
      オプション 変数 説明
      なし version 現在の操作の実行に使用している エッジ暗号化 プロキシのバージョン番号。
      -m mode 実行する操作またはモード (install or dist-upgrade)。
      -n ProxyName 暗号化プロキシ インスタンスの名前。特定のプロキシ インスタンスを識別できるように、一意の ProxyName を使用します。
      --instancehost host ServiceNow インスタンスのホスト名 (たとえば、mycompany.service-now.com)。
      -p InstancePort インスタンスのポート。プロトコルが https の場合、ポートは通常は 443 です。
      --protocol protocol ServiceNow インスタンスへのアクセスに使用されるプロトコル (通常は https)。
      注:
      ブラウザからコマンドをコピー アンド ペーストしないでください。コピー/ペースト操作によって予期しない文字がターゲット マシンに貼り付けられ、コマンドが正しく実行されないことがあります。マニュアルを参考にして手動でコマンドを入力するようにしてください。

      ヘルプ画面を表示するには、このコマンドを引数なしで実行します (java -jar edgeencryption-<version>-all.jar)。

    5. Windows マシンにインストールする場合は、エッジ暗号化 プロキシを Windows サービスとしてインストールします。
      1. オプション: 新しいプロキシで conf/wrapper.conf ファイルを開き、次のテーブルのプロパティを設定して、サービスの名前を変更します。
        プロパティ 説明
        wrapper.ntservice.name エッジ暗号化 プロキシ サービスの一意の名前。
        wrapper.ntservice.displayname エッジ暗号化 プロキシ サービスの表示名。
        wrapper.ntservice.description (オプション) プロキシサーバーの説明。

        この手順を実行しない場合、エッジ暗号化 プロキシ サービスは Edge Encryption という名前でインストールされます。

      2. ファイルを保存して閉じます。
      3. Windows のコマンドプロンプトを開き、cd ServerName_port/bin を実行します。
      4. edgeencryption.bat install を実行します。

    タスクの結果

    ProxyName_port ディレクトリーが現在のディレクトリーに作成されます。edgeencryption.properties ファイルが、コマンド ラインからのホスト、ポート、プロトコルの値に更新されます。