Dynamics 365 Finance + Operations (on-premises) への AX 2012 のデータ アップグレード プロセス

AX 2012 の Dynamics 365 Finance + Operations (on-premises) へのアップグレード

現在、サポートされているアップグレード方法は 2 つあります。

• [既存のアップグレード] Dynamics 365 Finance + Operations (on-premises) 環境 : この方法は、バージョン10.0.31以降でのみ使用できます。 アップグレードを終了してテストする場合に推奨される方法です。
• [/&システム内部からのアップグレード] : この方法には、データベースを仮想ハード ディスク (何も含む) にコピーして、これを行います。 全体的に、この方法は簡単です。
• データベースをポイントしている場所でアップグレードする : この方法は、データベースに対して、アップグレード プロセスを開始する必要があります。 アップグレード プロセスは、VHD 内から実行されます。

必要条件

1. 定期購読にプレビューします。
2. アップグレード前のチェックリストをインストールします。 詳細については、インストール を参照してください。
3. データ アップグレードの準備手順を実行します。 「ユーザー マッピングの設定」の手順はスキップできます。 この手順は、クラウドでホストされているアップグレードのみ関連しています。
4. データベースのバックアップを作成します (MicrosoftDynamicsAX)。 詳細については、「フル データベース バックアップの作成」を参照してください。

VHD 前提条件

データ アップグレードを実行する場合は、次の前提条件を確認する必要があります。

1. LCS で、ページの右側にあるタイルを選択して、共有アセット ライブラリに移動します。 資産タイプの選択の下のダウンロード可能な VHD を選択し、オンプレミス環境でアップグレードするバージョンに最も適合する VHD パッケージ全体をダウンロードします。 画像は大量のディスク容量を必要とします。 したがって、十分な空き領域のあるドライブでパッケージをダウンロードし、展開する必要があります。

2. ダウンロードしたファイルは、自己展開する zip ファイルです。 十分な空き容量が確保されている場所に VHD を展開してください。

3. Hyper-V を使用して、仮想マシン (VM) を開始し、VHD を接続します。 (VM はジェネレーション 1 である必要があります。)

4. VM に接続します。 資格情報の詳細については、ローカルで仮想マシン (VM) を実行する を参照してください。

5. オンプレミスで予定されている 10.0.x のターゲット バージョンとダウンロードした VHD イメージによっては、 共有アセット ライブラリから必要なアプリケーション更新プログラムとプラットフォーム更新プログラムをダウンロードして適用することが必要となる場合があります。 アセット タイプの選択で、ソフトウェア配置可能パッケージを選択します。 詳細な情報については、コマンド ラインからの配置可能なパッケージのインストール を参照してください。

   重要

   いずれの場合でも、最新の品質更新プログラムが VHD に適用されていることを確認し、データ アップグレードを実行するための最新の修正プログラムが含まれていることを確認してください。

6. 拡張機能またはカスタマイズがある場合、今 VHD にインストールしてください。 それ以外の場合、アップグレード プロセスは、カスタマイズに関連するデータをすべて削除します。 アップグレードの前に、環境を準備する必要がある場合、独立系ソフトウェア ベンダー (ISV) または付加価値再販業者 (VAR) に確認します。

Dynamics 365 Finance + Operations (on-premises) 前提条件

データ アップグレードを実行するのに Dynamics 365 環境を使用する場合は、次の前提条件が満たされている必要があります。

1. バージョン 10.0.31以降の Dynamics 365 Finance + Operations (on-premises) 環境は、デモ データ バックアップを使用して展開されます。
2. 最新の品質更新が環境に適用されています。
3. 拡張機能またはカスタマイズがある場合、すぐに環境に適用してください。 それ以外の場合、アップグレード プロセスは、カスタマイズに関連するデータをすべて削除します。 アップグレードの前に、環境を準備する必要がある場合、独立系ソフトウェア ベンダー (ISV) または付加価値再販業者 (VAR) に確認します。

Dynamics 365 Finance + Operations (on-premises) 環境からのアップグレード

