How To: Install Khaos Control on a client PC
Table Of Contents
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>\SharedAppsNote: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:Obtain ClientSetup
The Client Setup program may already be available on your server at:
K:\KeystoneSoftwareUTILS\ClientSetupIf 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>\SharedAppsSelect Reconnect at sign-in so that Windows reconnects the mapped drive automatically.
3. Run ClientSetup
Run:
K:\KeystoneSoftwareUTILS\ClientSetup\ClientSetup.exeConfigure ClientSetup as follows:
- Make sure MSSQL is selected.
- Set Network Share drive letter to
K. - Set Server Name to
<ServerName>. - Set the MSSQL Database alias name to
KHAOS, retaining the:before the database name where shown in the setup. - Click Begin to install the required files.
Note:KHAOSand 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\ShortcutsCopy 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:
- Full Control of: C:\KeystoneSoftware including its subfolders.
- 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:
- Sign out of Windows.
- Sign back in as the person who will normally use the PC.
- Open File Explorer.
- Map their
K:drive to:\\<ServerName>\SharedApps - Select Reconnect at sign-in.
- Check that the required Khaos Control shortcuts are available.
Test the Installation
Complete the following checks before considering the installation finished.
Test KhaosControl
- Open KhaosControl from the desktop shortcut.
- Sign in.
- Open the Customer screen.
- Select a customer.
- Check that the Address tab displays correctly.
- Open the Stock screen.
- Select a stock record.
- Check that the Detail and Telesales tabs display correctly.
Test KhaosControl TESTING
- Open KhaosControl TESTING from its desktop shortcut.
- Sign in.
- Open several screens to confirm that they load correctly.
- 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.