Lotus Notes Extractor

2024年08月29日 11:04

Extractorのインストールと実行

Lotus Notesは、MigrationWizで移行を行うためにローカルクライアントソフトウェアのインストールが必要となる唯一のメッセージングシステムです。Lotus Extractorは、Dominoサーバーから抽出したデータをMigrationWiz Webのポータルに安全にストリーミングする小さなコンソールアプリケーションです。（入手はこちらから）

Extractorは、ローカルエリアネットワークの一部である物理マシンまたは仮想マシンにセットアップする必要があります。 Lotus Extractorは、移行元のLotus NotesまたはDominoサーバーと直接通信します。その後、Lotus ExtractorはBitTitanサーバーとの通信に使用されます。 BitTitanへの通信は次のように行われます。

BitTitan MSPCompleteおよびMigrationWizプラットフォームに接続して、エンドポイントと移行対象のメールボックスを取得します。
クラウド内の1つ以上の移行サーバーに接続して、移行コマンドを受信し、Lotus Notesデータをプッシュ(push)します。

次の図は、メカニズムの概要です。

スクリーンショット

この方法は、大企業や分散環境を対象とした大規模な移行に最適です。

通信はExtractorによって開始されるため、他のLotus Extractorに対して外部IPアドレスなど、追加の接続を行う必要はありません。
移行中はメールファイルを操作しないことをお勧めします。また、移行中にメールファイルを処理するカスタムDominoエージェントを停止することで、ドキュメントのロックを回避できます。
コンピューター（または仮想マシン）に1つのLotus Extractorをインストールします。MigrationWizは、Extractorごとに最大15個のメールボックスを移行できます。実行する1つのLotus Extractorにつき、MSPComplete内の個別のエンドポイントおよびコンピューター（または仮想マシン）が必要です。

前提条件

Lotus Extractorを実行するのに必要なものは次のとおりです。

MigrationWizアカウント
Lotus Notes管理アカウント
Webアクセス
推奨ハードウェア：3.0GHZクアッドコアプロセッサ以上。
Windowsベースのコンピューター(Lotus Notesサーバーではないもの)
- 理想的な構成は、8GB以上のRAMを搭載したWindows 7または Server 2008以降です。
Extractorを実行可能な32ビットまたは64ビットのコンピューター。
Extractorをインストールして実行するには、コンピューターに.NETFrameworkバージョン4.6.1以降がインストールされている必要があります。現在インストールされている.NETFrameworkのバージョンを確認するには、Microsoftが示す手順に従ってください。方法：インストールされている.NETFrameworkのバージョンを確認する方法。
インストール済みのLotus Notes v6.5以降のクライアント。Domino Serverv6.5からv9.0.1までの移行のみをサポートします。
Lotus Extractorでは、ポート80と443が開いている必要があります。
Lotus Extractorログを保存するための空きディスク容量
- 必要な空き領域のサイズを見積もるには、次の式を使用してください。100MB + 50MB *（移行するメールボックスの数）。非常に大きなメールボックス（10GB以上）の場合、メールボックスあたりのログファイルサイズは100MBに達する可能性があります。

重要な詳細：

Lotus Extractorは、Domino AdministratorまたはLotus Serverコンポーネントがインストールされているコンピューターでは実行できません。
システムとサーバーのリソースに応じて、Lotus Extractorがインスタンスごとに同時に移行できるメールボックスは最大15個です。
Lotus NotesまたはLotus DominoからOffice 365などの複数の移行先への移行をサポートするために、複数のExtractorを設定できます。ただし、物理マシンまたは仮想マシンごとに実行できるLotus Extractorのインスタンスは1つのみです。
各Lotus Extractorの識別子は一意であるため、各Lotus Extractorには固有のMigrationWizエンドポイントとMigrationWiz内のメールボックス移行プロジェクトが必要になります。
A/S 400でDominoを実行する場合は、最初に概念実証を実行して、A/S 400バージョンがサポートされているかを検証することをお勧めします。QA(品質保証)部門ではA/S 400のすべてのバージョンをテストしていないため、すべてがサポートされているかを保証することはできません。

Lotus Extractorのセットアップ

Lotus Extractorを実行するには、次の手順に従ってください。