1. Service Fabric Explorer を使用して、すべての Application Object Server (AOS) ノードおよび Management Reporter (MR) ノードを無効にします。

   ヒント

   一度に 1 つのノードを無効にします。 最後のノードを無効にした場合、Azure Service Fabric はそのノード タイプに割り当てられたサービスを別のノードに入れ子にできるようにします。 ただし、他のノードを使用できないので、Service Fabric ではノードを無効にできません。 したがって、Service Fabric Explorer から最後のノードを再起動して、操作を強制する必要があります。 再起動後、ノードは無効になります。

2. 既存のデモ データ データベースを削除します。

3. 作成したバックアップを、既存のデモ データベースと同じ名前で復元します。 詳細については、「SSMS を使用したデータベース バックアップの復元」を参照してください。

4. 管理者特権モードで Windows PowerShell を開き、ファイル共有のインフラストラクチャ フォルダーに移動して、次のコマンドを実行します。

   .\Initialize-Database.ps1 -ConfigurationFilePath .\ConfigTemplate.xml -ComponentName AOS
   .\Configure-Database.ps1 -ConfigurationFilePath .\ConfigTemplate.xml -ComponentName AOS
   

5. 復元したデータベースに対して次の SQL コマンドを実行します。

   MERGE [dbo].[SQLSYSTEMVARIABLES] AS VARIABLES
   USING (values('RUNDATAUPGRADE', '1', 20, NULL)) as NEWVALUE (PARM, VALUE, IPARM, IVALUE)
   ON (VARIABLES.PARM = NEWVALUE.PARM)
   WHEN NOT MATCHED THEN
       INSERT (PARM, VALUE, IPARM, IVALUE)
       VALUES (NEWVALUE.PARM, NEWVALUE.VALUE, NEWVALUE.IPARM, NEWVALUE.IVALUE);
   

6. Service Fabric Explorer を使用して、AOS ノードの 1 つを有効にします。

7. AOS ノードが有効化され、サービスが開始されると、データ アップグレード プロセスが自動的にトリガーされます。 データ アップグレード プロセスを監視するには、データ アップグレードの監視のガイダンスを使用します。

8. データのアップグレードが失敗すると、サービス ログ フォルダー内にデータ アップグレード ログが格納されます。 パスは次の例のようになります。

   C:\ProgramData\SF\<nodename>\Fabric\work\Applications\AXSFType_App95\log

9. データ アップグレードがうまくいった後、ISV または VAR からカスタマイズする場合は、いくつかの投稿データのアップグレード スクリプトを実行する必要があるかどうかを確認します。

10. 残りの AOS ノードと MR ノードを再び有効にします。

VHD 内からアップグレードする

1. Onebox VM に作成したバックアップを復元します。 詳細については、「SSMS を使用したデータベース バックアップの復元」を参照してください。

2. オプション: 復元したデータベースの名前が axdb でない場合、管理者として Windows PowerShell を開き、次のスクリプトを実行します。

   .\Configure-On-Premises-Upgrade.ps1 -DatabaseName '<DB-name>'
   

   メモ

   • 以前の PowerShell スクリプトは、この記事の付録で提供されています。
   • <DB-name> をデータベースの名前 (AXDB など) で置き換えます。 多くの値を編集する場合、この記事の付録を参照してください。

   スクリプトは、データベース接続のテストを実行し、入力した情報が有効であることを検証します。

3. LCS では、共有アセット ライブラリに移動します。 アセット タイプの選択でソフトウェア配置可能パッケージを選択し、AX2012DataUpgrade-10-0-x を選択して、MajorVersionDataUpgrade.zip をダウンロードします。

4. ファイルをコピーして目的の場所に貼り付け (c:\D365FFOUpgrade\ など)、展開します。

5. 管理者として PowerShell ウィンドウを開き、展開したフォルダーへディレクトリを変更して、次のコマンドを実行します。

   .\AXUpdateInstaller.exe generate -runbookid="MajorVersionDataUpgrade-runbook" -topologyfile="DefaultTopologyData.xml" -servicemodelfile="DefaultServiceModelData.xml" -runbookfile="MajorVersionDataUpgrade-runbook.xml"
   .\AXUpdateInstaller.exe import -runbookfile="MajorVersionDataUpgrade-runbook.xml"
   .\AXUpdateInstaller.exe execute -runbookid="MajorVersionDataUpgrade-runbook"
   

   メモ

   アップグレードを監視する方法の詳細については、この記事の付録のデータ アップグレードの監視セクションを参照してください。

