1. Portal Configuration

1.1 In Process

In process mode means that the portal and the runtime will run in the same process. This means that when you start the “Eu.EDelivery.AS4.ServiceHandler.ConsoleHost.exe” then also the portal will be available.
This configuration is managed in the “settings.xml” file with the following option: 

Setting the “FeInProcess” value to true means that the “in process” mode is enabled.

Note: Running the portal “in process” is not the recommended way of running in production! Please see “Run in IIS” for a production setup.

1.2   Dedicated process

It’s also possible to run the portal in its own process, this can be achieved by setting the “FeInProcess” to false in the “settings.xml” file.

Now when you start the “…consolehost.exe”, the portal won’t be started.
From now on you will have to start the portal using “EU.EDelivery.AS4.Fe.exe”.

 Note: Running the portal in its own dedicated process is not the recommended way of running in production! Please see “Run in IIS” for a production setup.

1.3   Run in IIS

Note: Running the portal using IIS is the recommended way for production!

• Install the latest ASP.NET Core Module, https://github.com/aspnet/AspNetCoreModule, download & install the Windows Hosting package. After that restart IIS.
  • To verify if the module has been installed successfully, open “Internet Information (IIS) Manager” and view the modules and make the following module is listed.
    
    Open IIS Modules View
    
• “Add Website” in IIS manager
  

• Enter details for the new website, “Physical path” should point to the root of the extracted AS4 zip package.
  

• In the root of the AS4 folder create a file “web.config” with the following contents:
  

  Note: If the API doesn’t start, then you can enable the logging output by setting the stdoutLogEnabled option to true. After that all logging will be available in the logs folder.

• Next step is to allow the application pool user write access the following folders, this can be done by right clicking on the folders and going to “security” tab and giving the “IUSER_USRS”
  
  Folders to give write access:
  
• Verify that the installation is working by navigating to the configured URL, a setup dialog should appear:
  
  
  

1.4   Enable Microsoft Sql Server

1.1.1   Authentication database

• • Open appsettings.json
  • Change the “Provider” & “ConnectionString” properties to “sqlserver” & the ConnectionString matching your sql server setup.
    

1.1.2   AS4 Runtime messages database

• • Open appsettings.json
  • Change the “Provider” & “ConnectionString” properties to “sqlserver” & the ConnectionString matching your sql server setup.
    
    
    

1.5   Appsettings.json

In the AS4 package there are 2 configuration files available for the portal. “appsettings.json” & “appsettings.inprocess.json”. All settings in the “appsettings.inprocess.json” are used when running the portal “in process” and settings from “appsettings.json” are used when running in a dedicated process or with IIS.