[28825] | 1 | Preliminaries:
|
---|
| 2 |
|
---|
| 3 |
|
---|
| 4 | You will need to have installed:
|
---|
| 5 | 1. SVN
|
---|
| 6 | 2. Ant
|
---|
| 7 | 3. JDK 1.8 for Expeditee
|
---|
[28831] | 8 | (4. For the Windows release-kits, you will further need Microsoft Visual Studio.)
|
---|
[28825] | 9 |
|
---|
[28831] | 10 |
|
---|
| 11 | A. One-off steps
|
---|
| 12 |
|
---|
[28825] | 13 | 1. Check out the expeditee release kits:
|
---|
| 14 | svn co http://svn.greenstone.org/other-projects/expeditee-release-kits
|
---|
| 15 |
|
---|
[29233] | 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.
|
---|
[28825] | 19 |
|
---|
[29233] | 20 | 2b. Create a snapshots\expeditee folder
|
---|
[28835] | 21 |
|
---|
[29233] | 22 |
|
---|
[29231] | 23 | 3. Create the file "snapshots\expeditee\rke-build.properties". It should contain:
|
---|
| 24 | version:1
|
---|
[28825] | 25 | projectname:Expeditee
|
---|
| 26 | <empty newline>
|
---|
| 27 |
|
---|
| 28 | For 64 bit linux it should contain:
|
---|
[29231] | 29 | version:1
|
---|
[28825] | 30 | projectname:Expeditee
|
---|
[28835] | 31 | x64:true
|
---|
[28825] | 32 | <empty newline>
|
---|
| 33 |
|
---|
[29231] | 34 | Other versions of this Readme contained variations on some of these properties:
|
---|
| 35 | - version:v1.0
|
---|
| 36 | - x64:true*
|
---|
[28825] | 37 |
|
---|
| 38 |
|
---|
[29231] | 39 | B. Each time you want to run the release-kit:
|
---|
| 40 | (MANUAL STEPS. A script that automates these steps follows in C)
|
---|
[28825] | 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 |
|
---|
[28831] | 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
|
---|
[29231] | 52 | set PATH=C:\Research\ant\bin;%JAVA_HOME%\bin;c:\Program Files\Subversion\bin;%PATH%
|
---|
[28831] | 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.
|
---|
[28825] | 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 |
|
---|
[28831] | 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)
|
---|
[28825] | 71 |
|
---|
| 72 | 6. Go to your snapshots\expeditee folder and run "rke":
|
---|
| 73 | cd snapshots\expeditee
|
---|
| 74 | rke
|
---|
| 75 |
|
---|
[29231] | 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 |
|
---|
[29233] | 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.
|
---|