6. アップグレード プロセスが正常に完了した後、新たにアップグレードしたデータベースをバックアップします。 ISV または VAR からカスタマイズする場合は、いくつかの投稿データのアップグレード スクリプトを実行する必要があるかどうかを確認します。

7. データベースをオンプレミス環境の SQL Server に復元し、AX 2012 データベースの名前とは異なる名前 (AXDBupgraded など) を付けます。 復元したデータベースはコンフィギュレーションする必要があります。 Finance + Operations (on-premises) データベースを構成 の手順に従います。

8. 新しい Dynamics 365 Finance + Operations (on-premises) 環境の配置。

   • カスタマイズがある場合、次の手順に従います。

     1. LCS では、共有アセット ライブラリに移動します。

     2. 資産タイプの選択の下で、モデルを選択し、Dynamics 365 Finance + Operations on-premises のバージョン 10.0.x デモ データをダウンロードします。 オンプレミスのベースラインとして展開する 10.0.x 環境に最も近いバージョンを選択します。

     3. このファイルから新しいデータベースを作成するのには、SQL Server に対して復元バックアップ オプションを使用します。 (通常、このデータベースには AXDB という名前が付けられます。) 詳細については、SSMS を使用したデータベース バックアップの復元 を参照してください。

     4. デモ データベースはコンフィギュレーションする必要があります。 Finance + Operations (on-premises) データベースを構成 の手順に従います。

     5. LCS で新しい環境を設定し、バージョン 10.0.x で配置します。 詳細については、 オンプレミス環境の設定と配置 (プラットフォーム更新プログラム 12 以降) を参照してください。 環境を配置する場合、事前に作成したデータベースの名前 (通常は AXDB) を指定する必要があります。

     6. 新たに作成した 10.0.x 環境と ISV および VAR モジュールにカスタマイズを適用します。 それ以外の場合、この環境が最初にデータベースと同期される時、カスタマイズ関連または拡張機能関連のデータが削除されます。

     7. オンプレミスの Application Object Server (AOS)、ビジネス インテリジェンス (BI)、および Management Reporter (MR) サーバーをシャットダウンするか、または無効化 (再起動) を選択して、Azure Service Fabric ポータルからサービスを停止します。

     8. 名前を変更するか、配置で使用したデモ データベース (通常は AXDB) を削除して、新しいデータベース (通常は AXDBupgraded) の名前を、デモ データベースが使用していた名前 (通常は AXDB) に変更します。

     9. 名前を変更したデータベースはコンフィギュレーションする必要があります。 Finance + Operations (on-premises) データベースを構成 の手順に従います。

     10. オンプレミス AOS、BI、および MR サーバーを開始するか、または有効化を選択して Service Fabric ポータルからサービスを開始します。

         メモ

         AOS ノードの開始時にデータベースの同期プロセスがトリガーされますが、プロセスが完了するまで環境は使用できません。

   • カスタマイズがない場合、次の手順に従います。

     1. オプション: 既存のデータベース (通常は AXDBold) の名前を変更し、新しいデータベース (通常は AXDB) の名前を変更します。 次の手順で、アップグレードされたデータベース名の入力を確認します。
     2. LCS にて、新たな環境を設定し、バージョン 10.0.x (再展開) を展開します。 詳細については、オンプレミス環境での設定と配置を参照してください。

VHD がデータベースをポイントする場所でアップグレードする

1. オンプレミス環境 (通常は AXDB) から、データベースをバックアップします。 詳細については、「フル データベース バックアップの作成 (SQL Server)」を参照してください。

2. 先ほど作成したバックアップをデータベース サーバーを復元し、別の名前 (AXDBtoupgrade など) を付けます。 詳細については、「SSMS を使用したデータベース バックアップの復元」を参照してください。

