段階的なロールアウト (N-1) インストール、コンフィギュレーション、および切替ガイド

この記事では、Microsoft Dynamics AX for Retail Modern 販売時点管理 (MPOS) および Commerce Scale Unit、または Microsoft Dynamics AX for Retail Enterprise Point of Sale (EPOS) などの Microsoft Dynamics AX 2012 R3 チャンネル コンポーネントが、Microsoft Dynamics 365 Commerce Headquarters を使用できるように、段階的ロールアウト (N-1) のコンポーネントを設定する方法について解説します。

重要な用語

Overview

この記事のセクションでは、N-1 コンポーネントを所持する環境の設定を行う必要がある以下の手順について説明します。 これらの手順では、headquarters が既に配置され、AX 2012 R3 環境が現在実行中であることを前提としています。

• Microsoft Entra アカウントのセットアップ – このセクションでは、N-1 コンポーネントが本社への接続に使用するMicrosoft Entra アカウントを設定する方法について説明します。
• N-1 コンポーネントの構成 – このセクションでは、headquarters で N-1 コンポーネントを構成する方法について説明します。
• N-1 コンポーネントのインストール – このセクションでは既存の AX 2012 R3 環境で N-1 コンポーネントをダウンロードおよびインストールする方法について説明します。
• N-1 に切り替えるための切替手順 – このセクションでは、既存の AX 2012 R3 環境を AX 2012 R3 headquarters から Commerce headquarters に切り替えるために、新しい N-1 コンポーネントを使用する方法について説明します。
• トラブルシューティングの手順 – このセクションでは、一般的な問題のトラブルシューティングの手順について説明します。
• N-1 に必要な KB – このセクションでは、N-1 環境を設定するために必要な Microsoft サポート技術情報の記事番号 (KB) が一覧で表示されます。

高レベル アーキテクチャ

次の図は、N-1 手順の高レベル概要を示しています。

N-1 ライセンス キーが有効であることを確認します。

コンフィギュレーションおよび N-1 コンポーネントのインストールを開始する前に、対応するライセンス キーが有効であることを確認してください。 このライセンス キーは、AX 2012 R3 から Microsoft Dynamics 365 Commerce へのアップグレード中に自動的に有効になります。 ただし、以降の手順ではこのキーが必要であるため、続行する前に、キーがオンになっていることを確認してください。

1. Commerce headquarters にサインインし、システム管理>設定>ライセンスの構成に移動します。

2. コンフィギュレーション キー タブで、コマース キーを展開し、コマース スケジューラ キーを展開し、Retail Data Commerce Exchange 下位互換性キーのチェック ボックスがオンであることを確認します。

   Note

   キーがオンになっていない場合は、Microsoft サポートに問い合わせてオンにしてください。

Microsoft Entra アカウントの設定

1. Connector for Microsoft Dynamics AX のクライアント ID とシークレットを作成するために Azure Web App を生成します。 手順については、Microsoft Entra アプリケーションを作成するの「Microsoft Entra アプリケーションを作成する」セクションを参照してください。
2. クライアント ID とシークレットの作成が完了したら、Commerce でクライアント ID を受け入れます。 システム管理 > 設定 > Microsoft Entra アプリケーションの順に移動します。 クライアント ID をクライアント ID 列に入力し、説明のテキストを名列に入力、および RetailServiceAccount をユーザー ID 列に入力します。

N-1コンポーネントの構成

Headquarters で N-1 コンポーネントを構成するには、このセクションの手順に従います。

Microsoft Dynamics AX 用コネクタ

1. Commerce Headquartersにサインインし、小売・コマース本部の設定 コマーススケジューラ Microsoft Dynamics AX コネクタ に移動します。

2. 操作ウィンドウで [ 新規] を選択し、次のフィールドを設定します。

   セクション	フィールド	説明	サンプル値
   ヘッダー	プロファイル	設定する N-1 プロファイルの固有の名前を入力します。 AX 2012 R3 リアルタイム サービスがインストールされている環境またはサーバーごとに 1 つのプロファイルを作成します。	AXConnect
   ヘッダー	説明	プロファイルを識別するための説明テキストを入力します。	AX2012 のコネクタ
   接続	サーバー	N-1 リアルタイム サービスがインストールされるサーバーの名前を入力します。 このサーバーは、AX 2012 R3 リアルタイム サービスがインストールされているのと同じサーバーです。	sampleserver.local
   接続	ポート	N-1 リアルタイム サービスが使用するポートを入力します。	8017
   接続	Web アプリケーション名	Microsoft インターネット インフォメーション サービス (IIS) の N-1 リアルタイム サービスに使用する名前を入力します。	Real-timeServiceAX63
   接続	プロトコル	AX 2012 R3 のリアルタイム サービスによって使用されているプロトコルを選択します。	https
   接続	共通名	N-1 リアルタイム サービスが使用する証明書のフレンドリ名を入力します。	samplecertificate.local
   接続	パスフレーズ	N-1 リアルタイム サービスで使用するパスフレーズを入力します。
   接続	Language	N-1 リアルタイム サービスにマップされているストアに関連付けられている言語を選択します。	EN-US

