次の方法で共有

開発環境に Commerce Scale Unit をインストールする

  • [アーティクル]

この記事では、Microsoft Dynamics 365 Commerce の仮想ハードディスク (VHD) ローカル開発環境と Microsoft Dynamics Lifecycle Services (LCS) クラウド開発環境にインターネット インフォメーション サービス (IIS) ベースの Commerce Scale Unit (CSU) をインストールする方法を、順を追って説明します。 この記事は、インストールを完了するために実行する必要があるさまざまなアクションを表すセクションに分かれています。各セクションは順番に実行する必要があります。

Azure Active Directory アプリを作成する

まず、CSU 用と Store Commerce for Webアプリ (以前のクラウド販売時点管理または CPOS) 用の 2 つの Microsoft Entra ID (以前の Azure Active Directory) を作成する必要があります。 手順については、Microsoft Entra ID でカスタム Retail Server アプリを設定する と Microsoft Entra ID で Store Commerce for Web のカスタム アプリを設定する を参照してください。

ホスト名に基づいて Web サイトの SSL 証明書を作成する

次に、CSU Web サイトおよび Entra ID アプリ認証のホスト名に基づいて Secure Sockets Layer (SSL) 証明書を作成する必要があります。

SSL 証明書を作成するには、次の手順に従います。

  1. リモート デスクトップ プロトコル (RDP) を使用して開発マシンに接続します。
  2. コマンド プロンプトから管理者権限で PowerShell を開きます。
  3. 次のコマンドを入力します。
$cert = New-SelfSignedCertificate -Subject "CN=$env:computerName" -DnsName $env:computerName,$([System.Net.Dns]::GetHostByName($env:computerName).HostName) -KeyAlgorithm RSA -KeyLength 2048 -CertStoreLocation "Cert:\LocalMachine\My" -NotBefore (Get-Date) -NotAfter (Get-Date).AddYears(2) -KeyUsage KeyEncipherment,DataEncipherment,CertSign,DigitalSignature,CRLSign -FriendlyName "$env:computerName" -KeyExportPolicy Exportable -KeySpec Signature
Export-Certificate -Cert $cert -FilePath "$env:temp\https.cer"
Import-Certificate -CertStoreLocation cert:\LocalMachine\Root -FilePath "$env:temp\https.cer"'
  1. 後で CSU インストール セクションで使用するために、新しい証明書のサムプリント値をコピーします。

注記

PowerShell コマンド以外の方法を使用して SSL 証明書を作成する場合は、SSL 証明書に次の keyUsage プロパティ値が含まれていることを確認します: digitalSignature、keyEncipherment、dataEncipherment。

作成した SSL 証明書を .CER ファイル形式に変換する

次に、作成した SSL 証明書を .CER ファイル形式に変換する必要があります。

注記

CSU Entra ID アプに SSL 証明書を追加するには、.CER ファイル形式である必要があります。

作成した SSL 証明書を .CER ファイル形式に変換するには、以下の手順を実行します。

  1. 開発マシン上で、Windows ロゴキー＋Rを選択し、ファイル名を指定して 実行 ダイアログボックスを開きます。
  2. Microsoft 管理コンソールを開くには、「MMC」 と入力してください。
  3. ファイル > 追加/削除 スナップイン を選択します。
  4. 利用可能なスナップイン 配下で、証明書を選択し、追加 を選択します。
  5. 証明書スナップイン ダイアログ ボックスで、コンピュータのアカウントを選択し、次 を選択します。
  6. ローカル コンプーター をクリックし、終了 を選択します。
  7. OK を選択します。
  8. 証明書 > 個人 > 証明書 を展開します。
  9. 既に作成した SSL 証明書を見つけて右クリックし、すべてのタスク > エクスポート を選択します。
  10. エクスポート ダイアログ ボックスで 次へ を選択します。
  11. いいえ、秘密キーをエクスポートしません を選択し、次へ をを選択します。
  12. DER エンコード バイナリ X.509 (.CER) を選択します。
  13. C:\temp フォルダーを選択し、ファイル名として「DevBoxSelfSigned」と入力します。
  14. OK を選択してから、保存を選択します。

既存の CSU Entra ID アプリに SSL 証明書を追加する

次に、作成して .CER ファイル形式に変換した SSL 証明書を既存の CSU Entra ID アプリに追加する必要があります。 この手順は、CSUが Commerce headquarters との通信用認証トークンを生成するために必要です。