3. 管理者として Windows PowerShell を開き、次のスクリプトを実行します。

   .\Configure-On-Premises-Upgrade.ps1 -DatabaseName '<DB-name>' -DatabaseServer '<SqlServerName>' -DatabaseUser '<User>' -DatabasePassword '<Password>'
   

   メモ

   • 以前の PowerShell スクリプトは、この記事の付録で提供されています。
   • <DB-name>、<SqlServerName>、<User>、および <Password> を必要な値に置換します。
   • SQL Server 認証のみが、このアップグレードで正式にサポートされます。 詳細については、「データベース ユーザーの作成」を参照してください。
   • SQL Server 証明書に署名した証明機関の証明書を、OneBox VHD の信頼された証明機関ストアに追加する必要があります。 詳細については、「信頼されたルート証明書をインストールする」を参照します。
   • 使用するデータベースのユーザーに、sysadmin サーバー ロールが割り当てられているか、またはアップグレードするデータベースに少なくともすべての特権があるかを確認します。 また、ユーザーに tempDB にアクセスするためのアクセス許可があることを確認します。 これらの条件を満たしていない場合、アップグレード プロセスのステップ 6 は失敗します。
   • 証明機関の証明書を OneBox VHD にインストールする場合、そこに表示されるデータベースへ接続するには完全修飾ドメイン名 (FQDN) または IP アドレスを使用してください。 サーバーを指していないため、ドメイン名を使用してデータベースにアクセスできない場合は、ホスト ファイルを編集して FQDN が解決する必要がある FQDN と IP アドレスを追加します。

4. LCS では、共有アセット ライブラリに移動します。 アセット タイプの選択でソフトウェア配置可能パッケージを選択し、AX2012DataUpgrade-10-0-x を選択して、MajorVersionDataUpgrade.zip をダウンロードします。

5. ファイルをコピーして目的の場所に貼り付け (c:\D365FFOUpgrade\ など)、展開します。

6. 管理者として PowerShell ウィンドウを開き、展開したフォルダーへディレクトリを変更して、次のコマンドを実行します。

   .\AXUpdateInstaller.exe generate -runbookid="MajorVersionDataUpgrade-runbook" -topologyfile="DefaultTopologyData.xml" -servicemodelfile="DefaultServiceModelData.xml" -runbookfile="MajorVersionDataUpgrade-runbook.xml"
   .\AXUpdateInstaller.exe import -runbookfile="MajorVersionDataUpgrade-runbook.xml"
   .\AXUpdateInstaller.exe execute -runbookid="MajorVersionDataUpgrade-runbook"
   

   メモ

   アップグレードを監視する方法の詳細については、この記事の付録のデータ アップグレードの監視セクションを参照してください。

7. ISV または VAR からカスタマイズする場合は、いくつかの投稿データのアップグレード スクリプトを実行する必要があるかどうかを確認します。

8. この記事の後半にある VHD データベースのリセット (オプション) セクションで記述されている値を使用して Configure-OnpremUpgrade.ps1 スクリプトを実行します。

9. Finance + Operations (on-premises) データベースの構成 の手順に従って、Finance + Operations に対してアップグレードしたデータベースを構成します。

