エッジ暗号化プロキシサーバーをインストールする (コマンド ライン インストーラー)

  • リリースバージョン: Yokohama
  • 更新日 2025年02月20日
  • 所要時間：4分

    • 64 ビットの Windows または Linux コンピューターに エッジ暗号化 プロキシをインストールします。

    始める前に

    必要なロール：admin

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

    このタスクについて

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

    エッジ暗号化プロキシサーバーをアップグレードすると、現在のインストール ディレクトリー配下の 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 <proxy_name> --instancehost <host> -p <port> --protocol https –s <install_path>
      オプション 変数 説明
      なし version 現在の操作の実行に使用している エッジ暗号化 プロキシのバージョン番号。
      -m mode ランタイムモード。オプションは、新しい Edge プロキシサーバーの場合は「インストール」、既存の Edge プロキシサーバーをアップグレードする場合は「dist-upgrade」です。
      -n proxy_name インストールされている エッジ暗号化 プロキシサーバーの名前。特定のプロキシ インスタンスを識別できるように、一意のproxy_nameを使用します。
      --instancehost host ServiceNow インスタンスのホスト名 (たとえば、mycompany.service-now.com)。
      -p ポート ServiceNowインスタンスがリッスンするポート。通常、セキュリティで保護された HTTPS 接続はポート 443 でリッスンし、HTTP 接続はポート 80 でリッスンします。
      --protocol プロトコル バックエンド ServiceNow ホストに接続するときに、インストールされる Edge プロキシが使用するプロトコル。これは通常、ホストインスタンスがサポートするプロトコルに応じて 、HTTPS (セキュアな TLS 接続に優先) または HTTP (TLS を使用しない接続) になります。
      注:
      ブラウザからコマンドをコピー アンド ペーストしないでください。コピー/ペースト操作によって予期しない文字がターゲット マシンに貼り付けられ、コマンドが正しく実行されないことがあります。マニュアルを参考にして手動でコマンドを入力するようにしてください。

      ヘルプ画面を表示するには、 次のコマンドを –help オプションを指定して実行します: java -jar edgeencryption-<version>-all.jar --help

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

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

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

    タスクの結果

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