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 | 2. Create a snapshots\expeditee folder
|
---|
17 |
|
---|
18 |
|
---|
19 | 3. Create the file "snapshots\expeditee\rke-build.properties". It should contain:
|
---|
20 | version:1
|
---|
21 | projectname:Expeditee
|
---|
22 | <empty newline>
|
---|
23 |
|
---|
24 | For 64 bit linux it should contain:
|
---|
25 | version:1
|
---|
26 | projectname:Expeditee
|
---|
27 | x64:true
|
---|
28 | <empty newline>
|
---|
29 |
|
---|
30 | Other versions of this Readme contained variations on some of these properties:
|
---|
31 | - version:v1.0
|
---|
32 | - x64:true*
|
---|
33 |
|
---|
34 |
|
---|
35 | B. Each time you want to run the release-kit:
|
---|
36 | (MANUAL STEPS. A script that automates these steps follows in C)
|
---|
37 |
|
---|
38 | Set the environment:
|
---|
39 | 1. Add SVN\bin to the PATH
|
---|
40 | 2. Set ANT_HOME and add ANT_HOME\bin to the PATH
|
---|
41 | 3. Set JAVA_HOME to JDK 1.8 and add JAVA_HOME\bin to the PATH
|
---|
42 |
|
---|
43 | 4. If you're on Windows, run the vcvars.bat file of your Microsoft Visual Studio.
|
---|
44 |
|
---|
45 | My 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 |
|
---|
55 | 5. Add your expeditee-release-kits\bin to the PATH.
|
---|
56 | E.g. on Windows
|
---|
57 | cd c:\Research\Nightly\tools\expeditee-release-kits\bin
|
---|
58 | set PATH=%CD%;%PATH%
|
---|
59 |
|
---|
60 | E.g. on Linux/Mac:
|
---|
61 | export PATH=/Volumes/Research/jts21/expeditee-release-kits/bin:$PATH
|
---|
62 |
|
---|
63 | Toro is the Mac we use and JDK1.8 is located in /Volumes/Research
|
---|
64 | Jeremy'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 |
|
---|
68 | 6. Go to your snapshots\expeditee folder and run "rke":
|
---|
69 | cd snapshots\expeditee
|
---|
70 | rke
|
---|
71 |
|
---|
72 |
|
---|
73 | C. Automated binary generation
|
---|
74 | The script expeditee-release-kits\create-expeditee.bat now does all the above steps.
|
---|
75 | To use it,
|
---|
76 | 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
|
---|
77 | 2. Put create-expeditee.bat into C:\Research\Nightly. Check that the file paths it refers to are correct.
|
---|
78 | 3. Run create-expeditee.bat
|
---|
79 |
|
---|
80 |
|
---|
81 | D. Compile up custom ant taskdefs that the release kit relies on,
|
---|
82 | if 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 |
|
---|