• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

Asset Discovery と Asset Discovery コレクターをアップデートする

はじめる前に

  • Asset Discovery をインストールするには、ご利用の Windows または Linux システム上で Jira 管理者権限と管理者権限が必要です。

  • アップデート プロセス中に何か問題が発生した場合のために、Discovery フォルダーのバックアップを安全な場所に保存してください。

  • Linux 環境で Asset Discovery ツールまたはコレクター ツールをご利用の場合は、アップデート前に設定済みの cron タスクを必ず停止してください。

    *Windows 環境で Discovery ツールを使用する場合にのみ利用できます。

アップデート プロセスを実行する際には、実行中の Discovery サービスまたはコレクター サービスが自動的に停止されます。アップデート プロセスで停止されたサービスは、アップデート終了後に再開されます。

アップグレード ノート

  • In Discovery Tool 3.1.5-Cloud/6.1.5, we’ve changed the encryption mechanism. When you upgrade, we’ll use the new encryption algorithm for secure data you’ve saved before the upgrade. You’ll need to update all scanned Discovery Agents manually to the same version as the Discovery Tool.

  • Discovery Tool 3.1.11-Cloud/6.1.14 では、 ダウンロードした zip ファイルの命名パターンを Discovery_X.Y.Z.zip から assets-discovery-X.Y.Z.zip に変更しました。3.1.11-Cloud/6.1.14 より前のバージョンから 3.1.11-Cloud/6.1.14 またはそれ以降にアップグレードする場合は、ダウンロード用の zip の名前を以前の形式に変更してください。

  • In Discovery Tool 3.2.0-Cloud/6.2.0, we added an Agent Token to secure the communication between the Discovery application and Discovery Agents. You’ll need to update all scanned Discovery Agents manually to the same version as the Discovery Tool and configure the Agent Tokens. You’ll also need to update the password in SFTPSettings so it can be encrypted again.

Updating Assets Discovery and the Collector

Assets Discovery とコレクターを最新バージョンにアップデートするには:

  1. Uninstall Discovery-Service-XXX (Discovery.exe -u) and Discovery-Collector-Service-XXX (Collector.exe -u) if they were installed. (XXX stands for a unique value auto-generated for you.)

  2. Discovery を設定モード (Discovery.exe -s) で実行します。

  3. [アップデート] タブに移動します。
    このタブには、最新バージョンの詳細が含まれています。

  4. Atlassian Marketplace から最新バージョンをダウンロードしてインストールするアップデート サービス実行するには、[今すぐアップデート] を選択します。

  5. Reinstall Discovery-Service-XXX (Discovery.exe -i) and Discovery-Collector-Service-XXX (Collector.exe -i) if they were uninstalled in step 1.

Discovery とコレクターを手動で最新バージョンに、または最新バージョンより前のバージョンにアップデートする方法。

  1. Uninstall Discovery-Service-XXX (Discovery.exe -u) and Discovery-Collector-Service-XXX (Collector.exe -u). (XXX stands for a unique value auto-generated for you.)

  2. 新しいバージョン (例: Discovery_<version>.zip) をダウンロードして、Discovery フォルダー内の update サブフォルダーにコピーします。

  3. update.exe を実行します。

  4. ObjectHashSettings.xml ファイルをアップデートするかどうかを選択します (既定ではアップデートされません)。

    • ファイルに何も変更を加えない場合は、Yes を選択してアップデートを取得します。

    • ファイルを変更した場合は、No を選択して内容を新しいファイルに手動で適用します。

  5. Reinstall Discovery-Service-XXX (Discovery.exe -i) and Discovery-Collector-Service-XXX (Collector.exe -i) if they were uninstalled in step 1.

Updating to version 3.x

You can also try out the beta release of Discovery 3.x. See Updating Discovery to version 3.x.

Uninstall your Discovery Agent

If you have Discovery Agents installed on a remote scanned server, the Agent installer from the upgraded version needs to be copied over to each of those Agents and upgraded as well.

To upgrade your Discovery Agents:

  1. Stop the Discovery-Agent service Discovery Agent Service. You can also use the command line "sc stop Discovery Agent Service".

  2. Go to the agent installation path (by default it's C:\Program Files (x86)\Atlassian\Discovery Agent Installer). Back up the pattern files if the default patterns were changed. If new patterns were created, they will remain.

  3. Go to the Discovery installation directory from the same version as the Discovery Agent (if the Agent is on version 3.1.4, you’ll need to use the Discovery 3.1.4 installer).

    1. Double-click on the Discovery installer (Discovery_Agent_Setup_x86 or Discovery_Agent_Setup_x64) depending on your OS.

    2. Select Remove Discovery Agent Installer. As a result, all DLL files will be removed from the Agent directory, but the following directories will remain: logs, pattern (only if there are custom pattern files), scans, Agent.bak (it holds the previous configuration).

Install a new Discovery Agent

  1. From the Discovery_Agent_Setup.msi Installer package, open the new version of Discovery_x.x.x.zip and select Install

  2. If you made changes either with custom patterns or with the Agent.cfg file, change it in the target folder and add the path where the Discovery Agent was installed before.

  3. Go to the Agent directory again and remove the Agent.cfg file, which was created by the installer and holds the default configuration.

    • If customers had made some changes in previous version, we need to remove it.

    • Bear in mind, we still have the Agent.bak file which contains previous configuration.

  4. Stop and start the Discovery Agent Server service. A new Agent.cfg file should have been created based on the *.bak file.

If you need to restore the file, you must stop the Discovery Agent service first, restore the file, then start the service again.

既知の問題およびトラブルシューティング

.NET Framework 構成

リモート ソースから DLL を読み込めない場合は、.NET Framework ポリシーに次の machine.config 設定を追加してください。

32ビット:

1 %windir%\Microsoft.NET\Framework\[version]\config\machine.config

64ビット:

1 %windir%\Microsoft.NET\Framework64\[version]\config\machine.config

アップデート後、これを以前の設定に変更します。

サービス インスタンス ID の変更

一部のバージョンでは、実行中のサービスのインスタンス ID が UI に表示されるインスタンス ID とは異なることがあります。この問題が発生した場合は、次の手順で解決できます。

  1. サービスを開き、Discovery またはコレクターのサービスを見つけます。

  2. 管理者権限でコマンド プロンプトを開きます。

  3. 「sc stop Discovery-Service-<ID>」または「sc stop Collector-Service-<ID>」を実行します。

  4. 「sc delete Discovery-Service-<ID>」または「sc delete Collector-Service-<ID>」を実行します。

  5. サービスを更新し、サービスが削除されていることを確認します。

  6. Discovery を最新バージョンにアップデートします。

  7. 「discovery -i」または「collector -i」を使用してサービスをインストールします。

その他のヘルプ