IIS
How to publish a Wisej app to an IIS Server.
Deploying a Wisej 2 application to IIS is exactly the same as deploying any ASP.NET application. It's just a matter of copying the right files and configuring IIS to recognize the application folder as a web application.

Basic Steps

  1. 2.
    Create the /bin directory in the application's directory
  2. 3.
    Copy all the assemblies from your local /bin to the server's /bin (no need to copy xml and pdb files)
  3. 4.
    Copy the /Themes folder if you have custom themes or mixins
  4. 5.
    Copy the /Images folder if you have images that need to be served as URLs
  5. 6.
    Copy the /App_Data folder if your application uses it
  6. 7.
    Copy Web.config
  7. 8.
    Copy Default.html (and other html files you use sub-applications)
  8. 9.
    Copy Default.json (and other json configuration files if you use sub-applications)
  9. 10.
    Copy favicon.ico.
References:
Application for a Site <application>
docsmsft

Configuration file

If you are deploying a child IIS application, remember that IIS inherits the web.config from the parent application. When the parent application is also a Wisej application, you will get a server error because of duplicate settings in web.config.
There are two solutions:
  1. 1.
    Remove the duplicated setting in the child web.config
  2. 2.
    Add XML statements to remove the duplicated settings in the child web.config.
1
<modules>
2
<remove name="Wisej"/>
3
<add name="Wisej" type="Wisej.Core.HttpModule, Wisej.Framework"/>
4
</modules>
5
6
...
7
8
<handlers>
9
<remove name="json"/>
10
<remove name="wisejn"/>
11
<add name="json" verb="*" path="*.json" type="System.Web.HttpForbiddenHandler" />
12
<add name="wisej" verb="*" path="*.wx" type="Wisej.Core.HttpHandler, Wisej.Framework"/>
13
</handlers>
Copied!
Names are case sensitive.

Debug Mode

When deploying in production, we recommend to turn off the debug flag in web.config.
1
<configuration>
2
<appSettings>
3
<add key="Wisej.LicenseKey" value=""/>
4
<add key="Wisej.DefaultTheme" value="Blue-1"/>
5
</appSettings>
6
<system.web>
7
<compilation debug="true|false" />
Copied!
When debug mode is false all the .js and .css resources are minified and the debug console in the browser receives much less logging data then debug mode.

License Key

Copy your deployment Wisej Server key to web.config in the Wisej.LicenseKey setting. Make sure the server has internet connection in order to activate the license.
You may also use a pre-activated license by copying the wisej-server.lic file that was generated on the server that activated it. It must be placed in the root folder of the deployed project.

App Pool & Permissions

When you create a new application in IIS, it will be assigned to the DefaultAppPool which uses the ApplicationPoolIdentify as the user. This is fine in most deployments.
If you want to create a new Application Pool it's also fine. The only aspect of the application pool that affects Wisej is the user and the user's permissions: it must have Full Control on the system's Temp directory (which is usually located at C:\Windows\Temp).
Assigning Full Control for the system's Temp directory is required for the application to start; otherwise you will see the "Access Denied" exception on startup.
There are several settings on the Application Pool that you may also want to look at depending on your deployment requirements. Please refer to Microsoft's documentation for more information.
If you need additional professional support, please contact us.

Application Request Routing (AAR)

IIS can also function as a simple load balancer when the AAR module is installed. Please refer to Microsoft's documentation to learn about this feature.
Application Request Routing : The Official Microsoft IIS Site
The Official Microsoft IIS Site
Last modified 2mo ago