| | 1 | [[TOC()]] |
| | 2 | = How to install XGAP locally = |
| | 3 | == Step 1: Install and configure required software == |
| | 4 | XGAP is based on [http://www.molgenis.org MOLGENIS] which is known to run happily on Windows, Linux and Mac. We here assume the procedure for the windows installation; for other operating system distributions we refer to respective documentations. To get started, download and install the most recent: |
| | 5 | |
| | 6 | * Java 6 JDK http://java.sun.com/javase/downloads/ [[BR]]Just install the most recent standard JDK with standard options. [[BR]] |
| | 7 | * Tomcat >=5 web server http://tomcat.apache.org/ [[BR]]Remember the root password you are asked![[BR]] |
| | 8 | * Mysql >=5.1 database http://dev.mysql.com/downloads/mysql/5.1.html [BR]]During installation of the windows version you need to tick 'innodb'. Remember your root password. [[BR]] |
| | 9 | * Download XGAP .war and .sql files from [https://sourceforge.net/projects/molgenis/files/xgap/ sourceforge], current version xgap_1_2_distro |
| | 10 | |
| | 11 | == Step 2: Configure XGAP mysql database == |
| | 12 | Open mysql commandline client and: |
| | 13 | |
| | 14 | * Create a database named 'xgap_1_2_distro'` |
| | 15 | {{{ |
| | 16 | create database xgap_1_2_distro; |
| | 17 | }}} |
| | 18 | * Allow molgenis (engine of XGAP) to read and write to this database as user 'molgenis'` |
| | 19 | {{{ |
| | 20 | grant all privileges on xgap_1_2_distro.* to 'molgenis'@'localhost' identified by 'molgenis'; |
| | 21 | flush privileges; |
| | 22 | }}} |
| | 23 | * Select the database you just created. |
| | 24 | {{{ |
| | 25 | use xgap_1_2_distro; |
| | 26 | }}} |
| | 27 | * Copy-paste the contents of xgap_create_tables.sql in the mysql prompt to create the database. Alternatively, use command: |
| | 28 | {{{ |
| | 29 | source /path/to/xgap_create_tables.sql |
| | 30 | }}} |
| | 31 | |
| | 32 | == Step 3: Run XGAP software on web server == |
| | 33 | * If not already started (as in windows) start Tomcat using the proper startup SH or BAT script |
| | 34 | |
| | 35 | * Visit your local Tomcat Manager at[[BR]]`http://localhost:8080/manager/html` |
| | 36 | |
| | 37 | * At "WAR file to deploy", select the XGAP_1_2_distro.war file and click "Deploy" |
| | 38 | |
| | 39 | You can now use your XGAP at http://localhost:8080/xgap_1_2_distro/molgenis.do |
| | 40 | |
| | 41 | == Ideas for alternative distributions == |
| | 42 | Although quite straightforward, install of a local XGAP is still quite a hassle. Suggested alternative distributions include: |
| | 43 | * XgapVmwareImage -- create an VMware image that people can just run |
| | 44 | * XgapInstaller -- create installation script that does all above for you |
