Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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:
 

Image Added

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.

Image Added


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.
      Image Added
      Open IIS Modules View
      Image Added
  • “Add Website” in IIS manager
    Image Added
  • Enter details for the new website, “Physical path” should point to the root of the extracted AS4 zip package.
    Image Added

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

    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”
    Image Added
    Folders to give write access:
    Image Added
  • Verify that the installation is working by navigating to the configured URL, a setup dialog should appear:
    Image Added

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.
      Image Added

1.1.2   AS4 Runtime messages database

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

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.