Working with eclipse and CVS

Download eclipse and install in your C directory. You can copy the eclipse folder and put in your C directory if you are copying from a network directory rather than installing from a directory

Setting up Eclipse

1) If you haven’t already…please install JDK 1.2.2(jdk-1_2_2_014-windows-i586.exeand JDK 1.4.2(j2sdk-1_4_2_04-windows-i586.exe)

NOTE: This may mess up any classpaths, but you should be able to use eclipse to run anything you wish to run anyway.

IMPORTANT: If you already have these installed then please make sure you have only the default jars in the jre/lib/ext directory as anything more than the default can mess up eclipse

2) Then unzip into your temporary directory and then rename the eclipse directory in it to eclipse3 and cut/paste it into the root directory of your c drive (i.e. you should be in a situation where you have plugins/features directories directly inside the eclipse3 dir…if not then rework it until you do)

3) Eclipse should be run on JDK 1.4.2 1.4.2, and this is important, as even if you do get it to run on anything lower, you will find it unstable.  To guarantee using the correct JVM I suggest that everyone alters the shortcut they use to start eclipse to something like the following:

“c:\eclipse3\eclipse.exe -vm c:\java1.4directory\bin\javaw.exe”

4) Launch Eclipse using the shortcut you made in the previous step.  It will ask you to set your workspace…set it to “c:\eclipse3\workspace”… and check the box.  You will then be presented with a welcome screen click the x on the tab top left to close it.  Now go to window->open perspective -> java.  (I suggest at this point you close the Outline, and Navigator view, but this is just my preference)

5) Go to the Window Menu and select preferences, expand the Java node, and select “build path”, the right hand pane will now show a radio button selection for “Source and output folder”.  Please select the second option “Folders” (bin and src), and click Apply.  Do not close this window as we will be using it in the next step


6) Now click on the “Installed JREs”.  This will now list all of the JREs that you have, and by default it will have the one that you  specified in step 4.  Click “Add…”.  In the window that pops up put “JDK 1.2.2” (exactly) in the “JRE name” field, and then specify the “JRE home directory” by clicking browse and going to the place you installed the JDK 1.2.2 from step 1 (this is the root of the JDK EG “c:\jdk1.2.2”).  Now click ok

7) Copy the jars directory you copied from my server to c:\jars, you will use this later

B) Installing essential plugins

IMPORTANT: please EXIT ECLIPSE before performing the following steps

1) XMLBuddy  is for editing XML, it gives many useful pieces such as syntax highlighting, code assist, validation, and validation against a DTD, automatic formatting, etc

Unzip into your temporary directory,  then go into the directory, copy the “com.objfac.xmleditor_2.0.10” directory and paste it into the c:\eclipse3\plugins

2) Lomboz

You will need to use the files and lomboz.3.zipI suggest as part of this install you install Tomcat 4 (jakarta-tomcat-4.1.30-LE-jdk14.exe) or Tomcat 5 (jakarta-tomcat-5.0.27.exe).   (I recommend using Tomcat 4)

Watch out for a document I want to write soon about using Lomboz as there are a lot of features to it that might not initially be obvious, such as debug server

3) JFaceDBC (Optional)

Unzip and paste the contents of the plugin directory into the c:\eclipse3\plugin directory and the contents of the features directory into the c:\eclipse3\features directory

 Start Eclipse

 Connecting to CVS and Checking out the Master projects

First you will need to set your password.  To do this I suggest you telnet to yourCVSserver and then run the following to login to the new CVS machine by ssh:

ssh –l username youripaddress

then type “password”

now you accept the key by typing  “yes”, and enter

 now type passwd and change your password how you would usually in unix  (minimum 6 maximum 8, no dictionary words and has to have a number in it).  Then exit

 You are now ready to set up the  MASTER repository

      1)      window->open perspective->CVS Repository explorer

2)      right click on the cvs repositories view and select new-> repository location

3)      Host : Your CVSipaddress

4)      Repository Path:  /giveyourpath/here/Master

5)      Username:  your username 

6)      password will be the one you just set

7)      connection type: extssh

8)      use default port

9)      validate connection (tick)

10)  save password (tick)

11)  finish

12)  click yes on all pop-ups


Now you can check out the YourProject  module by expanding the new repository, open HEAD,  and right click onYourProject  select “check out”

NOTE: for other projects such as international or Fig you will be selecting check out on the appropriate other modules

  Now you need to setup the working Repository:

            The details are the same as the Master above, accept

Repository Path =  /giveyourpath/YourProject  /Working


Usage of Eclipse3 with the new CVS (ESSENTIAL TO READ THIS)

It’ll be difficult to follow these guidelines all the time from the start, but I strongly recommend you do, as it will save you a lot of time in the long run and will become second nature quite soon…especially once you get to see the benefits of them

1) Starting a new product (i.e. a completely new system, such as when we started international)

a) the same as starting a new project (below), other than you will be creating a lib directory to place all your jars in, and instead of “add external jars” use “add jars”

 2) Starting a new project

a)      Right click in the package explorer view select new->Project

b)      Java Project, Next->

c)      Specify you project name (I suggest no spaces in the name), leave the rest as default, Next ->

d)      Select Project Tab, select the relevant project that this project is based on

e)      For projects which will run from Jserv machines, Select the Libraries tab, select the JRE System library, and click edit, then change to “alternate JRE”, then select the JDK1.2.2 option, then click ok.

f)        It may also be useful to “add external jars” and select clases12.jar and nls_charset.jar from c:\jars if you are going to connect to a database with this project

g)      You will also have to “add external jars”  to support servlets/etc on Jserv machines you will be including c:\jars\jsdk.jar.  If you are using SUNONE, then install a J2EE (I suggest 1.4update1 or above…which you can find on my ftp server)

h)      Copy over the files you need from the master project (creating the packages as you need them).

i)        Once you are ready to share the project, right click it, and select team -> share project….select the CVS repository ending “Working”, and ok, no you will be show a view with all the project, expand this and right click the bin directory (and any others you don’t want to go to source control EG j2src when using Lomboz in a project) and select “add to .cvsignore”, now right click the project, and select “commit”, and then once it has committed, then click “finish”

j)        Now other people will be able to access you project

k)      I suggest when synchronizing you “add to .cvsignore” the bin directory

 3) Always use c:\jars for your jars, that way sharing projects should be easy as classpaths will just work

4) Running programs within eclipse

        Change the dbconnection to use the thin driver

Please feel to contact if you you need any support on this