Google Workspace Migrate のトラブルシューティング

1. ログを確認する手順は次のとおりです。
   • プラットフォーム インストールの場合 - C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform\AppBridgeServiceHost.log に移動します。
   • ノード インストールの場合 - C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform Node\AppBridgeServiceHost.log に移動します。

     注: 以前のバージョンの Google Workspace Migrate を実行している場合は、パスで「Google Workspace」のかわりに「G Suite」を使用する必要があります。

2. ログを開き、一番下までスクロールします。
3. 関連する問題がある場合は、問題のトラブルシューティングを行います。

   「Access denied: Symmetric encryption is required for this service request but not configured（アクセスが拒否されました。このサービス要求には対称型暗号化が必要ですが、設定されていません）」というメッセージは無視してかまいません。

4. 問題が解決しない場合は、Google Workspace Migrate の問題についてサポートに問い合わせるをご覧ください。

1. Google Workspace Migrate プラットフォームにログインし、右上にある [Servers（サーバー）] をクリックします。
2. ノードがリストに表示されていることを確認します。
3. ノードのステータスが [Ready]（緑色）であることを確認します。

ノードを Google Workspace Migrate プラットフォームに関連付けようとしたときにエラーが発生した場合は、そのノードが実行中であるかどうかを確認します。

1. プラットフォームを実行しているパソコンのブラウザで、ノードの IP アドレスとポート（例: http://192.0.2.1:5131）を入力します。
2. そのプラットフォームからノードに到達可能で、ノードサービスが実行されている場合は、「Node is running（ノードが実行中）」というメッセージが表示されます。
3. エラーが表示された場合は、次の方法をお試しください。
   • ネットワーク エラーの場合は、エラーを解決して、もう一度試す。
   • ノードサービスを再起動する。
   • ノード アプリケーションを再インストールする。詳しくは、ノードサーバーをインストールするの手順をご覧ください。

このエラーが表示される場合: 

1. ノードサーバーのサービスホストのログに移動します。

   詳しくは、サービスホストのログを確認するをご覧ください。

2. 次のエラーを確認します。The provided platform host address https://platformserver:443/Hub was unreachable（指定されたプラットフォームのホストアドレス https://platformserver:443/Hub に到達できませんでした）。
3. このエラーが表示された場合は、次の方法をお試しください。
   • プラットフォーム サーバーへのネットワーク接続を確認します。ネットワークに問題がある場合は、問題を解決してノードサービスを再起動します。
   • プラットフォームに TLS 証明書が構成されている場合は、プラットフォームを実行しているパソコンのブラウザで、プラットフォームの IP アドレスとポート（例: https://192.0.2.1:5131）を入力します。また、TLS 証明書が有効で期限切れになっていないことを確認してください。

ホストログに invalid_grant というメッセージが表示された場合は、次のことを確認します。

• 移行先アカウントですべての API スコープを有効にしている。詳しくは、Google Cloud Console を使用して API を有効にするをご覧ください。
• Google 管理コンソールで必要なスコープに対してサービス アカウントが承認されている。承認には、サービス アカウントのクライアント ID ではなく、OAuth 2.0 クライアント ID を使用します。詳しくは、OAuth ウェブ クライアント ID を作成するをご覧ください。

移行の実行速度が遅い場合、または移行がまったく進まない場合は、Google Workspace の API 割り当てレベルに関連するエラーが発生している可能性があります。詳しくは、割り当ての操作をご覧ください。

スキャンまたはブリッジの実行中に、パーティションのステータスを監視できます。

1. Google Workspace Migrate プラットフォームで、[Scans（スキャン）] または [Bridges（ブリッジ）] をクリックします。
2. 確認するスキャンまたはブリッジで、ログアイコン Partition log（パーティションのログ）] をクリックします。
3. [State（ステータス）] で、パーティションのステータスを確認します。
   • Ready - 開始する準備が完了しています。
   • Starting - 移行またはスキャンの準備をしています。
   • Crawling - 移行元のシステムからデータを読み込んでいます。
   • Processing - 移行先のシステムにデータを書き込む準備をしています。
   • Committing - 移行先のシステムにデータを書き込んでいます。
   • Cancelled - 失敗しました。キャンセルされたパーティションのトラブルシューティングに進んでください。
   • Completed - 処理が完了しました。
   • Skipped（エラーによる再試行時に表示されます） - エラーが発生しなかったためスキップされました。

パーティション ログに [Canceled（中止済み）] のパーティションが見つかった場合は、以下の方法を使用してトラブルシューティングを行います。

