廃止されたコンポーネントの削除

Data Aggregator には、廃止されたコンポーネントを削除するためのスクリプトが含まれます。廃止されたコンポーネントとは、物理デバイスに存在しなくなったコンポーネントです。廃止されたコンポーネントが多すぎると、ユーザインターフェースのパフォーマンスに影響を与える場合があります。廃止されたコンポーネントを削除するために、このスクリプトの使用方法を説明します。

注：廃止されたコンポーネントの削除を自動化するには、「Data Aggregator REST Web サービスを使用した管理ガイド」を参照してください。

以下の手順に従います。

コマンドプロンプトを開き、/opt/IMDataAggregator/scripts ディレクトリにアクセスします。
廃止されたコンポーネントを削除するスクリプトを呼び出すには、以下のコマンドを入力します。
```
./remove_retired_items.sh
```
スクリプトパラメータのリストと説明が表示されます。

例：廃止されたコンポーネントの総数を返す

以下のコマンドを入力します。
```
./remove_retired_items.sh -h host_name
```
-h host_name

接続する Data Aggregator ホスト名を指定します。

廃止されたコンポーネントの総数が表示されます。
（オプション）廃止されたコンポーネントの名前のリストを返すには、数字の「1」を入力します。
（オプション）廃止されたコンポーネントをすべて削除するには、数字の「1」を入力します。

例：特定の条件で、廃止されたコンポーネントのリストをフィルタリングする

廃止されたコンポーネントを削除するスクリプトを呼び出すには、以下のコマンドを入力します。
```
./remove_retired_items.sh
```
スクリプトパラメータのリストと説明が表示されます。
特定の条件で廃止されたコンポーネントを削除します。
- 複数の Data Collector インスタンスがインストールされている場合、IP アドレスが重複している可能性があります。廃止されたコンポーネントを IP アドレスによってフィルタリングするには、以下の手順に従います。
  1. 以下のコマンドを入力します。
```
   ./remove_retired_items.sh -h host_name -a device_IP_address
```
  2. 注： IP アドレスの範囲は入力できません。
  3. （オプション）廃止されたコンポーネントの名前のリストを返すには、数字の「1」を入力します。
  4. （オプション）廃止されたコンポーネントをすべて削除するには、数字の「1」を入力します。
- 廃止されたコンポーネントの経過期間（経過日数内）によって削除するには、以下のコマンドを入力します。
```
./remove_retired_items.sh -h host_name -t filter_by_days_old_from_current_time
```
  たとえば、以下のコマンドは、廃止されてからの日数が、現在の時刻から数えて 10 日未満であるコンポーネントを削除します。
```
./remove_retired_items.sh -h host_name -t 10
```

例：多数の廃止コンポーネントの削除

廃止されたコンポーネントの数が 100,000 を超えている場合、そのすべてを容易に削除できます。

廃止されたコンポーネントの数が 100,000 を超えている場合に、そのすべてを確認するには、以下のコマンドを入力します。
```
./remove_retired_items.sh -h host_name –o ouputfile 
```
-o outputfile

すべての廃止コンポーネントの出力です。出力は .csv ファイルです。

たとえば、以下のコマンドは、すべての廃止されたコンポーネントのリストを出力します。 .csv ファイル形式には、デバイスアイテム ID、デバイス表示名、廃止されたコンポーネント ID、および廃止されたコンポーネント表示名が含まれます。
```
./remove_retired_items.sh -h my_host_name –o myretired.csv
```
廃止されたコンポーネントの数が 100,000 を超えている場合にそのすべてを削除し、.csv ファイルに情報を記録するには、以下のコマンドを入力します。
```
./remove_retired_items.sh -h host_name –o ouputfile –c Yes
```
-o outputfile

すべての廃止コンポーネントの出力です。出力は .csv ファイルです。

–c Yes

廃止されたすべてのコンポーネントの削除を確定します。

たとえば、以下のコマンドは廃止されたすべてのコンポーネントを削除します。
```
./remove_retired_items.sh -h my_host_name –o myretired.csv –c Yes
```

廃止されたコンポーネントの削除について、さらに詳しく説明します。

廃止コンポーネントを IP ドメイン名または IP ドメイン ID によってフィルタリングする場合も、特定の IP アドレスを指定すると正しい結果が返されます。
フィルタ条件によって返される廃止コンポーネントの数が多すぎる場合、REST インターフェースは応答を返しません。その他のフィルタリングオプションを使用して、返される結果の範囲を絞ります。フィルタ条件の詳細については、http://hostname:port/rest/retired/xsd/filterselect.xsd を参照してください。