MySQL Bugs: #52760: Document ndbclient.lib in settings.xml

Bug #52760	Document ndbclient.lib in settings.xml
Submitted:	12 Apr 2010 8:47
Reporter:	Jørgen Austvik	Email Updates:
Status:	Open	Impact on me:	None
Category:	MySQL Cluster: Cluster/J	Severity:	S4 (Feature request)
Version:	mysql-5.1-telco-7.1	OS:	Any
Assigned to:	Jon Stephens	CPU Architecture:	Any

Description:
The ndbclient.lib setting has to be set in ~/.m2/settings.xml or similar.

Please add example on how to do this in README.html, or add settings.xml.sample in the repository.

How to repeat:
-

Suggested fix:
A small chapter with sample settings.xml in README.html.

This is documented as item 6 in the README.html, but apparently that's not sufficient, since you didn't find it.

Probably the best approach is as described, a sample.settings.xml next to the README.html, that a user could use to copy and paste, and a reference from item 6 to the sample file. Putting a settings.xml directly into the distribution might confuse folks.

I suggest that we add information to http://dev.mysql.com/doc/ndbapi/en/mccj-getting.html

You can also use the included file storage/ndb/clusterj/pom.xml for building ClusterJ with Maven.

To build with Maven, change directory to storage/ndb/clusterj and run the mvn install command.

To run tests, you will need the Maven variable ndbclient.lib set. The easiest way to do this is to add to your Maven settings in the file ~/.m2/settings.xml, entries similar to the following, wherever the ndbclient.lib has been installed:

<?xml version="1.0" encoding="UTF-8"?>
<settings>
  <profiles>
      <profile>
          <id>jni-library</id>
          <activation>
              <activeByDefault>true</activeByDefault>
          </activation>
          <properties>
              <ndbclient.lib>/Users/admin/ndb/install-5.6-cluster-7.3.3/lib</ndbclient.lib>
          </properties>
      </profile>
  </profiles>
</settings>