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.
Difference between revisions of "Getting ICE"
(→HDF5) |
|||
| (58 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
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. | 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|ICE requires the Java Development Kit version 8 to build and run.}} | |
| − | ICE | + | == Installing ICE from Binaries == |
| − | === | + | === Downloading ICE === |
| − | 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 table below shows the available binaries and their respective operating systems. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
{| class="wikitable" style="text-align:left;" | {| class="wikitable" style="text-align:left;" | ||
| Line 37: | Line 18: | ||
! | '''Operating System''' | ! | '''Operating System''' | ||
|- | |- | ||
| − | | | + | | ice-win32-x86_64-2.X.Y.zip |
| 64-bit versions of Windows, including most installations of Windows Vista, 7 and 8 | | 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 | | 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) | | 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) | | 64-bit Linux running GTK (most flavors of Linux) | ||
|- | |- | ||
| − | | | + | | ice-linux-gtk-x86-2.X.Y.zip |
| 32-bit Linux running GTK | | 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 '''<tt>eclipse.ice.project <at> gmail <dot> com</tt>''' or join one of [[ICE_Mailing_Lists | 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 [http://brew.sh/ 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 [https://wci.llnl.gov/simulation/computer-codes/visit/executables Lawrence Livermore National Laboratory website], and doesn't require any additional configuration to use with ICE. | ||
| + | |||
| + | ==== ParaView (Optional) ==== | ||
| + | |||
| + | As an alternative to VisIt, ICE is also capable of using ParaView instead, also on either a local ''or'' remote machine. | ||
| + | |||
| + | ParaView is available for download from the [https://wci.llnl.gov/simulation/computer-codes/visit/executables official ParaView website], and also 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 feature on your machine. | ||
| + | |||
| + | Certain features in ICE, currently including the Geometry and Mesh editors, also require JavaFX. This is included in most versions of the JDK, but default distributions for some Linux operating systems (including Fedora and CentOS) do not. In that case, you will need to download the official nightly build from [https://jdk8.java.net/download.html the Java website]. Then in the terminal, run | ||
| + | |||
| + | '''alternatives --install /usr/bin/java java /path/to/the/jdk installation/jre/bin/java 3''' | ||
| + | |||
| + | or some number other than 3 if you already have multiple jdk installations. Then run | ||
| + | |||
| + | '''alternatives --config java''' | ||
| + | |||
| + | And type in the number you assigned to the new JDK in the previous step. | ||
== Running ICE == | == Running ICE == | ||
| Line 65: | Line 75: | ||
: In the file browser, navigate to the folder where you extracted ICE. In the ICE folder, double-click <tt>ICE.exe</tt>. On Linux and Mac systems, you may follow the same procedure, but the ICE executable is only called <tt>ICE</tt> on those systems. | : In the file browser, navigate to the folder where you extracted ICE. In the ICE folder, double-click <tt>ICE.exe</tt>. On Linux and Mac systems, you may follow the same procedure, but the ICE executable is only called <tt>ICE</tt> on those systems. | ||
| − | ; | + | ;Mac OS |
| − | : You may get a message that says that ICE is from an unidentified developer and cannot be opened. | + | : You may get a message that says that ICE is from an unidentified developer and cannot be opened. Workaround: in the file browser right-click (or control-click) the <tt>ICE</tt> executable, click ''Open'' in the context menu, and then click ''OK'' when prompted again. Alternatively, ICE may be executed from the command line on Linux and Mac systems. |
;Linux | ;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 <code>./ICE</code>. | : 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 <code>./ICE</code>. | ||
| − | When ICE | + | When ICE is executed, it will display data and debug information in the console window as the environment runs. You may safely ignore this window while you are working by keeping it minimized or in the background. |
== What if ICE fails to run? == | == What if ICE fails to run? == | ||
| − | If ICE fails to run, email us directly at < | + | 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 '''<tt>ice-dev <at> eclipse.org</tt>'''. If you believe that you have identified a bug, please report it to [https://github.com/eclipse/ice/issues our GitHub bug tracker]. |
| − | + | ||
| − | + | ||
Latest revision as of 09:00, 2 February 2017
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.
Contents
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 table below shows the available binaries and their respective operating systems.
| 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.
ParaView (Optional)
As an alternative to VisIt, ICE is also capable of using ParaView instead, also on either a local or remote machine.
ParaView is available for download from the official ParaView website, and also 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 feature on your machine.
Certain features in ICE, currently including the Geometry and Mesh editors, also require JavaFX. This is included in most versions of the JDK, but default distributions for some Linux operating systems (including Fedora and CentOS) do not. In that case, you will need to download the official nightly build from the Java website. Then in the terminal, run
alternatives --install /usr/bin/java java /path/to/the/jdk installation/jre/bin/java 3
or some number other than 3 if you already have multiple jdk installations. Then run
alternatives --config java
And type in the number you assigned to the new JDK in the previous step.
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 OS
- You may get a message that says that ICE is from an unidentified developer and cannot be opened. Workaround: in the file browser right-click (or control-click) the ICE executable, click Open in the context menu, 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 is executed, it will display data and debug information in the console window as the environment runs. 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.