オンプレミス環境のインプレースアップグレードプロセス

[アーティクル]
03/08/2023

この記事では、Finance + Operations (on-premises) のバージョン 7.x のオンプレミス環境を 10.0.x にアップグレードする詳細プロセスを説明します。

メモ

運用環境のアップグレードを実行する前に、サンドボックス環境のアップグレードを実行してください。

バージョン7. x から10.0. x へのオンプレミスのアップグレード

メモ

このアップグレードプロセスは完了に時間がかかり、データアップグレード中はずっと Finance + Operations が使用できなくなります。

7.x から 10.0.x にアップグレードするにあたって、現在対応している可能性のある 2 つのパスがあります。

各パスの概要は下に記載されています。

VHD 内からのアップグレード - このパスは、仮想ハードディスク (VHD) に、データベースをコピーし、その中のアップグレードを実行します。全体的に、この方法はよりシンプルです。
データベースを指す VHD でアップグレード - このパスは VHD アップグレードプロセスをデータベースにポイントします。アップグレードプロセスは、VHD 内からも実行されます。

メモ

VHD では、アップグレードプロセスを実行するために外部のネットワークアクセス権は必要ありません。

必要条件

Lifecycle Services (LCS) では、共有資産ライブラリ (画面の右側にある) に移動します。
資産タイプの選択 で、ダウンロード可能な VHD を選択し、オンプレミス環境でアップグレードする VHD パッケージ全体をダウンロードします。イメージには大量のディスク領域が必要となるため、十分な空き領域のあるドライブにダウンロードして展開してください。
ダウンロードしたファイルは、自己展開する zip ファイルです。十分な空き容量が確保されている場所にに VHD を展開してください。
Hyper-V を使用して、仮想マシン (VM) を起動し、VHD を接続します。 (マシンはジェネレーション 1 である必要があります。)
VM に接続します。資格情報を仮想マシン (VM) をローカルで実行から見つけることができます。
オンプレミスで予定されている 10.0.x のターゲットバージョンとダウンロードした VHD イメージによっては、 アセットタイプの選択 と ソフトウェアで展開可能なパッケージ 配下にある共有アセットライブラリから必要なアプリケーションとプラットフォーム更新プログラムをダウンロードして適用することが必要となる場合があります。詳細な情報については、コマンドラインからの配置可能なパッケージのインストールを参照してください。
拡張機能やカスタマイズを VHD にインストールしている場合は、アップグレードプロセスによって、カスタマイズに関連するデータが削除されます。アップグレード前に、環境を準備する必要がある場合は、独立系ソフトウェアベンダー (ISV) または付加価値再販業者 (VAR) に確認します。

VHD 内からのアップグレード

オンプレミス AOS、BI、および MR サーバーをシャットダウンするか、または各ノードで Service Fabric Host Service を停止し、無効にします。
オンプレミス環境 (通常は AXDB) から、データベースをバックアップします。詳細については、「フルデータベースバックアップの作成」を参照してください。
VHD で C:\AOSService\PackagesLocalDirectory\Bin\CustomDeployablePackage に移動し、MinorVersionDataUpgrade zip ファイルをコピーします。
任意の場所にファイルを貼り付け、展開します。たとえば、c:\D365FFOUpgrade\ です。
管理者としてコマンドプロンプトを開き、手順 4 で展開していないフォルダーへディレクトリを変更します。
Onebox VM に作成したバックアップを復元します。詳細については、「SSMS を使用したデータベースバックアップの復元」を参照してください。
オプション: 復元したデータベースの名前が AXDB ではない場合は、管理者権限を持つ PowerShell を使用して実行します。
```
.\Configure-On-Premises-Upgrade.ps1 -DatabaseName '<DB-name>'
```
メモ

(たとえば、AXDB などの) 適切な値に <DB-Name> を置き換えます。値をさらに編集する場合は、この記事の付録を参照してください。

スクリプトは、データベース接続のテストを実行し、入力した情報が有効であることを確認します。
手順 5 からコマンドプロンプトを使用して、次のコマンドを実行します。

a. AxUpdateInstaller.exe generate -runbookid=upgrade -runbookfile=upgrade.xml -topologyfile=defaulttopologydata.xml -servicemodelfile=defaultservicemodeldata.xml

b. AxUpdateInstaller.exe import -runbookfile=upgrade.xml

c. AxUpdateInstaller.exe execute -runbookid=upgrade

データアップグレードのクリーンアップの実行中に、エラーが発生する場合があります。

