Installing and Running Leximancer V4.5

1. Supported Operating Systems

  • Windows 7, 8 10 (64 bit)
  • Mac Intel OS X 10.9+ (Mavericks, Yosemite, El Capitan) 64 bit

Operating systems must be fully up to date with latest service packs and security patches.

Leximancer may work with earlier versions of operating systems but are not supported.

2. Does Leximancer require Java to be installed?

As of V4.5, Leximancer no longer requires Java to be installed separately. The Leximancer V4.5 installer installs everything necessary to run Leximancer.

2A. Required Java Version (Leximancer V4.0)

Note: This FAQ item only applies to Leximancer V4.0

Leximancer V4.0 requires Oracle Java to be installed. It is strongly recommended that the latest available version be installed. OpenJDK Java is not supported.

OpenJDK Java is not supported.

Leximancer 4 does not use Java in the browser or make use of applet technology.

3A. How To Install Java: Windows

  • Windows 64 bit Java Installer: Please install the latest available Java8 JRE from Oracle. At the time of this writing the latest version is available here:

http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html

Make sure you select the Windows X64 version.

If for some other program you need to use Java 7, download from here:

http://www.oracle.com/technetwork/java/javase/downloads/jre7-downloads-1880261.html

On a 64 bit Windows System, you must install the 64 bit Java or Leximancer may not be able to correctly find the Java runtime.

3B. How To Install Java: OSX


  • Mac OS X: For 10.5 and 10.6, Java is pre-installed, for 10.7+ (Lion), 10.8+ (Mt. Lion, Yosemite, El Capitan) if Java is not installed you will be prompted to automatically download and install Java. Further details on installing Leximancer on OS X Lion 10.7+ are available here. On Apple OS X, Leximancer cannot use the version of Java available at www.java.com.

The Leximancer 4.0 required version of Java for OS X is available directly from Apple at: http://support.apple.com/kb/DL1572

4. Required System Memory

A minimum system should have 2GB of ram, with at least 750MB dedicated
to Leximancer. Please note that the amount of memory required by
Leximancer is dependent on the amount of text being analyzed and project
settings. Use of other software may limit the amount of memory available
to Leximancer.

  • Note: For Windows: In some cases, Leximancer may not be able to
    access enough memory to run even if the computer has enough memory. In
    this case, after rebooting, open Leximancer first, before any other
    applications such as Word or Excel.

5. Required Disk Space

It is recommended to have at least 10GB free disk space for source text
documents and Leximancer project data-store files. More disk space may
be required dependent on the number of documents analyzed and project
settings used.

6. Supported Web Browsers

Leximancer V4.5:

  • IE 11, IE Edge, Firefox 45+, Chrome 50+, and Safari 9+

Leximancer V4.0: The Leximancer 4 user interface is displayed in a browser.
Leximancer requires visualization and rendering capabilities that
not all legacy browsers support adequately. Leximancer has strived to
provide legacy browser users with as much functionality as possible. For some legacy browsers not all features will be available and performance may be degraded, particularly for the map visualizations.

It is strongly recommended to use the latest fully patched browser versions available:

  • Firefox
  • Chrome
  • Safari
  • Internet Explorer 9+ Internet Explorer 11 is NOT supported in V4.0. Leximancer 4 does not use Java browser applets.

Some Internet Explorer versions may experience some feature limitations
and performance degredation. Other browsers may work with Leximancer
Version 4 but are unsupported.

6.1 Problems with Internet Explorer 9

Some users have experienced difficulties using Leximancer Desktop and
the Leximancer Portal after their systems were upgraded to use IE9. If
you are having trouble opening projects or folders in IE9:

  • Select the 'Tools' menu in your browser and then 'Compatibility View Settings'.

Note: You may need to press the 'Alt' key to make the 'Tools' menu appear at the top of the browser window. A 'Compatibility View Settings' dialogue box will open. Click 'Add' to add the Leximancer site to the compatibility view list. For Leximancer Desktop, the website will be localhost For Leximancer Portal, the website will be leximancer.com * You should be able to use Leximancer after closing the dialogue box.

7. I’ve downloaded the Leximancer 4.0 installer. The filename is something like Leximancer-AAA-BBB-CCC.jar. How do I run the installer?

Note: This question refers only to Leximancer V4.0.

The Leximancer installer should have a filename that ends in ‘.jar’,
Leximancer-Desktop-VYYY-ZZZ.jar for example. If you have Java correctly
configured on your system, the installer may be run by double-cllcking
on the installation jar file. Alternatively the installer may be run
from a command prompt, which is cmd on Windows and Terminal on OS X, by
typing:

java -jar Leximancer-Desktop-VYYY-ZZZ.jar

8. How do I upgrade from Leximancer V3.5?

Note: Before upgrading Leximancer, be sure to check that your Java version is reasonably current. See Java versions.

Make sure you have a proper backup of your computer or at least the entire Leximancer installation directory before upgrading or transferring.