Lotus Notesクライアントをコンピューター（または仮想マシン）にインストールします。
Lotus Notesクライアントを開き、移行用に設定した管理者アカウントでログインします。
移行に使用されている管理者アカウントのIDファイルを取得し、コンピューター（または仮想マシン）にコピーします。
コンピューター（または仮想マシン）のインターネットプロキシ設定が正しいかを確認します。このオプションを無効にすることでインターネットに接続できなくなる場合は、ネットワーク管理者に連絡してLotus Extractorを許可してください。
Lotus Notesクライアントを閉じます。これにより、Lotus Notesクライアントがnotes.iniファイルで取得したロックが解除されます。
Lotus Extractorをインストールします。ダウンロードするにはこちらをクリックしてください。
インストール後、Lotus Extractorを起動します。
各Lotus Extractorは、.exeウィンドウの上部にLotus Extractor Identifierと呼ばれる一意の識別子を表示します。次のスクリーンショットを参照してください。移行の設定時に必要となるため、この識別子は書き留めてください。
BitTitanアカウントのユーザー名とパスワードを入力します。
移行用に作成したLotus Notes管理者アカウントのパスワードを入力します。

重要：

Lotus Extractorごとに、最大15個のメールボックスを同時に移行できます。MigrationWizメールボックス移行プロジェクトを設定したら、「詳細オプション(Advanced Options)」で同時に移行する数を15に設定します。詳細については、移行ガイドを参照してください。
移行先のLotus Dominoサーバーが配置されているローカルエリアネットワーク内に各Lotus Extractorを配置します。
Lotus Dominoサーバーが配置されているコンピューターにLotus Extractorを配置しないでください。
クラスタ化されたDominoサーバーで複製が有効に設定されている場合、MigrationWizを使用するすべての移行アクティビティのデータの移行元としてDominoサーバーを1つ選択する必要があります。
同じコンピューターに複数のLotus Extractorを配置しないでください。
実行中のLotus Extractorを停止しないでください。コンソールウィンドウは開いたままにします。構成が終了すると自動的に移行が開始されます。
認証後、Lotus Extractorは「LotusExtractor.csv」という名前のCSVファイルを生成します。このファイルを使用して、MigrationWizプロジェクトにユーザーを一括追加することができます。

手動でのインストール

Lotus Notesの移行に使用されるLotus Extractorは自動更新です。利用可能な最新バージョンが確認され、インストールされます。場合によっては、Lotus Extractorを手動で再インストールする必要があります。Lotus Extractorの現在のバージョンを手動でインストールする手順は以下の通りです。

Extractor が配置されているコンピューターで%UserProfile%\appdata\localに移動します。
フォルダーの名前をLotusExtractorからLotusExtractor.oldに変更します。
Lotus Extractorをダウンロードします。
新しいメールボックス移行プロジェクトを作成するには、「Lotus Notes 6.5+」の移行元エンドポイントを選択し「Lotus ExtractorAgentのダウンロード(Download The Lotus Extractor Agent )」ボタンをクリックします。
既存のLotus6.5以降の移行プロジェクトを編集する場合は、「移行元設定(Source Settings )」プロパティを選択し、「Lotus ExtractorAgentのダウンロード(Download The Lotus Extractor Agent )」ボタンをクリックします。
Lotus Extractorを起動するには、デスクトップに作成されたLotus Extractorショートカットを使用します。

Lotus Notes Extractorのよくある質問

セキュリティ

MigrationWizは、医療機関、政府機関、金融機関などの最も安全な組織によって使用されています。Lotus Extractorは、HTTPSを使用してMigrationWiz Webサービスと通信します。MigrationWiz Webサービスとのすべての通信は、SSLを使用して暗号化、認証されます。

Lotus Extractorは、一連の安全な移行サーバーとも通信します。そのため、Lotus ExtractorはHTTPを介してデータを送受信します。HTTPは暗号化されていない（クリアテキストの）通信チャネルであることに注意してください。Lotus Extractorは、このIPベースのチャネル（SSL証明書は利用不可）を介して通信する際に、軍用グレードのAES暗号化を使用してすべてのメールボックスデータを暗号化します。

メールボックスデータの暗号化には、各Lotus Notesコネクタに固有のキーが使用されます。これにより、すべての通信を復号できるのは、Lotus Extractorと相手側の移行サーバーの2つのみとなります。MigrationWizは、256ビットのAESキーを使用してデータを暗号化し、すべてのメールボックスデータにコネクタ固有の軍用レベルの強固な暗号化を行います。

Lotus Extractorは、初期化中にMigrationWizとLotus Notesの両方の資格情報を要求します。指定されたパスワードは、データの機密性を保護するために、入力時にマスクされます。指定した資格情報はメモリに保持されますが、ディスクに保存されることはありません。そのため、Lotus Extractorの再起動時に、毎回資格情報を提供する必要があります。

