1245 |
21 Oct 10 |
nicklas |
== Requirements == |
1245 |
21 Oct 10 |
nicklas |
2 |
|
1636 |
03 May 12 |
nicklas |
1. BASE 3.1.0 or later. |
1245 |
21 Oct 10 |
nicklas |
4 |
|
1245 |
21 Oct 10 |
nicklas |
== Introduction == |
1245 |
21 Oct 10 |
nicklas |
6 |
|
1245 |
21 Oct 10 |
nicklas |
This package is an extension package to BASE that installs a bittorrent |
1245 |
21 Oct 10 |
nicklas |
download service as part of the web server. It builds on the HTBTC library |
1245 |
21 Oct 10 |
nicklas |
for handling of the bittorrent protocol. |
1245 |
21 Oct 10 |
nicklas |
10 |
|
1245 |
21 Oct 10 |
nicklas |
* The homepage for this extension: |
1245 |
21 Oct 10 |
nicklas |
http://baseplugins.thep.lu.se/wiki/net.sf.basedb.torrent |
1245 |
21 Oct 10 |
nicklas |
* The HPBTC site: |
1245 |
21 Oct 10 |
nicklas |
http://sourceforge.net/projects/hpbtc/ |
1245 |
21 Oct 10 |
nicklas |
15 |
|
1245 |
21 Oct 10 |
nicklas |
== Installation == |
1245 |
21 Oct 10 |
nicklas |
17 |
|
1245 |
21 Oct 10 |
nicklas |
1. Download the `base-torrent-*.tar.gz` file. |
1245 |
21 Oct 10 |
nicklas |
2. Unpack the downloaded file to a directory of your choice. |
1245 |
21 Oct 10 |
nicklas |
3. Copy the `torrent.properties` file to `WEB-INF/classes` directory. |
1636 |
03 May 12 |
nicklas |
4. Copy the `base-torrent.jar` file to your BASE plug-ins directory. |
1636 |
03 May 12 |
nicklas |
Eg. the directory specified by the `plugins.dir` setting in `base.config`. |
1636 |
03 May 12 |
nicklas |
5. Log in to BASE as a user with Administrator priviliges. |
1636 |
03 May 12 |
nicklas |
6. Go to 'Administrate->Plug-ins & Extensions->Overview' page. |
1636 |
03 May 12 |
nicklas |
Run the installation wizard and select to install/update `base-torrent.jar`. |
1636 |
03 May 12 |
nicklas |
7. Done. |
1245 |
21 Oct 10 |
nicklas |
27 |
|
1245 |
21 Oct 10 |
nicklas |
== Known issues == |
1245 |
21 Oct 10 |
nicklas |
29 |
|
1245 |
21 Oct 10 |
nicklas |
This software is still in prototype status. Do not install in a production environment. |
1245 |
21 Oct 10 |
nicklas |
31 |
|
1245 |
21 Oct 10 |
nicklas |
== Compiling == |
1245 |
21 Oct 10 |
nicklas |
33 |
|
1245 |
21 Oct 10 |
nicklas |
To compile this package you also need: |
1245 |
21 Oct 10 |
nicklas |
35 |
|
1245 |
21 Oct 10 |
nicklas |
1. Ant 1.6 |
1245 |
21 Oct 10 |
nicklas |
2. Java 1.6 |
1245 |
21 Oct 10 |
nicklas |
38 |
|
1245 |
21 Oct 10 |
nicklas |
Follow these instructions: |
1245 |
21 Oct 10 |
nicklas |
40 |
|
1245 |
21 Oct 10 |
nicklas |
1. Download the source code from the subversion repository. See |
1245 |
21 Oct 10 |
nicklas |
http://baseplugins.thep.lu.se/wiki/net.sf.basedb.torrent for instructions. |
1245 |
21 Oct 10 |
nicklas |
43 |
|
1245 |
21 Oct 10 |
nicklas |
2. Type `ant download-lib` to automatically download the BASE core JAR file that |
1245 |
21 Oct 10 |
nicklas |
are neeed for compilation. You can also do this manually by copying the |
1636 |
03 May 12 |
nicklas |
base-core-*.jar and base-webclient-*.jar from the BASE installation directory |
1245 |
21 Oct 10 |
nicklas |
(`<basedir>/www/WEB-INF/lib/`) to the `./lib/compile` directory. |
1245 |
21 Oct 10 |
nicklas |
48 |
|
1245 |
21 Oct 10 |
nicklas |
3. Type `ant` to compile the code and generate the `base-torrent.jar` file |
1245 |
21 Oct 10 |
nicklas |
in the project directory. |
1245 |
21 Oct 10 |
nicklas |
51 |
|
1245 |
21 Oct 10 |
nicklas |
4. Use `ant package` to create a downloadable tar.gz package. |
1245 |
21 Oct 10 |
nicklas |
53 |
|
1245 |
21 Oct 10 |
nicklas |
Tip: If you need different values for any of the properties defined in |
1245 |
21 Oct 10 |
nicklas |
the 'build.xml' file, create a file named 'build.properties' and set |
1245 |
21 Oct 10 |
nicklas |
the values there. |