コマンドラインから展開可能パッケージをインストールする

メモ

コミュニティの関心グループが Yammer から Microsoft Viva Engage に移行されました。 Viva Engage コミュニティに参加し、最新のディスカッションに参加するには、「 Finance and Operations Viva Engage Community へのアクセスを要求する」フォームに入力し、参加するコミュニティを選択します。

この記事では、コマンドラインを使用して、開発環境またはビルド環境で作成したバイナリ更新プログラムまたはアプリケーション (AOT) 配置可能パッケージを適用する方法について説明します。

重要

ほとんどの種類の環境では、展開可能なパッケージを Microsoft Dynamics Lifecycle Services から直接環境に適用できます。詳細については、クラウド環境への更新プログラムの適用を参照してください。そのため、この記事は主に、ライフサイクルサービスを介した更新プログラムの適用をサポートしていない環境の種類に適用されます。たとえば、ローカル開発環境 (ダウンロード可能な仮想ハードディスク [VHD])、Microsoft Azure のマルチボックス開発環境とテスト環境 (ライフサイクルサービスパートナーおよび試用版プロジェクト)、ビルド環境などがあります。ただし、ライフサイクルサービスの代わりにコマンドラインを使用して、配置可能なパッケージをインストールする場合は、いつでもこの記事を使用できます。

重要な概念

配置可能パッケージ – 配置可能パッケージは、任意の環境に適用できる展開の単位です。 Application Object Server (AOS)、更新されたアプリケーションパッケージ、または新しいアプリケーションパッケージのランタイムコンポーネントに対するバイナリの修正プログラムで構成できます。
AXUpdateInstaller – AXUpdateInstaller は、配置可能パッケージにバンドルされている実行可能プログラムです。パッケージをコンピューターにダウンロードすると、インストーラーを使用できます。
Runbook – デプロイ Runbook は、デプロイ可能なパッケージをターゲット環境に適用するために生成され、使用される一連の手順です。ステップの一部が自動化され、一部は手動です。 AXUpdateInstaller を使用すると、これらの手順を一度に 1 つずつ正しい順序で実行できます。

開発環境でのアプリケーション (AOT) 配置可能パッケージのインストール

メモ

次の手順は、カスタマイズパッケージにのみ適用されます。 Microsoft Dynamics AX 2012 から財務および運用アプリへのアップグレードの一環として、データアップグレード配置可能パッケージを実行する場合は、 devinstall パラメーターを使用しないでください。

AOT 配置可能パッケージはアプリケーションのカスタマイズおよび拡張機能を含むパッケージです。開発またはデモ環境で AOT 配置可能パッケージをインストールするためだけにコマンドラインを使用する場合、このセクションの指示に従います。この記事の残りをスキップすることができます。

仮想マシン (VM) で、配置可能パッケージの zip ファイルをダウンロードします。 zip ファイルをユーザー以外のフォルダーに格納してください。

メモ

ZIP ファイルをダウンロードした後、右クリックしプロパティを選択します。その後、プロパティ ダイアログボックスの全般タブで、ブロック解除 を選択してファイルのロックを解除します。
ファイルを抽出します。
コマンドプロンプトウィンドウを開き、配置可能パッケージを展開したフォルダーに移動します。
次のコマンドを実行します。
```
AXUpdateInstaller.exe devinstall
```
devinstall オプションは、AOT の可能なパッケージを VM にインストールします。

メモ

このコマンドは、データベース同期を実行しません。配置可能なパッケージをインストールした後、Microsoft Visual Studio からデータベースの同期を実行する必要があります。

トポロジコンフィギュレーションデータを収集する

ライフサイクルサービスの [環境 ] ページで、VM の名前を選択します。環境ページで提供されているユーザー名とパスワードを使用して、VM へのリモートデスクトップの接続を確立します。
VM で、ライフサイクルサービスからデプロイ可能パッケージの zip ファイルをダウンロードします。 zip ファイルをユーザー以外のフォルダーに格納してください。

メモ

ZIP ファイルをダウンロードした後、右クリックしプロパティを選択します。その後、プロパティ ダイアログボックスの全般タブで、ブロック解除 を選択してファイルのロックを解除します。
ファイルを抽出します。
展開可能パッケージを抽出したフォルダーで、 DefaultTopologyData.xmlという名前のファイルを見つけて開きます。このファイルには、VM 名とインストール済みコンポーネントを指定する必要があります。
- VM 名を指定するには、次の手順を実行します。
  1. ファイルエクスプローラーで、この PC を右クリックしてから、プロパティを選択します。
  2. システムプロパティで、コンピューター名を検索して記録します (たとえば、AOS 950ed2c3e7b)。
  3. DefaultTopologyData.xml ファイルで、前の手順で示されているコンピューター名にマシン名を変更します。
- インストールされたコンポーネントを指定するには、次の手順を実行します。
  1. 管理者としてコマンドプロンプトウィンドウを開きます。
  2. 展開したフォルダーに移動し、コンピューターにインストールされているすべてのコンポーネントの一覧を表示するため、次のコマンドを実行します。
