AX 2012 からのアップグレード - セルフサービス環境のデータアップグレード

[アーティクル]
07/24/2024

この Microsoft Dynamics AX 2012 データアップグレードプロセスは、セルフサービスの環境向けです。この記事のセクションを次の順序で完了します。

前提条件
[データアップグレードプロセス ] : アップグレードDataMigrationTool.exeを実行してアップグレードプロセスを完了します。
[アプリケーションのレポート] : レプリケーションの検証、レプリケーションステータス、データアップグレードのステータス、およびロールバックデータアップグレードのステータスに関するレポートを確認します。
アプリケーションのツール作成セクション : このセクションでは、プロセスパラメータをリセットし、プロセスを再起動します。

前提条件

クラウドホスト (開発) 環境、またはセルフホスティングの開発用 VHD 環境で、顧客データを使用してアップグレードテストが正常に完了しました。このテストは、セルフサービス環境と同じアプリケーションバージョンおよびカスタマイズに対して実行されている必要があります。
Microsoft Dynamics Lifecycle Services (LCS) から Dynamics365 用 Data Migration Toolkit バージョン 1.0.12 (またはそれ以上) をダウンロードします。共有資産ライブラリで、資産タイプとしてモデルを選び、モデルファイルを選択します。展開する前に、ファイルプロパティを使用して ZIP ダウンロードのブロックを解除します。
LCS のセルフサービス環境を作成します。この環境は、配置済み状態である必要があります。セルフサービス環境である必要があります。クラウドホスト型開発環境は、AX 2012 年からのアップグレード - 開発環境でのデータアップグレードとしてのみ使用できます。

重要

アップグレードを実行する前に、使用している Dynamics 365 バージョンの最新の 品質更新 を適用してください。

メモ

次の点に注意してください:

Microsoft Dynamics AX 2012 データのアップグレードプロセスは、財務と運用のセルフサービス、サンドボックス (UAT) 環境専用です。生産計画に対して実行環境。
Dynamics 365 用 Data Migration Toolkit の最新バージョンを LCS からダウンロードしてください。
リンクされたデータベースを Power Platform 環境2012のデータアップグレードに AX 使用したりすることはできません。 Power Platform 環境は、データアップグレードの完了後に配置して使用できます。

まだインストールされていない場合は、.NET Framework version 4.7.1 をダウンロードし、インストールします。
レプリケーション機能がインストールされ、ソース SQL Server インスタンスに対して有効になっていることを確認します。レプリケーションが有効かどうかを確認するには、次の SQL スクリプトを実行します。
```
-- If @installed is 0, replication must be added to the SQL Server installation.

USE master;
GO
DECLARE @installed int;
EXEC @installed = sys.sp_MS_replication_installed;
SELECT @installed;
```
レプリケーションコンポーネントがインストールされていない場合は、SQL Server レプリケーションのインストールの手順に従いインストールします。
SQL Server 認証は、SQL Server および Windows 認証モード に設定する必要があります。 (この変更を行うには、SQL Server サービスを再起動する必要があります。) ツールキットではネイティブ SQL ログインのみを使用します。

メモ

ツールキットにSQLする # のサーバーロール 割り当てる必要があります。既存のSQLログインを使用するか、必要に応じて新しいログインを作成できます。
ソースデータベースサーバーで SQL Server Agent を有効にして起動します。
移行ツールキットの設定 : ソースデータベーステーブルの一部をターゲットデータベースにレプリケートしたくない場合は、データベースファイルで指定IgnoreTables.xmlできます。同様に、一部の関数を複製しない場合は、IgnoreFunctions.xml ファイルでそれらを指定できます。また、主パブリケーション外のパブリケーションに特定のテーブルを置く場合は、SpecialTables.xml ファイルを使用できます。
- IgnoreTables.xml ファイルのパス : Data\IgnoreTables.xml
- IgnoreFunctions.xml ファイルのパス : Data\IgnoreFunctions.xml
- SpecialTables.xml ファイルのパス : Data\SpecialTables.xml
次の例は、XML ファイルのテーブルおよび関数を指定する方法を示しています。
```
<?xml version="1.0" encoding="utf-8"?>
<IgnoreTables>
    <Name>
        <Table>NON_AOT_TABLE1</Table>
        <Table>NON_AOT_TABLE2</Table>
        <Table>NON_AOT_TABLE3</Table>
    </Name>
</IgnoreTables>
```
メモ

