Repository: accumulo Updated Branches: refs/heads/1.6.1-SNAPSHOT 7ccf20269 -> f61abc088 refs/heads/master c312fa6f8 -> 6b36d53a9
ACCUMULO-2821 Add/Update docs for building native lib Project: http://git-wip-us.apache.org/repos/asf/accumulo/repo Commit: http://git-wip-us.apache.org/repos/asf/accumulo/commit/f61abc08 Tree: http://git-wip-us.apache.org/repos/asf/accumulo/tree/f61abc08 Diff: http://git-wip-us.apache.org/repos/asf/accumulo/diff/f61abc08 Branch: refs/heads/1.6.1-SNAPSHOT Commit: f61abc088edd8607625bade07fea0fe02b7ffe37 Parents: 7ccf202 Author: Christopher Tubbs <ctubb...@apache.org> Authored: Fri May 16 15:27:37 2014 -0400 Committer: Christopher Tubbs <ctubb...@apache.org> Committed: Fri May 16 15:27:37 2014 -0400 ---------------------------------------------------------------------- README | 7 +++++++ .../chapters/administration.tex | 19 +++++++++++++------ 2 files changed, 20 insertions(+), 6 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/accumulo/blob/f61abc08/README ---------------------------------------------------------------------- diff --git a/README b/README index a2d758b..c2c2446 100644 --- a/README +++ b/README @@ -61,6 +61,13 @@ installed with the JAVA_HOME environment variable set. $ ./bin/build_native_library.sh +If your system's default compiler options are insufficient, you can add +additional compiler options to the command line, such as options for the +architecture. These will be passed to the Makefile in the environment variable +USERFLAGS: + + $ ./bin/build_native_library.sh -m32 + Alternatively, you can manually unpack the accumulo-native tarball in the $ACCUMULO_HOME/lib directory. Change to the accumulo-native directory in the current directory and issue `make`. Then, copy the resulting 'libaccumulo' http://git-wip-us.apache.org/repos/asf/accumulo/blob/f61abc08/docs/src/main/latex/accumulo_user_manual/chapters/administration.tex ---------------------------------------------------------------------- diff --git a/docs/src/main/latex/accumulo_user_manual/chapters/administration.tex b/docs/src/main/latex/accumulo_user_manual/chapters/administration.tex index 743b496..d2a2fcc 100644 --- a/docs/src/main/latex/accumulo_user_manual/chapters/administration.tex +++ b/docs/src/main/latex/accumulo_user_manual/chapters/administration.tex @@ -143,19 +143,26 @@ speed up performance by utilizing the memory space of the native operating syste native map also avoids the performance implications brought on by garbage collection in the JVM by causing it to pause much less frequently. -32-bit and 64-bit Linux versions of the native map ship with the Accumulo dist package. -For other operating systems, the native map can be built from the codebase in two ways- -from maven or from the Makefile. +32-bit and 64-bit Linux and Mac OS X versions of the native map can be built +from the Accumulo bin package by executing +\texttt{\$ACCUMULO\_HOME/bin/build\_native\_library.sh}. If your system's +default compiler options are insufficient, you can add additional compiler +options to the command line, such as options for the architecture. These will be +passed to the Makefile in the environment variable USERFLAGS. + +Examples: \begin{enumerate} -\item{Build from maven using the following command: \texttt{mvn clean package -Pnative.}} -\item{Build from the c++ source by running \texttt{make} in the \texttt{\$ACCUMULO\_HOME/server/src/main/c++} directory.} +\item{\texttt{\$ACCUMULO\_HOME/bin/build\_native\_library.sh}} +\item{\texttt{\$ACCUMULO\_HOME/bin/build\_native\_library.sh -m32}} \end{enumerate} After building the native map from the source, you will find the artifact in \texttt{\$ACCUMULO\_HOME/lib/native.} Upon starting up, the tablet server will look in this directory for the map library. If the file is renamed or moved from its -target directory, the tablet server may not be able to find it. +target directory, the tablet server may not be able to find it. The system can +also locate the native maps shared library by setting LD\_LIBRARY\_PATH +(or DYLD\_LIBRARY\_PATH on Mac OS X) in \texttt{\$ACCUMULO\_HOME/conf/accumulo-env.sh}. \subsection{Cluster Specification}
