# Release Notes - okapi-apps 0.33, May-07-2017

- Overview
- Windows Platform
- Linux Platforms
- Macintosh Platform
- Support

## Overview

The okapi-apps distribution contains:

- The okapi-lib distribution, a collection of Java classes design to help in programming components and applications related to translation and localization tasks.
- Several applications built on top of the framework:
  - Tikal is a command-line tool to execute some simple localization-related tasks, like extraction and merge of XLIFF documents.
  - Rainbow is an application that provides a user interface to launch different translation and localization-related utilities.
  - CheckMate is an application allowing you to perform quality checks on bilingual translated documents such as XLIFF, TMX, PO, TTX, etc.
  - Ratel is a simple editor for segmentation rules in SRX format.

For a list of changes since the previous release, please see the Changes Log document.

Note that parts of this project are still relatively new and still in development. Some of the classes, interfaces and internal workings presented here may change in the upcoming versions of the Okapi Framework.

`lib` | All the files needed to run the Okapi libraries and applications.
`help` | The help files.
`config` | Various default configuration files (e.g. segmentation rules, additional filter configurations, etc.)
`examples` | A few Java examples on how to use the library in your own programs. See the examples' readme file for details.
`dropins` | The directory where you can drop plug-ins.

The latest version of all documents and help is always available on-line, at the Okapi Framework Web site.

## Windows Platform

### Requirements

In order to run the Okapi applications on Windows you must have a running installation of Java 1.7 or later. Sun Java, or an OpenJDK VM is recommended.

### Installation

To install the Okapi applications on Windows (32- and 64-bit):

1. Download the ZIP file of the Windows distribution.
2. Unzip the file on any location where you have rights, for example `C:\Program Files\Okapi`.

To run Rainbow: simply double-click on the `rainbow.exe` file in the main folder.

You can also run the application with the following command line (assuming it has been unzipped in the recommended folder):

    C:\>javaw -jar C:\Program Files\Okapi\lib\rainbow.jar

To run Tikal: double-click on the `startTikalPrompt.bat` file. This will start a command prompt from where you can invoke Tikal from any directory. If you want to run Tikal at any time, from anywhere, you should add the directory where `tikal.bat` is located in the PATH of your system.

### Uninstallation

To uninstall:

1. Rainbow runs independently of Windows, so to uninstall it you can simply delete the folder where you have installed it. There is no Registry information to remove.
2. If you want you can also remove the file where the user preferences are saved. It is located in the Home folder of the user and called `.Rainbow`.

## Linux Platforms

#### Requirements

In order to run the Okapi applications on Linux you must have a running installation of Java 1.7 or later. Sun Java, or an OpenJDK VM is recommended.

### Installation

To install the Okapi applications on Linux (32- and 64-bit):

1. Download the ZIP file of the Linux distribution you need (there is one for 32-bit and one for 64-bit).
2. Extract the file on any location. Make sure to preserve the full paths when extracting.

To run, for example, Rainbow: simply double-click on the `rainbow.sh` file in the main directory.

You can also run the application from the command line (assuming Rainbow is installed in `\home\archie\okapi`):

    archie@archie:~>java -jar okapi/lib/rainbow.jar

### Uninstallation

To uninstall:

1. Delete the directory where the okapi application are installed.
2. If you want, you can also remove the files where the user preferences are saved. They are located in the Home folder of the user and called `.Rainbow` and `.Ratel`.

## Macintosh Platform

### Requirements

In order to run Okapi applications on Macintosh you must have Java 1.7 installed.

### Installation

To install the Okapi applications on Macintosh (64-bit):

#### Installing release builds

Release builds are distributed as signed DMG disk images.

1. Download and open the DMG file for the distrution.
2. Drag the "Okapi_[release]" directory into your `Applications` folder.

#### Installing snapshot builds

Snapshot builds are distributed as unsigned ZIP archives.

1. Download the ZIP file of the Macintosh distribution you need (See above).
2. Extract the ZIP file on any location. For example `/Users/admin/Desktop/Okapi`.

Note: Because snapshot builds are unsigned, users on recent versions of OS X (particularly Sierra or later) may have problems when running the applications. For more information and help, please contact the Okapi Tools users group.

#### Running the Applications

To run, for example, Rainbow:

1. The main directory of the distribution contains a `Rainbow` application bundle (Rainbow.app): simply double-click on it.
2. If you run the application for the first time since you downloaded it, you may be prompted to confirm you want to run it.

You can modify the shell file `rainbow.sh` that is in the `/Contents/MacOS` folder of the application bundle to fit your own parameters. In all cases you MUST specify the `-XstartOnFirstThread` option or the application may not work properly. You can make sure to run the Java VM in a specific mode using the `-d32` and `-d64` flags.

Tikal is a command-line tool and should be invoked from a Terminal window.

### Uninstallation

To uninstall:

1. Delete the directory where the okapi application are installed.
2. If you want, you can also remove the files where the user preferences are saved. They are located in the Home folder of the user and called `.Rainbow` and `.Ratel`.

## Support

If you have questions, suggestions or bug to report, you can do this different ways:

- Use the Send Feedback command in the Help menu of Rainbow.
- Read and post notes in the Okapi Tools users group (you need to be registered member to post, but not to read).
- Read an post issue report on the Google Code project site.