Changes between Initial Version and Version 1 of XgapDevelopment


Ignore:
Timestamp:
2010-10-01T23:38:13+02:00 (14 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • XgapDevelopment

    v1 v1  
     1[[TOC()]]
     2= Development installation of XGAP =
     3XGAP builds on the MOLGENIS toolbox for XgapCustomization. There are three steps involved in the development installation of XGAP:
     4
     5 * Download XGAP from the repository. Currently we use version 1.2
     6 * Download [http://www.molgenis.org MOLGENIS] from a repository. Currently we use version 3.3
     7 * Check buildpath and running of the generator
     8
     9We will now go into detail for each of these steps.
     10
     11== Download XGAP source code from subversion ==
     12For this tutorial it is assumed you already installed Java, MySQL and Tomcat as described in XgapInstall or [http://www.molgenis.org/wiki/MolgenisInstall MolgenisInstall].
     13
     141) Get an IDE such as Eclipse (see: http://www.eclipse.org) and install by extracting the archive.
     15
     16'''For this tutorial, we assume you use Eclipse and start out with a clean installation and a new workspace.'''
     17
     182) Install Subclipse (see: http://subclipse.tigris.org):
     19
     20 * Go to Help -> Install New Software...
     21 * Paste the URL '''http://subclipse.tigris.org/update_1.6.x''' or equivalent, tick 'Subclipse', click Next
     22
     23[[Image(svn1.png)]]
     24
     25 * Click Next again, 'I agree' (if you do), Finish.
     26 * Restart Eclipse 'Yes'.
     27
     283) Switch to SVN perpective:
     29
     30 * Go to Window -> Open Perspective -> Other...
     31 * Select 'SVN Repository Exploring'
     32
     334) Add the XGAP repository:
     34
     35 * Click right-mouse button in the SVN window
     36
     37[[Image(svn2.png)]]
     38
     39 * Enter this URL: http://www.xgap.org/svn and click Finish.
     40
     415) Download the XGAP distro:
     42
     43 * Expand the repository. Right-click on 'xgap_1_2_distro' and select Checkout.
     44
     45[[Image(svn3.png)]]
     46
     47 * Leave the settings and click Finish.
     48
     49[[Image(svn4.png)]]
     50
     51== Download MOLGENIS ==
     52
     531) Stay in SVN perspective or repeat Step 3 of 'Download XGAP'.
     54
     552) Add the XGAP repository:
     56
     57 * Click right-mouse button in the SVN window
     58 * Enter this URL:  http://gbic.target.rug.nl/svn/molgenis and click Finish.
     59
     603) Download the MOLGENIS toolbox:
     61
     62 * Expand the repository. Expand the folder 'molgenis', right-click on '3.3' and select Checkout.
     63
     64[[Image(svn5.png)]]
     65
     66== Running XGAP ==
     67The distro doesn't contain generated code. So we will first generate this code. Then we will update the database and run XGAP. See http://www.molgenis.org/wiki/MolgenisGeneratorBasics for general details on this procedure.
     68
     691) Switch back to Java EE perspective. (either use the toolbar or Window -> Open Perspective)
     70
     712) Check the xgap_1_2_distro build path. The XGAP distro project has a number of pre-set dependancies. The 'Java EE module dependancies' should include the 'molgenis' project as well as the libraries contained within.
     72
     73[[Image(svn6.png)]]
     74
     753) The other libraries needed are as such:
     76
     77[[Image(svn7.png)]]
     78
     794) When this is set up correctly, you can run the !MolgenisGenerate.java to generate the code for the XGAP system. You can find the generator in handwritten/java:
     80
     81[[Image(svn8.png)]]
     82
     835) Refresh eclipse to pick up the generated code. To this end rightclick on the xgap_1_2_distro and click 'Refresh'. The code is now compiled.
     84
     85With all the code compiled we can now update the database and run XGAP. We assume you have created a xgap_1_2_distro database as described in XgapInstall and have given MOLGENIS permission to access it.
     86
     876) To update the database structure, run !MolgenisUpdateDatabase.java. This updates the database structure
     88
     897) Run XGAP by right-clicking the xgap_1_2_distro project and choosing 'Run -> Run on server'. Notice: on the first run this will in a dialog asking you to define a new server. Choose Tomcat of your version and choose [next] to point it to the right directory.