Stack trace: Call to TTSCOMMIT without first calling TTSBEGIN.\' on category \'Error\'.

これを解決するには、次のコマンドのステップを再実行します。

AxUpdateInstaller.exe execute -runbookid=upgrade -rerunstep=\<failed-step\>
アップグレードプロセスが正常に完了したら、新たにアップグレードしたデータベースをバックアップします。 ISV または VAR からカスタマイズする場合は、いくつかの投稿データのアップグレードスクリプトを実行する必要があるかどうかを確認します。
運用環境用から (たとえば、AXDBupgraded など) 別の名前を使用して環境に、データベースを復元します。
オンプレミス AOS、BI、および MR サーバーを開始するか、または Service Fabric ポータルからサービスを開始します。
LCS でプロジェクトを開き、環境セクションで展開を削除します。アプリケーションが環境の Service Fabric Explorer から表示されなくなります。このプロセスは、持っているノードの数に応じて、時間がかかることがあります。新しい環境を配置する前に、Service Fabric Explorer を確認し、すべての申請が削除されていることを確認します。実際のプロセスが完了する前に、LCS では環境が削除されていることを示す場合があることに注意してください。
カスタマイズする場合、次の事項を行います。

a. LCS では、共有資産ライブラリに移動します。

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

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

d. データベースを構成する必要があります。 Finance + Operations (on-premises) データベースを構成の手順に従います。

e. LCS にて、新たな環境を設定し、バージョン 10.0.x (再展開) を展開します。詳細については、オンプレミス環境での設定と配置を参照してください。配置する場合、指定するデータベースは手順 13 c (通常は AXDB) で作成したものにする必要があります。

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

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

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

i. オンプレミス AOS、BI、および MR サーバーを開始するか、または Service Fabric ポータルからサービスを開始します。
カスタマイズを持っていない場合は、次の事項を実行します。

a. (省略可) 既存のデータベース (通常は AXDBold) の名前を変更し、新しいデータベース (通常は AXDB) の名前を変更します。次の手順で、アップグレードされたデータベースの名前を入力することを確認します。

b. LCS にて、新たな環境を設定し、バージョン 10.0.x (再展開) を展開します。詳細については、オンプレミス環境での設定と配置を参照してください。
(省略可) 新しい環境 (通常 AXDB) を使用しているデータベースでの財務レポートモジュールが失敗したために配置が失敗した場合は、次のコマンドを実行します。
```
ALTER TABLE RETAILTERMINALTABLE ADD CONSTRAINT PK_RecId PRIMARY KEY
CLUSTERED (RECID)
```

データベースを指す VHD でアップグレードする

オンプレミス AOS、BI、および MR サーバーをシャットダウンするか、または Service Fabric ポータルからサービスを停止します。
オンプレミス環境 (通常は AXDB) から、データベースをバックアップします。詳細については、「フルデータベースバックアップの作成 (SQL Server)」を参照してください。
先ほど作成したバックアップをデータベースサーバーを復元し、別の名前 (AXDBtoupgrade) を付けます。詳細については、「SSMS を使用したデータベースバックアップの復元」を参照してください。
接続されたら、C:\AOSService\PackagesLocalDirectory\Bin\CustomDeployablePackage に移動し、MinorVersionDataUpgrade zip ファイルをコピーします。
任意の場所にファイルを貼り付け、展開します。たとえば、C:\D365FFOUpgrade\ です。
管理者としてコマンドプロンプトを開き、手順 5 で展開したフォルダーへディレクトリを変更します。
管理者として新しい PowerShell を開き、次のように実行します。
```
.\Configure-On-Premises-Upgrade.ps1 -DatabaseName '<DB-name>' -DatabaseServer '<SqlServerName>' -DatabaseUser '<User>' -DatabasePassword '<Password>'
```
メモ

<*> を必要な値に置き換えます。
メモ
- SQL Server 認証のみが、このアップグレードで正式にサポートされます。詳細については、「データベースユーザーの作成」を参照してください。
- SQL Server 証明書に署名した証明書を、 OneBox の信頼された証明機関に追加する必要があります。詳細については、「信頼されたルート証明書をインストールする」を参照します。
- 使用するデータベースのユーザーに、sysadmin サーバーロールが割り当てられているか、またはアップグレードするデータベースに少なくともすべての特権があり、tempDB にアクセスする許可があるかを確認します。これが該当しない場合は、アップグレードプロセスの手順 6 で失敗します。
- Onebox で証明機関をインストールする場合、FQDN または IP を使用して表示されているデータベースに接続することを確認します。そのサーバーを指していないため、データベースにドメイン名を使用してアクセスできない場合は、ホストファイルを編集して、DN を追加し、解決する必要がある IP 追加します。
手順 6 からコマンドプロンプトを使用して、次のコマンドを実行します。