The recommended upgrade procedure is listed below, this procedure will provide you with:

  • A backup of the Leximancer V3.5 installation on external media
  • A new Leximancer V4 installation in a different directory that has copies of all your V3.5 projects
  • The original V3.5 installation directory with all V3.5 projects

Backup procedure before upgrading:

  1. First backup your current Leximancer V3.5installation:¶
  • Shutdown Leximancer V3.5 Desktop
  • Make a complete backup of your Leximancer V3.5 Desktop installation directory
  • Note: If you currently use backup software that backs up the disk Leximancer is installed on, such as time machine on Mac OS X, you may skip the next backup step.
  • Backup the Leximancer-Desktop-V3.xx entire installation folder to external media. (The installation directory name shown is for illustration only, your system will differ.) The Leximancer datastore and projects are in this folder. This will not back up your source text documents, as they may be anywhere on your hard drive. You must back those up separately. Make sure this backup has completed successfully and is valid.

Note: For Windows Users Only, your backup software must be able to handle long path names. robocopy is one copy program that correctly handles long path names.

Upgrading to V4

  1. Copy the ‘Leximancer-Desktop-V3xx’ to a new folder on the same machine(eg: called ‘Leximancer-V4’). Make sure there is adequate disk space before copying.
  2. Note: Make sure there is adequate disk space to make the copy.
  3. Warning for Windows Users, Your copy program must support long path names, robocopy from Microsoft can handle long paths. The standard windows copy program and the drag-and-drop copy using the File Explorer will often FAIL to properly copy long file names
  4. Run the Leximancer V4 Installer, selecting the (eg: Leximancer-V4) directory as the target folder. The installer may ask you if you wish to install to an existing directory, this is ok.

Start Leximancer V4. Your existing licence will continue to work in the new version. You should now perform all work with the new V4 version. The original V3.5 directory is only for backup / reference.

9. How do I transfer Leximancer and my projects to a new computer?

Note: If you will be using Leximancer V4.0 on the new computer, be sure to check that the new machine has a Java version is reasonably current. See Java versions.. If your new computer will be using Leximancer V4.5 this is not necessary as V4.5 does not require a separate Java installation.

The recommended upgrade procedure is listed below, this procedure will provide you with:

  • A backup of the current Leximancer installation on external media. This should be kept if needed, or at least until a backup of the new machine has been made.
  • A new Leximancer installation on the new machine that has a copy of your original Leximancer projects.
  • Note: In order for the new Leximancer installation directory to access the original source text documents for your projects you will have to move them to exactly the same locations on your new machine if you wish to re-run or modify the projects. If they are not in the same location and you make any changes to the project settings , you will have to re-select the text document locations and run the project from the start again. If you do not change the project, you can view the results without the original text documents being present.

Backup procedure before transfer:

  1. First backup your current Leximancer installation:
  • Shutdown Leximancer Desktop
  • Make a complete backup of your Leximancer Desktop installation directory. (For example On MacOS this should be the /Applications/Leximancer-Desktop-V4 folder.)
  • Note: If you currently use backup software that backs up the disk Leximancer is installed on, such as time machine on Mac OS X, you may skip the next backup step.
  • Using the backup software of your choice, backup the Leximancer Desktop entire installation folder to external media (USB stick or drive). The Leximancer datastore and projects are in this folder. This will not back up your source text documents, as they may be anywhere on your hard drive. You must back those up separately. Make sure this backup has completed successfully and is valid.

Backup Drive File System: The drive you are backing up to must have a modern file system on it such as NTFS (Windows) or Mac OS Extended (MacOS). Some USB drives come pre-formatted with ancient file systems like FAT which will not allow a correct copy of Leximancer to be made.

Warning for Windows Users: Your backup software must be able to handle long path names. Robocopy is one copy program that correctly handles long path names. The standard Windows copy program and the File Explorer copy WILL NOT always properly copy long file paths.

MacOS users may use the Finder copy commands to copy the Leximancer directory to a USB drive.

Transferring to a new machine

  1. Copy the ‘Leximaancer-V4-Desktop' USB backup directory you made to a folder on the new machine (eg: called ‘Leximancer-V4-Desktop’). Make sure there is adequate disk space before copying.
    • On MacOS, you will want to copy the Leximancer-V4-Desktop folder on the USB drive to the /Applications folder on your new machine.
  2. Warning for Windows Users: Your copy program must support long path names, robocopy from Microsoft can handle long paths. The standard windows copy program and the drag-and-drop copy using the File Explorer will often FAIL to properly copy long file names**
  3. Leximancer Installation on new machine:
    • If you are runnnig the same version of Leximancer on your new machine: Run the original Leximancer V4 Installer on the new machine, selecting the (eg: Leximancer-V4-Desktop) directory on the new machine you copied the original Leximancer to as the target folder. The installer may ask you if you wish to install to an existing directory, this is ok.
    • If you are running a newer version of Leximancer on the new machine, (upgrading from V4 to V4.5 for example) run the new installer. All of your old projects will be preserved.
  4. Start Leximancer on your new machine. Your existing licence will continue to work with the transferred version.
Leximancer Pty Ltd, Brisbane, Australia, ACN: 116 218 109