You are viewing an earlier version of the admin guide. For the latest version, please visit EmpowerID Admin Guide v7.211.0.0.

Skip to end of banner
Go to start of banner

Software Requirements

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Current »

To get the most out of your EmpowerID deployment, the following software requirements must be met. At a minimum, EmpowerID recommends one dedicated server for the Web Front-End (hosts server web services) and one dedicated server for the Application server (hosts back-end processes).

To prevent false alarms, errors or performance degradation during the installation and use of EmpowerID, please exclude the following directories from antivirus scanning software:

%ProgramFiles%\TheDotNetFactory\EmpowerID\Programs
%ProgramFiles%\TheDotNetFactory\EmpowerID\Web Sites
%WinDir%\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files
%WinDir%\Microsoft.NET\Framework\v4.0.30319\Temporary ASP.NET Files

Prior to running EmpowerID, you must install the Microsoft IIS CORS and URL Rewrite modules on each EmpowerID server. To do so, please run the below PowerShell script in administrative mode. 

[System.IO.Directory]::CreateDirectory("C:\TempEID")
(New-Object System.Net.WebClient).DownloadFile('https://download.microsoft.com/download/1/2/8/128E2E22-C1B9-44A4-BE2A-5859ED1D4592/rewrite_amd64_en-US.msi', 'C:\TempEID\rewrite_amd64.msi'); `
(New-Object System.Net.WebClient).DownloadFile('http://download.microsoft.com/download/2/F/2/2F259559-FC43-4B2C-B53F-DED3E9950912/IISCORS_amd64.msi', 'C:\TempEID\IISCORS_amd64.msi'); `
Start-Process msiexec.exe -ArgumentList '/i', 'C:\TempEID\IISCORS_amd64.msi', '/quiet', '/norestart' -NoNewWindow -Wait
Start-Process msiexec.exe -ArgumentList '/i', 'C:\TempEID\rewrite_amd64.msi', '/quiet', '/norestart' -NoNewWindow -Wait
rm -r 'C:\TempEID'

EmpowerID is configured for CORS out of the box, so no special configuration is needed. However, if you would like to configure it, you need to make your changes in the web.config file by default at: C:\Program Files\TheDotNetFactory\EmpowerID\Web Sites\EmpowerID.Web.SiteRoot to have your changes take effect across all subpaths.

For more information, see Microsoft IIS CORS module Configuration Reference.

EmpowerID Application and Front-End Server Software Requirements

Server Operating Systems

EmpowerID supports the last 2 major versions of Windows Server.

Although support extends to the last 2 major versions of Windows Server, EmpowerID recommends the latest version.

Please note that installing EmpowerID on a domain controller or on the same server that houses the EmpowerID SQL database is not supported in a production environment.

Additional Software

  • The latest version of the Microsoft® .NET Framework as well as 3.5 SP1 (installed using Server Manager > Features)

  • The latest version of Windows PowerShell is required for servers hosting the Exchange Management Web service. For Windows PowerShell script execution, run the following command in an elevated Windows PowerShell window:

    Set-ExecutionPolicy RemoteSigned

  • The latest version of IIS with ASP.NET (Web Server Role, Application Server Role and WCF Activation Features) is required for server running Web applications.

  • Visual Studio 2022 (any version) on both web/app sandbox servers (required to publish and debug workflows).

    • Please ensure that .NET Framework 4.8 SDK & .NET Framework 4.8 targeting pack or latest version of SDK and targeting pack components are selected.

The (UAC) must be disabled on each client machine running Workflow Studio applications.

Compatibility mode must be turned off when using Microsoft® Internet Explorer to browse EmpowerID. If you are unable to disable compatibility mode for the Internet Explorer security zone that EmpowerID falls into due to requirements for other legacy intranet sites in your organization, you may add EmpowerID URLs to the Trusted Sites zone using Microsoft Group Policy.


On Windows Server 2012 you can run the PowerShell cmdlets below to ensure all IIS prerequisites are met:

Add-WindowsFeature Web-Server,Web-Basic-Auth,Web-Windows-Auth,Web-Cert-Auth,Web-Url-Auth,Web-Http-Errors,Web-Net-Ext,Web-Net-Ext45,WAS-Process-Model,Web-Dyn-Compression,NET-HTTP-Activation,Web-Mgmt-Console,Web-HTTP-Redirect,Web-Asp-Net45,NET-WCF-HTTP-Activation45

Database Software Requirements

Supported Databases

EmpowerID supports the last 2 major versions of Windows SQL Server, to include SQL Server 2017.

Full-Text Search must be installed and enabled. To check your Microsoft SQL Server for Full-Text Search, execute the following T-SQL:

select SERVERPROPERTY('IsFullTextInstalled')

At a minimum the log for tempdb needs to have at least 50GB availability for growth.

Workflow Studio Software Requirements

Client Operating Systems

  • Windows 10 (x86 and x64)

  • The last 2 major versions of Windows Server (x64)

Additional Software

  • The latest version of the Microsoft® .NET Framework as well as 3.5 SP1

  • Microsoft® Visual Studio 2022 (any version)

EmpowerID Web Interfaces Software Requirements

Browser

The latest versions of Firefox, Chrome, Safari, Microsoft Edge and Microsoft® Internet Explorer 11 are supported.

Compatibility mode must be turned off when using Microsoft® Internet Explorer to browse EmpowerID. If you are unable to disable compatibility mode for the Internet Explorer security zone that EmpowerID falls into due to requirements for other legacy intranet sites in your organization, you may add EmpowerID URLs to the Trusted Sites zone using Microsoft Group Policy.

EmpowerID On-Premise Cloud Gateway Software Requirements (Optional installation)

Client Operating Systems

  • Windows 10 with latest updates

  • The last 2 major versions of Windows Server (x64)

Additional Software

None required

  • No labels