How To: Install Khaos Control on a client PC

Once Khaos Control has been installed and tested on your server, you can configure individual client PCs to access it.

Run the Client PC installation while signed in with local Administrator rights. Day-to-day users do not need to be local administrators, provided they have the required folder, network share and registry permissions.

If you need additional help installing a new Khaos Control client, email Support.

Prerequisites

Before starting, check the following requirements.

Server

These instructions are for an in-house Khaos Control server. This setup cannot be performed using an external server.

Map the SharedApps Folder

Every Khaos Control client requires a mapped network drive pointing to your server's SharedApps folder.
Where possible, ask your network or IT administrator to configure this. If you do not have an IT administrator, contact Khaos Control Support.

Before running Client Setup, make sure the Administrator account being used on the client PC has the following mapping:
K: → \\<ServerName>\SharedApps
Note: K: is the preferred drive letter, but it is not mandatory. Whichever drive letter you choose, all Khaos Control users on all client PCs must use the same drive letter for the SharedApps folder.

Every Windows user who needs to run Khaos Control on the PC also needs access to this mapped drive.
Existing Khaos Control documentation continues to reference resources and application files stored on the mapped K: drive, for example:

 K:\KeystoneSoftwareUTILS\Shortcuts and K:\KeystoneSoftware\Applic\KhaosControl.exe. 

Obtain ClientSetup

The Client Setup program may already be available on your server at:

K:\KeystoneSoftwareUTILS\ClientSetup

If it is not available there, download it from the Khaos Control Downloads page.

.NET Framework

The client PC must have.NET Framework 4.5 or later installed.

Install the Client

1. Sign in as an Administrator

Sign in to the client PC using an account with local Administrator rights.

2. Map the SharedApps Drive

Open File Explorer and map:

K: → \\<ServerName>\SharedApps

Select Reconnect at sign-in so that Windows reconnects the mapped drive automatically.

3. Run ClientSetup

Run:

K:\KeystoneSoftwareUTILS\ClientSetup\ClientSetup.exe

Configure ClientSetup as follows:
  1. Make sure MSSQL is selected.
  2. Set Network Share drive letter to K.
  3. Set Server Name to <ServerName>.
  4. Set the MSSQL Database alias name to KHAOS, retaining the : before the database name where shown in the setup.
  5. Click Begin to install the required files.
Note: KHAOS and the example SQL Server details in these instructions are defaults. Your database and SQL instance names may be different.
Khaos Control SQL connections can include both a SQL Server/instance and database name. For example, current Khaos Control documentation shows a connection in the format MYSERVER\SQLEXPRESS:KHAOS. 

When ClientSetup finishes, you should have a new KhaosControl shortcut on the desktop.

4. Check Firewall and Security Software

If the client PC has a firewall, port-blocking software or anti-virus restrictions, additional configuration may be required to allow the client to communicate with the server.

Set Up the Shortcuts

Open:

K:\KeystoneSoftwareUTILS\Shortcuts

Copy the appropriate shortcuts to the client PC so they are available to the required users.

For most PCs, you need:
  • KhaosControl, although ClientSetup should already have created this shortcut.
  • KhaosControl TESTING
The System Administrator, or anyone responsible for downloading and applying Khaos Control updates, may also need:
  • ChangeLog
  • ChangeLog TESTING
Khaos Control's current documentation also identifies K:\KeystoneSoftwareUTILS\Shortcuts as the standard location from which existing shortcuts can be copied and modified. 
You can also add the required shortcuts to a Keystone Software folder in the Windows Start menu.

Configure Permissions for Non-Administrator Users

If the person who normally uses the PC does not have local Administrator rights, give them the following permissions:
  1. Full Control of: C:\KeystoneSoftware including its subfolders.
  2. Full Control of the following registry key and its subkeys:
    HKEY_LOCAL_MACHINE\Software\KeystoneSoftware
Important: Changing registry permissions can affect the PC. Only make these changes if you are familiar with managing Windows permissions or have assistance from your IT administrator.

Set Up the Normal Windows User

Once ClientSetup and the required permissions have been configured:
  1. Sign out of Windows.
  2. Sign back in as the person who will normally use the PC.
  3. Open File Explorer.
  4. Map their K: drive to:
    \\<ServerName>\SharedApps
  5. Select Reconnect at sign-in.
  6. Check that the required Khaos Control shortcuts are available.

Test the Installation

Complete the following checks before considering the installation finished.

Test KhaosControl

  1. Open KhaosControl from the desktop shortcut.
  2. Sign in.
  3. Open the Customer screen.
  4. Select a customer.
  5. Check that the Address tab displays correctly.
  6. Open the Stock screen.
  7. Select a stock record.
  8. Check that the Detail and Telesales tabs display correctly.

Test KhaosControl TESTING

  1. Open KhaosControl TESTING from its desktop shortcut.
  2. Sign in.
  3. Open several screens to confirm that they load correctly.
  4. For example, open [ Stock | List ].
If these checks are successful, the client PC is ready to use with Khaos Control.

Example Configuration Used in This Guide

These instructions use the following example configuration:
  • SQL Server: <ServerName>
  • Shared drive: K:
  • Shared folder: \\<ServerName>\SharedApps
  • Live database: KHAOS
  • Testing database: KHAOS_TESTING
Your installation may use different server, drive or database names. Use the values configured for your own Khaos Control environment.

Did you find this article helpful?