Setting up the Web Server (IIS) - Active Directory - Ideagen Internal Audit MK 12.0
Who is this article for?Administrators who want to learn about creating Application User Account.
Administrative access to the web server is required.
This article will outline the process for setting up the webserver in relation to the installation, setup and configuration of Ideagen Internal Audit MK 12.0.
- Understanding the prerequisites
- Creating the Application Pool
- Installing PentanaMK web applications
- Creating Web applications
- Setting folder Security Permissions
- Configuring MKinsight Online Setup Web Application
- Configuring the Training account
- Configuring the Live account
- Configure Global Settings
- Further Reading
1. Understanding the prerequisites
Make sure all the below points are implemented before continuing with the installation.
- Web Server computer is a member of the network domain. See Appendix 2.
- Windows Server 2012 or above.
- .NET Framework version v4.7.1 .
- Web server (IIS) role and features installed. See Appendix 2 for specific requirements.
- WCF Activation.
- Must activate HTTP Activation. See Appendix 3.
- Must have SSL certificate installed on IIS server and bound to the website where MKinsight web application will be installed.
- IIS Server can connect to the Database Server.
2. Creating the Application Pool
- Run Internet Information Services (IIS) Manager on the web server computer.
- Create an Application Pool named Ideagen Internal Audit (Aura).
- Select .NET Framework version v4.0.
- Leave the other options shown in the Add dialog as the default value.
- Click OK to add the application pool.
For more information about creating an IIS application pool open internet link:
http://technet.microsoft.com/en-us/library/cc731784(v=ws.10).aspx
- Right-click on Ideagen Internal Audit (Aura) application pool and select Advanced Settings.
- Change Load User Profile to True.
- Change Identity to PentanaMK_User using the Custom account option.
For more information about application pool identity open internet link: http://technet.microsoft.com/en-us/library/cc771170(v=ws.10).aspx
3. Installing PentanaMK web applications
Extract the contents of the MKinsight Online Components (MKinsight Server 10.1 Revision X) to the desired folder on the web server computer (e.g. C:\Inetpub\wwwroot\12_0).
Important Note: It is essential that the extracted files remain in the 12_0 folder.
3.1. Create Web applications
- Using IIS Manager, right-click on 12_0 folder.
- Choose Convert to Application.
- Select Ideagen Internal Audit (Aura) Application Pool.
- Click OK.
- Select the 12_0 folder and from the right-hand section and double-click Authentication.
- Using the right-click menu, disable all listed authentication types, and then enable Anonymous Authentication.
- Expand the 12_0 folder and select each sub-application listed in bold below.
- Configure each item as required using a similar process as described above but noting the differences between each application.
- After each Convert to Application step, the Add Application screen is shown. Accept the default options.
- Click OK.
- Apps
- Convert to Application
- Enable Anonymous Authentication
- Remove Windows Authentication
- Dataservices
- Convert to Application
- Enable Anonymous Authentication
- Remove Windows Authentication
- ERM
- Convert to Application
- Enable Forms Authentication
- Enable Anonymous Authentication
- Remove Windows Authentication
- Ext
- Convert to Application
- Enable Forms Authentication
- Enable Anonymous Authentication
- Remove Windows Authentication
- Setup
- Convert to Application
- Enable Windows Authentication
- Once complete, the icons in IIS manager will appear as shown in the screenshot.
3.2. Setting folder Security Permissions
- Using Windows Explorer, go to the 12_0 folder, right-click and select Properties.
- Select the Security tab and click Edit.
- Click Add, and select the PentanaMK_User.
- Ensure the user has the permissions shown below.
- Click OK on Permissions and Properties dialogs.
- Select each of the folders listed below
- Right-click and select Properties
- Go to the Security tab.
- Click Edit.
- Select PentanaMK_User and tick Modify from the Allow list.
- Click OK on Permissions and Properties dialogs.
- 12_0/Apps/temp
- 12_0/Bin/mki.config
- 12_0/DataServices/temp
- 12_0/ERM/Temp
- 12_0/Ext/Temp o 12_0/Logs
- 12_0/overrides
- 12_0/plugins
4. Configure MKinsight Online Setup Web Application
Use Internet Explorer to navigate to the setup application from the web server computer. The IP address or server name in the URL is specific to the network configuration.
http://localhost or (IP address, server name)/12_0/setup/default.aspx
4.1. Configuring the Training account
- Select account Training
- Click Build
- Configure the connection string for the training database:
- Network Location: The network name or IP address for the SQL Server computer. The optional instance name should be specified by using a backslash followed by the name.
- Database Name: Ideagen Internal Audit (Aura) - Training (as appears in SQL Server Management Studio)
- Tick Integrated authentication.
- Click OK.
- Select Test database to verify the connection is working.
- Enter the Password for the Training account. This password will be required when the client installation is configured.
- Click Save to store the settings.
4.2. Configuring the Live account
- Select the Live account.
- Click Build to configure the connection string for the live database.
- Network Location: the network name or IP address for the SQL Server computer. The optional instance name should be specified by using a backslash followed by the name.
- Database Name: Ideagen Internal Audit (Aura) - Live (as appears in SQL Server Management Studio)
- Tick Integrated authentication.
- Click OK and Test database to verify the connection is working.
- Enter the Password for the Live account. This password will be required when the client installation is configured.
- It is recommended that the same password is used for both Live and Training accounts.
- Click Save to store the settings.
5. Configure Global Settings
5.1. Integrated authentication
- Click Add from Servers section:
- Enter a Name to describe the active directory server details. This is the name that will appear on screen when adding users to Ideagen Internal Audit MK.
- Enter the Domain Name for the domain controller using NETBIOS name format (the short name of the domain).
- Complete the username and password boxes using the PentanaMK_User account (Optional).
- Click Save.
Important Note: The password must never expire for the selected user.
- Tick all the boxes below:
- Allow creation of active directory users
- Client software auto-login
- Allow client standard login on auto-login fail
- Online software auto-login
- Allow online standard login on auto-login fail
- Scroll to the bottom of the page and click Save.
5.2. Mail Server
- Configure your mail server using your company specific settings.
- MKinsight uses the SMTP protocol to send e-mails.
- The mail server must support the SMTP protocol and allow access to this feature by the IIS Web Server (Relay).
- Click Save.
6. Further Reading
- Creating Application User Account - Active Directory - Ideagen Internal Audit MK 12.0
- Configuring MKinsight_User and Restoring Databases in MS SQL Server - Active Directory - Ideagen Internal Audit MK 12.0
- Install Full Text Search - Active Directory - Ideagen Internal Audit MK 12.0
- Installing the Client - Active Directory - Ideagen Internal Audit MK 12.0
- Installing Client Add-ins - Active Directory - Ideagen Internal Audit MK 12.0
- Installing a custom logo - Active Directory - Ideagen Internal Audit MK 12.0
- Appendix 1 – Creating Standard Windows User - Active Directory - Ideagen Internal Audit MK 12.0
- Appendix 2 – Installation & configuration of Web Service (IIS) - Active Directory - Ideagen Internal Audit MK 12.0
- Appendix 3 – WCF Activation - Active Directory - Ideagen Internal Audit MK 12.0
- Appendix 4 – Self-signed SSL certificate - Active Directory - Ideagen Internal Audit MK 12.0