Skip to main content
Version: 4.2.5

Managing the iCore AS2 Server application

The iCore AS2 Server application is a web application hosted in IIS.

For general considerations regarding hosting of iCore web applications in IIS, see iCore web applications hosted in IIS.

Prerequisites​

The iCore AS2 Server application is installed, removed and updated with PowerShell scripts. Before you start the installation, note the following:

  • You need to be logged in with an account with administrative rights.
  • PowerShell 3.0 (or later) must be enabled in the OS settings. If you are running iCore on an x64 OS, you need to run the x64 version of the PowerShell console.
note

If you are running Windows 2008 R2 SP1, you need to execute the scripts from a PowerShell console or PowerShell ISE. A bug in the Microsoft PowerShell installation prevents users from starting a PowerShell script using File Explorer if the script has any arguments.

  • To run a script from within the PowerShell console, type: & "<path to .ps1-script>".

Also, acquire the following information:

  • The name of the site where the web service is to be installed.
  • The name of the IIS application pool where the web service is to be executed.
  • A suitable name for the new web service instance.
note

It is possible to install multiple instances of an iCore AS2 Server application hosted in IIS and you can also share application pools between web service instances.

Installing the iCore AS2 Server application in IIS​

  1. Open the File Explorer and navigate to the folder [iCore root]\bin\Web service templates\iCoreAS2Service.
  2. Locate the file CreateiCoreAS2Application.ps1, right-click and select Run with PowerShell. The PowerShell console opens.
  3. Enter the requested information:
    • Site name
    • Web service name
    • IIS application pool name.
      • If a new application pool should be created, enter Y or Yes. If you enter N or No, an application pool is expected to already exist. If it does not, installation will fail.
  4. Confirm the creation of the web application.
  5. When complete, press <ENTER> to close the PowerShell console.

Troubleshooting​

The AS2 application writes error logs regarding failed requests or other severe problems to the Windows Event Log under Applications and Services Logs/iCore Solutions/iCIS/iCoreAS2/Admin.

Removing the iCore AS2 Server application​

note

Removing an instance of the iCore AS2 Server application will also remove the corresponding Web.config file. If information in this file needs to be saved, make sure to create a backup copy and store it in a different location.

  1. Open the File Explorer and navigate to the folder [iCore root]\bin\Web service templates\iCoreAS2Service.
  2. Locate the file RemoveiCoreAS2Application.ps1, right-click and select Run with PowerShell. The PowerShell console opens.
  3. Enter the requested information:
    • Site name
    • Web service name
    • IIS application pool (remove or keep)
      • Y or Yes: remove application pool (if application pool is used by another application it will not be removed).
      • N or No: keep application pool
  4. Confirm removal of web application.
  5. When complete, press <ENTER> to close the PowerShell console.

Updating the iCore AS2 Server application​

When a new version of iCIS has been installed, the iCore AS2 Server application needs to be updated. Note however that the update procedure takes care of all instances of the iCore AS2 Server application, on all sites, so the update only needs to be done once on each host machine.

note

When updating from versions earlier than iCIS v4.1, the SystemContextEndpointBehavior section of the web.config file must be updated. For more information, see Configuration.

  1. Open the File Explorer and navigate to the folder [iCore root]\bin\Web service templates\iCoreAS2Service.
  2. Locate the file UpdateAlliCoreAS2Applications.ps1, right-click and select Run with PowerShell. The PowerShell console opens, and all found instances of iCore AS2 Server applications are listed.
  3. Verify that no instances are missing. Also make sure that the list does not include any "non-iCore" AS2 web applications.
  4. Confirm to update the listed web applications.
  5. When complete, press <ENTER> to close PowerShell host.

See also​

AS2​

AS2 Workflow activities

Last updated on