3. 完了後は、保存 を選択します。

コマース共有パラメーター

1. headquarters で、Retail とコマース > バックオフィスの設定 > パラメーター > コマースの共有パラメーターの順に移動します。

2. セキュリティタブで、次のフィールドを設定します。

   フィールド	説明	サンプル値
   Real-time Service プロファイル	前のセクションの Connector for Microsoft Dynamics AX ページで作成したプロファイルを選択します。	AXConnect
   TS パスワードの暗号化名	トランザクションのサービスに接続するために使用するアルゴリズムを入力します。 このフィールドを SHA256 に設定します。	SHA256
   レガシ デバイス アルゴリズム	AX 2012 R3 デバイス アルゴリズムを入力します。	AES

コマース スケジューラのパラメーター

1. headquarters で、Retail とコマース > バックオフィスの設定 > パラメーター > コマース スケジューラ パラメーターの順に移動します。

2. HQ メッセージ データベースクイック タブで、次のフィールドを設定します。

   フィールド	説明	サンプル値
   SQL Server インスタンス名	既存の AX 2012 R3 本社メッセージ データベースをホストする Microsoft SQL Server インスタンスの名前を入力します。	sampleinstance
   サーバー名	既存の AX 2012 R3 headquarters メッセージ データベースをホストするサーバーの名前を入力します。	sampleserver
   データベース名	AX 2012 R3 のヘッドクォーター メッセージ データベース名を入力してください。 AX 2012 R3 では、既定の名前は HQMessageDB です。	HQMessageDB

3. 完了後は、保存 を選択します。

作業フォルダー

1. Headquarters で、Retail とコマース > バックオフィスの設定 > コマース スケジューラ > 作業フォルダーの順に移動します。

2. グリッドで、次のフィールドの値が設定されていることを確認してください。

   フィールド	説明	サンプル値
   Name	作業フォルダーの名前。	N-1 のファイル ストレージ
   説明	作業フォルダーの説明。	N-1 のファイル ストレージ
   ダウンロード パス	AX 2012 R3 Commerce Data Exchange (CDX) ダウンロード パッケージを格納するネットワーク パス。	\\sampleserver\Download
   アップロード パス	AX 2012 R3 CDX がをアップロード パッケージを格納するネットワーク パス。	\\sampleserver\Upload

3. 完了後は、保存 を選択します。

チャネル データベース グループ

1. Headquarters で、Retail とコマース > バックオフィスの設定 > コマース スケジューラ > チャネル データベース グループの順に移動します。

2. AX 2012 R3 環境の各現物チャネル データベースについては、アクション ペインで 新規 を選択し、以下のフィールドを設定します。

   セクション	フィールド	説明	サンプル値
   ヘッダー	Name	AX 2012 R3 環境に使用するチャネル データベース グループの名前を入力します。	Default_AX63
   ヘッダー	説明	AX 2012 R3 チャネル環境に使用するチャネル データベース グループの説明を入力します。	AX63 チャネル データベースの既定のグループ
   全般クイック タブ	チャネル スキーマ	AX 2012 R3 スキーマを選択します。 このフィールドを AX2012R3 に設定 します。	AX2012R3
   全般クイック タブ	作業フォルダー	CDX データ パッケージの同期にシステムが使用する作業フォルダー レコードへの参照を選択します。 前のセクションで、この作業フォルダーのレコードを作成しました。	workingfolder

3. 完了後は、保存 を選択します。

チャネル データベース

1. Headquarters で、Retail とコマース > バックオフィスの設定 > コマース スケジューラ > チャネル データベースの順に移動します。

