ノート
コミュニティの関心グループが Yammer から Microsoft Viva Engage に移行されました。 Viva Engage コミュニティに参加し、最新のディスカッションに参加するには、「 Finance and Operations Viva Engage Community へのアクセスを要求する 」フォームに入力し、参加するコミュニティを選択します。
この記事では、独立系ソフトウェア ベンダー (ISV) ライセンスをオンプレミス配置にインポートする方法について説明します。
重要
この記事で説明するプロセスは、プラットフォーム更新プログラム 12 以降でデプロイされているオンプレミス環境をお持ちのお客様のみが使用できます。
ISV ライセンスの利点、ソリューションのライセンスを有効にする方法に関する情報、自己署名証明書に関連するその他の情報については、 独立系ソフトウェア ベンダー (ISV) のライセンスを参照してください。
ライセンス ファイルの生成
ライセンスを発行する顧客のテナント名と ID を収集します:
- 環境がホストされている Service Fabric Explorer のインスタンスに接続します。
- Clusters>Applications>AXSFType>fabric:\AXSF に移動します。 右側のページで、[ 詳細 ] タブを選択します。
- パラメーター テーブルで License‑TenantDomainGuid および License_TenantDomainGuid キーの値を検索します。
顧客のライセンス (テナント ID と名前) を生成し、証明書のプライベート キーを使用してライセンスを登録します。 次のパラメーターを AXUtil genlicense コマンドに渡して、ライセンス ファイルを作成します。 このコマンドは XML ファイルを生成します。
パラメーター名 内容 ファイル ライセンス ファイルの名前。 licensecode Microsoft Visual Studio のライセンス コードの名前。 certificatepath 証明書のプライベート キーのパス。 パスワード 証明書のプライベート キーのパスワード。 顧客 顧客のテナント名。 serialnumber 顧客のテナント ID。 expirationdate オプション: ライセンスの有効期限。 usercount オプション: カスタム検証ロジックに必要となる可能性がある数値。 この数はユーザー数が可能ですが、ユーザーに限定されるものではありません。 コマンドの例を次に示します。
C:\AOSService\PackagesLocalDirectory\Bin\axutil genlicense /file:c:\templicense.txt /certificatepath:c:\tempisvcert.pfx /licensecode:ISVLicenseCode /customer:TAEOfficial.ccsctp.net /serialnumber:4dbfcf74-c5a6-4727-b638-d56e51d1f381 /password:********
自動インポート
必要条件
- この環境は、Microsoft Dynamics 365 Finance + Operations (オンプレミス) バージョン 10.0.31 以降で展開または処理されます。
- 配置可能パッケージには、運用環境用の独立系ソフトウェア ベンダ (ISV) ライセンス に記載されているライセンス ファイルが含まれています。
ライセンスのインポート
環境とデプロイ可能なパッケージが上記の前提条件を満たしている場合、環境にサービスを提供すると、ライセンスが自動的にインポートされます。 データベース同期の前に、ライセンスのインポート手順が完了します。 そのため、この操作に追加のダウンタイムは必要ありません。
手動インポート
必要条件
オンプレミス環境に ISV ライセンス ファイルをインポートする前に、次の前提条件が満たされていることを確認します。
- 環境をデプロイするときに、ローカル エージェントの最新バージョンを使用しました。
- プラットフォーム更新プログラム 12 で環境を展開し、プラットフォーム更新プログラム 12 のすべての修正プログラムを適用しました。 Microsoft が ISV ライセンス シナリオの修正プログラムをリリースしたため、この手順は必須です。 最新の修正プログラムを入手するには、Microsoft Dynamics Lifecycle Services の 環境の詳細 ページでタイルを使用します。
- ISV ライセンスをインポートする前に、環境がデプロイされ、アプリケーション オブジェクト サーバー (AOS) サービスが実行されています。
- ISV ライセンスをインポートする前に、ISV ソリューションをオンプレミス環境に適用します。 デプロイ フロー中に、ISV ソリューションをオンプレミス環境に適用できます。 または、Lifecycle Services の更新プログラムの適用 フローを使用して配置後の手順として ISV ソリューションを適用することができます。 ライセンスをインポートする前に ISV ソリューションを適用しないと、カスタマイズは有効になりません。
ライセンスのインポート
オンプレミス プロジェクトにデプロイするサンドボックス環境または運用環境には、次の手順を使用します。
ノート
ISV ライセンスをインポートするにはダウンタイムが必要です。 インポート中、ユーザーは環境内でビジネス トランザクションを実行できません。 ライセンスをインポートするときは、誰もシステムを使用していないことを確認し、すべてのユーザーに公式のダウンタイム通知を伝えます。
生成されたライセンスを fabric:/AXSF を実行するマシンのいずれかのフォルダーにコピーし、fabric:/AXSF が正常であることを確認します。
AOS コンピューターのいずれかから Import-LicensePackage.ps1 スクリプトを実行します。 このスクリプトは、Lifecycle Services の共有アセット ライブラリにあるモデル タブの最新の Microsoft Dynamics 365 Finance + Operations (on-premises)、配置スクリプト フォルダーにあります。 スクリプトに次のパラメーターを渡します。
- LicenseFilesPath – インポートするライセンス ファイルを含むフォルダーのパス。
- SqlUser – AOS を実行するために credentials.json ファイルで指定したのと同じユーザー。
- SqlPassword – SQL への接続に使用できるパスワード。
- EnvironmentConfigPath - 環境のコンフィギュレーション ファイル。 このファイルの名前は、config.json で、wp \< 環境名 >\ StandaloneSetup という形式のフォルダー内のエージェント共有の下にあります。
コマンドを実行すると、処理するライセンス ファイルごとにログ ファイルが生成されます。 ログ ファイルの名前は、{license_file_name}.output.log と {license_file_name}.error.log です。 データベース同期中に生成されるログは、dbsync.output.log および dbsync.error.log のような構造のファイルにあります。
ノート
インフラストラクチャ スクリプト 2.17.0 では、Import-LicensePackage.ps1 スクリプトは非推奨となり、自動フローが採用されました。 このスクリプトは、今後のリリースで削除される予定です。
スクリプトが正常に実行されたら、構成キーがインポートされ、有効になっていることを検証します。 製品では、対応する構成キーが使用可能で、[ ライセンス構成 ] ページで有効になっています。 既定では、コンフィギュレーションが有効です。 たとえば、ISVConfigurationKey1 という名前の構成キーを追加すると、構成キーの一覧に表示されます。
構成キーを有効にすると、ISV ソリューションの変更が製品に表示されます。