Ignore リストに追加するテーブルは、Microsoft Dynamics AX 2012 アプリケーションオブジェクトツリー (AOT) に存在しないテーブルでなければなりません。 AOT に存在するテーブルを含めると、データのアップグレード中にエラーが発生します。これらのテーブルはターゲットデータベースに複製されません。
```
<?xml version="1.0" encoding="utf-8"?>
<IgnoreFunctions>
    <Name>
        <Function>if_WHSInventReserveUnionDelta</Function>
    </Name>
</IgnoreFunctions>
```
重要

XML ファイルに指定された機能はターゲットデータベースに複製されません。
```
<?xml version="1.0" encoding="utf-8"?>
<SpecialTables>
  <Name>
    <Table></Table>
  </Name>
</SpecialTables>
```
重要

SpecialTables ファイルで指定されたテーブルは、専用のパブリッシャーに追加されます。特別テーブルパブリッシャーの数は、NumberOfPublishers パラメーターに基づいています。以下の手順を参照してください。特別なテーブル処理は、ダウンタイム時間中に手動でレプリケーションを開始する必要がある、非常に大規模なテーブルに有用です。
レプリケーションの待機時間/パフォーマンスを最適化するために、App.config ファイルで次のディストリビューターのパラメーターを更新できます。
- MaxBcpThreads - 既定では、パラメーターは 6 に設定されています。機械のコア数が 6 未満の場合は、その値をコア数に更新します。指定できる最大値は 8 です。
- NumberOfPublishers - 既定では、パラメーターは 4 に設定しています。この値を使用することを推奨します。ただし、パブリッシャーの数を増やして、各パブリッシャーに配分するテーブル数を少なくする場合があります。この変更により、手動のスナップショットが開始し、より小さな初期スナップショットを実行できます。これは、メンテナンス期間が限られていて、レプリケーションの開始を複数に分割する必要がある場合に役立ちます。
- snapshotPostPublication : このオプションを使用すると、自動レポートプロセスの開始間にスナップショット5分の遅延が追加されます。これにより、ソースサーバーの負荷を支援できます。ツールキットでは手動でスナップショットを開始することも可能です。そのオプションを選択した場合、設定の必要はありません。

メモ

システムのリソース / メモリの使用率 / IO 操作が高いピーク時には、レプリケーションを設定または構成しないでください。リソースが上限まで使用されている場合 (90% 以上が既に消費されている)、システムが使用可能なリソースを見つけるためにレプリケーションが遅延する場合があります。システムリソースの使用が最小 (オフピーク時) であるオフ時間にレプリケーションを開始することをお勧めします。また、Go-Live の切替については、前の週末にレプリケーションを開始することをお勧めします。

データアップグレードプロセス

DataMigrationTool.exe アプリケーションを実行する

レプリケーションプロセスを開始する前に、LCS環境は、 が作成 状態になります。

DataMigrationTool.exe アプリケーションを実行します。

クラウドタイプを指定できるコンソールウィンドウ環境開きます。
- パブリック: [ lcs.dynamics.com]
- GCC: [ gov.lcs.microsoftdynamics.us ]
- 高い、[ uae.lcs.dynamics.com]
  クラウド環境を入力すると、サインインを求めるプロンプトが表示されます。
LCS へのサインインに使用する資格情報を提供します。
正常に認証された後コンソールウィンドウで、Project-Id 値から Environment-Id 値を順に作成します。

指定した値を検証するには、LCSへのログインに使用する資格情報を使用してログインする必要があります。

メモ

プロジェクト ID および環境 ID の値は、LCS の環境の管理ページで確認できます。また、環境 ID の値は、環境の詳細ページでも確認できます。

データレプリケーションおよびアップグレードの実施

検証が成功すると、アプリケーションには、データアップグレードプロセスの手順に対応する一連のメニューオプションが表示されます。データのレプリケーションおよびアップグレードを完了するには、次の手順を順番に実行する必要があります。

環境の準備: 環境の設定活動

この手順では、次の情報の入力が求められます。
- ソースデータベースの詳細:
  - ソースサーバー (サーバー名\サーバーインスタンスの形式)
  - ソースデータベース名
  - ユーザー名
  - パスワード
- ソースデータベースサーバーの IP アドレス (許可リスト用)
- 配布データベースパス (D:\SQLServer\Data など)
- レプリケーションスナップショットパス (D:\SQLServer\Snapshot など)
重要

