Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 317 lines (217 sloc) 10.433 kb
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
1 OAB-Java
2 ========
7463359 @flexiondotorg Updated docs
authored
3 oab-java.sh v0.2.6 - Create a local 'apt' repository for Sun Java 6 and/or Oracle Java 7 packages.
9250d86 @flexiondotorg Minor doc edit
authored
4
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
5 Copyright (c) Martin Wimpress, http://flexion.org. MIT License
6
7 By running this script to download Java you acknowledge that you have
8 read and accepted the terms of the Oracle end user license agreement.
9
10 * http://www.oracle.com/technetwork/java/javase/terms/license/
11
12 Usage
13 -----
14 ::
15
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
16 sudo ./oab-java.sh
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
17
18 Optional parameters
19
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
20 * -7 : Build oracle-java7 packages instead of sun-java6
405faa9 @flexiondotorg Added option to use existing signing key. git clone use http, fixes #27.
authored
21 * -c : Remove pre-existing packages from /var/local/oab/deb
22 * -k <gpg-key-id> : Use the specified existing key instead of generating one
23 * -s : Skip building if the packages already exist
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
24 * -h : This help
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
25
26 How do I download and run this thing?
27 -------------------------------------
28 Like this.
29 ::
30
31 cd ~/
7463359 @flexiondotorg Updated docs
authored
32 wget https://github.com/flexiondotorg/oab-java6/raw/0.2.6/oab-java.sh -O oab-java.sh
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
33 chmod +x oab-java.sh
34 sudo ./oab-java.sh
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
35
36 If you are behind a proxy you may need to run using:
37 ::
38
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
39 sudo -i ./oab-java.sh
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
40
525ecdc @gontadu Little spelling and grammar stuff
gontadu authored
41 If you want to see what this script is doing while it is running then execute
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
42 the following from another shell:
43 ::
44
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
45 tail -f ./oab-java.sh.log
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
46
47 How it works
48 ------------
49 This script is merely a wrapper for the most excellent Debian packaging
50 scripts prepared by Janusz Dziemidowicz.
51
52 * https://github.com/rraptorr/sun-java6
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
53 * https://github.com/rraptorr/oracle-java7
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
54
55 The basic execution steps are:
56
57 * Remove, my now disabled, Java PPA 'ppa:flexiondotorg/java'.
58 * Install the tools required to build the Java packages.
59 * Create download cache in /var/local/oab/pkg.
60 * Download the i586 and x64 Java install binaries from Oracle. Yes, both are required.
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
61 * Clone the build scripts from https://github.com/rraptorr/
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
62 * Build the Java packages applicable to your system.
63 * Create local apt repository in /var/local/oab/deb for the newly built Java Packages.
64 * Create a GnuPG signing key in /var/local/oab/gpg if none exists.
65 * Sign the local apt repository using the local GnuPG signing key.
66
67 What gets installed?
68 --------------------
69 Nothing!
70
71 This script will no longer try and directly install or upgrade any Java
72 packages, instead a local apt repository is created that hosts locally
73 built Java packages applicable to your system. It is up to you to install
74 or upgrade the Java packages you require using apt-get, aptitude or
75 synaptic, etc. For example, once this script has been run you can simply
76 install the JRE by executing the following from a shell.
77 ::
78
79 sudo apt-get install sun-java6-jre
80
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
81 Or if you ran the script with the -7 option.
c603916 @flexiondotorg Correct formating error in docs
authored
82 ::
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
83
84 sudo apt-get install oracle-java7-jre
85
86 If you already have the *"official"* Ubuntu packages installed then you
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
87 can upgrade by executing the following from a shell.
88 ::
89
90 sudo apt-get upgrade
91
92 The local apt repository is just that, **local**. It is not accessible
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
93 remotely and oab-java.sh will never enable that capability to ensure
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
94 compliance with Oracle's asinine license requirements.
95
405faa9 @flexiondotorg Added option to use existing signing key. git clone use http, fixes #27.
authored
96 By default, the script creates a temporary GPG keyring in the working
97 directory. In order to use the current user's GPG chain instead, specify
98 the key ID of an existing secret key. Run gpg -K to list available keys.
99
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
100 Known Issues
101 ------------
102
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
103 * The Oracle download servers can be horribly slow. My script caches the downloads
104 so you only need download each file once.
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
105
106 What is 'oab'?
107 --------------
108 Because, O.A.B! ;-)
109
110
111 History
112 =======
113
a1666f3 @flexiondotorg Updated changelog
authored
114 0.2.5
115 -----
116
d2a5841 @flexiondotorg Minor doc updates
authored
117 * Fixed building Oracle Java 7 by adding ``libxrender1`` to the dependencies.
a1666f3 @flexiondotorg Updated changelog
authored
118
48f49d0 @flexiondotorg Closes #31, #32, #33, #34 and #39. Thanks for all the pull requests guys...
authored
119 0.2.4
120 -----
121 * Added support for JCE Unlimited Strength Jurisdiction Policy Files. Thanks to Ladios Jonquil and Jameson J Lee.
122
123 * Closes: https://github.com/flexiondotorg/oab-java6/issues/31
124
125 * Reverted to https for git clone of upstream tools.
126
127 * Closes: https://github.com/flexiondotorg/oab-java6/issues/32
128
129 * Updated download links to Sun Java 6 and Oracle Java 7. Thanks to Ladios Jonquil and Jameson J Lee.
130
131 * Closes: https://github.com/flexiondotorg/oab-java6/issues/33
132 * Closes: https://github.com/flexiondotorg/oab-java6/issues/34
133 * Closes: https://github.com/flexiondotorg/oab-java6/issues/39
134
c2e231e @flexiondotorg Added support for oracle-java7. Integrated common functions, fixes #23
authored
135 0.2.3
136 -----
137 * Added an option to build ``oracle-java7`` packages.
138 * Integrated common function into oab-java6.sh
139
140 * Closes : https://github.com/flexiondotorg/oab-java6/issues/23
141
405faa9 @flexiondotorg Added option to use existing signing key. git clone use http, fixes #27.
authored
142 0.2.2
143 -----
144 * Added an option to use a pre-existing signing key. Thanks to Hannes Schmidt.
145 * The ``git clone`` of ``rraptorr/sun-java6`` now uses http rather than https.
146
147 * Closes : https://github.com/flexiondotorg/oab-java6/issues/27
148
9083f3f @flexiondotorg Readying for 0.2.1
authored
149 0.2.1
150 -----
151 * Fixed downloading from ``edelivery.oracle.com`` (again). Thanks to onlymostlydead (Mark).
152
153 * Closes : https://github.com/flexiondotorg/oab-java6/issues/28
154
79204ba @flexiondotorg Fixed download from edelivery.oracle.com, closes #13. Fixed rebuilding b...
authored
155 0.2.0
156 -----
157
158 * Fixed downloading from ``edelivery.oracle.com`` when ``ca-certificates`` is not installed.
159
160 * Closes : https://github.com/flexiondotorg/oab-java6/issues/22
161
162 * Fixed the skip rebuilding behaviour so it works as described.
163 * Fixed the format of ``apt`` source file.
164 * Documentation is now self referencing.
165
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
166 0.1.9
167 -----
168
66f4680 @flexiondotorg Fix documentation formatting.
authored
169 * Fixed download of the Oracle binary packages, which now requires cookies. Thanks to Martin Polden and Miah Johnson.
97a29e1 @flexiondotorg Nested bullets are fixed.
authored
170
171 * Closes : https://github.com/flexiondotorg/oab-java6/issues/18
172
66f4680 @flexiondotorg Fix documentation formatting.
authored
173 * Added an option (-s) to skip rebuilding if packages already exist, tanks to Derek Chen-Becker.
79204ba @flexiondotorg Fixed download from edelivery.oracle.com, closes #13. Fixed rebuilding b...
authored
174 * Added a comment to the ``apt`` source file, thanks to Eshwar Andhavarapu.
66f4680 @flexiondotorg Fix documentation formatting.
authored
175 * Added documentation for user running the script behind a proxy server, thanks to Olzhas.
97a29e1 @flexiondotorg Nested bullets are fixed.
authored
176
177 * Closes : https://github.com/flexiondotorg/oab-java6/issues/12
178
66f4680 @flexiondotorg Fix documentation formatting.
authored
179 * Should now build on Ubuntu 12.04 LTS, but untested.
180 * Updated documentation which is now correctly formatted as reStructuredText.
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
181
182 0.1.8
183 -----
184
66f4680 @flexiondotorg Fix documentation formatting.
authored
185 * Added dynamic determination of Java package URLs and sizes.
186 * Added an option (``-c``) to optionally clean .deb package.
97a29e1 @flexiondotorg Nested bullets are fixed.
authored
187
188 * Closes : https://github.com/flexiondotorg/oab-java6/issues/10
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
189
190 0.1.7
191 -----
192
66f4680 @flexiondotorg Fix documentation formatting.
authored
193 * Fixed GPG key creation on VMware ESX Server.
97a29e1 @flexiondotorg Nested bullets are fixed.
authored
194
195 * Closes : https://github.com/flexiondotorg/oab-java6/issues/11
196
66f4680 @flexiondotorg Fix documentation formatting.
authored
197 * Fixed clone of the ``sun-java6`` repository for users behind restrictive firewalls, thanks to Thorsten Möllers.
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
198
199 0.1.6
200 -----
201
66f4680 @flexiondotorg Fix documentation formatting.
authored
202 * Fixed downloading of ``common.sh`` when ca-certificates is not installed.
97a29e1 @flexiondotorg Nested bullets are fixed.
authored
203
204 * Closes : https://github.com/flexiondotorg/oab-java6/issues/3
205
66f4680 @flexiondotorg Fix documentation formatting.
authored
206 * Updated to support Java6u31
97a29e1 @flexiondotorg Nested bullets are fixed.
authored
207
208 * Closes : https://github.com/flexiondotorg/oab-java6/issues/7
209 * Closes : https://github.com/flexiondotorg/oab-java6/issues/8
210 * NOTE! Requires that the upstream script tags Java6u31 as stable, see the following ticket https://github.com/rraptorr/sun-java6/issues/3
211
66f4680 @flexiondotorg Fix documentation formatting.
authored
212 * Prevent script from running under Ubuntu Precise as it is currently known to be unsupported.
97a29e1 @flexiondotorg Nested bullets are fixed.
authored
213
214 * Closes : https://github.com/flexiondotorg/oab-java6/issues/4
215
66f4680 @flexiondotorg Fix documentation formatting.
authored
216 * Prevent automated key generation when running in an OpenVZ container because I'm too stupid to work out a proper solution
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
217
218 0.1.5
219 -----
220
66f4680 @flexiondotorg Fix documentation formatting.
authored
221 * Fixed missing code that actually does the build.
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
222
223 0.1.4
224 -----
225
66f4680 @flexiondotorg Fix documentation formatting.
authored
226 * Added GnuPG signing of the local ``apt`` repository.
227 * Updated package building to preserve the upstream package urgency.
228 * Re-factored to remove hard coded versions, now uses ``debian/changelog``.
229 * Fixed the ``override`` file generation to ensure it doesn't contain duplicates.
230 * Updated documentation.
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
231
232 0.1.3
233 -----
234
66f4680 @flexiondotorg Fix documentation formatting.
authored
235 * Added checking out of tagged releases of the upstream scripts.
97a29e1 @flexiondotorg Nested bullets are fixed.
authored
236
237 * Closes : https://github.com/flexiondotorg/oab-java6/issues/1
238
66f4680 @flexiondotorg Fix documentation formatting.
authored
239 * Added loose distribution checking so it should now work with Linux Mint and other Ubuntu derivatives.
97a29e1 @flexiondotorg Nested bullets are fixed.
authored
240
241 * Closes : https://github.com/flexiondotorg/oab-java6/issues/2
242
66f4680 @flexiondotorg Fix documentation formatting.
authored
243 * Added the creation of a local ``apt`` repository
244 * Removed installation of Java packages, you can now use ``apt-get`` yourself
245 * Updated documentation
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
246
247 0.1.2
248 -----
249
66f4680 @flexiondotorg Fix documentation formatting.
authored
250 * Fixed build requirements.
251 * Fixed install of ``ia32-sun-java6-bin`` on 64-bit systems.
252 * Fixed install of Java browser plug-in on systems without a supported browser.
253 * Added runtime requirements.
254 * Added TODO.
255 * Updated documentation.
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
256
257 0.1.1
258 -----
259
66f4680 @flexiondotorg Fix documentation formatting.
authored
260 * Updated to use dynamic version detection throughout.
261 * Fixed package installation when upgrading.
262 * Minor documentation updates.
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
263
264 0.1.0
265 -----
266
66f4680 @flexiondotorg Fix documentation formatting.
authored
267 * Initial release.
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
268
269 Credits
270 =======
271
272 This package is written and maintained by Martin Wimpress, <code@flexion.org>
273
274 Other contributors, listed alphabetically, are:
275
276 * Derek Chen-Becker - Added an option to skip rebuilding packages.
277 * Eshwar Andhavarapu - Added comments in the apt source file.
405faa9 @flexiondotorg Added option to use existing signing key. git clone use http, fixes #27.
authored
278 * Hannes Schmidt - Added an option to use a pre-existing signing key.
48f49d0 @flexiondotorg Closes #31, #32, #33, #34 and #39. Thanks for all the pull requests guys...
authored
279 * Jameson J Lee - Added support for JCE Unlimited Strength Jurisdiction Policy Files and fixed downloading from Oracle (yet again).
280 * Ladios Jonquil - Added support for JCE Unlimited Strength Jurisdiction Policy Files and fixed downloading from Oracle (yet again).
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
281 * Martin Polden - Fixed download binary packages from Oracle.
282 * Miah Johnson - Fixed download binary packages from Oracle.
c5bce45 @flexiondotorg Minor doc updates
authored
283 * onlymostlydead - Fixed downloading from Oracle (again).
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
284 * Thorsten Möllers - Fixed git cloning for users behind restrictive firewalls.
285
286 Many thanks for all contributions!
287
288 Todo
289 ====
290
291 * Check the binary packages downloaded from Oracle are the correct size.
292 * Add support to build for a given Ubuntu distribution.
d2a5841 @flexiondotorg Minor doc updates
authored
293 * Add support to build using ``pbuilder`` or use ``fakeroot``.
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
294
2faf967 @flexiondotorg 0.2.4 ready. Closes #32. Fixes #33. Fixes #34. Fixes #39. Many thanks to...
authored
295
8e66677 @flexiondotorg Merged several pull requests which close #18 and close #12.
authored
296 License
297 =======
298
299 Copyright (c) 2012 Martin Wimpress, http://flexion.org/
300
301 Permission is hereby granted, free of charge, to any person obtaining a copy of
302 this software and associated documentation files (the "Software"), to deal in
303 the Software without restriction, including without limitation the rights to
304 use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
305 the Software, and to permit persons to whom the Software is furnished to do so,
306 subject to the following conditions:
307
308 The above copyright notice and this permission notice shall be included in all
309 copies or substantial portions of the Software.
310
311 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
312 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
313 FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
314 COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
315 IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
316 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Something went wrong with that request. Please try again.