10. 新しい Dynamics 365 Finance + Operations (on-premises) 環境の配置。

    • カスタマイズがある場合、次の手順に従います。

      1. LCS では、共有アセット ライブラリに移動します。

      2. 資産タイプの選択の下で、モデルを選択し、Dynamics 365 Finance + Operations on-premises のバージョン 10.0.x デモ データをダウンロードします。 オンプレミスのベースラインとして展開する 10.0.x 環境に最も近いバージョンを選択します。

      3. SQL Server に対して復元バックアップ オプションを使用して、このファイルから新しいデータベース (通常は AXDB) を作成します。 詳細については、「SSMS を使用したデータベース バックアップの復元」を参照してください。

      4. デモ データベースはコンフィギュレーションする必要があります。 Finance + Operations (on-premises) データベースを構成 の手順に従います。

      5. LCS にて、新たな環境を設定し、バージョン 10.0.x (再展開) を展開します。 詳細については、オンプレミス環境での設定と配置を参照してください。 環境を配置する場合、事前にコンフィギュレーションしたデータベースの名前 (通常は AXDB) を指定する必要があります。

      6. 新たに作成した 10.0.x 環境と ISV および VAR モジュールにカスタマイズを適用します。 それ以外の場合、この環境が最初にデータベースと同期される時、カスタマイズ関連または拡張機能関連のデータが削除されます。

      7. オンプレミス AOS、BI、および MR サーバーをシャットダウンするか、または Service Fabric ポータルからサービスを停止します。

      8. 名前を変更するか、配置で使用したデモ データベース (通常は AXDB) を削除して、新しいデータベース (通常は AXDBupgraded) の名前を、デモ データベースが使用していた名前 (通常は AXDB) に変更します。

      9. オンプレミス AOS、BI、および MR サーバーを開始するか、または Service Fabric ポータルからサービスを開始します。

         メモ

         AOS ノードの開始時にデータベースの同期プロセスがトリガーされますが、プロセスが完了するまで環境は使用できません。

    • カスタマイズがない場合、次の手順に従います。

      1. オプション: 既存のデータベース (通常は AXDBold) の名前を変更し、新しいデータベース (通常は AXDB) の名前を変更します。 次の手順で、アップグレードされたデータベース名の入力を確認します。
      2. 新しい環境を設定し、バージョン 10.0.x で配置します。 詳細については、オンプレミス環境での設定と配置を参照してください。

既存のユーザーのコンフィギュレーション