2. AX 2012 R3 環境の各現物チャネル データベースについては、アクション ペインで 新規 を選択し、以下のフィールドを設定します。

   セクション	フィールド	説明	サンプル値
   ヘッダー	チャネル データベース ID	現物の チャネル データベースの固有識別子を入力します。 AX 2012 R3 環境からこの値を派生させます。	Default_AX63_Database
   ヘッダー	チャネル データベース グループ	チャネル データベースがマップされているチャネル データベース グループを選択します。 AX 2012 R3 環境からこの値を派生させます。	Default_AX63_DatabaseGroup
   ヘッダー	タイプ	チャネル データベース レコードのタイプを選択します。 このフィールドを Channel データベースに設定します。	チャネル データベース
   ヘッダー	データ同期間隔	CDX データの同期を実行する間隔を選択します。 このフィールドは空白のままにします。
   ヘッダー	ユーザー名 (大文字と小文字を区別)	AX 2012 R3 チャネル データベースへの接続に使用するユーザー名を入力します。	channeluser
   ヘッダー	パスワード	AX 2012 R3 チャネル データベースへの接続に使用するパスワードを入力します。	パスフレーズ
   ヘッダー	データベース名	AX 2012 R3 チャンネル データベースの名前を入力します。	SampleChannelDB
   ヘッダー	サーバー名	AX 2012 R3 チャネル データベースをホストするサーバーの名前を入力します。	sampleserver
   チャネル クイック タブ	チャネル	チャネル データベースにマップされている段階的なロールアウト (N-1) のチャネルのリストを追加するには、追加を選択します。 AX 2012 R3 環境からこれらの値を派生させます。	ロンドン

3. 完了後は、保存 を選択します。

チャネル プロファイル

1. Headquarters にサインインして、Retail とコマース > チャネル > 店舗 > すべての店舗の順に移動します。

2. アップグレード プロセスが以前のバージョン環境でホストする Retail Server ごとに、アクション ウィンドウで [ 新規] を選択し、次のフィールドを設定します。

   セクション	フィールド	説明	サンプル値
   ヘッダー	Name	設定する以前のバージョンのチャネル プロファイルの一意の名前を入力します。 AX 2012 R3 Retail Server がインストールされている環境またはサーバーごとに 1 つのプロファイルを作成します。	Default_AX63_Profile
   プロファイルのプロパティ	プロパティ キー	AX 2012 R3 環境で使用される Retail Server URL のキーを入力します。 このフィールドを Retail Server URL に設定します。	Retail サーバー URL
   プロファイルのプロパティ	プロパティ値	AX 2012 R3 環境で使用される Retail Server URL を入力します。	http://localhost"35080/RetailServer/V1
   プロファイルのプロパティ	プロパティ キー	AX 2012 R3 環境で使用されるハードウェア ステーション URL のキーを入力します。	ハードウェア ステーションの URL
   プロファイルのプロパティ	プロパティ値	AX 2012 R3 環境で使用されるハードウェア ステーション URL を入力します。	ipc://localhost

3. 完了後は、保存 を選択します。

すべての店舗

1. Headquarters にサインインして、Retail とコマース > チャネル > 店舗 > すべての店舗の順に移動します。

2. N-1 環境にマップするストアごとに、チャネル ID を選択します。 次に、店舗詳細ページの、一般クイックタブで、次のフィールドを設定します。

   フィールド	説明	サンプル値
   ライブ チャネル データベース	ストアをマップし、以前に設定したチャネル データベースを選択します。	Default_AX63_Database
   チャネル プロファイル	ストアをマップし、前のセクションで設定したチャネル プロファイルを選択します。	Default_AX63_Profile

3. 完了後は、保存 を選択します。

AX 2012 スケジューラの初期化

1. Headquarters にサインインし、小売とコマース> Headquarters の設定 > コマース スケジューラ > AX 2012 Retail スケジューラ の初期化の順に移動します。
2. [OK] を選択.

配送スケジュール

1. Headquarters にサインインし、Retail とコマース > Retail とコマース IT > 配送スケジュールの順に移動します。
2. 左側のウィンドウで、接尾語 AX63 のある配送スケジュールを選択します。 次に、[ チャネル データベース グループ ] クイック タブで、先ほど作成したエントリが配布スケジュールにマップされていることを確認します。

作業者

1. Headquarters にサインインし、Retail とコマース > 従業員 > 作業者の順に移動します。
2. AX 2012 R3 環境にサインインする各作業者の名前を選択します。 次に、作業者の詳細ページの、コマース タブの、コマース クイック タブで、パスワード フィールドを設定します。

N-1 コンポーネントのインストール

Microsoft Dynamics AX インストーラー用コネクタを実行する前に、次の要件が満たされていることを確認します。

• インストーラーでは、Microsoft .NET Framework バージョン 4.5.1 がシステムにインストールされている必要があります。

