1. Installation¶
This section describes how to install and run MONGKIE. Installation instructions are provided for Linux
, Mac OS X
, and Windows
.
Caution
If you have an older version on your computer, you should uninstall it and remove the User Directories.
1.1. System Requirements¶
1.1.1. Recommended hardware requirements¶
OS | Processor | Memory | Disk space |
---|---|---|---|
Linux | Intel Core i5 or equivalent | 2GB (32-bit), 4GB (64-bit) | 1.5GB of free disk space |
Windows | Intel Core i5 or equivalent | 2GB (32-bit), 4GB (64-bit) | 1.5GB of free disk space |
OS X | Dual-Core Intel | 4GB | 1.5GB of free disk space |
1.1.2. Java¶
MONGKIE is written in Java, and runs on the Java Runtime Environment. Therefore, the Java runtime (7 or 8) is required to install and run it. You can download the latest version of Java runtime from here for Windows and Linux, and OS X Lion (10.7), Mountain Lion (10.8), or Mavericks (10.9).
The tested Java versions are Java 8
and 7u67
for Windows, Linux, and OS X.
Caution
MONGKIE cannot be installed or run using Java 6.0, and OpenJDK is not supported, be sure to run the official Java version from Oracle’s website.
1.2. ZIP Distributions¶
Download the latest release of a ZIP distribution for your OS.
Unzip it to any directory on your system.
Run the executable file located in the
bin
directory- On Linux,
mongkie/bin/mongkie
- On Windows,
mongkie\bin\mongkie.exe
- On OS X,
mongkie.app/Contents/MacOS/mongkie
- On Linux,
1.3. Installable Packages¶
Download the latest release of an installer for your OS.
1.3.1. Linux and Windows¶
After the download completes, run the installer.
- For Windows, the installer file has the
.exe
extension. Double-click the file to run it. - For Linux, the installer file has the
.sh
extension. You need to make the installer executable by using the following command:chmod +x <installer-file>
. Type./<installer-file>
to start the installation wizard.
- For Windows, the installer file has the
Follow steps in the installation wizard.
1.3.2. OS X¶
- After the download completes, click on the downloaded
.dmg
file. - Drag the mongkie application in your Application folder.
1.4. User Directories¶
userdir
is the directory where MONGKIE stores user configuration data such as window layouts, and various application options. Sometimes your userdir
can be corrupted and this results in the MONGKIE behaving weirdly.
To fix such issues, delete userdir
entirely, then restart MONGKIE, and allow it to generate a new userdir
from scratch. In most cases, this should repair the problems.
userdir
is located in:
- On Windows 2K/XP,
C:\Documents and Settings\<username>\Application Data\.mongkie
- On Windows Vista or later,
C:\Users<username>\AppData\Roaming\.mongkie
- On OS X,
/Users/<username>/Library/Application Support/mongkie
- On Linux,
/home/<username>/.mongkie