Webserver Setup

Atlas Library is designed to run on Windows Server 2016 or later. There are a few installs to get the website running.

Server Requirements

A single hospital install will generally have <40gb of data. A majority of the data is report usage data. Here is a rule of thumb sizing for a single hospital. You can scale the numbers to your size -

  • Database Server Ram: 40gb
  • Database Server Disk Space: 80gb (keep in mind the ETL’s use a staging database, so you need effectively 2x the disk space of the prod database.)
  • Server cores: 8

The website server requirements are much less. The website requires <1gb of disk space. On a shared webserver we would recommend 16gb ram and 8 cores.

Install Requirements

  • IIS Webserver with Microsoft .NET SDK 7 (Hosting Bundle)

    Extension
  • Ensure IIS has server roles needed for web deploy and web management service installed and started. Microsoft has a few examples.

  • IIS: ASPNET

  • IIS: .NET Extensibility

  • By default the Web Deploy seems to not install correctly. Change the install in Control Panel > Programs > Programs and Features and ensure the package is completely installed.

    Extension
  • Java JRE. You can check your current install by running java --version in command prompt. Java can be downloaded here.

    • Add a system environment variable “JAVA_HOME” that points to the install path of java. Most likely something close to C:\Program Files\Java\jdk-17.0.1

After installing the server should be rebooted, or the web services restarted (Web Deployment Agent Service and Web Management Service).

Setup IIS

Open the Internet Information Services (IIS) Manager on your Windows Server.

First, create a new site by right clicking on Site then Create New Site.

Add website

Next, fill out the require parameters. If you have setup a DNS you can enter it in the Host name box.

Add website configuration
Attention
Ideally you will add another binding for https. There are many tutorials showing how to enable HTTPS.

Finally, verify that windows authentication is enabled and all other methods are disabled.

Open authentication settings
Verify windows authentication