Caché Monitor installation instructions

Requirements

Caché Monitor requires Java to be executed. Versions up to 2.74 run on Java 7 or higher, versions 2.75 to 2.93 require a Java 8 runtime, and from version 2.94 on a private Java runtime is bundled so that no installed Java is needed. See the requirements page for details.

• The latest version of Caché Monitor could be downloaded from the download page. The packages are no longer hosted; the current version is SQL DATA LENS.
• Caché Monitor does not require an installer. To install Caché Monitor you need an unzip tool. Windows, macOS and Linux all ship one; a free cross-platform alternative is Info-ZIP.

Installation

Unzip Caché Monitor into a folder of your choice, for example C:\Program Files\CacheMonitor. The ZIP archive does not add any entries to the Windows Start menu. Make sure to extract the complete archive including the lib folder; a missing lib folder is the most common reason why Caché Monitor shows its splash screen and then does nothing (see the FAQ).

Later releases (2.75 and newer) were additionally offered as a Windows setup package that installs Caché Monitor like any other Windows application.

Starting Caché Monitor

Windows

Double-click cachemonitor.exe or cachemonitor.jar.

macOS

Double-click cachemonitor.jar.

Other Java platforms (Linux, Unix)

Open a shell, change to the directory where you unpacked the archive and type:

java -jar cachemonitor.jar

First steps

After Caché Monitor starts you have to register a Caché server. Right-click the root Caché Server Group node in the Server Navigator and select Add Server. Enter the required information and press OK. You can leave user and password empty; Caché Monitor will then ask for them before connecting to the server.

Caché Monitor downloads the required InterSystems JDBC driver from the web when a server of a not yet known Caché version is connected for the first time. This feature can be disabled in the preferences; later releases ship the drivers for all supported Caché and IRIS versions inside the package.

By expanding a server node, Caché Monitor connects to this Caché server and you can browse namespaces and more. Check the context menu for further options. Continue with first steps with Caché Monitor.

If your Caché ODBC data source already works, its settings are all you need: see ODBC settings to JDBC connection.

Uninstall

Uninstalling Caché Monitor is done by deleting the complete Caché Monitor directory. Installations made with the Windows setup package are removed through the Windows list of installed programs.

Where settings are stored

Caché Monitor stores information about registered Caché servers, the SQL history and some temporary files in a folder called .cm in the user's home directory:

• On Windows: the location of the HOME environment variable, that is ...\.cm (usually C:\Users\<name>\.cm).
• On macOS and Linux: ~/.cm

Version 2.82 fixed a bug of the 2.81 release which used .cm_beta instead of .cm as configuration folder.