作成した SSL 証明書を CSU Entra ID アプリに追加するには、次の手順に従います。

  1. 仮想マシン (VM) 上の Web ブラウザーで、前に作成した CSU Azure アプリ登録を編集します。
  2. クライアント認証情報 で、証明書またはシークレットの追加 を選択します。
  3. 証明書 タブを選択します。
  4. 証明書のアップロード を選択します。
  5. C:\temp から DevBoxSelfSigned 証明書を選択します。
  6. 説明 に「Devbox cert」と入力します。
  7. セットの説明に、「Devbox自己署名証明書」と入力します。
  8. 追加を選択します。

Commerce headquarters を更新します

次のセクションでは、CSU インストールを実行する前に Commerce headquarters で行う必要があるすべての変更を示します。

CSU Entra ID アプリのアプリケーション ID (クライアント ID) を入力する

headquarters で CSU Entra ID アプリのアプリケーション ID (クライアント ID) を入力するには、以下の手順に従ってください。

  1. システム管理 > 設定 > Azure Active Directory アプリケーション (Microsoft Entra ID アプリケーション) の順に移動します。
  2. クライアント ID 列には、Entra ポータルの CSU Entra ID アプリののアプリケーション ID (クライアント ID) を入力します。
  3. 名前 列に説明用のテキストを入力します。
  4. ユーザー ID 列に、「RetailServiceAccount」 と入力します。

新しいチャネル データベース レコードを作成します

CSU 用に新しいチャネル データベース レコードを作成する必要があります。 そのデータベース レコードを作成した後、構成ファイルのコピーを取得する必要があります。これは、インストール プロセスを簡略化するのに役立ちます。

headquarters に CSU 用の新しいチャネル データベース レコードを作成するには、以下の手順に従います。

  1. 小売りとコマース > Headquarters の設定 > コマース スケジューラ > チャネル データベース の順に移動します。
  2. 新規を選択します。
  3. チャネル データベース ID に「DevSealedCSU」 を入力します。
  4. チャネル データベースのグループ に「Default」を入力します。
  5. 保存 を選択します。
  6. 小売情報チャンネル のクイックタブで、追加 を選択します。
  7. 普段ご利用の店舗を選択してください。
  8. 保存 を選択します。
  9. 新しい小売チャネルのマ​​ッピング 警告ダイアログ ボックスで、はい を選択します。
  10. ダウンロード > 構成ファイル を選択します。
  11. 構成ファイルを C:\temp に保存します。
  12. 構成ファイルの名前を「StoreSystemSetup.xml」に変更します。

新しいチャンネルのプロファイルを作成します

次に、CSU URL の新しいチャネル プロファイル レコードを作成し、既存の店舗レコードを更新して、新しいチャネル データベースとプロファイルを使用する必要があります。

注記

代わりに、既存のチャネル プロファイル レコードを変更して CSU の URL を使用することもできます。

headquarters で新しいチャネル プロファイルを作成し、既存の店舗レコードを更新して、新しいチャネル データベースとプロファイルを使用するには、次の手順に従います。

  1. 小売りとコマース > チャネル設定 > チャネル プロファイル の順に移動します。
  2. 新規を選択します。
  3. 名前 に「DevSealedCSUProfile」と入力します。
  4. 保存 を選択します。
  5. プロファイル プロパティ で、追加 を選択します。
  6. 非外部 VM 接続 には、次のように入力します:
    1. プロパティ キー には、プロパティ キーの値を入力します。
    2. Retail Server の URL に https://<HostName>:446/RetailServer/Commerce を入力してください。
    3. Cloud POS URL に https://<HostName>:446/POS を入力します。
  7. 小売とコマース > チャネル > 店舗 > すべての店舗 の順に移動します。
  8. 通常作業する店舗レコードごとに、次のフィールドを更新します:
    1. ライブ チャネル データベース に「DevSealedCSU」 を入力します。
    2. チャネル プロファイル に、「DevSealedCSUProfile」と入力します。
    3. 保存 を選択します。

注記

  • The store's closing method must be set to 'Shift' という警告が表示された場合は、店舗の 明細書/決済 FastTab で、決済方法 値を シフト に更新します。
  • 通常 <HostName> 値は "DEV" で始まり、IIS マネージャを開いて、左上隅に表示されるサーバー名の値を確認することで見つけることができます。 また、LCS 環境ページの 環境の管理 > ローカル アカウント の下にある VM 名 列でも確認できます。

CDX データ 譜ループの更新

次の変更では、既定のデータベースが使用されなくなったため、headquarters の Commerce Data Exchange (CDX) データ グループからこのデータベースを削除します。 この更新を行わないと、後でデータの同期エラーが発生する可能性があります。

headquarters で CDX データ グループを更新するには、以下の手順に従ってください。

  1. 小売とコマース > 配送スケジュール の順に移動します。
  2. 既定のデータ グループを選択します。
  3. このグループから既定のデータベース レコードを削除します。

