Skip to main content
Skip table of contents

Installation

Windows Server Step-by-step guide

Prerequisites

  1. Please ensure your server has the minimum requirements installed.
  2. Please ensure you have the ASP.NET Core Runtime Hosting Bundle installed.
    1. For EzeScan WebApps versions 3.10.x or higher, please ensure you have the ASP.NET Core Runtime Hosting Bundle 8.0.x installed.
    2. For EzeScan WebApps versions 3.9.x or lower, please ensure you have the ASP.NET Core Runtime Hosting Bundle 6.0.x installed.
    3. Make sure you select the "Hosting Bundle" option for your respective version.


The ASP.NET Core Runtime hosing bundle must be installed after the IIS components. 

If you have installed the hosting bundle before installing IIS then please rerun the ASP.NET Core Runtime hosting bundle installer.
If you don't then you will see an error messaging from IIS saying it doesn't understand the sites web.config file.

Installation files

  1. Go to the EzeScan website www.ezescan.com.au
  2. Logon using your User ID & Password
    1. Contact support@ezescan.com.au if you are unsure as to what this is.
  3. Go to Downloads > Software Downloads > EzeScan Webapps
  4. Download and then extract the installation files to the Downloads folder.
  5. Copy the extracted folder to C:\ or whichever drive or folder to your liking.
  6. Rename the folder to EzeScan.WebApps to remove the version number.
  7. Check the folder contains the application files.

Create Application Pool in IIS

  1. Open Internet Information Services (IIS) Manager.
  2. Right click Application Pools > select Add Application Pool.
  3. Set the following options and click OK:

    NameEzeScanWebApps
    .NET CLR VersionNo Managed Code
    Managed pipeline modeIntegrated

  4. Confirm your application pool appears in the list.

Set Application Pool settings

  1. Right click EzeScanWebApps > select Advanced Settings...
  2. Set the Start Mode to AlwaysRunning.
  3. Set the Disable Overlapped Recycle to True.
  4. Click the OK button to save the settings.

Set Permissions

EzeScan WebApps application pool’s identity needs to have read/write access to the App_Data folder in order to move files around and function correctly.

  1. Navigate to the EzeScanWebApps directory.
  2. Right click the App_Data folder and select Properties.
  3. Select the Security Tab and then click the Edit button.
  4. Click the Add button.
  5. Enter IIS AppPool\EzeScanWebApps and click the Check Names button.
  6. Confirm the name is changed to EzeScanWebApps and click the OK button.
  7.  Tick the Modify checkbox and then click the OK button.

Setup IIS

  1. Open Internet Information Services (IIS) Manager.
  2. Right click Default Web Site and then click Add Application.
  3. Set the following values:

    Site Aliasewa
    Application PoolEzeScanWebApps (click Select button)
    Physical PathC:/EzeScanWebApps (click ... to navigate)
    Enable PreloadTicked

  4. Click OK to finish and confirm your application is shown under Default Web Site.

Testing the site

  1. Right click on ewa > Manage Application > Browse.

    If page load fails with an error 500. One possible cause could be that in Prerequisites section, you did not check that IIS was installed and enabled before you installed the ASP.NET Core Runtime Hosting Bundle 6.0.x bundle.

    If you had installed and enabled IIS only after you had installed the ASP.NET Core Runtime Hosting Bundle 6.0.x bundle, you will need to go back and reinstall the ASP.NET Core Runtime Hosting Bundle 6.0 again, and choose to 'Repair' it's prior install.

    Once its repaired, stop and start the IIS site and retry step 1 above to retest the site.

  2. If the page loads, then installation is complete.
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.