方法 1: エラーコードを確認する

エラーコードを見つけるには、パーティション ログの行にカーソルを合わせ、その他アイコン Partition log（パーティションのログ）] をクリックします。障害に関連するエラーコードを使用して問題を解決します。詳しくは、Google Workspace Migrate のエラー メッセージを解釈するをご覧ください。

方法 2: ノードを確認する

パーティション ログを使用して、特定のノード上の全パーティションがキャンセルされているかどうかを確認します。通常、キャンセルされたノードはすべて、移行元のサービスが一時的に利用できないなどの接続の問題を示しています。ノードの関連付けに関するエラーの手順を完了します。スキャンを再試行するか、差分移行を実行してください。

方法 3: パーティションの実行ログを確認する

問題が複数のノードに影響する場合は、パーティションの実行ログを調べることができます。パーティションに関連付けられている実行ログを表示するには、次の操作を行います。

1. パーティション ログを開きます。
2. ログ内の行にカーソルを合わせ、その他アイコン Execution log（実行ログ）] をクリックします。
3. [State（ステータス）] [Failed（失敗）] をクリックします。
4. エラーを確認し、問題の原因を特定して、トラブルシューティングします。
5. スキャンまたは移行を再試行します。

移行サマリーログで同じようなエラーが増加していることが確認される場合は、移行の設定が正しくない可能性があります。

以下の設定が正しく行われていることを確認します。

1. API（特に Admin SDK）が Google 管理コンソールで有効になっている。詳しくは、Google Cloud Console を使用して API を有効にするをご覧ください。
2. 移行元のアカウントと Google Workspace Migrate にユーザー アカウントが存在する。アカウントが凍結、停止、名前変更されていないことを確認します。
3. 必要な Google Workspace Migrate サービス（Gmail や Google ドライブなど）をすべてのユーザーが使える状態になっている。詳しくは、Google Workspace の要件をご覧ください。

ホストログにこのエラーが表示された場合は、サードパーティ製アプリにドライブ ファイルへのアクセスを許可する必要がある可能性があります。

この問題を解決するには、サードパーティのアプリに、ドライブに保存されたファイルへのアクセスを許可するに記載されている手順を実施してください。

多くの場合、差分移行を実施することで多くのエラーを修正できます。差分移行では、永続的なエラーを特定し、一時的な問題（レート制限と割り当てレベル、ネットワークの問題、401 エラーなど）をクリーンアップします。差分移行を複数回実行してトラブルシューティングを行うことができます。詳しくは、運用開始に向けて準備するをご覧ください。

このエラーによりファイルの移行に失敗した場合:

1. トランザクション ログを開きます。
2. [Error Code（エラーコード）] で「1029」を検索して、親フォルダの移行が失敗したかどうかを確認します。
3. 親フォルダが移行されなかった場合は、エラーコードを確認して問題を修正します。
4. 差分ブリッジを実行する

共有ドライブから別の共有ドライブにファイルを移行する場合は、ブリッジでソースをターゲット ユーザーにマッピングする ID マッピングを使用してください。

1. Google Workspace Migrate プラットフォームで、[Scans（スキャン）] または [Bridges（ブリッジ）] をクリックします。
2. 確認対象のスキャンまたはブリッジで、ログアイコン Transaction log（トランザクションのログ）] をクリックします。
3. 該当するトランザクションにカーソルを合わせて、その他アイコン Transaction details（トランザクションの詳細）] をクリックします。
4. 次の表で、一般的なトランザクション エラーとトラブルシューティングの手順を確認してください。

トランザクション ログ内のトランザクションは以下の理由でスキップされる場合があります。

• 差分移行を実行しているが、オブジェクトが前回の移行時から変更されていない。
• 設定テンプレートのフィルタ条件によりオブジェクトが除外された。
• メールのコンテンツをグループに移行しているが、サイズの大きな添付ファイルがスキップされた。
• 共有ドライブの設定テンプレートを使用し散るが、コンテンツをマイドライブに移行している。

移行元によっては、他の理由が考えられます。

• SharePoint - ドキュメント ライブラリの一部ではないためにフォルダがスキップされた。
• Exchange - Google グループへの移行時にメールの下書きがスキップされた。
• Box - 版がないためファイルのバージョンがスキップされた。
• ファイル共有 - ノードに、アイテムにアクセスするための十分な権限がないため、アイテムがスキップされた。
• Gmail - Chat のメッセージ（Chat ラベルが付いているアイテム）がスキップされた。

