エージェントのアップグレード

当社のエージェントパッケージは、パッケージリポジトリで配布されます。まだ設定していなければ、ご自身のシステムでリポジトリを設定してください。

制約と考慮事項

Next-Gen WAF エージェントを使用する際には、以下の点に留意してください。

エージェント自動更新サービスを使用する

エージェント自動更新サービスは、パッケージダウンロード Webサイトでエージェントの新しいバージョンを確認し、新しいバージョンが利用可能になるとエージェントを更新します。

制約と考慮事項

エージェント自動更新サービスを設定する際には、以下の点に留意してください。

  • エージェント自動更新サービスは、サポートされているバージョンの Debian、Red Hat CentOS 7以上、Ubuntu 18.04以上のエージェントとのみ互換性があります。

  • エージェント自動更新サービスは、古いパッケージバージョンをアンインストールし、最新のバージョンをインストールすることでエージェントを更新します。エージェントのアップグレード中に短時間のダウンタイムが発生するため、Webサイトや Web アプリケーションのトラフィックの少ない時間帯に更新をスケジュールすることをお勧めします。

エージェント自動更新サービスを有効にする

エージェントをインストールしたら、エージェント自動更新サービスを有効にできます。

  1. エージェント自動更新サービスを有効にします。

    $ sudo systemctl enable --now sigsci-agent-update.timer
  2. (オプション) エージェントの自動更新タイマーをカスタマイズします。デフォルトでは、新しいバージョンのチェックは毎月第2木曜日に実行されます。

    $ sudo systemctl edit sigsci-agent-update.timer
    [Timer]
    OnCalendar=
    OnCalendar=Thu *-*-08,09,10,11,12,13,14 03:00:00
    RandomizedDelaySec=8h

エージェント自動更新サービスを無効にする

エージェントの自動更新サービスを無効にするには、以下のコマンドを実行します。

$ sudo systemctl disable --now sigsci-agent-update.timer

Azure の自動更新のその他の形式

以下は、Azure で設定できるさまざまな自動更新の形式です。

Alpine Linux システムでエージェントをアップグレードする

Alpine Linux システムでエージェントを手動でアップグレードするには、次の手順に従ってください。

  1. エージェントパッケージをアップグレードします。

    $ apk update
    $ apk add sigsci-agent
  2. エージェントを再起動します。

    $ sudo systemctl start sigsci-agent

Red Hat-CentOS システムのエージェントをアップグレードする

Red Hat CentOS システムでエージェントを手動でアップグレードするには、次の手順を実行します。

  1. エージェントパッケージをアップグレードします。

    $ yum -q makecache -y --disablerepo=* --enablerepo=sigsci_*
    $ yum install sigsci-agent
  2. エージェントを再起動します。

    $ sudo systemctl restart sigsci-agent

Ubuntu-Debian システムのエージェントをアップグレードする

Ubuntu または Debian システムでエージェントを手動でアップグレードするには、次の手順に従ってください。

  1. Ubuntu 15.04 以降
  2. Ubuntu 14.04
  1. エージェントパッケージをアップグレードします。

    $ sudo apt-get update
    $ sudo apt-get install sigsci-agent
  2. エージェントを再起動します。

    $ sudo systemctl start sigsci-agent

Windows システムのエージェントをアップグレードする

Windows システムでエージェントを手動でアップグレードするには、次の手順に従ってください。

  1. Windows インストーラー
  2. CLI
  1. 最新のエージェント MSI を dl.security.fastly.com または dl.signalsciences.net からダウンロードしてインストールします。

  2. services.msc を開きます。

  3. Signal Sciences Agent を選択します。

  4. 右クリックして再起動を選択します。

エージェントの自動更新を有効にする

Windows エージェント自動更新ユーティリティはエージェント MSI パッケージに含まれており、別のフォルダC:\Program Files\Signal Sciences\AgentAutoUpdateにインストールされます。ユーティリティを実行すると、Windows 用エージェントの新しいバージョンがあるかどうかを確認し、それが存在する場合はダウンロードしてインストールします。agent-autoupdate ユーティリティは、Windows タスクスケジューラと連携して動作するように設計されており、更新のチェックを自動化できます。

Windows タスクスケジューラでエージェントの自動更新を有効にするには、次の手順を実行してください。

  1. タスクスケジューラを開きます。

  2. タスクスケジューラウィンドウで、Action > Create Task に移動します。

  3. General タブで、次の情報を入力します。

    • Name : タスクに名前を付けます (例 : 「Fastly Agent Update」)。

    • Security Options : ユーザーがログインしているときだけタスクを実行するかどうかを決定します。このタスクは、SYSTEM アカウントまたは管理者アカウントで実行する必要があります。

  4. Trigger タブから、タスクをいつ開始するか、どのくらいの頻度で実行するかを定義する新しいトリガーを作成します。タスクは月単位のスケジュールで実行することをお勧めします。

  5. Action タブStart a program をクリックします。

  6. agent-autoupdate ユーティリティがインストールされているフォルダを参照し、ユーティリティ agent-autoupdate.exe を選択します。

  7. OK をクリックしてタスクを保存します。選択したユーザーアカウントのパスワードの入力を求められます。

  8. タスクが動作しているかどうかをテストするには、タスクスケジューラライブラリでタスクを右クリックし、実行をクリックします。タスク履歴を有効にして、タスクが実行されたときの詳細なログと、発生した可能性のある問題を表示します。

ヒント : エージェント自動更新ユーティリティの後続のリリースでは、変更ログに明示的に記載されていない限り、新しいタスクを再作成する必要はありません。さらに、Windows の一時ディレクトリ (Temp) にagent-autoupdate.exeによって作成されたアーティファクトとログは、Windows システムが頻繁に再起動されない場合、定期的なファイル削除が必要になる場合があります。

トラブルシューティング

スケジュールされたタスクが失敗した場合、または期待どおりに実行されない場合は、agent-autoupdate ユーティリティがインストールされているディレクトリに移動し、管理者権限でコマンドプロンプトからバイナリを実行して、診断出力を表示できます。