Operating System

  • Install the x64 version of Windows 10 Pro (1903 or higher) or Windows Server 2016 or later and run Windows Update.
  • Launch File Explorer and create a folder named c:\moab_api. This is where the Moab deployment files found inside the latest Publish folder will be deployed to.
  • Create a firewall rule to open inbound ports 80 and 443

Database

PostgreSQL

  • Navigate to https://www.enterprisedb.com/downloads/postgres-postgresql-downloads then download and install the Windows x86-64 version of PostgreSQL 12.1
  • During the installation, you’ll be asked to enter a password so enter P@ssw0rd or another password you prefer.
  • Launch pgAdmin 4 and you’ll be asked to enter a master password so enter P@ssw0rd or another password you prefer.
  • Set the default database password to P@ssw0rd. This password can be changed later along with the corresponding password Moab uses to access the database via the appsettings.json file.
  • In the Browser pane of the pgAdmin tool, expand the Servers tree view, right-click on Databases and create a new empty database called MoabDB1.
  • Right-click on the MoabDB1 icon and select Restore…
  • In the Restore dialog, click the ellipsis to the right of Filename text box to open the Select file dialog. Click the Format combo box and select sql.
  • Navigate to backup database file.
  • In the Role name combo box select postgres then click Restore.

Application Server

  • Install Internet Information Services (IIS) 10.
    • From the Start menu, click Settings.
    • In the Windows Settings dialog, click Apps.
    • In the Apps & features dialog, click Programs and Features.
    • In the Programs and Features dialog, click Turn on Windows Features on or off.
    • In the Windows Features dialog, click the + sign to expand .NET Framework 4.8 Advanced Services and check ASP.NET 4.8.
    • Check Internet Information Services and click the + sign next to it to expand the tree view.
    • Click the + sign next to World Wide Web Services to expand the tree view.
    • Click the + sign next to Application Development Features to expand the tree view.
    • Check ASP.NET 4.8 and WebSocket Protocol.
    • Click the + sign next to Security to expand the tree view.
    • Check IP Security and then click OK to close the Windows Features dialog and begin the installation process.
    • Click Close when the installation is complete.
    • Launch a browser, type localhost and press Enter to test to see if the Internet Information Services home page appears.
  • Configure Internet Information Services
    • From the Start menu select Windows Administrative Tools, Internet Information Services (IIS) Manager.
    • Right-click Default Web Site and select Add Application…
    • In the Add Application dialog, enter moab in the Alias text box, use the existing DefaultAppPool in the Application pool text box, and in the Physical path text box enter c:\moab_api and click OK.
  • Secure the Application
    • Install SSL certification on IIS
  • Deploy the Application
    • Launch File Explorer and copy the Moab deployment files found inside the latest Publish folder to c:\moab_api.
    • Find a file named Web.config within the deployment files and open it with Notepad.
    • In the ConnectionStrings section, ensure DefaultConnection reflects the proper database host location and password.
  • Test the Application
    • Launch a browser, type localhost/moab and press Enter to test to see if the ASP.NET home page appears. Depending on the speed of your computer, it might take a few moments to launchthe first time.
    • Click the API menu at the top of the page to see a list of callable APIs, URIs, parameter names, data types, and sample request formats.