SQLサーバーネイティブ認証に基づいてログインを使用する必要があります。ドメインサインインは使用できません。前にこのドキュメントで述べたように、このログインは、 管理者または登録 があります。

指定した配布データベースとレプリケーションスナップショットパスには、十分な容量が必要です。容量は、少なくともソースデータベースのサイズにすることをお勧めします。 AX 2012 データベースで圧縮を使用した場合、スナップショットが圧縮されていないと必要容量が大きくなります。パスは、コンピューターのローカルディスクに含まれる必要があります。共有パスの使用を避けます。

仮想コンピューター (VM) またはコンピューター (手順 1. の許可リストのため) に対して静的 IP アドレスを設定することをお勧めします。これにより、ターゲットデータベースに関する接続の問題を防ぐのに役立ちます。

この手順では、次のアクションを実行します。
- ソースデータベースへの接続を検証します。
- AX 2012 データベースのバージョンを検証します。
- ソースの IP アドレスを承認します。
- ターゲットデータベースを検証します。
環境の準備 : データアップグレードのターゲット環境を準備する

この手順により、LCS の環境の状態が配置済みからレプリケーションの準備完了に変更されます。
レプリケーション : ターゲットデータベースのクリーンアップ

この手順では、次のアクションを実行します。
1. LCS 環境の状態を、レプリケーションの準備完了からレプリケーションの処理中に変更します。
2. ターゲットデータベースのすべての AX 製品タブレット、ビュー、ストアドプロシージャ、およびターゲットデータベースのユーザー定義関数を削除します。
レプリケーション : 配布の設定

この手順により、ソースサーバーのシステムデータベース フォルダー下に配布データベースが作成されます。この配布データベースは、レプリケーションに使用されます。
レプリケーション : 主キー (PK) テーブル用にパブリケーションを設定する

この手順により、ソースサーバーのレプリケーション フォルダーの下に主キーテーブル用のパブリケーションが作成され、ターゲットデータベースに複製されます。 ignore-table エントリが指定された場合、指定されたテーブルはレプリケーションから除外されます。 特別テーブル エントリが追加された場合、追加の特別テーブルパブリケーションに追加されます。

ノート

SQL Management Studio でスナップショットを手動で起動する必要があります。レプリケーションモニターを開き、SQL Server のインスタンスを選択します。次に、エージェント タブで、開始するパブリッシャーを選択したまま (または右クリック)、開始を選択します。

一度に 1 つのスナップショットを開始し、そのスナップショットのレプリケーションが完了するまで待機します。レプリケーションモニターで、次の例のようなメッセージが表示されるまで、ディストリビューターからサブスクライバーへ の履歴を確認します: "\unc\server\folder から配信されたスナップショット"。

レプリケーションを監視する方法の詳細については、データ移行ツールキットのレプリケーションの監視を参照してください。

手順 6 と 7 のパブリッシャースナップショットを手動で開始する必要があります。

古いバージョンのデータ移行ツールキットには自動開始と手動開始があります。ツールキットの最新バージョンに移行することをお勧めします。

作成された新しい AX_PUB_PkTable_[*]

ノート

このレプリケーション構成ステップが完了すると、バックグラウンドで実行される SQL ジョブとして実際のデータレプリケーションが発生します。このジョブは完了までに少し時間がかかります。レプリケーションの状態を表示するには 'rs' オプションを指定します。 'rs' オプションについては、この記事の後のアプリケーションのレポーティングセクションセクションで確認してください。
レプリケーション : 他のオブジェクト (機能) に対するパブリケーションの設定

この手順により、他のオブジェクト (機能) に対するパブリケーションが作成され、ターゲットデータベースに複製されます。一部の関数を複製しない場合は、IgnoreFunctions.xml ファイルでそれらを指定できます。

作成元 : AX_PUB_OtherObjects

メモ

このレプリケーションは完了までに少し時間がかかることがあります。レプリケーションの状態を表示するには、'rs' オプションを指定します。

複製する関数がない場合、パブリケーションは作成されません。

このステップの DataReplicationStatus プロパティが完了として表示されるまで、次のステップに進まないでください。
切替: 非 PK テーブル用にパブリケーションを設定する

この手順では、2 つのパブリケーションを作成します: 1 つは主キーのないテーブルの複製に使用され、もう 1 つはロックされたテーブルの複製に使用されます。

