KKSys Laptop Installation Steps

Please follow these steps to make an installation on a KK laptop

Upgrading an existing laptop installation

Take new backup files for the "Data" and "SystemDB" databases.
Copy the new EXE file into the appropriate folder on the laptop.
Use the backup files to restore the databases.
Check that the Updates Store is empty, with no "EDBUpd" files waiting to be transferred.
Check for the presence of the "edb_signature" in Regedit.exe under Current_User/Software/Orixa/KKSys

Reviewing the "Signature" settings in Regedit:

Database "signature" settings

To Reset These:

Orixa Registry Management Utility

Open the Registry Management Utility, enter the Application Name "KKSys" and find registry values, then ensure that the "Signature" field is set correctly, other registry settings can be checked at the same time.

Installing onto a new laptop

Install Files from DropBox

Find the latest versions of the needed files.
These may be stored on the server in the "Utilities" folder, or they may be available from the Orixa website "Downloads" page.

Contents of the ZIP file

The zip-file contains all the files needed for the laptop install.

Dictionary files (6 in total)

KKLogo.jpg (splash screen logo)

KKSys.exe, or IKKICOSys.exe or TeleAgricSys.exe

OrxServer.exe

OrxServer.ini

Supporting DLL Files

Create a new user-store

On the server, open the DB Management Utility page of KKSys and create a new downloads store for the new user by running the SQL Script:

CREATE STORE "Downloads-XXX"
AS LOCAL PATH 'Stores/Downloads-XXX'

change "XXX" in the above store to a unique number for the new user.

Then Copy a Backup file for the Data database and SystemDB database into the same store.

Create "C:\KKSys" and copy file

On the laptop, Copy the "OrxUpgrader.exe" into a folder "C:\KKSys" (shown at 1.). If there is a previous installation of KKSys in this folder, delete all the files.

Then run the OrxUpgrader program (shown at 2.)

OrxUpgrader New Installation page

In the OrxUpgrader

Find the "New Installation" page, then:

Set the name of the Remote store to the same name used in the script above.
Enter the database password.
Enter a UID for the new user.

Then click "Create Empty Database", "Create and Open Remote Store".

After this point the files in the remote store should become visible in the window.

Now click "Copy to Local" all the needed files will be copied into the correct places in the laptop.

Restore database screen

Finally, click "Restore DB and SysDB", a window will open (shown in the image) listing the backup files you have copied across.

Follow the instructions on the screen to restore the databases.

Click the backup file for the maindatabase, and click "Restore Main Database".
Click the backup file for the SystemDB database and click "Restore SystemDB Database" button.
NOTE: If your main database is not called "Data" please put the correct database name here.

Once this step is complete the installation is complete and the application is ready to run.

Find the application in the C:\KKSys folder, and double-click it to run.

You can also add a short-cut to the program on the laptop desktop.

The OrxServer Running on the test machine

Once installation is complete the OrxServer program should show running in the Task-Notification Area (marked 1. in the image).

This program runs to connect the KKSys to the database on the laptop. You may need to add this program to Windows Start up folder, as it is not always possible for the installer to do this automatically. See instructions on how to do this at the end of the document.

The "Utils" folder with the OrxServer and its Ini File

The OrxServer program is saved in "\\Database\Utils".

If you need to start it manually you can find it there, and double click to run it.

Sometimes it is necessary to mark this program as "safe" for Windows Defender or any other anti-virus.

Common issues and problems

OrxUpgrader.exe does not run / appear

This is usually because of issues with anti-virus. Review and try to fix this on the machine.

This may be due to "bad" entries in the Windows Registry. If there is a problem run Regedit.exe and navigate to HKEY_CURRENT_USER\Softare\Orixa\KKSys and delete the key.

Registry Editors, Orixa location

Once the installation runs the installer cannot connect to the Server to download the installation files

In this case, run EDB-Manager on the machine, and try to create a new database session which links to the Server (Remote Session, Character-set ANSI, IP Address 192.168.10.254). You may then need to fix network settings on the laptop to enable connection to the server, but the error messages provided by EDB Manager will help diagnose the problem.

EDB Manager Create Session

Everything runs well, but once installed running the EXE gives an error such as "cannot connect" or "connection refused"

Check that the OrxServer.exe is running in the Task Bar, run it. Run EDB Manager and create a new session to connect to it (Remote Session, Character-set ANSI, IP Address 127.0.0.1, port 12010) review any errors and fix them. It is possible that the OrxServer has been set up with "wrong" settings, check these in the OrxServer.ini file.

On restart KKSys does not run, or gives a "cannot connect" or "connection refused" error

Check that OrxServer.exe is running. Add it to the Windows Startup Folder to ensure it runs every time the computer switches on.

Shell:Startup

Type Windows-Key + "R", and in the "Run" box, type "Shell:Startup" and click "OK".

Start up folder

The Windows start up folder will appear (note the location, marked at 1., it is possible to navigate to this directly in windows explorer)

Copy a short-cut to the OrxServer into this folder (shown at 1.) once this is done the OrxServer will always run at start up.