メンテナンス モード
この記事では、財務と運用アプリのメンテナンス モードについて説明します。 メンテナンス モードを有効にすると、システム機能に影響を与える可能性のあるシステム変更を、システム管理者が安全に実行する方法が提供されます。 たとえば、コンフィギュレーション キーは、有効または無効にすることができます。 メンテナンス モードがオンのとき、システム管理者および メンテナンス モード ユーザー ロールを持つユーザーのみがシステムにサインインすることができます。 既定では、メンテナンス モードがオフになっています。 メンテナンス モードがオフのとき、ライセンス コンフィギュレーション ページを編集することはできません。
メモ
環境でメンテナンス モードを有効にした後は、対話型の AOS と非対話型 AOS (バッチ AOS) を 1 つしか使用できません。
Lifecycle Services を通じてサンドボックスおよび運用環境でメンテナンス モードを有効または無効にする
サンドボックスおよび運用環境で、Microsoft Dynamics 365 Lifecycle Services を通じて直接メンテナンス モードを有効または無効にできます。
Lifecycle Services を通じて直接メンテナンス モードを有効または無効にするには、次の手順に従います。
- 環境の詳細ページに移動し、 メンテナンス メニューで メンテナンス モードの有効化 をクリックします。
- スライダーで、環境の メンテナンス モードを有効にする を設定し、確認 を選択します。
- サービス工程が開始され、システムがメンテナンス モードになります。
- 完了時、環境の状態が メンテナンス中 になります。 この時点では、システム管理者だけが環境にアクセスできます。
- システム全体の変更を完了後、 メンテナンス メニューの メンテナンスモードの無効化 をクリックすることで、メンテナンス モードをオフにすることができます。
- サービス操作が開始され、環境がメンテナンス モードから解除されます。 環境の詳細ページで、工程の進捗状況を確認できます。
- これが完了すると、環境が 配置中 状態に戻ります。 すべてのユーザーが環境にログオンできるようになりました。
- メンテナンス モードが有効または無効かを環境の履歴ページで確認することができます。 環境履歴ページに移動するには環境の詳細ページで 履歴 および 環境の変更 を選択します。
サンドボックスおよび運用環境のメンテナンス モードをオン/オフにする操作と、サービス操作に似ています。 メンテナンス モードのオンまたはオフに失敗した場合は、再開、ロールバック、および 中止 などのオプションが表示されます。 操作に失敗した理由をトラブルシューティングするためにログをダウンロードすることもできます。
顧客のサブスクリプションで動作している開発テスト環境またはデモ環境にてメンテナンス モードをオンにする/オフにする
開発者のマシンに RDP の接続を確立します。
開発者のマシンで、Lifecycle Services から axdbadmin ユーザーの資格情報を使用して SQL Server にサインインします。 次に、AXDB データベースに切り替えて、次のコマンドを実行します。
update SQLSYSTEMVARIABLES SET VALUE = 1 where PARM = 'CONFIGURATIONMODE'World Wide Web 公開サービス を再起動して IIS をリセットします。
サービスが再起動されると、システムはメンテナンス モードになります。
メンテナンス モードの活動を完了したら、ステップ 2 および 3 を繰り返しますが、値はステップ 2 で 0 に設定します。
顧客がホストする VHD ベース環境でメンテナンス モードのオン/オフを切り替える
次のコマンドを実行して、メンテナンス モードをローカルでオンにすることができます。
メモ
一部の仮想マシン (VM) では、Deployment.Setup.exe ツールの正確な場所が異なる場合があります。 AosServiceWebRootbin を確認してください。
J:\AosService\PackagesLocalDirectory\Bin\Microsoft.Dynamics.AX.Deployment.Setup.exe --metadatadir J:\AosService\PackagesLocalDirectory --bindir J:\AosService\PackagesLocalDirectory\Bin --sqlserver . --sqldatabase axdb --sqluser axdbadmin --sqlpwd ********* --setupmode maintenancemode --isinmaintenancemode true
コマンドを実行した後、World Wide Web 公開サービスを再起動して、IIS をリセットします。 システムはメンテナンス モードになります。
次のテーブルに、このコマンドで使用されるパラメーターを示します。
| パラメーター名 | 説明 |
|---|---|
| --setupmode maintenancemode | システムをメンテナンス モードにするかメンテナンス モードを解除するかをセットアップ ツールに通知するには、このパラメーターを使用します。 |
| --metadatadir | メタデータ ディレクトリ を指定するには、このパラメーターを使用します。 既定のパッケージ ディレクトリを使用する必要があります。 |
| --bindir | バイナリ ディレクトリ を指定するには、このパラメーターを使用します。 既定のパッケージ ディレクトリを使用する必要があります。 |
| --sqlserver | このパラメーターを使用して Microsoft SQL Server を指定します。 1 ボックス環境では、ピリオド (.) を使用します。 |
| --sqluser | SQL Server のユーザーを指定するには、このパラメーターを使用します。 AOSUser を使用する必要があります。 |
| --sqlpwd | SQL Server のパスワードを指定するには、このパラメーターを使用します。 |
| --isinmaintenancemode | 構成モードを有効または無効にするには、このパラメーターを使用します。 オンにするには true とし、オフにするには false にします。 |
Finance + Operations (on-premises) 環境でのメンテナンス モードのオン/オフの切り替え
少なくともバージョン 2.18.2 のインフラストラクチャ スクリプトがあるようにします。 スクリプトの取得に関する詳細については、Finance + Operations (on-premises) 配置のインフラストラクチャ スクリプトの取得を参照してください。
- メンテナンス モードを有効にするには、Service Fabric Cluster 内の任意のノードから次のスクリプトを実行します。
.\Set-MaintenanceMode.ps1 -ConfigurationFilePath .\ConfigTemplate.xml -Enable
重要
スクリプトにより、すべての Application Object Server (AOS) インスタンスが再起動します。
- AOS インスタンスが再度実行された後、システムがメンテナンス モードになります。
- メンテナンス モードの活動を完了したら、Service Fabric Cluster 内の任意のノードから次のスクリプトを実行します。
.\Set-MaintenanceMode.ps1 -ConfigurationFilePath .\ConfigTemplate.xml -Disable
コンフィギュレーション キーの有効化 (または無効化)
Application Object Server (AOS) のインスタンスを再起動すると、システムはメンテナンス モードになります。 次のスクリーンショットに示すように、構成キーを有効にすることができます。
メンテナンス モードになっている際にシステムへアクセスしようとすると、システム管理者またはメンテナンス モード ユーザー ロールを持つユーザーではない人が、Finance and Operations にアクセスしようとすると、エラー メッセージが表示されることがあります。
次のコマンドを実行して、メンテナンス モードをオフにすることができます。
J:\AosService\PackagesLocalDirectory\Bin\Microsoft.Dynamics.AX.Deployment.Setup.exe --metadatadir J:\AosService\PackagesLocalDirectory --bindir J:\AosService\PackagesLocalDirectory\Bin --sqlserver . --sqldatabase axdb --sqluser axdbadmin --sqlpwd ********* --setupmode maintenancemode --isinmaintenancemode false
コマンドを実行した後、World Wide Web 公開サービスを再起動して、IIS をリセットします。 システムがメンテナンス モードではなくなります。
注記
層 1 (クラウドホスト) 環境を使用する場合は、データベースの完全同期 (DBSync) を実行し、Microsoft Visual Studio を使用して保守モードを完了する必要があります。