extensions/net.sf.basedb.hdfs/trunk/README

Code
Comments
Other
Rev Date Author Line
1330 01 Apr 11 nicklas 1 == Requirements ==
1330 01 Apr 11 nicklas 2
2289 13 Mar 14 nicklas 3  1. BASE 3.3 or later.
1330 01 Apr 11 nicklas 4  
1330 01 Apr 11 nicklas 5 == Introduction ==
1330 01 Apr 11 nicklas 6
1330 01 Apr 11 nicklas 7 This package is an extension package to BASE that adds support
1330 01 Apr 11 nicklas 8 for external files located on a Hadoop Distributed File System
1330 01 Apr 11 nicklas 9 (HDFS).
1330 01 Apr 11 nicklas 10
1330 01 Apr 11 nicklas 11  * The homepage for this extension: 
1330 01 Apr 11 nicklas 12    http://baseplugins.thep.lu.se/wiki/net.sf.basedb.hdfs
1330 01 Apr 11 nicklas 13
1330 01 Apr 11 nicklas 14 == Installation ==
1330 01 Apr 11 nicklas 15
1330 01 Apr 11 nicklas 16  1. Download the hdfs-*.tar.gz file.
1330 01 Apr 11 nicklas 17  2. Unpack the downloaded file to a directory of your choice.
1358 03 May 11 nicklas 18  3. Copy the 'hdfs.jar' file to your BASE plug-ins directory. Look in your 
1358 03 May 11 nicklas 19     'base.config' file if you don't know where this is. 
1358 03 May 11 nicklas 20  4. Go to 'Administrate->Plug-ins & Extensions->Overview' page.
1358 03 May 11 nicklas 21  5. Run the installation wizard and select to install 'hdfs.jar'.
1358 03 May 11 nicklas 22  6. Done. 
1330 01 Apr 11 nicklas 23
1330 01 Apr 11 nicklas 24  
1330 01 Apr 11 nicklas 25 == Using ==
1330 01 Apr 11 nicklas 26
1330 01 Apr 11 nicklas 27 Create an external file in BASE using an URL on the form:
1330 01 Apr 11 nicklas 28
1330 01 Apr 11 nicklas 29   hdfs://namenode.server:port/path/on/hdfs/filesystem
1330 01 Apr 11 nicklas 30
1330 01 Apr 11 nicklas 31 where 'namenode.server' is the ip-address or name of the
1330 01 Apr 11 nicklas 32 Namenode for the HDFS cluster. The port is optional. If not 
1330 01 Apr 11 nicklas 33 specified 9000 is used as the default port.
1330 01 Apr 11 nicklas 34
1330 01 Apr 11 nicklas 35 It is also possible to create a "File server" item in BASE
1330 01 Apr 11 nicklas 36 to force the use of HDFS. Since HDFS does not yet support
1330 01 Apr 11 nicklas 37 autentication the rest of the options for the file server
1330 01 Apr 11 nicklas 38 item are not used.
1330 01 Apr 11 nicklas 39
1330 01 Apr 11 nicklas 40
1330 01 Apr 11 nicklas 41 == Compiling ==
1330 01 Apr 11 nicklas 42
1330 01 Apr 11 nicklas 43 To compile this package you also need:
1330 01 Apr 11 nicklas 44  
1451 03 Nov 11 nicklas 45  1. Ant 1.8
2289 13 Mar 14 nicklas 46  2. Java 1.7
1330 01 Apr 11 nicklas 47
1330 01 Apr 11 nicklas 48 Follow these instructions:
1330 01 Apr 11 nicklas 49
1330 01 Apr 11 nicklas 50  1. Download the source code from the subversion repository. See
1330 01 Apr 11 nicklas 51     http://baseplugins.thep.lu.se/wiki/net.sf.basedb.hdfs for instructions.
1330 01 Apr 11 nicklas 52  
1330 01 Apr 11 nicklas 53  2. Type `ant download-lib` to automatically download the BASE core JAR files that
1330 01 Apr 11 nicklas 54     are neeed for compilation. You can also do this manually by copying the 
1330 01 Apr 11 nicklas 55     base-core-3.x.jar file from the BASE installation directory 
1330 01 Apr 11 nicklas 56     (<basedir>/www/WEB-INF/lib/) to the ./lib/compile directory.
1330 01 Apr 11 nicklas 57
1330 01 Apr 11 nicklas 58  3. Type 'ant' to compile the code and generate the 'hdfs.jar' file
1330 01 Apr 11 nicklas 59     in the project directory.
1330 01 Apr 11 nicklas 60
1330 01 Apr 11 nicklas 61  4. Use 'ant package' to create a downloadable tar.gz package.
1330 01 Apr 11 nicklas 62  
1330 01 Apr 11 nicklas 63 Tip: If you need different values for any of the properties defined in
1330 01 Apr 11 nicklas 64 the 'build.xml' file, create a file named 'build.properties' and set
1330 01 Apr 11 nicklas 65 the values there.
1330 01 Apr 11 nicklas 66

Generated on Tue Nov 21 03:25:01 2023 (UTC) by svndigest 0.11.2pre (dev build 1672)