a. AxUpdateInstaller.exe generate -runbookid=upgrade -runbookfile=upgrade.xml -topologyfile=defaulttopologydata.xml -servicemodelfile=defaultservicemodeldata.xml

b. AxUpdateInstaller.exe import -runbookfile=upgrade.xml

c. AxUpdateInstaller.exe execute -runbookid=upgrade

データアップグレードのクリーンアップの実行中に、エラーが発生する場合があります: Stack trace: Call to TTSCOMMIT without first calling TTSBEGIN.\' on category \'Error\'.

これを解決するには、次のコマンドのステップを再実行します: AxUpdateInstaller.exe execute -runbookid=upgrade -rerunstep=\<failed-step\>
ISV または VAR からカスタマイズする場合は、いくつかの投稿データのアップグレードスクリプトを実行する必要があるかどうかを確認します。
オンプレミス AOS、BI、および MR サーバーを開始するか、または Service Fabric ポータルからサービスを開始します。
LCS でプロジェクトを開き、環境セクションで展開を削除します。アプリケーションが環境の Service Fabric Explorer から表示されなくなります。このプロセスは、持っているノードの数に応じて、時間がかかることがあります。
カスタマイズする場合、次の事項を行います。

a. LCS では、共有資産ライブラリに移動します。

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

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

d. データベースを構成する必要があります。 Finance + Operations (on-premises) データベースの構成の手順に従います。

e. LCS にて、新たな環境を設定し、バージョン 10.0.x (再展開) を展開します。詳細については、オンプレミス環境での設定と配置を参照してください。配置する場合、指定する必要があるデータベースは手順 12 c (通常は AXDB) で作成したものにする必要があります。

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

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

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

i. オンプレミス AOS、BI、および MR サーバーを開始するか、または Service Fabric ポータルからサービスを開始します。
カスタマイズを持っていない場合は、次の事項を実行します。

a. (省略可) 既存のデータベース (通常は AXDBold) の名前を変更し、新しいデータベース (通常は AXDB) の名前を変更します。次の手順で、アップグレードされたデータベースの名前を入力することを確認します。

b. 新しい環境を設定し、バージョン 10.0.x で配置します。詳細については、オンプレミス環境での設定と配置を参照してください。
(省略可) 新しい環境 (通常 AXDB) を使用しているデータベースでの財務レポートモジュールが失敗したために配置が失敗した場合は、次のコマンドを実行します。
```
ALTER TABLE RETAILTERMINALTABLE ADD CONSTRAINT PK_RecId PRIMARY KEY
CLUSTERED (RECID)
```

付録

Configure-On-Premises-Upgrade.ps1 の使用状況

重要

このスクリプトは、OneBox VHD 環境からの実行のみを目的としています。

スクリプトは、少なくとも DatabaseName パラメーターを渡すことを必要としています。渡さないと、スクリプトは自動的に要求します。

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

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

-DatabaseName - アップグレードするデータベースの名前です。
-DatabaseServer - Finance + Operations (on-premises) データベースが含まれているデータベースサーバー。
-DatabaseUser - SQL 認証のユーザー名です。
-DatabasePassword - SQL 認証のパスワードです。

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

Configure-On-Premises-Upgrade.ps1

<#
.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

}

トラブルシューティング

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

次の方法で共有

オンプレミス環境のインプレースアップグレードプロセス

バージョン7. x から10.0. x へのオンプレミスのアップグレード

必要条件

VHD 内からのアップグレード

データベースを指す VHD でアップグレードする

付録

Configure-On-Premises-Upgrade.ps1 の使用状況

トラブルシューティング

フィードバック

その他のリソース

次の方法で共有

オンプレミス環境のインプレース アップグレード プロセス

バージョン7. x から10.0. x へのオンプレミスのアップグレード

必要条件

VHD 内からのアップグレード

データベースを指す VHD でアップグレードする

付録

Configure-On-Premises-Upgrade.ps1 の使用状況

トラブルシューティング

フィードバック

その他のリソース

オンプレミス環境のインプレースアップグレードプロセス