Who is this article for?

Administrators who want to learn about installing the client software.

Windows admin permissions are required

This article provides a step-by-step guide for installing and configuring the client software. It is essential to follow these instructions carefully to ensure a successful setup and seamless connection to the system.

1. Installing the client software
2. Configuring the Live and Training systems
3. Configuring proxy server settings
4. Further Reading

1. Installing the client software

Before beginning installation of the client, please ensure that:

1. You have copied any user configured mkinsight.exe.config files.
2. You are logged in with administrative privileges.
3. You have uninstalled all old versions of the software.
4. You have the necessary configuration details to hand (e.g. mkinsight account name, account password, any firewall or proxy settings that are required to use Internet on your network, and the web server URL that hosts the mkinsight server components.
5. Microsoft.net framework 4..6.1 point one is installed on the system.
6. Run the .msi file provided, following the wizard, choosing required preferences

2. Configuring the Live and Training systems

Once installed it is necessary to configure both the live and training systems.

As an example we will configure the Live system first.

1. Double-click on the MK v11.1 icon on your desktop.
2. The following dialogue box will display

3. The text may differ from that shown above but, by default, the first item in the list for Live and the second item in the list is for Training.
4. Select the Live configuration option
5. The first time that you start the software you will be asked for the configuration settings at the screen shown below:

6. This happens only when a configuration hasn't been provided, and after a successful configuration will not be requested again unless forced.
7. Enter the web server location, account name and account password in the box is provided. Commentary on these options is provided in the below table.

• If you do not use a proxy server on your network click Save Configuration and Start Ideagen MKinsight.
• If successful these parameters are encrypted and stored in the software's local store. If the client software was unable to connect to the server correctly an error message will be displayed with further information.
• If you do use the proxy server please read section 3 in order to configure the software for use through a proxy server.
• Otherwise repeat this process for the Training system by exiting MKinsight, double-clicking the MKinsight - 11.1 icon on the desktop and selecting the MKinsight Training item in the list.

3. Configuring proxy server settings

For IT and Data Security and as part of organisational policy, an organisation may decide to employ the use of firewall or proxy servers. These are often devices located on a network between you and the Internet, or other network points within your organisation that regulate and control the data that passes through it, often by blanket denying all, except predefined access.

MKinsight has been designed to allow communications through proxy servers but requires a little more information in the way of proxy server details in order to function correctly and connect to the Internal Audit MK system.

1. To configure the proxy server details, click on the proxy server button alongside the Web server location text box. A window will appear as below:

Note: The details are specific to your own network configuration and as such there are no defaults or expected values. However, further explanation is given below.

Note: If you are unsure of the configuration you should provide, consult your IT or Networking team for clarification. Ideagen support cannot provide these details as the system belongs to your organisation and as such, we do not have the access to this information.

Note: When you have completed the proxy settings, the message will be displayed on the main screen to show that the settings have been provided.

2. Attempt to store these configuration details by clicking Start MKinsight.
3. If the proxy server details are invalid then a detailed error message will appear to provide more information.

2. Further Reading

1. Creating Application User Account - Standard Authentication - MKinsight 11.1
2. Configuring MKinsight_User and Restoring Databases in MS SQL Server - Standard Authentication - MKinsight 11.1
3. Install Full Text Search - Standard Authentication - MKinsight 11.1
4. Setting up the Web Server (IIS) - Standard Authentication - MKinsight 11.1
5. Installing Client Add-ins - Standard Authentication - MKinsight 11.1
6. Installing a custom logo - Standard Authentication - MKinsight 11.1
7. Appendix 1 – Creating Standard Windows User - Standard Authentication - MKinsight 11.1
8. Appendix 2 – Installation & configuration of Web Service (IIS) - Standard Authentication - MKinsight 11.1
9. Appendix 3 – WCF Activation - Standard Authentication - MKinsight 11.1
10. Appendix 4 – Self-signed SSL certificate - Standard Authentication - MKinsight 11.1