Lotus Extractorはソースコードからビルドされ、ビルドプロセスの一部として圧縮されます。したがって、Lotus Extractor実行可能ファイルと対応するzipアーカイブを生成する際に人が介入する必要がありません。これにより、zipアーカイブの手動生成（ウイルスまたはトロイの木馬の埋め込みを含む）に関連したリスクを避けることができます。

安定性とパフォーマンス

BitTitan Lotus Extractorは、IBM Notesクライアントライブラリを使用して、メールボックス内のデータにアクセスします。そのため、Lotus Extractorの安定性とパフォーマンスは、IBM Notesクライアントライブラリに大きく依存しています。IBM Notesクライアントライブラリはシングルユーザーアクセスのみをサポートするため、Lotus Extractorもサポートします。

同じプロセスで複数のユーザーメールボックスにアクセスすると、同時アクセス用に設計されていないため、ライブラリがクラッシュします。しかし、拡張性の高い移行を実行するには、BitTitan Lotus Extractorが複数のユーザーメールボックスを同時に移行する必要があります。

この制限に対処し、同時移行をより多く実行するために、Lotus Extractorは複数のプロセスを生成し、それぞれがIBM Notesクライアントライブラリの一意のコピーをロードし、単一のメールボックスにアクセスします。残念ながら、この方法は共有メモリを使用するため、Notesクライアントライブラリ内でのクラッシュを完全に制限することはできません。

Lotus Extractorは、クラッシュの検出を試み、自動的に再起動します。ただし、状況によっては、クラッシュが頻発し移行の妨げになる場合があります。共有メモリをクリーンアップするために、コンピューターの完全な再起動が必要になる場合もあります。したがって、Extractorごとに1つのメールボックスを移行し、同時移行数を徐々に増やして、クラッシュせずに処理できる総処理数を最大限にする最適な値を見つけることをお勧めします。 Extractorごとに移行できるメールボックスは最大15個です。

注： Lotus Extractorを別の物理マシンまたは仮想マシンに配置することは、この問題を解決するための安全な方法です。

プロキシ接続

Lotus Extractorは、インターネットへのプロキシ接続をサポートしています。

1.プロキシサーバーで認証が必要ではない場合、Lotus Extractorはいかなる変更もなく機能します。「インターネットオプション(Internet Options)」-> 「接続(Connections)」タブ-> 「LAN設定(LAN Settings)」で、「設定を自動的に検出する(Automatically Discover Settings)」の横にチェックマークが設定されていることを確認してください。

2.資格情報を必要とするプロキシサーバーを介してインターネット接続を確立する場合は、「ProxyCredentials.txt」というファイル名のプレーンテキストファイルを別に作成して、LotusExtractor.exeの解凍先ディレクトリに配置する必要があります。次のように、1行目にはプロキシサーバーのURL、2行目には完全なユーザー名、3行目にはプレーンパスワードが含まれている必要があります。

http://proxyserver:8080/
CORP\testuser
自分のパスワード

米国のみのIPアドレスの設定

Lotus Notes Extractorは、米国以外のIPアドレスからのIPチェックを行います。これにより、非常に厳しい環境では、Extractorが正しく機能しない可能性があります。

このIPチェックを回避するには、<add key="IsDev" value="false"/>を、移行を実行するマシンの%localappdata%\LotusExtractor に保存されているLotusExtractor.exe.configファイルのエントリとして追加します。

この構成ファイルの編集は、次の行の下に追加する必要があります。

<appSettings>  <add key="IsDev" value="false"/>

最終結果は次のようになります：

<appSettings>
<!-- Version -->
<add key="IsDev" value="false"/>
<add key="LogShippingEnabled" value="false"/>

ファイルを保存してExtractorを実行します。

トラブルシューティング

一度に何個のメールボックスを移行できますか？

最大15個のメールボックスを同時に移行できます。移行プロジェクトを作成したら、MigrationWizの「詳細オプション(Advanced Options)」で同時移行の数を15に設定します。

Lotus Extractorはどこに配置しますか？

Lotus Extractorは、移行先のLotus Dominoサーバーが配置されているローカルエリアネットワーク内に配置します。ただし、Dominoサーバーが配置されているコンピューターにExtractorを配置しないでください。
各コンピューターに配置できるExtractorインスタンスは1つのみです。

Lotus Extractorが消える