以前の手順のいずれかに従った場合、LCS で指定した管理者ユーザーを使用してサインインできます。 ただし、他のユーザーは、新しいシステム用にコンフィギュレーションされるまで、サインインできません。 USERINFO テーブルに対して Select ステートメントを実行し、管理者ユーザーの NETWORKDOMAIN フィールドの値 (https://adfs.contoso.com/adfs または http://adfs.contoso.com/adfs/services/trust など) をメモしておき ます。 サインインできる必要のあるすべての対話型ユーザーについて、NETWORKDOMAIN フィールドに管理者ユーザーと同じ値を設定します。 NETWORKALIAS フィールドも変更する必要があります。 Finance + Operations において、このフィールドにはユーザーの電子メールアドレス (testuser@contoso.com など) が設定され ます。

VHD データベースのリセット (オプション)

Configure-On-Premises-Upgrade.ps1 スクリプトを使用した場合、次のコマンドを実行してデータベースを既定のコンフィギュレーションにリセットします。

.\Configure-OnPremUpgrade.ps1 -DatabaseName 'AxDB' -DatabaseServer 'localhost' -DatabaseUser 'axdbadmin' -DatabasePassword 'AOSWebSite@123'

付録

Configure-On-Premises-Upgrade.ps1 スクリプトを使用する

必要に応じて、DatabaseServer または DatabaseUser などの追加のパラメーターを渡すことができます。 ただし、この場合は、スクリプトはすべての追加のパラメーターを要求します。 この現象は、スクリプトが VM 外のマシンにデータベース接続を指定する必要があると想定するために発生します。 したがって、これらのパラメータは接続を正しく確立するのに必要です。

次のパラメーターをスクリプトに渡することができます。

• -DatabaseName : アップグレードするデータベースの名前。
• [< データベース サーバー] : Finance + Operationsデータベースが格納されているデータベース サーバー。
• -DatabaseUser : #サーバー認証のSQL名。
• -Database大都市 : SQL認証用のパスワード。

コンフィギュレーションが渡された後、スクリプトは新しいパラメーターを使用してデータベース接続のテストを実行します。 スクリプトがデータベースに接続できない場合は、SQL Server Management Studio または別のツールを使用して、接続をデバッグすることをお勧めします。

インストール後のアップグレードの構成

<#
.Synopsis
    Configures a OneBox deployment to upgrade an OnPrem 7.x database to OnPrem 10.0.x 

.DESCRIPTION
    This must be executed before the upgrade process is carried out.

.EXAMPLE
    .\Configure-OnPremUpgrade.ps1 -DatabaseName 'AxDB'

    .\Configure-OnPremUpgrade.ps1 -DatabaseName 'AxDB' -DatabaseServer '127.0.0.1' -DatabaseUser 'axdbadmin' -DatabasePassword 'secretPass'
#>
[CmdletBinding()]
param
(
    # Database server containing Microsoft Dynamics 365 for Operations, on-premises database.
    [AllowNull()]
    [string] $DatabaseServer,

    # Database name that you want to upgrade.
    [Parameter(Mandatory = $true)]
    [string] $DatabaseName,

    # Username for SQL Authentication.
    [AllowNull()]
    [string] $DatabaseUser,

    # Password for SQL Authentication.
    [AllowNull()]
    [string] $DatabasePassword
)

$webroot = "C:\AOSService\webroot"

$commandParameter = " -decrypt `"$webroot\web.config`""

$command = Resolve-Path "$webroot\bin\Microsoft.Dynamics.AX.Framework.ConfigEncryptor.exe"

Start-Process $command $commandParameter -PassThru -Wait

if([string]::IsNullOrEmpty($DatabaseUser) -and [string]::IsNullOrEmpty($DatabasePassword) -and [string]::IsNullOrEmpty($DatabaseServer)) { 

    [xml]$web = Get-Content $webroot\web.config

    $web.SelectSingleNode("configuration/appSettings/add[@key='DataAccess.Database']").value = [string]$DatabaseName

}
else { 

    if([string]::IsNullOrEmpty($DatabaseServer)){

        $DatabaseServer = if($value = Read-Host 'What is the IP or FQDN of the Database server? [127.0.0.1]') {$value} else {'127.0.0.1'}

    }

    if([string]::IsNullOrEmpty($DatabaseUser)){

        $DatabaseUser = if($value = Read-Host 'What is the SQL Authentication username? [axdbadmin]') {$value} else {'axdbadmin'}

    }

    if([string]::IsNullOrEmpty($DatabasePassword)){

        $dbPassEn = if($value = Read-Host 'What is the SQL Authentication password?' -AsSecureString) {$value} else {''}

        $BSTR = [System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($dbPassEn) 

        $DatabasePassword = [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($BSTR)

    } 

    [xml]$web = Get-Content $webroot\web.config

    $web.SelectSingleNode("configuration/appSettings/add[@key='DataAccess.DbServer']").value = [string]$DatabaseServer

    $web.SelectSingleNode("configuration/appSettings/add[@key='DataAccess.Database']").value = [string]$DatabaseName

    $web.SelectSingleNode("configuration/appSettings/add[@key='DataAccess.SqlUser']").value = [string]$DatabaseUser

    $web.SelectSingleNode("configuration/appSettings/add[@key='DataAccess.SqlPwd']").value = [string]$DatabasePassword

}
#Save Configuration to webroot config
$web.Save("$webroot\web.config")

#Reloading the configuration to run test
[xml]$web = Get-Content $webroot\web.config

$TestDbServer = $web.SelectSingleNode("configuration/appSettings/add[@key='DataAccess.DbServer']").value

$TestDbName = $web.SelectSingleNode("configuration/appSettings/add[@key='DataAccess.Database']").value

$TestDbUser = $web.SelectSingleNode("configuration/appSettings/add[@key='DataAccess.SqlUser']").value

$TestDbPass = $web.SelectSingleNode("configuration/appSettings/add[@key='DataAccess.SqlPwd']").value

#Setting up connection test.

$dbConn = New-Object System.Data.SqlClient.SqlConnection

$dbConn.ConnectionString = "Data Source=$TestDbServer;User ID=$TestDbUser;Password=`"$TestDbPass`";Database=$TestDbName"

try{

    $dbConn.Open()

    $result = $true

}

catch{

    $result = $_.Exception.Message

}
Finally{

    $dbConn.Close()

}

$commandParameter = " -encrypt `"$webroot\web.config`""

Start-Process $command $commandParameter -PassThru -Wait

if($result -ne $true){

    Write-Host "`nThe connection to the Database Server failed:" -ForegroundColor Red
    Write-Host $result -ForegroundColor Red

}
else{

    Write-Host "`nThe connection to the Database Server was successful!" -ForegroundColor Green

}

