****************************************

 Filename:	README.config  
 Software:	Eclipse 4.8m4
 Locker:	eclipse-sdk_v4.8m4
 Last Updated:	1/8/17
		
****************************************

VOLUMES IN LOCKER:	                LOCATION:       REPLICATED:    

	sw.eclipse-sdk_v4.8m4		top-level	no

LINKS TO VOLUMES/LOCKERS:


CHANGES FOR ATHENA:


PROGRAMS IN LOCKER:	eclipse	- main application (several additional plugins)

STARTUP SCRIPT:

    DESCRIPTION 
      wrapper script that sets various environment variables, and calls main
      binary (/mit/eclipse-sdk_v4.8m4/distrib/$ATHENA_SYS/eclipse/eclipse). 
      Wrapper also has a lot of logic to configure workspace and .metadata 
      dirs, for AFS and non-AFS working directories. 

      We need to set UBUNTU_MENUPROXY to 0 in order for menus to work on 
      Ubuntu trusty.

    INSTALLATION 

Note: download site can be hard to find- "classic" download is at
http://download.eclipse.org/eclipse/downloads/

Use eclipse-SDK-4.8M4-linux-gtk-x86_64.tar.gz.

    MAKING CHANGES



    SPECIAL NOTES

The 32 bit version no longer installs plugins correctly so we punt it. There
may be remaining 32/64 bit legacy code.

Depends on Java in "current" Java locker; user's workspace/.metadata files are
platform and version-dependent- we create a template directory structure that 
keeps these separate, using AFS @sys links to keep Linux 32 and 64 bit versions
separate in common workspace directories. This requires substantial extra
intelligence in the wrapper script to allow users to mix AFS and non-AFS
work areas. Eclipse may create ~/.eclipse; we prepare for this by creating
an empty ~/.eclipse (if $HOME is not in AFS), or 
.eclipse -> ./.eclipse.48m4.@sys (if $HOME is in AFS)- this is similar to what
we do for .metadata directories.

Users are offered a choice of workspace before launch (with a default of 
~/workspace), which is created if not already found. Because of the way we
need to prepare workspaces in AFS beforehand, users should not select File ->
Switch Workspace, if switching to a workspace in AFS that has not been used 
before.

After initial install, update Eclipse as follows:

Help -> Check for Updates

Plugins are installed in various ways- if a site is set up as an
update site, we can choose Help -> Install New Software select obvious
buttons and install it from within the main GUI (an update site
generally has a files site.xml, and directories "features" and
"plugins" at the top level).

If an update site does not exist, often the <plugin>.zip files can be unzipped
in the plugins directory (taking care that it unpacks at the right directory 
level). In some cases substantial additional configuration may be required.

We add the plugins (by request of teaching faculty):

Help -> Install new Software -> 
                       Photon -http://download.eclipse.org/releases/photon

Programming Languages,
   Eclipse C/C++ Development Tools, Eclipse C/C++ Development Tools SDK, 
   C/C++ Call Graph Visualization, C/C++ Library API Documentation Hover Help,
   C/C++ Autotools support, C/C++ Docker Container Launch Support, 
   C/C++ Unit Testing support 
Performance, Profiling and Tracing Tools,
   Valgrind Tools Integration

and add sites:

Pydev - http://pydev.org/updates/ (not Pydev for mylyn)
GEF - http://download.eclipse.org/tools/gef/updates/releases
Subclipse - https://dl.bintray.com/subclipse/releases/subclipse/latest/
            (not Subclipse Integration for Mylyn 3.x)

(do after installing subversion, below)

In order to build the help indexes inside the installation tree, the
installer should run Help -> Help Contents, and search for some
arbitrary term, on each platform. Do this last, after installing the plugins.

We add JavaHL for Subclipse plugin.

install from subversion-1.9.7.tar.gz

In subversion-1.9.7 directory,
Run sh ./autogen.sh first, then ./get-deps.sh, followed by manual build of 
apr, apr-util:

cd apr
./buildconf
./configure --prefix=/mit/eclipse-sdk_v4.8m4
make
make install

cd ../apr-util
./buildconf
./configure --prefix=/mit/eclipse-sdk_v4.8m4 --with-apr=/mit/eclipse-sdk_v4.8m4
make 
make install

cd ..
./configure --enable-shared --without-serf
  --with-apr=/mit/eclipse-sdk_v4.8m4
  --with-apr-util=/mit/eclipse-sdk_v4.8m4
  --with-jdk=/afs/athena.mit.edu/software/java/current/distrib/home 
  --prefix=/mit/eclipse-sdk_v4.8m4

make javahl
make install
make install-javahl

Note: we need to put /mit/eclipse-sdk_v4.8m4/arch/$ATHENA_SYS/lib
on LD_LIBRARY_PATH in order for JavaHL to be functional.

Check for proper JavaHL integration by opening Window -> Preferences
-> Team -> SVN: JavaHL should be enabled.

A number of plugin components involving mylyn couldn't be installed due to 
missing dependencies.

MAINTENANCE NOTES:

In principle additional updates can be added to the locker later.

Note: users may now need to configure the Web browser.

    TUTORIAL

Internal, from the opening main GUI; also internal examples.