これまで、このクラッシュが発生した際にログに記録が残されたことはありません。対応策として、PowerShellセッションで、実行ログ出力機能を有効にしてExtractorを実行します。これにより、少なくともクラッシュに至るまでの経緯を把握できます。これを行うためには、Extractorが配置されているコンピューターでPowerShellセッションを開いて実行します。
Lotus Extractorを開いて、最新バージョンであることを確認します。バージョンを確認したら次を実行します。

Start-Transcript
cd $ ENV：APPDATA
cd LotusExtractor
$name = Get-ChildItem | ?{$_.name match "App"} | sort -Descending | Select -First 1
cd $name.name
.\LotusExtractor.exe

これにより、PowerShellセッションで実行ログの記録が開始されます。Extractorが停止した場合は、次の手順を実行します。

Stop-Transcript

実行ログファイルの出力先が示されます。出力された拡張子.txtの実行ログファイルをzip形式で圧縮し、チケットに添付して返信してください。

Extractor稼働マシンの%localappdata%ディレクトリに移動して、BitTitanフォルダー全体をzip形式で圧縮し、マシン名を含むファイル名を付けて、サポートチケットの添付ファイルとして追加します。ファイルが20MBを超える場合は、ログをアップロードするためにFTPロケーションを作成する必要があることをサポートに伝えてください。

共有メモリエラー

共有メモリアーキテクチャを使用して構築されているLotus Notesクライアントが原因で、「以前のNotes / Dominoの実行から共有メモリが検出されました。このプロセスは今すぐ終了します。」というエラーが移行中に発生します。これは、Lotus Notesクライアントが実行時に共有メモリスペースを作成することを意味しています。

Lotus Extractorは、Lotus Notesクライアントライブラリを使用して移行を実行します。移行中に、Lotus Notesクライアントは作成された共有メモリスペースに書き込みます。スレッドで使用されている共有メモリスペースの一部が、元のスレッドが完了する前に他のスレッドによって上書きされたり、共有メモリブロックが破損したりする可能性がある場合でも、Lotus Notesクライアントは引き続き共有メモリスペースを使用しようとします。

いずれの場合も、共有メモリスペースをクリアするには、「以前のNotes / Dominoの実行から共有メモリが検出されました。このプロセスは今すぐ終了します。」エラーが表示されたらこちらの手順に従ってください。
エラーが表示された際に「OK」ボタンをクリックすると、エラーウィンドウは閉じますが、同じ共有メモリスペースが継続して使用されます。これにより、「OK」ボタンのクリック後にエラーが再度表示されないため、Extractorが移行を処理しているかのように見えていても、最終的に移行が失敗します。手順に従うことによって、エラーの再発を防ぐことができます。

問題の原因となるアイテム

メール配信不能レポートとカレンダー/会議の更新アイテム（例：会議のキャンセル、会議の承認、会議の日付/時刻の更新など）は、MigrationWizでは移行できません。これらのメッセージタイプのいずれかがフォルダー内にある場合、処理時間が大幅に遅くなり、 `GetFullItems`または` GetAllItems`コマンドがコマンドのタイムアウトしきい値内で何も返さないため、エラーが発生して移行が失敗します。エラーを解決または防止する方法は、次の2つです。

移行元メールボックスからすべてのメール配信不能レポートとカレンダー/会議の更新アイテムを削除します。または
これらのアイテムを移動する新しいフォルダーを作成し、そのフォルダーを移行から除外します。手順の詳細については、こちらを参照してください。

アイテムの移動

アイテムを除外するフォルダーを作成する場合は、アイテムをコピーせずに移動してください。アイテムをコピーすると、オリジナルがフォルダーに残っているため、同じエラーが発生します。

受信トレイフォルダー内に多くの破損したアイテムがあります。

MigrationWizは、破損したアイテムを可能な限り修復しようとしますが、すべてのアイテムを修復することはできません。破損したアイテムは、修正が不可能なアイテムと判断されて次のアイテムに移動するまでの処理に時間がかかるため、 `GetFullItems`または` GetAlltems`コマンドがコマンドのタイムアウトしきい値内で何も返さない原因となり、エラーが発生して移行が失敗します。Domino AdminでNSFファイルのオフラインデフラグを実行するか、移行元Dominoサーバー上のエンドユーザーNSFファイルに対してFixUpを実行して、移行を再送信します。

受信トレイフォルダーにあるアイテムが多すぎます。

