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

Revision 29231, 2.9 KB (checked in by ak19, 6 years ago)

Modifying the expeditee release-kit README to take into account the latest commits

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
162. Create a snapshots\expeditee folder
17
18
193. Create the file "snapshots\expeditee\rke-build.properties". It should contain:
20    version:1
21    projectname:Expeditee   
22    <empty newline>
23
24For 64 bit linux it should contain:
25    version:1
26    projectname:Expeditee   
27    x64:true
28    <empty newline>
29
30Other versions of this Readme contained variations on some of these properties:
31    - version:v1.0
32    - x64:true*
33   
34   
35B. Each time you want to run the release-kit:
36(MANUAL STEPS. A script that automates these steps follows in C)
37
38Set the environment:
391. Add SVN\bin to the PATH
402. Set ANT_HOME and add ANT_HOME\bin to the PATH
413. Set JAVA_HOME to JDK 1.8 and add JAVA_HOME\bin to the PATH
42
434. If you're on Windows, run the vcvars.bat file of your Microsoft Visual Studio.
44
45My windows compile environment batch file looks like:
46    set ANT_HOME=C:\Research\apache-ant-1.8.2
47    set JAVA_HOME=C:\Program Files\Java\jdk1.8.0
48    set PATH=C:\Research\ant\bin;%JAVA_HOME%\bin;c:\Program Files\Subversion\bin;%PATH%
49
50    call "C:\Program Files\Microsoft SDKs\Windows\v6.1\Bin\SetEnv.cmd"
51    call "C:\Program Files\Microsoft Visual Studio 9.0\VC\bin\vcvars32.bat"
52
53(Microsoft SDK is necessary for the windows.h header I think. It may not be needed for the Expeditee release kits.)
54
555. Add your expeditee-release-kits\bin to the PATH.
56E.g. on Windows
57    cd c:\Research\Nightly\tools\expeditee-release-kits\bin
58    set PATH=%CD%;%PATH%
59
60E.g. on Linux/Mac:
61    export PATH=/Volumes/Research/jts21/expeditee-release-kits/bin:$PATH
62
63Toro is the Mac we use and JDK1.8 is located in /Volumes/Research   
64Jeremy's Linux under his jts21 account is what's used to generate the Linux binary.
65
66(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)
67
686. Go to your snapshots\expeditee folder and run "rke":
69    cd snapshots\expeditee
70    rke
71
72
73C. Automated binary generation
74The script expeditee-release-kits\create-expeditee.bat now does all the above steps.
75To use it,
761. 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
772. Put create-expeditee.bat into C:\Research\Nightly. Check that the file paths it refers to are correct.
783. Run create-expeditee.bat
79
80   
81D. Compile up custom ant taskdefs that the release kit relies on,
82if you ever update the ant task definitions or the ant installer code. You will need to recompile them before running the release-kit.
83    pushd shared\core\ant-tasks\greenstone
84    ant
85    popd
86
87    pushd shared\core\ant-installer
88    ant
89    popd
90
Note: See TracBrowser for help on using the browser.