|Description: The Eclipse Platform, and Plug-in Development Environment.|
|SHARCNET Package information: see ECLIPSE software page in web portal|
|Full list of SHARCNET supported software|
- 1 Eclipse on new Compute Canada clusters
- 2 Introduction to Eclipse on SHARCNET clusters
- 3 Version Selection
- 4 Job Submission
- 5 Example Usage
- 6 General Notes
- 7 References
Eclipse on new Compute Canada clusters
Eclipse has been installed on the new Compute Canada clusters cedar and graham as a module.
To use it, connect with a graphical interface enabled (ssh -Y ...) and execute:
module load eclipse eclipse
The information below refers to Eclipse usage on SHARCNET clusters. Some of this functionality has not yet been enabled on cedar and graham. If you find you need this functionality on the new clusters as well, please email email@example.com
Introduction to Eclipse on SHARCNET clusters
Sharcnet provides a module for the Eclipse for Parallel Application Developers Release. Once the module is loaded and the eclipse gui is up and running, users can easily install any of the available add-on packages found in the left hand column of the package comparison table to customize and extend their eclipse environment. The installation procedure for additional software into eclipse is explained in the general nodes section below.
module load eclipse/4.6.2 eclipse
Eclipse is intended for interactive use outside of the queue therefore this section is not applicable.
Eclipse provides sample project for getting started such as hello world. Once the Intel Compilers have been added as described below the following button click seqeuence should allow you to load up Hello World to test compiling with the Intel C++ compiler, where \ simply indicates a line break:
File->New->Project->C/C++->C/C++ Project->C++ Managed Build->Executable-> \ Hello World C++ Project->Intel C++ Compiler->Prject Name: test1->Finish
To get started see the eclipse Parallel Development User Guide. To find help building openmpi parallel programs click Running Parallel Programs then scroll down the the PTP supported Target System Configurations table and click Open MPI-Generic-Interactive. More detailed usage instructions to provide user guidance will be provided here asap.
Before beginning to use Eclipse the following steps should be done since there is limited space under home which otherwise would be used by default.
1) mkdir -p /work/$USER/eclipse/.eclipse 2) mkdir -p /work/$USER/eclipse/workspace 3) ln -s /work/$USER/eclipse/.eclipse ~/.eclipse 4) ln -s /work/$USER/eclipse/workspace ~/workspace
Note that Step 4) assumes you specify your workspace under your home directory, adjust accordingly.
On VDI Workstation
0) Install tigervnc client on your desktop 1) Start tigervnc client application 2) Connect to vdi-centos6.user.sharcnet.ca 3) open a terminal window 4) module load intel/16.0.4 eclipse/4.6.2 5) eclipse
On Devel Node
Please note that its not recommended to run graphical application on sharcnet clusters over ssh due to performance issues. When a program is available on vdi or viz workstations, its best to run it there instead since vnc can be used.
1) ssh -Y orca.sharcnet.ca 2) ssh -Y orc-dev1 3) module unload intel mkl 4) module load intel/16.0.4 5) module load eclipse/4.6.2 6) eclipse
Installing the Integration
The intel article " Using Intel® C++ Compiler with the Eclipse IDE on Linux explains in detail how to configure eclipse to use any of the intel compiler versions installed on linux. The main step which might not be obvious is adding the repository once you click the Add->Local buttons, you should specify a repository root directory such as /opt/sharcnet/intel/16.0.4/ide_support_2016/eclipse/compiler_xe by clicking File System in the left had menu of the finder window that appears and traversing down the tree. Once the compiler is added it will be available the next time you run eclipse, as can be confirmed by scrolling through help --> Installed Software and you should see:
Name Version I Provider Intel C++ Compiler 18.104.22.168607221 com.intel.compiler.composerxe.feature.group Intel Corporation C/C++ Developement Tools 22.214.171.1246120613 org.eclipse.cdt.feature.group Eclipse CDT
You should also see new fortran entries under PTP Fortran Support.
Name Version I Provider PTP Fortran Support 126.96.36.199612062209 org.eclipse.ptp.fortran.feature.group Eclipse PTP Fortran Development Tools (Photran) 188.8.131.52612062125 org.eclipse.photran.feature.group Eclipse PTP Linux Intel(R) Fortran Compiler Support 184.108.40.206612062125 org.eclipse.photran.intel.feature.group Eclipse PTP
Its not necessary to install Fortran Development Tools (Photran) since its included in PTP.
Using the Integration
The intel article reminds us to source compilervars.[csh|sh] before starting eclipse so the compiler commands are found. Its sufficient to load the corresponding intel sharcnet module before starting eclipse as follows:
module unload intel mkl module load intel/16.0.4 module load eclipse/4.6.2 eclipse
This section shows the basic procedure for installing additional (eclipse provided) packages into eclipse. The installation of Photran (the Fortran IDE plugin for Eclipse) which works with the intel compiler and most other compilers is used as an example. Many other packages can similarly be installed. Since the eclipse download repository is external to the sharcnet network, package installation must be done on iqaluk or a viz station and not on a devel node. Once the required add-on packages are installed they are available on any other sharcnet system where eclipse might be started. Note that the packages are installed under your ~/.eclipse directory hence significant disk space consumption could occur depending how many packages are added.
1) Connect to vdi-centos6.user.sharcnet.ca 2) module load eclipse/4.6.2 3) eclipse (start workbench) 4) select the default workspace /home/myusername/workspace then click Ok 5) click Help on top pull down menu, then click Install New Software 6) from the pulldown select ... The Eclipse Project Updates - http://download.eclipse.org/eclipse/updates/4.6 7) from the "Available Software" menu click something like ... Plugin development tools 8) Click finish to commit the installation and wait to finish.
Note in step 6 you can see what packages are already installed by clicking "What is already installed?"
Querying Installed Packages
1) Start eclipse
2) click Help on top pull down menu
3) click About Eclipse
Version: Neon.2 Release (4.6.2) Build id: 20161208-0600
4) click Installation Details All packages relating to the base installation will be displayed:
Eclipse for Parallel Application Developers 64bit-linux Tools for C, C++, Fortran, and UPC, including MPI, OpenMP, OpenACC, a parallel debugger, and remotely building, running and monitoring applications...
o Eclipse Homepage
o Eclipse Documentation
o Eclipse Wiki
o Eclipse Download Area
o Compare Eclipse Meta Packages
o CDT Documentation
o Eclipse PTP
o Photran - An Integrated Development Environment and Refactoring Tool for Fortran
o Fortran Development User Guide