メモ

ロックされたテーブルがない場合、出版物は作成されません。

パブリケーション名 : AX_PUB_NoPKTable、AX_PUB_TABLE_LockedTable

基本 AX の作成時にスキーマロックが取得された場合、それらのテーブルは公開から無視されます。これらは、一時テーブルに追加され、切替パブリケーションの作成中にレプリケーション用にマークされます。

[重要] このステップの DataReplicationStatus プロパティが完了として表示されるまで、次のステップに進まないでください。

メモ

'dv' オプションを使用して複製データを検証できます。テーブルが不一致である場合は、この手順によりそのテーブル用のパブリケーションを作成できます。レプリケーションに対して不一致のテーブルを除外する場合は、アプリを閉じ、それらのテーブルを Data/IgnoreTables.xml に追加します。その後、アプリを再実行し 'dv' オプションを使用します。

'dv' オプションの詳細については、この記事の後のアプリケーションのレポートセクションを参照してください。
切替: レプリケーションの設定の削除

この手順では、ソースデータベース、配布データベース、およびレプリケーションスナップショットに作成されたすべてのパブリケーションを削除します。
メモ

例外を発生させずにスナップショット フォルダーを削除するには、ソースデータベースで次のスクリプトを実行します。このスクリプトを実行しなくても、受信した例外メッセージは無視できます。
```
EXEC master.dbo.sp_configure 'show advanced options', 1

RECONFIGURE WITH OVERRIDE

EXEC master.dbo.sp_configure 'xp_cmdshell', 1

RECONFIGURE WITH OVERRIDE
```
レプリケーション後: 環境の状態をレプリケート済に更新する

この手順では、LCS 環境の状態を、レプリケーションの処理中からレプリケーション完了に変更します。
データ同期 : トリガー変換

このステップは、データアップグレードをトリガーします。アクションが成功した際、LCS 環境の状態をレプリケーション完了からデータアップグレードの処理中に変更します。

この時点で、データアップグレードトリガーだけが発生します。実際のデータアップグレードは、セルフサービス環境で行われます。データアップグレードのステータスを確認するには、'ds' オプションを使用します。オプションの詳細については、記事の後半でアプリケーションのレポーティングセクションセクションを参照してください。

データのアップグレードに成功すると、'ds' オプションは AX 2012 アップグレードトポロジ (LCS) ステータス: 配置済みとして示され、アップグレードステップは完了状態になります。

データのアップグレードに失敗すると、'ds' オプションは AX 2012 アップグレードトポロジ (LCS) ステータス: 失敗として示され、ひとつ以上のアップグレードステップは失敗状態になります。 メニューオプション (10) ツールには、再開ステータスが表示されます。

失敗の理由を解決して修正した後、再開操作を実行できます。アクションが正常に実行されると、LCSの状態環境 "Failed 更新更新中 から変更されます

メモ

データアップグレードが正常に終了するまで、この手順を繰り返します。
データアップグレードのロールバック : ロールバックトリガーロールバック

この手順は、データアップグレードのロールバックをトリガーします。これにより、アップグレードがトリガーされる前の状態にデータがロールバックされ、LCS 環境の状態がレプリケート済みに設定されます。これにより、"環境" " " のされます。

この時点では、ロールバックをトリガーしたのみです。ロールバックのステータスを表示するには、'rbs'オプションを使用します。オプションの詳細については、この記事で後述するアプリケーションのレポートセクションを参照してください。

ロールバックに成功した場合、'rbs'オプションは、AX 2012 年のアップグレードトポロジ (LCS) ステータス: レプリケート済と表示されます。

ロールバックに失敗した場合、'rbs'オプションは、AX 2012 年のアップグレードトポロジ (LCS) ステータス: 失敗と表示されます。

データアップグレードプロセスの詳細については、AX 2012 – データアップグレード FAQ からアップグレードを参照してください。この記事では、Microsoft Dynamics AX 2012からのアップグレードの際、データアップグレードについてよく寄せられる質問に回答します。

アプリケーションのレポートセクション

次のオプションを使用して、レプリケーションの検証、レプリケーションステータス、データアップグレードのステータス、データアップグレードステータスのロールバックに関するレポートを確認できます。

レポート:のValidate。

このオプションは、ソースサーバーデータベースとターゲットサーバーデータベースのテーブルとレコードの数を比較した後、レポートを表示します。このオプションは、手順 7 が完了した後にのみ使用できます。