受信トレイフォルダーなどのフォルダー内に非常に多くのアイテムがある場合、 `GetFullItems`または` GetAlltems`コマンドは、コマンドのタイムアウトしきい値内で何も返さないため、エラーが発生し、移行が失敗します。受信トレイフォルダー内のアイテムが20,000個を超えている場合は、受信トレイフォルダーの下にサブフォルダーを作成し、作成された全サブフォルダーに受信トレイフォルダーのコンテンツを均等に分散する必要があります。各サブフォルダーに配置するアイテム数は、15,000個以内にすることをお勧めします。たとえば、受信トレイフォルダーに60,000個のアイテムがある場合、次のようになります。

Inbox-1、Inbox-2、Inbox-3、Inbox-4などの名前を付けた4個のサブフォルダーを、受信トレイフォルダーの下に作成します。
15,000個のアイテムを受信トレイからInbox-1に移動し、さらに15,000個のアイテムを *Inbox-2*に移動するなど、すべてのアイテムが4個のサブフォルダーすべてに均等に分散されるようにします。注：アイテムは移動し、コピーしないでください。
統計をリセットします。

フォルダー内にサイズの大きなアイテムがたくさんあります。

受信トレイフォルダーなどのフォルダー内にサイズの大きなアイテムが多くある場合、GetFulltemsが失敗する原因になります。このような場合は：

1. Inbox-LargeItems-1、Inbox-LargeItems-2などの名前を付けたサブフォルダーを受信トレイフォルダーの下に作成します。
2. 受信トレイフォルダー内のアイテムをサイズの降順で並べ替えます。
3. たとえば、10 MBを超えるすべてのアイテムを、新しく作成されたサブフォルダーに均等に分散して移動します。
4. 詳細については、ナレッジベースの記事「アイテムの統計をリセットするにはどうすればよいですか？」https://help.bittitan.com/hc/en-us/articles/115008259728-How-do-I-reset-statistics-を参照してください。移行を再送信します。

複数のExtractorと大規模な同時移行

複数のExtractorを使用すると、いくつかの問題を軽減し、移行量を増やすことができますが、考慮すべき点がいくつかあります。一番に考慮しなければいけない点は、Dominoサーバーに、処理可能な数を超えた移行を実行させないことです。もう1つは、同じDominoサーバーを接続先として指定できるExtractorは3つまでで、それぞれのExtractorが同時に実行できる移行は5つまでであることです。

Lotus Extractorの各インスタンスには、MigrationWizに個別のメールボックス移行プロジェクトが必要です。

よくある誤解は、多くのExtractorが使用されると、Lotus Notesの移行中にスループットが向上するというものです。Dominoサーバーでは、アイテムのコピー、アイテム変換の実行、コピーおよび変換されたアイテムのクリーンアップなどの多くの移行が処理され、絶えず次の一連のアイテムの処理が行われます。たとえば、同時に8つの移行が処理されていると、Dominoサーバーのリソースが大量に使用されます。多くの場合、同時に実行される移行が多すぎるとリソースが消耗します。

同時移行の数は、移行ごとに決定する必要があります。つまり、Domino Server DOMSRV01から移行が行われる場合は、DOMSRV01で同時に実行できる移行の数を決定する必要があります。プロセスは、移行を1つずつ実行し、完了するのを待ってから、パフォーマンスを判定するため手間がかかります。パフォーマンスが良好であれば、MigratoinWizプロジェクトの同時移行の最大数を1から2に増やし、2つの移行の送信が完了したら、パフォーマンスを判定します。パフォーマンスが良好であれば、最大数を3に増やし、3つの移行が正常に完了したらパフォーマンスを判定し、適切な同時移行数が分かるまで数を増やしていきます。設定されている数が6で、3つのExtractorを使用している場合、Extractorごとに実行できる移行数は2つまでです。設定されている数が4の場合、4つの移行を複数のExtractorで実行するか、追跡を簡単にするため、1つのExtractorでのみ実行します。

残念なことに、1つの移行を実行すると機能し、複数の移行を実行するとクラッシュまたは問題が発生する場合があるため、その際は一度に実行する移行を1つにする必要があります。特定の移行が問題発生の原因になっている場合、問題のある移行を一度に1つずつ実行し、完了するまでは、他のExtractorがそのDominoサーバーからの移行を実行することがないようにしてください。

Dominoサーバーのバージョン10以降は、MigrationWizの移行元としてサポートされていません。

Lotus Extractorが頻繁に更新されるのはなぜですか？

Lotus Notes Extractorは、「継続的インテグレーション」を使用して構築された大規模なシステムの一部です。大規模なシステムでは、他のサポートライブラリ（ログ、レポートなど）に依存しており、同期を維持するには継続的に再構築する必要があります。

システム全体が一度に展開されるため、毎日更新されます。