Preparations

In this tutorial, we will set up a server running on IIS in an independent machine, and then publish and host the Web APIs in the IIS running on this server.

Step 1: Set up the server with the following OS and software (install the software in the order listed).

  • Windows Server 2019 (64-bit)

  • Microsoft IIS

    Follow the section below to install and configure IIS.

  • Web Deploy 3.6 (or later)

    Download and install from https://www.microsoft.com/download/confirmation.aspx?id=43717.

    IMPORTANT: Make sure to select the Complete setup type when installing Web Deploy.


    When the installation is complete, select Control Panel > System and Security > Administrative Tools > Services, and make sure "Web Deployment Agent Service" is running.

    Important

    Web Deploy must be installed after IIS is installed. If you have installed Web Deploy before IIS, uninstall Web Deploy and then choose the Complete setup type to install it again; do not use the Modify feature to re-install Web Deploy.

  • ASP.NET Core Hosting Bundle 3.1

    Download and install from https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-aspnetcore-3.1.13-windows-hosting-bundle-installer.

Step 2: Make sure the .NET server can connect to the NuGet site: https://www.nuget.org (for installing PowerServer NuGet packages) and the following Appeon sites (through port number 80): https://apips.appeon.com and https://apipsoa.appeon.com (or https://apips.appeon.net and https://apipsoa.appeon.net) (for validating the PowerServer license).

Note

If the server connects to Internet through a proxy server, make sure to configure the proxy server settings in the PowerServer Web API as well (the ServerAPIs project > Server.json file > "ProxyOptions" block).

Step 3: Configure Windows Defender Firewall on the .NET server to allow the .NET server port (81 in this tutorial or any port number you choose). The section "Configuring Windows Defender Firewall" has detailed instructions.