同期ジョブの実行

次の同期ジョブは、インストールが完了すると CSU Async Clientサービスでデータ パッケージ ファイルを使用できるように、インストール前に headquarters で実行されます。 CSU のインストールが成功すると、Async Client がこれらのジョブを適用するため、ジョブは適用済みステータスを表示します。 CSU をインストールする前にこのセクションを実行する必要はありませんが、この手順は、早期のトラブルシューティングとすべてが機能していることの確認に役立ちます。

headquarters で同期ジョブを実行するには、以下の手順に従ってください。

  1. 小売 とコマース > 小売 とコマース IT > 配送スケジュール の順に移動します。
  2. 9999 ジョブを選択します。
  3. 今すぐ実行を選択します。
  4. 警告ごとに、はい を選択します。
  5. ジョブをスケジュールするには、OK を選択します。

シールド CSU の前提条件をインストールする

シールド CSU インストーラーを実行する前に、次の手順を完了する必要があります。

インストールされている IIS コンポーネントを確認する

IIS 6 Management Compatibility (IIS 6 Metabase Compatibility) コンポーネントが開発コンピュータにインストールされていることを確認するには、次の手順に従います。

  1. サーバー マネージャー > ローカル サーバー > 管理 > ロールと機能の追加 に移動します。
  2. IIS 配下で、管理ツール > IIS 6管理の互換性 (IIS 6メタベースの互換性) コンポーネントがチェックされます。

.NET Core ホスティング バンドルをインストールする

開発コンピューターに .NET Core ホスティング バンドルをインストールするには、以下の手順に従います。

  1. リモート デスクトップ プロトコル (RDP) を使用して開発マシンに接続します。
  2. Web ブラウザを開き、.NET 6.0 (Linux、macOS、および Windows のダウンロード) に移動します。
  3. ASP.Net Core Runtime 6.0.X セクションで、Windows 用 Hosting Bundle インストーラーを選択してダウンロードします。
  4. dotnet-hosting-6.0.x-win.exe インストーラーを実行します。

シールド自己ホスト型インストーラーをダウンロードする

注記

シールド CSU インストーラーは、LCS アセット ライブラリからのみ入手できます。

シールド自己ホスト CSU インストーラーを開発コンピューターにダウンロードするには、次の手順に従います。

  1. 開発マシンで Web ブラウザを開き、Microsoft Dynamics Lifecycle Services にログインします。
  2. リストからプロジェクトを選択します。
  3. ページ上部のハンバーガー メニューから、資産ライブラリ を選択します。
  4. 小売セルフサービス パッケージ を選択します。
  5. リストにシールされた CSU インストーラーがすでにある場合は、パッケージ名を選択してダウンロードを開始します。
  6. リストに CSU シールされたインストーラーがない場合は、インポート を選択し、使用するシールされたインストーラーのバージョンを選択します。続いて 選択 をクリックし、パッケージ名を選択してダウンロードを開始します。
  7. シールされたインストーラーを Downloads フォルダーから C:\temp にコピーします。

シールド CSU のインストール

シールド CSU をインストールするプロセスでは通常、本社からダウンロードした構成ファイルが使用されます。このファイルには、Retail Transaction Service (RTS) 認証に必要な情報がすべて含まれています。 構成ファイルを使用しない場合は、--AadTokenIssuerPrefix、--StoreSystemAosURL、--StoreSystemChannelDatabaseId、--TenantId などの追加パラメーターを必ず指定します。 インストーラー コマンドの完全なリストについては シールド Commerce セルフサービス コンポーネントの大規模展開 を参照してください。

シールドされた CSU を開発マシンにインストールするには、次の手順に従います。

  1. 管理者権限で Windows コマンド プロンプトを開きます。
  2. ディレクトリを C:\temp (たとえば、 CD C:\temp) に変更します。
  3. 次のコマンドを実行してください :

CommerceStoreScaleUnitSetup.exe install --port 446 --SSLCertThumbprint "<SSL thumbprint of certificate created earlier>" --RetailServerCertThumbprint "<SSL thumbprint of certificate created earlier>" --AsyncClientCertThumbprint "<SSL thumbprint of certificate created earlier >" --AsyncClientAADClientID "<CSU Azure APP Client ID>" --RetailServerAADClientID "<CSU Azure APP Client ID>" --CPOSAADClientID "<CPOS Azure APP Client ID>" --RetailServerAADResourceID "<Application ID URI>" --Config "c:\temp\StoreSystemSetup.xml" --SkipSChannelCheck --trustSqlservercertificate

