Installing Business Central Using Setup
You use Business Central Setup to install the different components that comprise a Business Central production, demonstration, or development environment. For a list of components, see Components and Topology.
Setup is available on the installation media (DVD) in the setup.exe file. When run, Setup leads you through installation process, where you can install individual components or select predefined options that install a logical collection of components.
Throughout Setup, you are presented with various configuration settings. Some settings require that you set them, and other settings have a default value. In many cases, the default value is sufficient for the initial installation. After you run Setup, you can change the configuration settings by using other tools such as the Business Central Server Administration tool and Business Central Administration Shell.
Prerequisite Installations by Setup
There are some components that require other software in order run, for example the database requires SQL Server and the Web client requires IIS. Setup will install several of these prerequisites, like installing SQL Server Express and enabling IIS. You can see which prerequisites Setup installs in the System Requirements.
Before you run Setup
Plan your deployment and identify the components that you want to install.
Verify that the target computer where you will install components meets the hardware and software requirements for the components that you want to install. For more information, see System Requirements.
Make sure that you are an administrator on the computer where you run Setup.
Determine the HTTP ports that you will use for components.
During setup, you will have to specify the following HTTP ports:
Port Description Default Management services The listening TCP port for the Business Central Server Administration tool. 7045 Client services The listening HTTP port for client services. 7046 SOAP services The listening HTTP port for SOAP web services. 7047 OData service The listening HTTP port for OData web services. 7048 Developer services The listening HTTP port for Microsoft Dynamics NAV Developer web services 7049
You must either select a port number that is not being used by another service, or stop/disable the other service before you run setup. For example, if you have an older version of Dynamics NAV Server or Business Central Server installed, then configure the new server instance to use other ports than the old server instance, or stop the old server instance before you install the new one.
In the installation media (DVD) folder, double-click the setup.exe.
Follow Setup until you get to the Dynamics 365 Business Central page.
- Choose Get a free online trial to sign-up if you interested in hearing about and trying the cloud experience.
- Choose Get the Business Central app from the Microsoft Store to download a companion app that mimics that Web client but has the same look-and-feel as the mobile apps. For more information, see Installing Installing the Microsoft Dynamics 365 Business Central App.
- Choose Advance installation options to install a demonstration environment or one more components. Then, follow the on-screen instructions to complete the installation.
Setup does not provide a Cancel button on all pages, but you can cancel an installation from any page by choosing the Close button in the upper-right corner. All Business Central components are removed from the computer. The only software that Setup cannot remove are:
Database files, such as the Demo database.
Prerequisites for Business Central components that Setup can install, such as the .NET Framework.
Run Setup from a command prompt
You can run Business Central Setup from a command prompt, either by pointing to its location on the installation media, or after the initial installation, from the location where the Setup.exe is automatically stored on your computer. The default location is:
C:\Program Files (x86)\Common Files\Microsoft Dynamics 365 Business Central\<Version number>\Setup
You can use the following options with Setup.exe.
|/config <Setup config file>||Specifies path and file name information for a Setup configuration file to load.
This is the only required option.
|/help||Displays Help about Setup.exe options.|
|/log <log path>||Specifies path and file name information for a Setup log file to be created by Setup. The file must not exist before you run Setup.|
|/quiet||Specifies that Setup does not display anything on the screen. All configuration information is taken from the specified configuration file.|
|/repair||Repairs the current installation of Business Central.|
|/uninstall||Removes the current installation Business Central.|
Save, Edit, and Load a Setup Configuration File
During Setup, you can save the configuration settings to a file before you finish and exit Setup. Then later, you can load use Setup to load the configuration file to make it faster to replicate the same configuration for another deployment.
Save to a Setup configuration file
Choose Save on the Specify parameters page in Setup. This page is available when you run Setup unless you select Install Demo, which skips all other Setup pages.
Type a file name for the configuration file. An .xml extension is added automatically.
You now return to the Specify parameters page, where you can continue with installing software. You can also close Setup if you only have to create a Setup configuration file.
Edit a Setup configuration file
You edit the file using an XML editor or text editor. Setup configuration files contain two types of settings.
|Component||For each component, there are three separate values, all displayed on a single line:
Specifies whether the component should be displayed in Setup. For silent installs, this parameter is not relevant.
There are two possible values: Local, indicates that the component is included in the install, and Absent indicates that the component is not included.
Identifies the component
You can change value for State or ShowOptionNode, but not for Id. Also, you cannot add or remove a component.
|Parameter||These settings contain configuration information for components. As with Components, you can modify a parameter’s Value, but not its Id.|
Load a Setup configuration file
The option to load a Setup configuration file is on the Choose an installation option page in Setup.
If you are using a Setup configuration file that was created from an earlier version of Business Central or Dynamics NAV, be aware that there might be some elements that are no longer supported because the feature has been deprecated. For example, the elements that have the following IDs are no longer supported as og 2019 release wave 2: "RoleTailoredClient", "ExcelAddin, "ClassicClient", "ClickOnceInstallerTools", "STOutlookIntegration", "PublicWinBaseUrl", and "ACSUri".
On the Choose an installation option page, choose Load Configuration.
This option is located under Custom Components.
A Setup configuration file contains information about which components to install and which settings to apply to each component. Therefore, you should not customize the list of components or configure components in Setup before you load a Setup configuration file because loading the configuration overwrites all prior customization and configuration.
In the Open dialog box, select or browse to the Setup configuration file that you want to open, and then double-click the file.
Setup now shows the Customize the installation page that has been modified according to the component selection in the loaded Setup configuration file.
Modify the list of components to install or choose Next to proceed to the Specify parameters page, where settings from the Setup configuration file are shown.
Configure these settings or choose Apply to accept these values and continue.