[20/50] [abbrv] git commit: ACCUMULO-2821 Add/Update docs for building native lib

[el...@apache.org]

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/ACCUMULO-378
Commit: f61abc088edd8607625bade07fea0fe02b7ffe37
Parents: 7ccf202
Author: Christopher Tubbs <ct...@apache.org>
Authored: Fri May 16 15:27:37 2014 -0400
Committer: Christopher Tubbs <ct...@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}