Configuring the Web Application Path
For each InterSystems IRIS web application you want to serve, configure its relative path (/csp or /irisinstance2) as an IIS Application.
Note that configuring an IIS Application creates the path mapping which is required to allow the web server to serve static files, provided that the web server has adequate permissions to access the physical path.
For each application path you want to configure, perform the following steps:
-
Open the Internet Information Services (IIS) Manager.
-
Within the Connections panel, expand the contents of your localhost connection to select Sites > Default Web Site.
-
Select View Applications from the Actions panel.
-
Select Add Application... from the Actions panel.
-
In the Add Application dialog, provide the following information:
-
Alias: the relative base URL path for the application. For example: /irisinstance2 for applications hosted by the instance IRISinstance2, or csp for the application /csp/sys and its sibling applications.
-
Physical path: the directory which contains the static files associated with the application. If you want IIS to serve static files from a different directory for applications with paths subordinate to the application path you are currently configuring, define an IIS Virtual Directory for the child directory.
-
Select OK.
-
If you are finished configuring IIS, restart it to allow configuration changes to take effect.
Note:
To access the management pages for a Web Gateway without access to an InterSystems IRIS instance, enable the Web Gateway for the /csp path.
If you are using a Web Gateway solution based on an alternative option, set up an application called /bin under the /csp application. Map this to the physical directory holding the Web Gateway binaries. In most cases, this would be a mapping between the application path /csp/bin and the physical path C:\Inetpub\CSPGateway
Define a Virtual Directory
IIS Virtual Directories enable users to serve some static content from a file system location outside of the file system location specified for the application. For example, the administrator of a static web site which hosts its images at domain.com/images can store most of the web site’s content in C:\Inetpub\wwwroot but store images in C:\siteimg by mapping the Virtual Directory images to that physical path.
You can use IIS Virtual Directories if you maintain different static file storage locations for different InterSystems IRIS applications within one parent path directory (for example, /csp).
To configure an IIS Virtual Directory:
-
Within the Internet Information Services (IIS) Manager, locate the IIS Application for which you want to configure a subordinate Virtual Directory in the Connections panel, and select it.
-
Select View Virtual Directories from the Actions panel.
-
Select Add Virtual Directories from the Actions panel.
-
In the Add Virtual Directory dialog, provide the following information:
-
Select OK.
-
If you are finished configuring IIS, restart it to allow configuration changes to take effect.