注記

  • これは開発コンピューターであるため、同じ SSL サムプリントを使用した全サービスの実行が許可されます。 実稼働環境とユーザー受け入れテスト (UAT) 環境では、これらの値は異なる必要があります。
  • インストール中に ポート 80 または 443 を入力しないでください。 これらの値のいずれかを入力すると、Commerce headquarters Web サイトをホストするアプリケーション オブジェクト サーバー (AOS) サービスが妨げられます。

クラウド (LCS) 展開された開発環境の追加手順

シールド CSU のインストール の設定手順では、CSU URL にアクセスする際に開発環境に RDP することを前提としています。 開発 VM の外部から開発環境シールド CSU にアクセスできるようにするには、次の追加タスクを実行する必要があります。

注記

外部のアクセス可能なリダイレクトは、Commerce バージョン 10.0.39 以前でのみテストされています。 この機能は、以前のレガシ (既定) Retail Server URL を、VM 上のシールド CSU にリダイレクトすることに基づいています。 この機能のサポートは、レガシ (既定) の Retail Server の削除に伴い、今後のバージョンで削除される予定です。

外部アクセス用のチャネルプロファイルを作成する

外部アクセス用のチャネル プロファイルを作成するには、次の手順に従います。

  1. headquarters で、小売りと Commerce > チャネルの設定 > チャネル プロファイル の順に移動し、新しいチャネル プロファイルを作成します。
  2. 次のプロパティ値を設定します:
    1. Retail Server の URL に https://<LCSEnvironmentName>devret.axcloud.dynamics.com/RetailServer/Commerce を入力してください。
    2. Cloud POS に https://<LCSEnvironmentName>devret.axcloud.dynamics.com/POS を入力します。
  3. 保存 を選択します。
  4. 小売とコマース > チャネル > 店舗 > すべての店舗 の順に移動します。
  5. 普段使用しているストア レコードを編集します。
  6. 作成した値の チャンネル プロフィール を更新します。
  7. 保存 を選択します。
  8. 小売りと Commerce > 小売りと Commerce IT > 配送スケジュール の順に移動し、1070 (チャネル構成) 同期ジョブを実行します。

Web サイトの IIS バインディングを更新する

レガシの Retail Server とシールド CSU の IIS バインディングは、リダイレクトをサポートするために更新する必要があります。

Web サイトの IIS バインドを更新するには、次の手順に従います。

  1. リモート デスクトップ プロトコル (RDP) を使用して開発マシンに接続します。
  2. IIS マネージャーを開いて サイト を展開します。
  3. RetailServer のWeb サイトを選択します。
  4. 画面の右側で、バインド を選択します。
  5. HTTPS バインドを選択し、編集 を選択します。
  6. ポート の値に「444」を設定します。
  7. ホスト名 には、後で使用するために URL 文字列値全体をコピーし、値を削除します。
  8. OK を選択します。
  9. 閉じるを選択します。
  10. RetailStoreScaleUnitWebsite.AspNetCore Web サイトを選択します。
  11. 画面の右側で、バインド を選択します。
  12. HTTPS バインドを選択し、編集 を選択します。
  13. ポート の値に「443」を設定します。
  14. ホスト名 に、先ほどコピーした URL 文字列値の ホスト名 を入力します。
  15. SSL証明書 に、下向き矢印を選択します。
  16. <LCS name>devaos.axcloud.dynamics.com で終わる SSL 証明書を選択します。
  17. OK を選択します。
  18. 閉じるを選択します。

UAT からのデータベースの復元

以前に シールド CSU のインストール の手順を使用してシールド CSU を設定し、その後別の環境から headquarters データベースを復元した場合は、シールド CSU を再び機能させるために次の手順を実行する必要があります。

  1. レコードを再作成するには、Commerce headquarters の更新 の手順に従います。

    注記

    チャネル データベース ID と チャネル プロファイル には、前回のインストールで使用したものと同じ値を使用する必要があります。 これらの値が以前のインストールと異なる場合は、インストーラーを再実行する必要があります。

  2. ダウンロード セッションをチェックして、ジョブが適用されているかどうかを確認してください。
    • ジョブが適用されている場合、CSU は動作しているため、インストーラーの手順を再実行する必要はありません。
    • ダウンロード ジョブが適用されない場合は、まず Windows イベント ログを調べて明らかなエラーがないかどうかを確認し、次にチャネル データベース フォームから新しい構成ファイルをダウンロードし、新しい構成ファイルを使用して CSU インストーラーを再実行します。

シールド CSU を新しいバージョンに更新する

シールド CSU を新しいバージョンに更新するには、シールド CSU インストーラー ファイルの新しいバージョンを取得し、最初にシールド CSU をインストールするために使用したのと同じコマンド ライン引数を実行します。