How To: Install Khaos Control on a client PC

Once Khaos Control has been installed and tested on the server, the client PCs can be setup to access it. Whilst the Client PC installation program should always be run by a user with Administrator rights to the computer, 'normal' users may run Khaos Control subject to having the necessary directory and registry permissions.

Should you require additional help when installing a new KhaosControl client please email Support.

Prerequisites

Server

It is not possible to perform this setup using external servers. - the Khaos Control server must be in-house.

Mapping to the SharedApps folder

A requirement of all Khaos Control clients is a mapped drive which points to the network path on your file server where all the Khaos Control files are located. This is best performed by your network / IT administrator. Contact Khaos Control support if you do not have an IT administrator.

Before proceeding, ensure that the Administrator running the Client PC installation program on the Client PC has their K: drive mapped to the SharedApps share on the server
Note: the use of the drive letter K: is preferred, not mandatory. The actual letter does not matter, so long as ALL Khaos Control users on ALL Client PCs use the same letter to map to the server's SharedApps folder. All other users of the Client PC will also need to be mapped to this in order to run Khaos Control.

Obtaining the Client Setup program

The client setup program may be available in the "K:\KeystoneSoftwareUTILS\ClientSetup folder" on your server. If not, you will need to download it from the Khaos Control Support website: /restricted-article/downloads/

.NET Framework

.NET Framework 4.5 or above must be installed on the client machine for Khaos Control.

Running the Client Setup program

To install a Khaos Control client* on a PC:

  1. Logon to the PC as a user with local Administrator rights.
  2. Open "My Computer", map the "K:" drive to "\\<ServerName>\\SharedApps" and tick the "Reconnect on Logon" box.
  3. Run the setup program "K:\ KeystoneSoftwareUTILS\ClientSetup\ClientSetup.exe"
    • Firstly ensure that the MSSQL option is selected.
    • Set Network Share drive letter to "K".
    • Set Server Name to "<ServerName>".
    • Set MSSQL Database alias name to "KHAOS", making sure to retain the : before the database name.
      Note: your database name and SQL instance name are not necessarily the same as mentioned here, these are the default examples.
    • Click the Begin button to start installing the files.
    When the process completes you will find a new shortcut on your desktop which can be used to load Khaos Control. If everything has been successful you should now be able to log into Khaos Control.
    Note: Should the client PC have a firewall configured, it may be necessary to enable selected ports. Similar considerations apply if port blocking or anti-virus software is in use.
  4. Open the "K:\KeystoneSoftwareUTILS\Shortcuts" folder and copy the relevant icons to the local PC's "C:\Documents and Settings\All Users\Desktop" folder (this will ensure that all users of the PC get the icons on their desktops).
    • For most PCs, just two icons are needed:
      KhaosControl (running ClientSetup should already have created this icon)
      KhaosControl TESTING
    • The System Administrator (or anyone else who will be downloading and applying updates to Khaos Control) will also need:
      ChangeLog
      ChangeLog TESTING
  5. You may also wish to copy the icons to a "Keystone Software" folder in the Start Menu (e.g. "C:\Documents and Settings\All Users\Start Menu\Programs\Keystone Software")
  6. If the normal user does NOT have local administrator rights on the PC:
    • Give the user Full Control of the "C:\KeystoneSoftware" directory tree.
    • Give the user Full Control of the "HKLM\Software\KeystoneSoftware" key and its subkeys in the HKEY_LOCAL_MACHINE registry hive.
  7. Logoff the PC and logon again as the normal user.
  8. Open "My Computer", map the user's "K" drive to "\\<ServerName>\SharedApps" and tick the "Reconnect on Logon" box.
  9. Check that the Khaos Control icons are present.
  10. Run "KhaosControl" from the desktop icon, open the Customer screen, select a customer record and check the address tab displays correctly. Then open the stock screen, select a stock record and check the detail and telesales tabs display correctly.
  11. Run "KhaosControl TESTING" from the desktop icon and check that a variety of screens load, for example the [ Stock | List ] screen.

You have now successfully installed Khaos Control on the Client PC.

Note: These instructions assume the following to be true:

  1. Khaos Control uses a SQL Server database running on a server called <ServerName>;
  2. All Khaos Control clients are using the K: drive as their shared drive;
  3. The live Khaos Control database is called KHAOS and the testing database is KHAOS_TESTING.

Did you find this article helpful?