[デフォルト] 設定テンプレートを使用して共有ドライブ間で移行する場合、GWM は移行先アカウントに新しい共有ドライブを作成しますが、移行元の共有ドライブからデータを移行しないことがあります。その理由は次のとおりです。

• 移行元と移行先に ID マッピングがない。
• テンプレートの [マッピングされていないユーザーを許可する] オプションがオンになっていない。

この問題を修正するには、次の 2 つの方法があります。

1. [デフォルト] 設定テンプレートからカスタム テンプレートを作成し、[マッピングされていないユーザーを許可する] をオンにします。
2. ID マッピングを追加します。

トランザクション レポートのサイズが大きすぎてダウンロードできない可能性があります。次のオプションに沿ってトラブルシューティングをお試しください。

方法 1: 移行前にフィルタを追加する

レポートのサイズを小さくするには、完了ステータスやエラーコードなどの特定のデータに限定されるようにトランザクション ログをフィルタします。詳しくは、移行の進行状況をモニタリングするをご覧ください。

方法 2: フィルタを指定してログをダウンロードする

コマンドラインを使用して、トランザクション ログのダウンロード方法を指定できます。

• ログ内のアイテム数を減らすには、transactionState オプションを使用します。
• ログのダウンロードにかけられる時間を増やすには、queryTimeout オプションを使用します。

詳しくは、コマンドラインを使用してログをダウンロードするをご覧ください。

想定よりも移行に時間がかかる場合は、次のシステム要件を満たしていることを確認します。

Google API の割り当てレベル

割り当て設定が原因で、403 Forbidden Error、429 Too Many Requests、503 Service Unavailable などのコードのエラーが発生することがあります。割り当てレベルが移行速度に影響しているかどうかを確認するには:

1. Google Cloud コンソールで割り当てを確認します。手順については、Google Cloud コンソールで割り当てを表示するをご覧ください。
2. リソース使用量に対応できるように割り当てを調整します。手順については、コンソールを使用して割り当てを管理するをご覧ください。

クライアントサイドのスロットリング設定

スロットリング設定は、クライアントが Google サービスにリクエストを送信できるレートを管理します。設定によっては、403 Forbidden Error、429 Too Many Requests、503 Service Unavailable などのコードのエラーが発生することがあります。

これらのコードのエラーは、Google Workspace Migrate（GWM）のスロットリング レートが高すぎる場合に発生することがあります。サーバーサイドのスロットリングが大幅に発生していないにもかかわらずクライアントサイドのスロットリングが高い場合は、GWM のパディング設定を調整すると効果があります。

始める前に

• 更新によって予期しない結果が生じる可能性があるため、これらの変更は経験豊富な管理者のみが行うようにしてください。
• 次の手順では Google のスロットリング戦略を設定しますが、googleThrottlingStrategy、exchangeThrottlingStrategy、sharepointThrottlingStrategy などの他のデータソースを使用する必要がある場合もあります。

GWM バージョン 2.1.54.0 以降でデフォルトのスロットリング戦略をオーバーライドするには:

1. プラットフォーム サーバーで、ディレクトリ C:\ProgramData\AppBridge\Overrides を作成します。
2. throttling_settings.json という名前の JSON ファイルを追加します。
3. メモ帳を使用して、JSON ファイルに次のテキストを追加します。

   {
"googleThrottlingStrategy": {
"throttlingModel": "ADAPTIVE_THROTTLING",
"adaptiveThrottlePadding": 32,
"adaptiveThrottleAcceptanceRatio": 1.1,
"adaptiveThrottleIntervalMs": 60000
}
}

4. JSON ファイルを保存します。
5. Windows のシステムトレイで をクリックします。
6. GWM サービスを停止してから再起動します。

ファイアウォールの制限

ディスクとネットワークのオペレーションへの干渉を減らすため、ウイルス対策ソフトウェア、セキュリティ スキャナ、その他の不要なソフトウェアを Workspace サーバーからアンインストールします。

Google Workspace Migrate は、MySQL を使用して構成設定とロギングの詳細を保存します。MySQL 接続が断続的であるか、応答しない場合は、サービスホストのログを確認するに移動し、プラットフォーム インストールの手順に沿って操作します。

AppBridgeServiceHost.log に MySQL エラーが見つかった場合は、次の手順をお試しください。

1. MySQL のトラブルシューティングに移動します。
2. 引き続きサポートが必要な場合は、Google Workspace Migrate の問題についてサポートに問い合わせるをご覧ください。