```
AXUpdateInstaller.exe list
```
  3. コンポーネントの一覧で DefaultTopologyData.xml ファイルを更新します。
  VM 名とインストールされているコンポーネントの指定が完了すると、DefaultTopologyData.xml ファイルは次の図のようになります。
環境ページに記載されているその他のすべて VM に対して手順 1 ～ 4 を繰り返します。

トポロジからランブックを生成します

DefaultTopologyData.xml ファイル内のトポロジ情報に基づいて、各 VM を更新するための詳細な手順を提供する Runbook ファイルを生成します。

すべての VM で、次のコマンドを実行して Runbook を生成します。
```
AXUpdateInstaller.exe generate -runbookid=[runbookID] -topologyfile=[topologyFile] -servicemodelfile=[serviceModelFile] -runbookfile=[runbookFile]
```
このコマンドで使用されるパラメーターの説明を次に示します。
- [RunbookID] – 展開可能なパッケージを適用するときに開発者が指定するパラメーター。
- [topologyFile] – DefaultTopologyData.xml ファイルのパス。
- [serviceModelFile] – DefaultServiceModelData.xml ファイルのパス。
- [RunbookFile] – 生成する Runbook ファイルの名前 ( たとえば、AOSRunbook.xml)。
  
  例
```
AXUpdateInstaller.exe generate -runbookid="VAL200AA2BMEDIU-runbook" -topologyfile="DefaultTopologyData.xml" -servicemodelfile="DefaultServiceModelData.xml" -runbookfile="VAL200AA2BMEDIU-runbook.xml"
```

Runbook には、環境を更新するために実行する必要がある一連の手順が用意されています。次の図は、Runbook ファイルの例を示します。 Runbook の各ステップは、ID、マシン名、およびステップ実行の詳細に関連付けられます。

配置可能パッケージのインストール

Runbook ファイルに一覧表示されている最初のマシン (VM) で、次の手順を実行します。
1. 次のコマンドを実行して、Runbook をインポートします。
```
AXUpdateInstaller.exe import -runbookfile=[runbookFile]
```
  例
```
AXUpdateInstaller.exe import -runbookfile="VAL200AA2BMEDIU-runbook.xml"
```
2. runbook を確認します。
```
AXUpdateInstaller.exe list
```
3. runbook を実行します。
```
AXUpdateInstaller.exe execute -runbookid=[runbookID]
```
  例
```
AXUpdateInstaller.exe execute -runbookid="VAL200AA2BMEDIU-runbook"
```
  AXUpdateInstaller は、VM で各ステップが実行された後に Runbook ファイルを更新します。 Runbook には、各ステップに関する情報も記録されます。
  
  手動ステップについては、指示に従い、Runbook でステップを完了済とマークする以下のコマンドを実行します。
```
AXUpdateInstaller.exe execute -runbookID=[runbookID] -setstepcomplete=[stepID]
```
  例
```
AXUpdateInstaller.exe execute -runbookid="VAL200AA2BMEDIU-runbook" -setstepcomplete=2
```
  いずれかの手順でエラーが発生した場合は、スクリプトまたは手順をデバッグし、それに応じて更新します。
4. Runbook をエクスポートします。
```
AXUpdateInstaller.exe export -runbookid=[runbookID] -runbookfile=[runbookFile]
```
  例
```
AXUpdateInstaller.exe export -runbookid="VAL200AA2BMEDIU-runbook" -runbookfile="VAL200AA2BMEDIU-runbook.xml"
```
Runbook ファイルに一覧表示されている他のすべての VM で手順 1 を繰り返します。開発、ビルド、デモ環境などのワンボックス環境の場合、VM は 1 つだけです。

インストールの確認

新しい更新プログラムがインストールされていることを確認するには、次のコマンドを実行します。
```
AXUpdateInstaller.exe list
```
Runbook を表示して、完了したステップを確認します。手順が完了する Runbook ファイルの例を次に示します。

Runbook ファイルをバックアップします

Runbook のすべての手順を完了し、Runbook をエクスポートしたら、後で参照するためにファイルをコンピューターの外部に保存します。たとえば、次のような状況で Runbook ファイルを使用する必要がある場合があります。
- 運用環境のダウンタイム要件などを分析する必要があります。
- 展開可能なパッケージをインストールできないため、ファイルを Microsoft に送信する必要があります。

トラブルシューティング

Runbook のステップが失敗した場合は、次のコマンドを実行して再実行します。
```
AXUpdateInstaller.exe execute -runbookid=[runbookID] -rerunstep=[stepID]
```
同じ配置可能パッケージのバージョンの不一致、ダウングレード、またはインストールを防ぐには、次のコマンドを実行します。
```
AXUpdateInstaller.exe execute -runbookid=[runbook ID] -versioncheck=true
```
データベースの同期を確認するには aosservice\scripts\ フォルダー内の dbsync.error.txt ファイルを見つけて開き、エラーを探します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-04-03