Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Getting ICE

Revision as of 11:07, 14 November 2016 by Crawfordst.ornl.gov (Talk | contribs) (Prerequisites)

This page describes the process by which users can download and use the binary version of ICE. We recommend most users use the binary, however, for those who are adventurous at heart, detailed instructions on building ICE from the source code are available on the ICE Build Instructions page.

Note.png
ICE requires the Java Development Kit version 8 to build and run.


Installing ICE from Binaries

Downloading ICE

ICE binaries are now available on the ICE website: https://www.eclipse.org/ice/. From the main menu, select Downloads and then choose the desired binaries (stable nightly builds or unstable nightly builds). Upon selection, the user will be taken to a mirror site to download the binary for their operating system.

The user should select the appropriate binary for their application. In the naming scheme ice-*-2.X.Y.zip.zip, * is the operating system and processor architecture, and X and Y are the major and minor version numbers.

For example, ice-win32-x86-2.2.0.zip would be the appropriate choice for 64-bit Windows and ice-linux-gtk-x86_64-2.X.Y.zip would be the appropriate choice for 64-bit Red Hat Enterprise Linux 6 (RHEL6). The choices are as follows:

Binary version Operating System
ice-win32-x86_64-2.X.Y.zip 64-bit versions of Windows, including most installations of Windows Vista, 7 and 8
ice-win32-x86-2.X.Y.zip 32-bit versions of Windows, including most installations of Windows XP
ice-macosx-cocoa-x86_64-2.X.Y.zip 64-bit Mac, including most OS X installations (10.4.7 "Tiger" and newer)
ice-linux-gtk-x86_64-2.X.Y.zip 64-bit Linux running GTK (most flavors of Linux)
ice-linux-gtk-x86-2.X.Y.zip 32-bit Linux running GTK

The binary distributions are fully-functional, full-featured, executable versions of ICE that include everything except for the Java Virtual Machine, third-party libraries and plug-ins that are currently in development. If you have any questions, please contact us at eclipse.ice.project <at> gmail <dot> com or join one of our mailing lists.

Prerequisites

ICE requires a Java Development Kit (JDK) with Java 1.8 or greater. Sun's version of Java can be used on Linux, Windows, or Mac, and OpenJDK can also be used on Linux and Mac. The ICE development team prefers OpenJDK for Linux systems. Some tools in ICE also require the installation of third-party libraries. While it is not necessary to install these libraries to run ICE, the Reactors and Visualization perspectives will not work correctly without them.

For Mac OS X users, ICE developers also recommend installing the Homebrew package manager.

VisIt (Optional)

To visualize 3D data, ICE requires the installation of VisIt (minimum version 2.8.2) on a local or remote machine.

VisIt is available for download from the Lawrence Livermore National Laboratory website, and doesn't require any additional configuration to use with ICE.

3D Graphics

ICE also requires that your system has 3D rendering enabled to edit geometries and visualize 3D data, which is normally done by installing the 3D graphics drivers from the vendor of your graphics card. You should consult your IT specialist if you do not know how to enable this on your own.

Running ICE

Once you download the appropriate zip file for your operating system, extract it to a directory of your choice. No additional installation steps are required because ICE is executed directly from this directory.

Windows
In the file browser, navigate to the folder where you extracted ICE. In the ICE folder, double-click ICE.exe. On Linux and Mac systems, you may follow the same procedure, but the ICE executable is only called ICE on those systems.
Mac
You may get a message that says that ICE is from an unidentified developer and cannot be opened. In the file browser, you can right-click the executable, click "Open" in the context menu that appears and then click "OK" when prompted again. Alternatively, ICE may be executed from the command line on Linux and Mac systems.
Linux
ICE may be executed from the command line on Linux systems by navigating to the folder where ICE was extracted, and then issuing the command ./ICE.

When ICE runs, it will stream data to a console window that displays debug information as the environment is used. You may safely ignore this window while you are working by keeping it minimized or in the background.

What if ICE fails to run?

If you feel you've followed all the above directions for configuring ICE and its dependencies, and ICE still fails to run, email us directly at ice-dev <at> eclipse.org. If you believe that you have identified a bug, please report it to our GitHub bug tracker.

Back to the top