Morgan Kai Ltd

MKinsightTM

MKinsight Installation Instructions

Client components

(Version 8.1)

Document version 1.0

th
30 April 2013
MKinsight Installation Instructions v 1.0

Table of Contents
1 Introduction .................................................................................................... 3
1.1 Install the client software ........................................................................... 3
1.2 Configure the Live and Training systems ...................................................... 3
1.3 Advanced configuration – proxy server settings ............................................ 6

Page 2 of 7 Morgan Kai Ltd

v 1.0 MKinsight Installation Instructions

1 Introduction
1.1 Install the client software

Before beginning installation of the client, please ensure that:

 You have copied any user configured config.xml files.

 You are logged in with administrative privileges.
 You have uninstalled all old versions of the software and;
 You have the necessary configuration details to hand - namely the MKinsight
account name, account password, any firewall or proxy settings that are required
to use the Internet on your network, and the web server URL that hosts the
MKinsight server components, and;
 Microsoft .NET Framework v3.5 SP1 is installed on the system.

Run the msi provided, following the wizard, choosing requested preferences.

1.2 Configure the Live and Training systems

Once installed it is necessary to configure both the Live and the Training systems.

As an example, we will configure the Live system first.

Double click on the MKInsight – 8.1 icon on your desktop. Or Double click on the
MKInsight – Live icon if you have both MKInsight – Live and MKInsight – Training icons.

If you have only the one icon (MKInsight – 8.1) the following dialog box will display.

The Text may differ from that shown above, but the first item is for Live and the
second item in the list is for Training.

Select the Live Configuration option.

The first time that you start the software, you will be asked for the configuration settings
at the screen shown below:

Morgan Kai Ltd Page 3 of 7

MKinsight Installation Instructions v 1.0

This happens only when a configuration hasn't been provided, and will never be
requested again upon successful configuration.

Enter the web server location, account name, and account password in the
boxes provide. Commentary on these options is provided below:

Parameter Typical value Notes

Web server https://mydomain/mkinsight The URL or IP address of the

location web server as accessible. The
URL should not include the
8_1 part of the web address
e.g:

https://mkinsight.com/

Account name MKInsight-Live The account names are pre-

configured by Morgan Kai,
and are in the format ‘XXXX-
Live’ or ‘XXXX-Training’

(Case Sensitive)

Account <as configured> This is the password

password configured in the ‘MKInsight
Setup’ web application by
your IT team or provided by
Morgan Kai.

If you do not use a proxy server on your network, then click ‘Save Configuration
and Start MKinsight’ and if successful, these parameters are encrypted and

Page 4 of 7 Morgan Kai Ltd

v 1.0 MKinsight Installation Instructions

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 a proxy server, then please read Section 1.3 in order to configure
the software for use through a proxy server.

Otherwise, repeat this process for the Training system by exiting MKinsight and
Double clicking the ‘MKinsight – 8.1’ icon on the desktop and selecting the
Training item in the list or Double click on the ‘MKinsight – Training’ icon on the
desktop.

Morgan Kai Ltd Page 5 of 7

MKinsight Installation Instructions v 1.0

1.3 Advanced configuration – proxy server settings

For IT and Data Security and/or 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 then regulate and control the data that passes
through it, often by blanket denying all except pre-defined access.

MKinsight has been designed to allow communication 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 MKinsight system.

To configure the proxy server details within MKinsight, click on the ‘Proxy server’
button alongside the web server location text box. A window as below will be
displayed:

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.

Page 6 of 7 Morgan Kai Ltd

v 1.0 MKinsight Installation Instructions

Setting Details

Proxy server location

Use machine names (from This will use the exact same proxy server
Internet Explorer) details as configured within your Internet
Explorer (the details being found in Tools |
Internet Options, Connections tab, then
clicking the ‘LAN settings’ button.

Bypass on local addresses This instructs the software to not use the
proxy server for addresses on your local
network.

Authentication

Anonymous – no login This setting specifies that the proxy server

required listed below does not require direct
authentication.

Integrated – login with MKinsight will attempt to authenticate with

current user details the proxy server via Windows Authentication
(current user).

Specific – complete login If the proxy server requires configuration

details below with explicit details and the settings above
do not apply, then you should complete
these details.

If you are unsure of the configuration you should provide, consult your
IT/Network team for further clarification. Morgan Kai cannot provide details as
the system belongs to your organisation and as such, we do not have access to
this information.

When you have completed proxy

setting, a message will be displayed on
the main screen to show that settings
have been provided.

You may now attempt to store these configuration details by clicking 'Start MKinsight'. If
the proxy server details are invalid, then a detailed error message will appear to provide
more information.

Morgan Kai Ltd Page 7 of 7