Kipling Troubleshooting | LabJack
 
« Close

Datasheets and User Guides

App Notes

Software & Driver

 

Kipling Troubleshooting

Getting stuck loading the Splash Screen?

If Kipling is getting stuck at the Splash Screen with an error message "Finishing Installation" or "Failed to start IO manager...", follow the steps below:

  1. Close Kipling.
  2. Delete the files in the temporary files folder as described below.
  3. Re-start Kipling.
  4. If Kipling still doesn't start correctly, delete the temporary files one more time, re-download our latest beta installer, install it, and try again.
  5. On macOS or Linux: try the suggestions listed under the Additional Debugging Steps section.

If none of these suggestions fix the issue, please contact us.

Kipling's sub-process is crashing

This error can happen either right after Kipling starts and when it first starts scanning for devices or after running for a while. This error is typically related to a runtime issue associated with scripting languages or due to a seg-fault.

First, follow the steps for "Getting stuck loading the Splash Screen?" above. If those don't work, try checking if other applications can run LJM_ListAll correctly:

  • Windows - Try using LJLogM - Beta to scan for devices.
  • Windows, macOS, or Linux - Try running one of the ListAll examples:

If device scanning isn't working in other applications or code examples, try re-downloading and installing our latest beta installer and running Kipling again.

If device scanning does work in other software, then there is likely an issue with Kipling that needs to be solved. To report the error, please follow the instructions on the Hacks and Hidden Features page to open the developer tools window. Go to the developer tools console view and take a screenshot. Please send the screenshot and a description of what was happening before the error occurred to [email protected].

Deleting the Temporary Files

Kipling uses the following directory to store application execution files and user settings:

  • Windows: C:\ProgramData\LabJack\K3
  • macOS and Linux: /usr/local/share/LabJack/K3

Deleting the contents of this folder and re-starting Kipling fixes some issues.

Windows

The K3 folder can be deleted by running the following command in a Windows command prompt window:

RMDIR /s C:\ProgramData\LabJack\K3

On Windows, the ProgramData folder is hidden by default. You may need to adjust your system settings to show hidden files using the Windows file explorer.

macOS and Linux

On macOS and Linux, the temporary directory contents can be deleted by running the command:

rm -r /usr/local/share/LabJack/K3/*

Additional Debugging Steps

macOS

When starting Kipling, if it hangs showing only the splash screen and the text "Extracting Static_files", you need to ensure you have permission to write to /usr/local/share/LabJack/ and /usr/local/share/LabJack/K3. A quick fix is to open a terminal window and type the following to make the folder readable and writable:

sudo chmod -R a+rw /usr/local/share/LabJack

Linux

Running the command labjack_kipling may give the following error:

/usr/local/bin/labjack_kipling: 10: /usr/local/bin/labjack_kipling: Syntax error: "fi" unexpected

In this case you need to open /usr/local/bin/labjack_kipling and edit it as necessary—you can uncomment line 9 (echo 'Waiting for Kipling to shut down'):

sudo gedit /usr/local/bin/labjack_kipling

Ubuntu 18.04

Ubuntu 18.04 requires a few additional commands to be run before the application will work. If Kipling won't start, try starting it using the command below to get additional debugging information:

/opt/labjack_kipling/Kipling

  • You may need to install libgconf by running the command below according to this GitHub issue:

    sudo apt -y install libgconf2-4

  • There is a font issue related to libfreetype. There is another GitHub issue here. To fix, run the commands:

    sudo add-apt-repository "deb http://us.archive.ubuntu.com/ubuntu/ artful-updates main"
    sudo apt-get update
    sudo apt-get install libfreetype6=2.8-0.2ubuntu2.1
    sudo apt-mark hold libfreetype6

  • Additionally, if there is an issue loading the "canberra-gtk-module" which is an optional fix. To fix, run the command:

    sudo apt install libcanberra-gtk0 libcanberra-gtk-module

Windows XP - No Longer Supported

Kipling version 3.1.x currently does not run on Windows XP machines. You can use an old version of the installer to get Kipling version 3.0.x and then upgrade the LJM driver manually.