1 | Preliminaries:
|
---|
2 |
|
---|
3 |
|
---|
4 | You will need to have installed:
|
---|
5 | 1. SVN
|
---|
6 | 2. Ant
|
---|
7 | 3. JDK 1.8 for Expeditee
|
---|
8 | (4. For the Windows release-kits, you will further need Microsoft Visual Studio.)
|
---|
9 |
|
---|
10 |
|
---|
11 | A. One-off steps
|
---|
12 |
|
---|
13 | 1. Check out the expeditee release kits:
|
---|
14 | svn co http://svn.greenstone.org/other-projects/expeditee-release-kits
|
---|
15 |
|
---|
16 | 2a. Compile the ant taskdefs and ant installer as described in section D below.
|
---|
17 | To compile the ant-installer as is necessary, need to create an "antlib" folder in
|
---|
18 | shared\core\ant-installer and then copy your ANT_HOME\lib's ant.jar and ant-launcher.jar into it.
|
---|
19 |
|
---|
20 | 2b. Create a snapshots\expeditee folder
|
---|
21 |
|
---|
22 |
|
---|
23 | 3. Create the file "snapshots\expeditee\rke-build.properties". It should contain:
|
---|
24 | version:1
|
---|
25 | projectname:Expeditee
|
---|
26 | <empty newline>
|
---|
27 |
|
---|
28 | For 64 bit linux it should contain:
|
---|
29 | version:1
|
---|
30 | projectname:Expeditee
|
---|
31 | x64:true
|
---|
32 | <empty newline>
|
---|
33 |
|
---|
34 | Other versions of this Readme contained variations on some of these properties:
|
---|
35 | - version:v1.0
|
---|
36 | - x64:true*
|
---|
37 |
|
---|
38 |
|
---|
39 | B. Each time you want to run the release-kit:
|
---|
40 | (MANUAL STEPS. A script that automates these steps follows in C)
|
---|
41 |
|
---|
42 | Set the environment:
|
---|
43 | 1. Add SVN\bin to the PATH
|
---|
44 | 2. Set ANT_HOME and add ANT_HOME\bin to the PATH
|
---|
45 | 3. Set JAVA_HOME to JDK 1.8 and add JAVA_HOME\bin to the PATH
|
---|
46 |
|
---|
47 | 4. If you're on Windows, run the vcvars.bat file of your Microsoft Visual Studio.
|
---|
48 |
|
---|
49 | My 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 |
|
---|
59 | 5. Add your expeditee-release-kits\bin to the PATH.
|
---|
60 | E.g. on Windows
|
---|
61 | cd c:\Research\Nightly\tools\expeditee-release-kits\bin
|
---|
62 | set PATH=%CD%;%PATH%
|
---|
63 |
|
---|
64 | E.g. on Linux/Mac:
|
---|
65 | export PATH=/Volumes/Research/jts21/expeditee-release-kits/bin:$PATH
|
---|
66 |
|
---|
67 | Toro is the Mac we use and JDK1.8 is located in /Volumes/Research
|
---|
68 | Jeremy'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 |
|
---|
72 | 6. Go to your snapshots\expeditee folder and run "rke":
|
---|
73 | cd snapshots\expeditee
|
---|
74 | rke
|
---|
75 |
|
---|
76 |
|
---|
77 | C. Automated binary generation
|
---|
78 | The script expeditee-release-kits\create-expeditee.bat now does all the above steps.
|
---|
79 | To use it,
|
---|
80 | 1. 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
|
---|
81 | 2. Put create-expeditee.bat into C:\Research\Nightly. Check that the file paths it refers to are correct.
|
---|
82 | 3. Run create-expeditee.bat
|
---|
83 |
|
---|
84 |
|
---|
85 | D. Compile up custom ant taskdefs that the release kit relies on,
|
---|
86 | if 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 |
|
---|
95 | To 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.
|
---|