Difference between revisions of "ISAPI Extension for IIS"
Yvonne.milne (Talk | contribs) |
Yvonne.milne (Talk | contribs) |
||
(14 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
==See Also== | ==See Also== | ||
− | [[ | + | [[Creating a Self-Signed Certificate]] |
==Installing and Configuring the Lianja ISAPI Extension for IIS== | ==Installing and Configuring the Lianja ISAPI Extension for IIS== | ||
Line 9: | Line 9: | ||
This will provide both HTTP and HTTPS (SSL) access to your Lianja Apps and the whole Lianja APaaS with integrated Login, App Center and Logout. | This will provide both HTTP and HTTPS (SSL) access to your Lianja Apps and the whole Lianja APaaS with integrated Login, App Center and Logout. | ||
+ | |||
+ | If '''Internet Information Services''' is not already installed, it can be added from '''Turn Windows features on or off''' or for Windows Server '''Add Roles and Features'''. Check the box for '''Internet Information Services > World Wide Web Services > Application Development Features -> ISAPI Extensions''' if it is not selected by default. | ||
To install and configure the Lianja ISAPI Extension for IIS perform the following steps. | To install and configure the Lianja ISAPI Extension for IIS perform the following steps. | ||
==IIS Manager== | ==IIS Manager== | ||
− | Open the '''IIS Manager''' | + | Open the '''IIS Manager''': |
− | + | ||
+ | '''Windows 10''': Control Panel > Administrative Tools > Internet Information Services (IIS) Manager | ||
+ | '''Windows 11''': Control Panel > Windows Tools > Internet Information Services (IIS) Manager | ||
− | + | '''Windows Server''': Server Manager > Tools> Internet Information Services (IIS) Manager | |
+ | Select the target site and double-click '''Handler Mappings''' or select '''Handler Mappings''' and click '''Open Feature''' in the '''Actions''' panel. | ||
+ | [[{{ns:file}}:Iis_win_32.png|800px|border|left|link={{filepath:Iis_win_32.png}}|IIS Manager - Handler Mappings]] | ||
<br clear=all> | <br clear=all> | ||
==Add Wildcard Script Map== | ==Add Wildcard Script Map== | ||
− | + | Click '''Add Wildcard Script Map...''' in the '''Actions''' panel. | |
− | + | ||
+ | Click [...] to select the '''Executable''' for your architecture as shown below ([[#Windows 32 bit|32 bit]] / [[#Windows 64 bit|64 bit]]). | ||
− | The 32 bit Lianja ISAPI Extension is | + | Enter the '''Name''' for the Handler: |
+ | <pre>LianjaCloudServerHandler</pre> | ||
+ | |||
+ | ===Windows 32 bit=== | ||
+ | The 32 bit Lianja ISAPI Extension is: | ||
+ | <pre>Drive:\lianja\server\bin\lianja.dll</pre> | ||
+ | [[{{ns:file}}:Iis_win_32_1.png|800px|border|left|link={{filepath:Iis_win_32_1.png}}|Add Wildcard Script Map]] | ||
<br clear=all> | <br clear=all> | ||
===Windows 64 bit=== | ===Windows 64 bit=== | ||
− | + | From v6.0 the 64 bit Lianja ISAPI Extension is | |
+ | <pre>Drive:\lianja\server\bin\x86_64\lianja64.dll</pre> | ||
− | + | Prior to v6.0 it is: | |
− | + | <pre>Drive:\lianja\server\bin\lianja64.dll</pre> | |
+ | [[{{ns:file}}:Iis_win_64_1.png|800px|border|left|link={{filepath:Iis_win_64_1.png}}|Add Wildcard Script Map]] | ||
<br clear=all> | <br clear=all> | ||
− | + | Note that on 64 bit Windows systems, the Lianja ISAPI Extension bit type must match the '''Application Pool'''. | |
− | + | ||
− | + | ||
+ | If the Application Pool has '''Enable 32-bit Applications''' set to False, '''lianja64.dll''' should be used. | ||
− | + | If the Application Pool has '''Enable 32-bit Applications''' set to True, '''lianja.dll''' should be used. | |
− | + | [[{{ns:file}}:Iis_win_64_1b.png|800px|border|left|link={{filepath:Iis_win_64_1b.png}}|Application Pool]] | |
<br clear=all> | <br clear=all> | ||
− | + | ==ISAPI and CGI Restrictions== | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
[[{{ns:file}}:Iis_win81_1.png|450px|thumb|left|link={{filepath:Iis_win81_1.png}}|Allowed (ISAPI and CGI Restrictions) - No]] | [[{{ns:file}}:Iis_win81_1.png|450px|thumb|left|link={{filepath:Iis_win81_1.png}}|Allowed (ISAPI and CGI Restrictions) - No]] | ||
Click '''No''' when prompted. | Click '''No''' when prompted. | ||
+ | |||
+ | If you receive the error ''The specified module required by this handler is not in the modules list'', please go to '''Turn Windows features on or off''' and add '''ISAPI Extensions''' (Internet Information Services > World Wide Web Services > Application Development Features). | ||
<br clear=all> | <br clear=all> | ||
Line 77: | Line 85: | ||
This time, click '''Yes''' when prompted. | This time, click '''Yes''' when prompted. | ||
<br clear=all> | <br clear=all> | ||
− | |||
==Restart IIS== | ==Restart IIS== | ||
− | |||
− | |||
− | |||
Click '''Restart''' to restart the Server. | Click '''Restart''' to restart the Server. | ||
+ | [[{{ns:file}}:iis_win_64_restart.png|800px|border|left|link={{filepath:iis_win_64_restart.png}}|Restart IIS]] | ||
<br clear=all> | <br clear=all> | ||
− | |||
==Run using IIS== | ==Run using IIS== | ||
That's it. You have now integrated Lianja Cloud Server into IIS so now you can use http and https/SSL directly against IIS to serve your Lianja Apps and Data. | That's it. You have now integrated Lianja Cloud Server into IIS so now you can use http and https/SSL directly against IIS to serve your Lianja Apps and Data. | ||
− | |||
[[{{ns:file}}:Iis_win7_32_5.png|450px|thumb|left|link={{filepath:Iis_win7_32_5.png}}|Login]] | [[{{ns:file}}:Iis_win7_32_5.png|450px|thumb|left|link={{filepath:Iis_win7_32_5.png}}|Login]] | ||
Line 97: | Line 100: | ||
The default Username/Password is admin/admin. | The default Username/Password is admin/admin. | ||
+ | |||
+ | See below how to [[#Redirect Default Document|redirect the IIS Default Document]] to '''login.rsp'''. | ||
<br clear=all> | <br clear=all> | ||
Line 112: | Line 117: | ||
Click an App's tile to load the App. | Click an App's tile to load the App. | ||
+ | <br clear=all> | ||
+ | |||
+ | ===Redirect Default Document=== | ||
+ | To redirect the IIS Default Document to '''login.rsp''', first make sure the HTTP Redirection feature is installed. | ||
+ | |||
+ | Windows: | ||
+ | [[{{ns:file}}:http_redirection1.png|left|link={{filepath:http_redirection1.png}}|Add HTTP Redirection Feature (Windows 10)]] | ||
+ | <br clear=all> | ||
+ | |||
+ | Windows Server: | ||
+ | [[{{ns:file}}:http_redirection2.png|600px|left|link={{filepath:http_redirection2.png}}|Add HTTP Redirection Feature (Windows Server)]] | ||
+ | <br clear=all> | ||
+ | |||
+ | Then, as an administrator, edit the web.config file for the site and add in the redirection to your existing configuration. | ||
+ | |||
+ | Here just showing the httpRedirect specification: | ||
+ | [[{{ns:file}}:web_config.png|600px|left|link={{filepath:web_config.png}}|web.config]] | ||
+ | <br clear=all> | ||
+ | |||
+ | <code lang="xml"> | ||
+ | <httpRedirect enabled="true" exactDestination="true" httpResponseStatus="Found"> | ||
+ | <add wildcard="/iisstart.htm" destination="/login.rsp" /> | ||
+ | </httpRedirect> | ||
+ | </code> | ||
+ | |||
+ | Note that this assumes '''iisstart.htm''' is the first reached Default Document. If this is not the case, replace '''iisstart.htm''' in the code above. | ||
+ | |||
+ | [[{{ns:file}}:iis_default_document.png|600px|left|link={{filepath:iis_default_document.png}}|IIS Default Document]] | ||
+ | <br clear=all> | ||
+ | |||
[[Category:Installation]] | [[Category:Installation]] | ||
[[Category:Deployment]] | [[Category:Deployment]] | ||
− | [[Category:Cloud Server]] | + | [[Category:Lianja Cloud Server]] |
+ | [[Category:Lianja v6.0]] |
Latest revision as of 10:00, 22 June 2023
Contents
See Also
Creating a Self-Signed Certificate
Installing and Configuring the Lianja ISAPI Extension for IIS
If you want to integrate Lianja Cloud Server in with IIS you need to install and configure the Lianja ISAPI Extension for IIS.
The Lianja Cloud Server ISAPI Extension handles built-in connection pooling providing optimum performance when used with IIS.
This will provide both HTTP and HTTPS (SSL) access to your Lianja Apps and the whole Lianja APaaS with integrated Login, App Center and Logout.
If Internet Information Services is not already installed, it can be added from Turn Windows features on or off or for Windows Server Add Roles and Features. Check the box for Internet Information Services > World Wide Web Services > Application Development Features -> ISAPI Extensions if it is not selected by default.
To install and configure the Lianja ISAPI Extension for IIS perform the following steps.
IIS Manager
Open the IIS Manager:
Windows 10: Control Panel > Administrative Tools > Internet Information Services (IIS) Manager
Windows 11: Control Panel > Windows Tools > Internet Information Services (IIS) Manager
Windows Server: Server Manager > Tools> Internet Information Services (IIS) Manager
Select the target site and double-click Handler Mappings or select Handler Mappings and click Open Feature in the Actions panel.
Add Wildcard Script Map
Click Add Wildcard Script Map... in the Actions panel.
Click [...] to select the Executable for your architecture as shown below (32 bit / 64 bit).
Enter the Name for the Handler:
LianjaCloudServerHandler
Windows 32 bit
The 32 bit Lianja ISAPI Extension is:
Drive:\lianja\server\bin\lianja.dll
Windows 64 bit
From v6.0 the 64 bit Lianja ISAPI Extension is
Drive:\lianja\server\bin\x86_64\lianja64.dll
Prior to v6.0 it is:
Drive:\lianja\server\bin\lianja64.dll
Note that on 64 bit Windows systems, the Lianja ISAPI Extension bit type must match the Application Pool.
If the Application Pool has Enable 32-bit Applications set to False, lianja64.dll should be used.
If the Application Pool has Enable 32-bit Applications set to True, lianja.dll should be used.
ISAPI and CGI Restrictions
Click No when prompted.
If you receive the error The specified module required by this handler is not in the modules list, please go to Turn Windows features on or off and add ISAPI Extensions (Internet Information Services > World Wide Web Services > Application Development Features).
Double-click the newly added Handler to Edit.
Click the Request Restrictions... button.
Uncheck Invoke handler only if request is mapped to:.
Click OK.
This time, click Yes when prompted.
Restart IIS
Click Restart to restart the Server.
Run using IIS
That's it. You have now integrated Lianja Cloud Server into IIS so now you can use http and https/SSL directly against IIS to serve your Lianja Apps and Data.
To login, specify login.rsp.
The default Username/Password is admin/admin.
See below how to redirect the IIS Default Document to login.rsp.
Once logged in, you will be taken to the App Center.
Note: you will only see deployed Apps.
Click an App's tile to load the App.
Redirect Default Document
To redirect the IIS Default Document to login.rsp, first make sure the HTTP Redirection feature is installed.
Windows:
Windows Server:
Then, as an administrator, edit the web.config file for the site and add in the redirection to your existing configuration.
Here just showing the httpRedirect specification:
<httpRedirect enabled="true" exactDestination="true" httpResponseStatus="Found"> <add wildcard="/iisstart.htm" destination="/login.rsp" /> </httpRedirect>
Note that this assumes iisstart.htm is the first reached Default Document. If this is not the case, replace iisstart.htm in the code above.