DD Installation

Download as docx, pdf, or txt
Download as docx, pdf, or txt
You are on page 1of 7

Install and Configure IIS

Follow these steps to turn on IIS (Internet Information Service or Web Service) on
Windows 10. The procedure is similar on other versions of Windows.
Tip: A quick Google search gives you multiple results on how to install IIS on your
machine,
https://www.rootusers.com/how-to-install-iis-in-windows-server-2019/

On Windows 10
1. Open the Windows Control Panel (right-click the Start button in the bottom-
left corner and select Control Panel).

2. Select Programs and Features:

3. Click Turn Windows features on or off :

4. In the Windows Features, select the check boxes shown in the below image:
o NET framework 3.5 (includes .NET 2.0 and 3.0)
o Windows Communication Foundation HTTP Activation
o Internet Information Services
o Web Management Tools
o IIS Management Console
o World Wide Web Services
o Dynamic Content Compression
o Basic Authentication

5. Click OK.

If you completed step 4 successfully, you should be ready to run


the CommerceServiceForLSCentral.Setup.202x.x.exe setup to create the WCF web
service.
If .NET Framework 4.7 Advanced Services is not an available feature to you, you
have to set up .NET Framework 4.7 ( https://dotnet.microsoft.com/download/dotnet-
framework/net47 ).

After installing the .NET framework, make sure that

 Internet Information Services


 World Wide Web Services
o Application Development Features
 ASP.NET

is selected (inside Windows Features).

The final step is to activate and allow the newly installed .NET 4.7 framework inside
IIS:

1. Start by looking for and opening Internet Information Services:

2. In IIS, select ISAPI and CGI Restrictions:


3. Right-click ASP.NET v4, and click Allow:

Install Options
Data Director Install can be executed with parameters to make use of a scripted
installation. You can find details of what options are available here:

http://unattended.sourceforge.net/InnoSetup_Switches_ExitCodes.html

The available tasks are:

 srvfiles: DD Service [Default]


 clitools: Client tools (Config & Job Monitor) [Default]
 navcli: Add-ins files for NAV/BC RTC
 navsrv: Add-ins files for NAV/BC SRV
 web: Install Incoming DD Web Service to IIS

 Install DD in silent mode with Service and Client Tools:


/VERYSILENT /SUPPRESSMSGBOXES
 Install Service and Client Files only:
/VERYSILENT /SUPPRESSMSGBOXES /TASKS=”srvfiles,!clitools”
 Install only Client Files, without Service and Client Tools:
/VERYSILENT /SUPPRESSMSGBOXES /TASKS=”!srvfiles,!clitools”
 Install Service, Client Files & Tools and add BC Addins:
/VERYSILENT /SUPPRESSMSGBOXES /MERGETASKS="navcli,navsrv"

To add path for NAV/BC installation folders, for example if Nav/BC is installed on
Docker, and path cannot be found in the Registry, add -NAVSRV “<path>” -NAVCLI
“<path>”
It is possible to change default DD Configuration values during installation:

 Create ddconfig.xml file with the modified values, put the file into the bin
folder where DD will be installed, and after installation is done, DD will check
for this file before creating the default configuration file, and modify those
values from the xml file.

Note: This file must be in place before the first start of DD, as DD will only look for
this file if default configuration values have not yet been created.

Sample of ddconfig.xml file that will set the Alias value and change Decimal fix for
Database process to BIG and activate debug:

Copy

ddconfig.xml

<DDConfig>
<BaseConfig>
<Aliases>MyDD</Aliases>
</BaseConfig>
<AppConfig>
<Program Port="3">
<Debug>15</Debug>
<Param>
<DecFix>BIG</DecFix>
</Param>
</Program>
</AppConfig>
</DDConfig>

How to: Enable Basic


Authentication
1. Open the IIS Manager.

2. Go to Authentication, enable Basic Authentication, and disable Anonymous


Authentication:
3. In the Site section, select the Web site where Commerce is installed
(default: Default Web Site). Click Bindings, add https for port 443, and select
your certification.

4. Navigate to the application installation folder. There are pre-configured


WebServices files there for different Authentication modes.

5. Open Web.config and replace the Configuration Source file for services in this
line:

<services configSource="WebServices.config"/>

to one of these files:

o WebServices_Basic.config: Basic Authentication (port 80)


o WebServices_SSL.config: SSL (port 443)

Basic/SSL Authentication needs user login information with the web request header.

To set up user for IIS, right-click Computer and select Manage (or go to Control
Panel > Administrative Tools > Computer Management), and in Local Users and
Groups you can add a new user. Then, give that user permission to read the directory
where the site is hosted.

After creating the user, be sure to edit the user and remove all roles so that user
cannot be used to access the computer itself, like log into it.

For other authentication methods, like certification, use the SSL Services file and
configure the web config files, where Commerce is installed, according to the setup
in IIS.

Note: These are just sample configuration files on how to configure


IIS. Commerce uses standard IIS methods in handling security. A lot of information is
available online, for example by Google search, on how to set up different methods
of security in IIS, that can be applied to those configuration files that come
with Commerce.

You might also like