#Building C++ MongoDB Driver

The instructions provided below specify the steps to build C++ MongoDB Driver legacy-1.1.1 on Linux on the IBM z Systems for RHEL 6/7, SLES 12 and Ubuntu 16.04

General Notes: i) When following the steps below please use a standard permission user unless otherwise specified.

ii) A directory /<source_root>/ will be referred to in these instructions, this is a temporary writable directory anywhere you'd like to place it.

1. Install build dependencies

For RHEL 7.1

sudo yum install automake boost-devel libtool gcc-c++ git make wget

For RHEL 6

sudo yum install automake boost-devel libtool gcc-c++ git make tar wget which

For SLES 12

sudo zypper install automake boost-devel libtool gcc-c++ git make scons

For SLES 11

Known not to work on SLES 11

For Ubuntu 16.04

sudo apt-get update
sudo apt-get install gcc libtool wget tar make scons git g++ libboost-all-dev 

Note: Add following repos in /etc/apt/sources.list file and upgrade the system, if any of the mentioned package on Ubuntu is missing. deb http://ports.ubuntu.com/ubuntu-ports/ xenial main restricted universe multiverse deb-src http://ports.ubuntu.com/ubuntu-ports/ xenial main restricted universe multiverse deb http://ports.ubuntu.com/ubuntu-ports/ xenial-security main restricted universe multiverse deb http://ports.ubuntu.com/ubuntu-ports/ xenial-updates main restricted universe multiverse deb-src http://ports.ubuntu.com/ubuntu-ports/ xenial-security main restricted universe multiverse deb-src http://ports.ubuntu.com/ubuntu-ports/ xenial-updates main restricted universe multiverse

You may already have these packages installed - just install any that are missing.

2. Install SCons

   The C++ build system uses SCons. On Suse, this is available via normal package install. On Redhat, download and install package manually:

   On RHEL6 and RHEL7, download scons-2.5.0-1.noarch.rpm from SCons 2.5.0 Downloads and install it like this:

    cd /<source_root>/
    wget https://sourceforge.net/projects/scons/files/scons/2.5.0/scons-2.5.0-1.noarch.rpm
    sudo rpm -i scons-2.5.0-1.noarch.rpm
   

#Build and Install the C++ Driver

1. Download the Driver

   Clone the C++ driver source code:

   cd /<source_root>/
   git clone https://github.com/mongodb/mongo-cxx-driver
   cd /<source_root>/mongo-cxx-driver
   git checkout legacy-1.1.1

2. Build and Install

   Use SCons to build and install it:

   sudo scons --prefix=/usr/local install --disable-warnings-as-errors  
   

3. Build and run the unit tests with scons:

   sudo scons build-unit --disable-warnings-as-errors
   sudo scons unit --disable-warnings-as-errors   

#Basic validation test

The example code section given below is used to perform a basic test to ensure that the MongoDB C++ Driver is working as expected, and can connect to, modify and query a MongoDB server.

1. Prerequisites

   The MongoDB Driver obviously needs access to a running MongoDB server, either on your local server or a remote system. The following commands are an example of how to start up a MongodDB server and then connect to it with the client shell, but note that MongoDB has not been installed as part of these instructions, and typically you would be running MongoDB on a remote server.

   mongod > /tmp/mongodb.log &
   mongo --host localhost 

   Which would typically give a command prompt such as:

   MongoDB shell version: 2.4.10 connecting to: localhost:27017/test > 

   The example code below will need to be modified to use your remote server hostname or IP address instead of "localhost", if you are attempting to connect to your own (remote) server.

2. The Test Code

   Use vi to create test.cxx with the content shown below. This code connects to a MongoDB server, inserts some documents and then queries the database to read them back and display them.

   Remember, if you are connecting to a remote server then you need to substitute the localhost with the hostname or IP address of the MongoDB server.

   #include <cstdlib>
   #include <iostream>
   #include "mongo/client/dbclient.h" // for the driver
   #include "mongo/bson/bson.h" // for BSON datatypes
   
   using mongo::BSONObj;
   using mongo::BSONObjBuilder;
   using mongo::DBClientCursor;
   
   const char *server("localhost");
   const char *db_collection("ibm_test_db.mongodb_cpp_test");
   
   int main() {
       mongo::DBClientConnection db;
   
       mongo::client::initialize();
       try {
           db.connect(server);
           std::cout << "connected ok" << std::endl;
       } catch( const mongo::DBException &e ) {
           std::cout << "caught connect error: " << e.what() <<     std::endl;
       }
   
       mongo::OID oid = mongo::OID::gen();
       BSONObjBuilder b;
       b.append("_id", oid);
       b.append("company", "IBM");
       b.append("project", "MongoDB Driver");
       b.append("language", "C++");
       b.append("version", "legacy");
       BSONObj p = b.obj();
   
   
       db.dropCollection(db_collection, NULL);
   
       try {
           db.insert(db_collection, p);
           std::cout << "inserted ok" << std::endl;
       } catch( const mongo::DBException &e ) {
           std::cout << "caught insert error: " << e.what() << std::endl;
       }
   
       for ( int i = 0; i < 3 ; i++) {
           mongo::OID oid = mongo::OID::gen();
           BSONObjBuilder b;
           b.append("_id", oid);
           b.append("line", i);
           BSONObj p = b.obj();
           db.insert(db_collection, p);
       }
   
       try {
           std::auto_ptr<DBClientCursor> cursor = db.query  (db_collection, BSONObj() );
           std::cout << "find ok" << std::endl;
           while (cursor->more()) {
               std::cout << cursor->next().toString() << std::endl;
           }
       } catch( const mongo::DBException &e ) {
           std::cout << "caught find error: " << e.what() << std::endl;
       }
   
       return EXIT_SUCCESS;
   }

3. Compile

   Compile and run the test program by:

     g++ test.cxx -o test -pthread -lmongoclient -lboost_thread -lboost_system -lboost_regex
     ./test

   Executing the script should produce output similar to this (the Object Ids will vary, but typically will be consecutive):

   { _id: ObjectId('55f839498d772db54d86f38c'), company: "IBM", project: "MongoDB Driver", driver: "C++", version: "legacy" }
   { _id: ObjectId('55f8394a8d772db54d86f38d'), row: 0 }
   { _id: ObjectId('55f8394a8d772db54d86f38e'), row: 1 }
   { _id: ObjectId('55f8394a8d772db54d86f38f'), row: 2 }

   Note: If you get the following error /usr/bin/ld: cannot find -lboost_thread, then create a symbolic link named libboost_thread to libboost_thread-mt

   sudo ln -s /usr/lib64/libboost_thread-mt.so /usr/lib64/libboost_thread.so

https://github.com/mongodb/mongo-cxx-driver