テーブルが不一致である場合は、この手順によりそのテーブル用のパブリケーションを作成できます。レプリケーションに対して不一致のテーブルを除外する場合は、アプリを閉じ、それらのテーブルを Data/IgnoreTables.xml に追加します。その後、アプリを再実行して 'dv' オプションを使用します。

レポートデータは、output/PostValidationInfo.csv で確認できます。
rs) レポート: レプリケーションステータスを取得します。

このオプションは、作成されたパブリケーションのレプリケーションプロセスのレポートを表示します。このオプションは、手順 5 が開始された後 (任意のパブリケーションのレプリケーションプロセス中) にのみ使用できます。
(レポート) アップグレードステータスを取得します。

このオプションは、データアップグレードプロセスのレポートを表示します。このオプションは、手順 10 を開始した後にのみ使用できます。
rbs) レポート: ロールバックステータスを取得します。

このオプションは、ロールバックプロセスのレポートを表示します。このオプションは、手順 11 を開始した後にのみ使用できます。

アプリケーションのツールセクション

担当者のリセット : すべてのレプリケーションコンフィギュレーションを削除してレプリケーションの設定を変更します。パブリケーションおよび配布データベースが削除されます。すべてのレプリケーションおよび切替メニューオプションのステータスが、完了モードからリセット モードにリセットされ、レプリケーションを最初からやり直すのに役立ちます。
すべてリセット : すべてのメニューオプションを設定し、レプリケーションコンフィギュレーションを削除します。すべてのオプションの状態は、リセットに変更されます。
クリア : 設定活動を環境してください。 プロジェクト ID の値、環境 ID の値、ソースデータベースの詳細など、すべての情報がキャッシュからクリアされます。
ヘルプ : 更新されたステータスのデータアップグレード移行オプションを表示します。
終了 : 閉じるを実行します。
失敗: 環境を削除する場合、および環境が PreparingForReplication, ReadyForReplication または 複製およびレプリケート) の状態: 環境の状態を Failed に設定した後、環境をLCSから削除できます。

トラブルシューティング

問題解決の情報については、Dynamics 365 Finance + Operations セルフサービス環境への問題解決アップグレードを参照してください。

SQL Server Management Studio 経由でのレプリケーションの構成とステータスについて

SSMS で、オブジェクトエクスプローラーにレプリケーション フォルダーが含まれる場合、レプリケーション機能がサーバーにインストールされ、使用可能になります。

データアップグレードプロセスの手順 3 が完了したら、レプリケーション フォルダー下にコンフィギュレーションされたパブリッシャーが表示されます。レプリケーションステータスを確認するには、レプリケーション フォルダーを選択したまま (または右クリック)、レプリケーションモニターの起動を選択します。

レプリケーションモニターには、レプリケーション用に作成されたすべてのパブリッシャーを表示できます。
スナップショット タブには、スナップショットのステータスが表示されます。
詳細ログ/トランザクションを表示するには、グリッド品目をダブルタップ (またはダブルクリック) します。
ターゲットへのデータレプリケーションを表示するには、すべてのサブスクリプション タブで、グリッド品目のサブスクリプションをダブルタップ (またはダブルクリック) します。

次の方法で共有

AX 2012 からのアップグレード - セルフサービス環境のデータアップグレード

前提条件

データアップグレードプロセス

DataMigrationTool.exe アプリケーションを実行する

データレプリケーションおよびアップグレードの実施

アプリケーションのレポートセクション

アプリケーションのツールセクション

トラブルシューティング

SQL Server Management Studio 経由でのレプリケーションの構成とステータスについて

フィードバック

その他のリソース

次の方法で共有

AX 2012 からのアップグレード - セルフサービス環境のデータ アップグレード

前提条件

データ アップグレード プロセス

DataMigrationTool.exe アプリケーションを実行する

データ レプリケーションおよびアップグレードの実施

アプリケーションのレポート セクション

アプリケーションのツール セクション

トラブルシューティング

SQL Server Management Studio 経由でのレプリケーションの構成とステータスについて

フィードバック

その他のリソース

AX 2012 からのアップグレード - セルフサービス環境のデータアップグレード

データアップグレードプロセス

データレプリケーションおよびアップグレードの実施

アプリケーションのレポートセクション

アプリケーションのツールセクション