• インストーラーは、次のオペレーティング システムにのみ Microsoft Dynamics AX アプリケーション用コネクタをインストールします。 コンポーネントをインストールする前に、利用可能なすべてのサービス パックと更新プログラムを使用してオペレーティング システムを更新します。

  • Windows 7 Professional、Enterprise、または Ultimate エディション (x86 および x64 アーキテクチャの両方)。 Home エディションおよび埋め込みエディションはサポートされていません。
  • Windows 8.1 Update 1 Pro または Enterprise エディション (x86 および x64 アーキテクチャの両方)。 標準エディションはサポートされていません。
  • Windows 10 Pro または Enterprise エディション (x86 および x64 アーキテクチャの両方)。 Home エディションはサポートされていません。
  • Microsoft Windows Server 2012 R2 または Microsoft Windows Server 2016。

非同期サーバー コネクタ サービス

インストーラーは、すべての前提条件が満たされていることを検証します。 これらの前提条件には、SQL Server のローカル インストールなどの SQL 前提条件、または SQL Command Line Utilities やその他の必要な SQL 接続インストールなどの別の前提条件が含まれています。

前提条件を満たすには、接続先の SQL Server にフルテキスト検索が必要であり、少なくともトランスポート層セキュリティ (TLS) 1.1 のサポートが必要です。 Microsoft SQL Server 2012 の場合は、Service Pack 3 を少なくともインストールする必要があります。 Microsoft SQL Server 2014 の場合、Service Pack 2 をインストールする必要があります。

システムの再起動が必要な場合、インストーラーでこの要件が表示されます。 再起動することを推奨されていますが、インストーラーを使用せずに続行することができます。

準備ができたら、次の手順に従ってコンポーネントをダウンロードおよびインストールします。

1. 本社にサインインし、小売とコマース > 本社設定 > コマース スケジューラ > Microsoft Dynamics AX のコネクタの順に移動します。

2. 作成済みのコネクタを選択します。

3. アクション ウィンドウのダウンロードタブで、Async Server Connector service を選択してインストーラー ファイルをダウンロードし、Async Server Connector service の下の構成ファイルを選択して、対応する構成ファイルをダウンロードします。 構成ファイルがインストーラー ファイルの横に保存されていることを確認します。

4. インストーラーと構成ファイルをダウンロードした後、インストーラー ファイルをダブルクリックし、次の手順に従います。

   1. アプリケーション オブジェクト サーバー (AOS) URL (本社へのアクセスに使用する URL) を確認し、[ 次へ] を選択します。
   2. 特定のユーザーが必要な場合は、サービスを実行するために必要なユーザー名とパスワードを入力します。 既定では、インストーラーは自動的に使用するサービス アカウントを生成します。 この方法は安全性が高く、推奨されますが、データベースが別のコンピューター上にある場合は使用できません。 [次へ] を選択して続行します。
   3. この Connector for Microsoft Dynamics AX インストールに関連付けられているアプリケーション ID (クライアント ID) とシークレットを入力します。
   4. インストールを選択します。

   Note

   • クライアント ID およびシークレットを作成するため Azure Web アプリを正しく生成する方法の詳細については、Microsoft Entra アプリケーションを作成するで「Microsoft Entra ID でアプリケーションを登録するための基本」セクションを参照してください。
   • Web アプリを作成するとき、最初の URI と URL は特定の値である必要はありません。 重要なのは、作成するアプリケーション ID (クライアント ID) とシークレットだけです。

5. アプリケーション ID (クライアント ID) とシークレットを作成したら、Commerce でアプリケーション ID を受け入れます。 小売とコマース > 本社設定 > Microsoft Entra アプリケーションに移動します。 アプリケーション ID をクライアント ID 列に入力し、説明テキストを名列に入力、および RetailServiceAccount をユーザー ID 列に入力します。

6. headquarters で、Retail とコマース > バックオフィスの設定 > パラメーター > コマースの共有パラメーターの順に移動します。

7. ID プロバイダータブで、発行者値で始まる HTTPS://sts.windows.net/ プロバイダーを選択します。 選択に基づいて、依存する関係者クイックタブの値が自動的に設定されます。

8. 依存する関係者クイック タブで、追加を選択します。 このインストール用に作成したアプリケーション ID (クライアント ID) を入力します。 Type フィールドを Public に、UserType フィールドを Worker に設定します。 [アクション] ウィンドウで、保存 を選択します。

9. アクション ウィンドウで、保存を選択します。

N-1 リアルタイム サービス

1. 本社にサインインし、小売とコマース > 本社設定 > コマース スケジューラ > Microsoft Dynamics AX のコネクタの順に移動します。

