MYOB Acumatica Command-Line Tool: To Deploy an Instance by Using the Configuration File

The following activity will walk you through the process of preparing a configuration file by using the MYOB Acumatica ERP Configuration Wizard. You will then deploy an MYOB Acumatica instance from this configuration file by using the MYOB Acumatica command-line tool.

Story

Suppose that you are the system administrator of your company and you need to deploy an out-of-the-box MYOB Acumatica instance from a configuration file by using the command-line tool.

Process Overview

In this activity, you will create a configuration file by using the MYOB Acumatica ERP Configuration Wizard. Then you will deploy an out-of-the-box MYOB Acumatica instance from this configuration file by using the command-line tool.

System Preparation

Before you begin performing the step of this activity, you should do the following:

Make sure that you have completed the MYOB Acumatica Installation On-Premises: To Install the MYOB Acumatica Configuration Wizard prerequisite activity.
Make sure that a command-line utility has been installed on your computer.
Tip:
You can use Command Prompt, the built-in command-line utility for Microsoft Windows.

Step 1: Creating the Configuration File by Using the MYOB Acumatica Configuration Wizard

To create a configuration file with the settings of an MYOB Acumatica instance, do the following:

On the Start menu, click Acumatica ERP Configuration to open the MYOB Acumatica ERP Configuration Wizard.
On the wizard pages, specify the settings to deploy an out-of-the-box instance, as described in Instance Deployment: To Deploy an Out-of-the-Box Instance.
In the Instance Name box on the Instance Configuration page, specify the name of the instance: AcumaticaCLT.
On the Confirmation of Configuration page, click Save Configuration to save the configuration data.
By default, the name of the configuration file is InstallConfig.xml.
Save the InstallConfig.xml on your computer.

Step 2: Deploying an Instance by Using the Command-Line Tool

To deploy an out-of-the-box MYOB Acumatica instance with the settings specified in the prepared configuration file, do the following:

On the Start menu, run as administrator a command-line utility installed on your computer.
In the command line, enter a command to navigate to the folder where the MYOB Acumatica ERP Configuration Wizard is installed and ac.exe is stored.
You can use the cd [path to ac.exe] command, where [path to ac.exe] is the path to the executed file, which is specified in the following format.
```
cd C:\Program Files (x86)\MYOB Acumatica\Data\
```
In the command line, enter ac.exe -f:"path to the configuration file" to start the execution of the configuration file and the deployment of the instance. [path to the configuration file] is the path to the configuration file, which is specified in the following format.
```
ac.exe -f:"C:\Program Folder\InstallConfig.xml"
```
Press Enter.
Wait until the deployment of the AcumaticaCLT instance has been completed.
Open the MYOB Acumatica ERP Configuration Wizard.
On the Welcome page of the MYOB Acumatica ERP Configuration Wizard, click Perform Application Maintenance. The Application Maintenance page opens.
In the Installed Sites table, make sure that the AcumaticaCLT instance is in the list.
Select the AcumaticaCLT instance, and click Launch.
You can access the instance and enable the features for the first time to make sure that it is an out-of-the-box instance, as you have specified in the settings of the configuration file. (For more information about these tasks, see Instance Deployment: To Deploy an Out-of-the-Box Instance and Instance Deployment: To Enable Features and Activate the License.)