Installing KnowBuddy™ or the Linguist™ applications

KnowBuddy is a collaborative application for grammatical disambiguation of sentences organized within a lattice of groups which may correspond to a table of contents or other document structure.

The Linguist extends KnowBuddy’s grammatical disambiguation capabilities to logical disambiguation, including specifying quantifiers, scopes of formulas, and co-references between phrases.

Together, the applications enable teams to acquire knowledge from text and develop artificially intelligent applications, such as in:

o   compliance

o   policy automation

o   decision management

o   question answering

o   decision support

The applications are patent pending and copyrighted by Automata, Inc.

Contents

Introduction. 1

Prerequisites for launching the application. 1

Installation using the browser. 1

Safari-specific installation: 1

Installing from the command line. 1

Running the application for the 1st time. 1

Opening a terminal on Mac OSX: 1

Opening a terminal on Windows 10: 1

Problems launching the application. 1

Uninstalling Java webstart applications. 1

Installing application shortcuts on the dock or desktop. 1

Relaunching the application. 1

Reporting problems. 1

Configuring Java to show the console. 1

 

Introduction

You must install Java in order to run KnowBuddy or the Linguist.

·         Install Java from https://java.com/en/download/manual.jsp

o   preferably a 64-bit version on 64-bit versions of Windows or Linux

·         See Java webstart applications for more information

The software is available from the following URLs:

·         https://linguist.haleyai.com/webstart/KnowBuddy.jnlp

·         https://linguist.haleyai.com/webstart/Linguist.jnlp

The command line instructions are platform-independent and avoid certain operating system or browser specific steps described below.

For example, the command line instructions allow you to bypass Apple’s prohibition of applications that are not installed via the Apple Store.  Alternatively, see the Mac OSX instructions using the Safari browser below.

On Microsoft Windows, it is not uncommon for Java to be installed but not enabled in one of various browsers.  Generally, however, there are fewer issues with installing through the browser on Windows.

Prerequisites for launching the application

You must have registered with Automata, Inc. by submitting the login form with the register checkbox checked.

·         http://linguist.haleyai.com/login

Automata, Inc. may follow up with you regarding your registration or simply confirm your registration, in which case the email address you registered will receive a link for you to confirm and finalize your registration.

If you are registered, you will be able to visit the following URL from your browser.  Doing so will cause your browser to prompt for your credentials, which are the email address and password with which you registered or otherwise as provided you by Automata, Inc.

·         https://lingust.haleyai.com/kb?action=list

If you are properly registered, the response to this URL will be text listing the names of knowledge bases to which you have access (e.g., “public”).  If you receive no error but a blank page, please contact linguist@haleyai.com.

Installation using the browser

The easiest way to install the software on most platforms is to click on the links given above from your browser.  Unfortunately, there may be platform- or installation-specific issues, as addressed here.

Safari-specific installation:

On the Mac, the links download a JNLP file that Apple will not permit to launch.  Consequently, it will seem like nothing happens unless you check your downloads:

If you select the downloaded JNLP file, the application may be prohibited (depending on your security settings) because, for example, the application was not downloaded from the Apple store.

To resolve this, go to System Preferences:

Choose the Security & Privacy panel:

And permit the downloaded application to run by clicking “open anyway”:

Finally, select “open” when asked for confirmation:

Proceed to the section on running the application for the 1st time or, if Java says it is unable to launch the application, go to the corresponding section below.

Installing from the command line

Open a terminal shell with a command-line prompt.  Instructions to do this are given for Mac OSX and Windows 10 below.

Use the java webstart command to launch the application by typing the following in the terminal:

·         javaws https://linguist.haleyai.com/webstart/KnowBuddy.jnlp  

If this command does not execute properly, install Java from https://java.com/en/, see your systems administrator, or contact linguist@haleyai.com.

Running the application for the 1st time

Give the application permission to execute on your machine (check the box, if desired):

Opening a terminal on Mac OSX:

Open a terminal window from the utilities folder of the Finder, as shown below:

Opening a terminal on Windows 10:

·          Type X while holding down the Windows key or right click on the start menu and select “Command Prompt”, or

·          Type “cmd” and select “Command Prompt” or say “command prompt” to Cortana.

Problems launching the application

You may experience the following when launching the application:

This can happen when 1st installing the application or when relaunching the application.  Each time the application is launched it checks the web site to make sure it is up to date.  If the web site cannot be reached (e.g., if the machine is not connected to the Internet) or if there is some other communication problem.

When this dialog is presented, more information about the precise cause is available by pressing the “details” button.  This will present a dialog with a more detailed explanation and a number of tabs.  The exception tab is most informative, so if reporting a problem, please included the contents of that tab (or a screen shot of the dialog).

If the details indicate a communication problem, the typical course of action is simply to try again.  If the details indicate some more obscure problem, it may help to clear Java’s cache and try again.

Uninstalling Java webstart applications

In some circumstance, Java may become confused or corrupted.  For example, if an older version of the application is not properly updated or if certain types of communication problems occur between a computer and the web server providing the application.

To ensure that a complete and current copy of the application is downloaded, you can use the command line or the Java control panel.

From the command line, you can use the following command which is installed when you install Java.  If it is not found, Java is not properly installed.

·         javaws

This will present instructions, including “-clearcache”, which will remove all cached applications, e.g., using the following command:

·         javaws -clearcache

Alternatively, open the Java control panel (the last icon shown here in Mac System Preferences) and press the “view” button on its “general” panel:

Select the application to be removed and press the button to delete it (e.g., the red X).

Then make sure any old icons are deleted from your desktop before reinstalling the application.

Installing application shortcuts on the dock or desktop

There are settings in the Java control panel which may prevent the installation of a shortcut to launch the application on your dock or desktop.  These can change when Java is updated and previously installed shortcuts may be removed in some circumstances.

To ensure or restore such shortcuts, press the “view” button on Java’s control panel:

Select the application and press the black arrow button.  (If that button is disabled, either the shortcuts have already been installed or there is an installation problem, such as lacking permission to save a shortcut to your dock or desktop):

You may also want to change the setting for installing shortcuts on the Java control panel’s “advanced” tab to “always allow”:

If you do so and have problems with shortcuts, you might want to remove the installed application and repeat the installation process as described above.

Relaunching the application

Unless prohibited by your configuration of Java, the application installs a shortcut on your desktop that allows you to relaunch without going through your browser and related security obstacles. 

Whether relaunched from the link above or by the desktop shortcut, Java first checks that the installed version of the application matches the current version on the web site.  If not, it downloads and installs any updated components before launching.

Reporting problems

When you encounter problems, please send the log file that is written to your temporary directory.  The location of that directory varies depending on who is logged in and on what platform.  The log file is also written to the Java console.

The location of the log file is shown on the first line after the console instructions above.

When reporting a problem, especially when the system indicates an exception, please:

1.      paste a copy of the log file using the copy button shown on the Java console or

2.      attach the log file to your email.

Configuring Java to show the console

If you encounter problems and want to report them, you can turn on the Java console by opening the Java control panel from System Preferences (the last icon shown below):

and selecting to show the console on the Advanced tab of the Java control panel as shown below (the very last icon below).

Alternatively, you can find the location of the application’s log file in the “Preferences” tab of the software.

Sending a copy of the console’s contents or the log file may be instrumental in resolving certain problems.

Copyright © 2017-8 by Automata, Inc. all rights reserved.