2. 作成済みのコネクタを選択します。

3. アクション ウィンドウのDownloadタブで、Dynamics AX 2012 R3 用リアルタイム サービスを選択してインストーラー ファイルをダウンロードします。次に、Dynamics AX 2012 R3 用リアルタイム サービスの下にあるConfiguration fileを選択して、対応する構成ファイルをダウンロードします。 セットアップ ファイルの横に構成ファイルを保存していることを確認します。

4. インストーラーと構成ファイルをダウンロードした後、インストーラー ファイルをダブルクリックし、次の手順に従います。

   1. AOS URL (本社へのアクセスに使用する URL) を確認し、[ 次へ] を選択します。

   2. HTTPS 通信に使用する有効な TLS/SSL 証明書を選択し、[ 次へ] を選択します。

      証明書は秘密キー ストレージを使用する必要があり、サーバー認証は拡張キー使用プロパティにリストされている必要があります。 また、証明書はローカルに信頼される必要があり、期限切れにすることはできません。 ローカル コンピューターの個人用証明書ストアの場所に保存する必要があります。

   3. 特定のユーザーが必要な場合は、アプリケーション プールを実行するために必要なユーザー名とパスワードを入力します。 既定では、インストーラーは自動的に使用するサービス アカウントを生成します。 この方法は、安全性が向上しお勧めしますが、データベースが別のコンピューターにある場合は使用できません。 [次へ] を選択して続行します。

   4. 使用する HTTPS ポートを確認し、コンピューターのホスト名が正しいことを確認します。 [次へ] を選択して続行します。

      ストア システム プロファイルには、HTTPS ポートが一覧表示されます。 店舗システム プロファイルにアクセスするには、店舗詳細ページの店舗システム クイック タブで、選択した店舗システムのプロファイル ID を選択します。 インストーラーは自動的にホスト名を入力します。 インストールのホスト名を変更する必要がある場合は、ここで変更します。 ホスト名はシステムの完全修飾ドメイン名 (FQDN) である必要があり、この記事の前半の Connector for Microsoft Dynamics AX ページで入力した値と一致している必要があります。

   5. この Connector for Microsoft Dynamics AX インストールに関連付けられているアプリケーション ID (クライアント ID) とシークレットを入力します。 その後、インストール を選択します。

      このアプリケーション ID とシークレットは、Async Server Connector service のインストールで使用したのと同じアプリケーション ID とシークレットにできます。 クライアント ID およびシークレットを作成するため Azure Web アプリを正しく生成する方法の詳細については、Microsoft Entra アプリケーションを作成するで「Microsoft Entra ID でアプリケーションを登録するための基本」セクションを参照してください。 Web アプリを作成するとき、最初の URI と URL は特定の値である必要はありません。 重要なのは、作成するアプリケーション ID (クライアント ID) とシークレットだけです。

N-1に切り替えるための切替手順

このセクションでは、既存の AX 2012 R3 チャンネル環境を AX 2012 R3 Headquarters から Commerce headquarters に切り替えるための、推奨される詳細な手順を説明します。 これらの手順は一般的なものです。 特定のビジネス要件または技術要件に対応するために、実装が異なる場合があります。

前提条件

システム移行の準備として環境を整えます。

準備

カットオーバーが予定される数日前に準備を始めてください。

切替手順

切替プロセスを行うには、これらの手順に従います。

次の図は、これらの手順のビジュアル表示です。

トラブルシューティングの手順

このセクションでは、発生する可能性があるいくつかの一般的な問題と、調査、または回復する手順について説明します。

ランタイム

このセクションでは、アプリケーションの実行時に発生する可能性のあるエラーの、トラブルシューティングの手順について説明します。

メタデータ同期に失敗

メタデータ同期に失敗

メタデータの同期が失敗した場合、または、CDX ジョブが正常にダウンロードされたが、適用されない場合

CDX ジョブが正常にダウンロードされますが、適用されません。

N-1 非同期サーバー コネクタ サービスの通信例外

AX 2012 R3 MPOS のライセンス認証は、ステップ 1 でエラーで失敗します

AX 2012 R3 MPOS のライセンス認証は、ステップ 2 でエラーで失敗します

AX 2012 R3 MPOS のライセンス認証は、ステップ 2 でエラーで失敗します

AX 2012 R3 MPOS のライセンス認証は、ステップ 9 でエラーで失敗します

N-1 に必要な KB

次の図では、正常に動作するために N-1 を必要とする全ての KB を表しています。

Dynamics 365 Retail – Microsoft Dynamics 365 7.2 headquarters