データ アップグレードの監視

配置可能パッケージには、アップグレード全体を処理する 1 つ のRunbook ステップがあります。 ただし、このステップはバックグラウンドで実行される次のサブステップで構成されます。

• PreReq – この手順は、SQL ディクショナリを構成し、システム シーケンスではなく SQL 順序を適用し、ユーザー情報とシステム変数を変更し、システム テーブルのデータベース同期を行い、新しいテーブルの機能を同期化します。
• PreSync – 最初のアップグレード ジョブ セットをバッチ処理によって呼び出す場合、主に固有インデックスを無効にします。
• DBSync – この手順では、最初の完全同期が実行されます。 PreSync ステップ中に無効となった固有のインデックスは、この手順で作成されません。
• PostSync – この手順では、メイン データ変換ジョブをバッチ処理経由で実行します。
• FinalDBSync – この手順では、データベースの残りの全オブジェクトを同期化する最終的なデータベース同期を行います。

アップグレード サービスの実行手順を決定するために、AXDB データベースで次の SQL クエリを実行できます。

SELECT StartTime, EndTime, Steps, SubSteps, Status
FROM [DBUPGRADE].[DATAUPGRADESTATUS]
ORDER BY EndTime DESC

結果は次の例のようになります。 ここで指定された日時は、説明用のみに使用されます。 この時間は、データ量および AX 2012 年に使用されるモジュールによって異なります。

トラブルシューティング

データベース接続問題

• "0" 引数を使用した "Open" の呼び出しで例外が発生しました: 「ログインによって要求されたデータベース「AxDB1」を開くことはできません。 ログインに失敗しました。 ユーザー 'axdbadmin' のログインが失敗しました。」データベース名が間違っている、またはユーザーにデータベースへのアクセスがありません。
• "0" 引数を使用した "Open" の呼び出しで例外が発生しました: SQL Server への接続の確立中に、ネットワーク関連またはインスタンス固有のエラーが発生しました。 サーバーが見つからない、またはアクセスできませんでした。 インスタンス名が正しいかを確認し、さらに SQL Server が構成されリモート接続が許可されていることを確認します。 (プロバイダー: 名前付きパイプ プロバイダー、エラー: 40 - SQL Server への接続を開けませんでした)。 スクリプトは、指定された SQL Server との接続を確立できませんでした。 使用した IP/FQDN およびポートを確認します。
• "0" 引数を使用した "Open" の呼び出しで例外が発生しました: 「ユーザー 'axdbadmin' のログインが失敗しました。」指定されたログイン資格情報が正確ではありません。

失敗後、Runbook を再実行

データ アップグレードの Runbook が失敗した場合は、次の例に示すように、-rerunstep オプションを使用して最後のステップを再試行できます。 必要に応じてステップ番号を編集します。

.\AXUpdateInstaller.exe execute -runbookid="MajorVersionDataUpgrade-runbook" -rerunstep=3

Runbook ログを確認

ログは、配置可能パッケージの下のサブフォルダに格納されます。 現在の Runbook ステップのログを見つけるログ フォルダを表示し、エラーを確認します。

PreSync アップグレード ジョブまたは PostSync アップグレード ジョブに関する詳細の表示

アップグレード PreSync と PostSync スクリプトは、データ アップグレードのプロセスが開始しているバッチ プロセスを使い、X++ by で実行します。 Visual Studio のアプリケーション エクスプローラーでは、表示できる一部のクラスの前に ReleaseUpdate が付いています。 Runbook プロセス中にアップグレード スクリプトが失敗した場合、SQL Server Management Studio を開き、次のコードを実行して ReleaseUpdateScriptsErrorLog をクエリすることでエラーの原因をさらに確認できます。

select * from RELEASEUPDATESCRIPTSERRORLOG

追加リソース

トラブルシューティングについては、次の記事を参照してください。

• アップグレード中の開発環境のトラブルシューティング
• PreSync と PostSync アップグレード スクリプトのトラブルシューティング