root/other-projects/expeditee-release-kits/README.txt @ 29743

Revision 29233, 3.3 KB (checked in by ak19, 5 years ago)

Another instruction to get Expeditee release kit to work on Windows

Line 
1Preliminaries:
2
3
4You will need to have installed:
51. SVN
62. Ant
73. JDK 1.8 for Expeditee
8(4. For the Windows release-kits, you will further need Microsoft Visual Studio.)
9
10
11A. One-off steps
12
131. Check out the expeditee release kits:
14svn co http://svn.greenstone.org/other-projects/expeditee-release-kits
15
162a. Compile the ant taskdefs and ant installer as described in section D below.
17To compile the ant-installer as is necessary, need to create an "antlib" folder in
18shared\core\ant-installer and then copy your ANT_HOME\lib's ant.jar and ant-launcher.jar into it.
19
202b. Create a snapshots\expeditee folder
21
22
233. Create the file "snapshots\expeditee\rke-build.properties". It should contain:
24    version:1
25    projectname:Expeditee   
26    <empty newline>
27
28For 64 bit linux it should contain:
29    version:1
30    projectname:Expeditee   
31    x64:true
32    <empty newline>
33
34Other versions of this Readme contained variations on some of these properties:
35    - version:v1.0
36    - x64:true*
37   
38   
39B. Each time you want to run the release-kit:
40(MANUAL STEPS. A script that automates these steps follows in C)
41
42Set the environment:
431. Add SVN\bin to the PATH
442. Set ANT_HOME and add ANT_HOME\bin to the PATH
453. Set JAVA_HOME to JDK 1.8 and add JAVA_HOME\bin to the PATH
46
474. If you're on Windows, run the vcvars.bat file of your Microsoft Visual Studio.
48
49My windows compile environment batch file looks like:
50    set ANT_HOME=C:\Research\apache-ant-1.8.2
51    set JAVA_HOME=C:\Program Files\Java\jdk1.8.0
52    set PATH=C:\Research\ant\bin;%JAVA_HOME%\bin;c:\Program Files\Subversion\bin;%PATH%
53
54    call "C:\Program Files\Microsoft SDKs\Windows\v6.1\Bin\SetEnv.cmd"
55    call "C:\Program Files\Microsoft Visual Studio 9.0\VC\bin\vcvars32.bat"
56
57(Microsoft SDK is necessary for the windows.h header I think. It may not be needed for the Expeditee release kits.)
58
595. Add your expeditee-release-kits\bin to the PATH.
60E.g. on Windows
61    cd c:\Research\Nightly\tools\expeditee-release-kits\bin
62    set PATH=%CD%;%PATH%
63
64E.g. on Linux/Mac:
65    export PATH=/Volumes/Research/jts21/expeditee-release-kits/bin:$PATH
66
67Toro is the Mac we use and JDK1.8 is located in /Volumes/Research   
68Jeremy's Linux under his jts21 account is what's used to generate the Linux binary.
69
70(6. If you have any file-locking issues, you may want to delete the contents of the snapshots\expeditee folder, all EXCEPT the rke-build.properties file)
71
726. Go to your snapshots\expeditee folder and run "rke":
73    cd snapshots\expeditee
74    rke
75
76
77C. Automated binary generation
78The script expeditee-release-kits\create-expeditee.bat now does all the above steps.
79To use it,
801. First create a custom version of rke-setup.bat.in at the same level (as "expeditee-release-kits\rke-setup.bat") and adjust its environment variable paths
812. Put create-expeditee.bat into C:\Research\Nightly. Check that the file paths it refers to are correct.
823. Run create-expeditee.bat
83
84   
85D. Compile up custom ant taskdefs that the release kit relies on,
86if you ever update the ant task definitions or the ant installer code. You will need to recompile them before running the release-kit.
87    pushd shared\core\ant-tasks\greenstone
88    ant
89    popd
90
91    pushd shared\core\ant-installer
92    ant
93    popd
94
95To compile the ant-installer, need to create an "antlib" folder in shared\core\ant-installer and then copy your ANT_HOME\lib's ant.jar and ant-launcher.jar into it.
Note: See TracBrowser for help on using the browser.