Set up Corticon Server for .NET
- Last Updated: November 6, 2023
- 4 minute read
- Corticon
- Version 6.3
- Documentation
The Corticon install guide describes the system requirements and options for Corticon Server installation. When you download and run the installer for Corticon Server, choose the Corticon Server for .NET option. That installer will install utilities, scripts, and samples as well as resources that will be provisioned to the IIS server.
See Run the Server and Web Console installer wizard .Checklist
- System requirements are met—See System requirements.
- IIS is setup and verified.—See How to set up IIS server.
- Corticon Server for .NET is installed on the IIS machine—See Run the Server and Web Console installer wizard. The installer sets up the REST API doc, utilities, scripts, and samples as well as resources that will be provisioned to the IIS server.
- You have a Corticon Server for .NET license that was issued to you.
IMPORTANT: The default Corticon server for .NET installation doesn’t include an evaluation license. You need a proper evaluation or production license from Progress to run the software. If not, Corticon Server for .NET will not work. Once you have a non-evaluation license JAR, navigate to the IIS installation location, typically
C:\inetpub, and then navigate to its\wwwroot\Corticon\libdirectory to paste the file and, if necessary, overwrite the existing file in that location.
Sites\Default Web
Site, and then right-click on any Applications and choose Remove. In
the File Explorer, delete all folders except aspnet_client. Close the
IIS Manager, and then relaunch it.To install Corticon for .NET to the IIS server:
- Launch
C:\<Corticon_Server>\Server .NET\IIS\install.batas Administrator. Press Enter to run the script. - IMPORTANT: Use the File Explorer to copy your .NET license file,
CcLicense.jar, toC:\inetpub\wwwroot\Corticon\lib. A license file may have been installed but it is not one enabled for .NET..
Create the axis application in IIS
To convert the axis directory into an application:
- In the IIS Manager, select the DefaultWebsite, then right-click on the root, and select Refresh.
- Expand the tree and navigate to the
axisdirectory. - Right-click on the
axisfolder, and then choose Convert to Application. - In the Add Application Pool dialog that
opened, choose .NET v4.5 Classic, and then click
OKin both dialog boxes.
Set Access Permissions for directories in IIS
Corticon Server for .NET needs to be able to write to various
subdirectories of the IIS installation directory's axis subdirectory. The following task might be required for your setup, as
the Classic Application Pool runs under the built in user account ApplicationPoolIdentity, a user that has no WRITE permissions for the axis folders, so these rights must be set.
To set access permissions:
- In the IIS Manager, select the DefaultWebsite, then right-click on the root, and select Refresh.
- Expand the tree and navigate to the
axisdirectory. - Right-click on
axis, and then choose Edit Permissions. In the dialog, click the Security tab. Click Edit, and the choose IIS_IUSRS. Click the Allow - Full control box, as shown:
Note: If you do not have a userIIS_IUSRS, click Add, and then enter an object nameIIS_IUSRS(yourUserName\IIS_IUSRS). - Click Apply, then OK to both dialogs.
- Similarly, right-click on the
Corticonfolder, and then choose Edit Permissions. In the dialog, click the Security tab. Click Edit, and the choose IIS_IUSRS. Click the Allow - Full control box. Click Apply, then OK to both dialogs. - In the IIS Manager, right-click on the root to choose Stop,
and then after a few seconds, choose Start. (You might prefer
to execute
iisresetin a Command Prompt to restart IIS.)
The IIS Internet Information Services is now running the axis web service for Corticon.
Once your Corticon Server for .NET is up, it a good idea to check all configuration properties to confirm the setup of the work directory, and that the license has been correctly applied. Before you do so, you may want to wait a minute to let IIS finish the startup of Corticon Server. Then you will see the number of milliseconds in the response that the server has been up.