Building Python MongoDB Driver

Building Python MongoDB Driver

Below versions of Python MongoDB Driver are available in respective distributions at the time of creation of these build instructions:

• Ubuntu 16.04 has 3.2
• Ubuntu 17.10 has 3.4.0

The instructions provided below specify the steps to build Python MongoDB Driver (PyMongo) version 3.6.1 on Linux on IBM Z for the following distributions:

• RHEL (6.9, 7.3, 7.4)
• SLES (11 SP4, 12 SP2, 12 SP3)
• Ubuntu (16.04, 17.10)

General Notes:

• When following the steps below please use a standard permission user unless otherwise specified.

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

Step 1: Building and Installing PyMongo

1.1) Install dependencies

• RHEL 6.9

sudo yum install -y git python-devel python-setuptools python-setuptools-devel python-virtualenv curl gcc

• RHEL (7.3, 7.4)

sudo yum install -y git openssl openssl-devel pyOpenSSL  python-devel python-setuptools python-setuptools-devel python-virtualenv libffi-devel gcc

• SLES 11 SP4

sudo zypper install -y git curl  python-xml python-openssl  python-setuptools openssl-devel openssl tar python-devel gcc  

• SLES (12 SP2, 12 SP3)

sudo zypper install -y git wget python-xml python-devel python-cffi openssl-devel libffi-devel gcc

• Ubuntu (16.04, 17.10)

sudo apt-get update
sudo apt-get install -y git openssl libssh-dev python python-openssl python-setuptools python-dev gcc 

1.2) Install pip

• RHEL 6.9

curl -o /tmp/ez_setup.py https://bootstrap.pypa.io/ez_setup.py
sudo /usr/bin/python2.6 /tmp/ez_setup.py
sudo sed --in-place 's#http://pypi.python.org#https://pypi.python.org#g' /usr/lib/python2.6/site-packages/setuptools/command/easy_install.py
sudo /usr/bin/easy_install pip		

• RHEL (7.3, 7.4) and Ubuntu (16.04, 17.10)

sudo easy_install pip

• SLES 11 SP4

curl -O https://pypi.python.org/packages/source/p/pip/pip-1.2.1.tar.gz
tar xvfz pip-1.2.1.tar.gz
cd pip-1.2.1
sudo python setup.py install
sudo ln -sfn /usr/local/bin/pip /usr/bin/pip	

• SLES (12 SP2, 12 SP3)

 wget https://bootstrap.pypa.io/ez_setup.py && sudo python ez_setup.py	   
 sudo easy_install pip==1.2.1

1.3) Download Pymongo source and Install

cd /<source_root>/
git clone git://github.com/mongodb/mongo-python-driver.git pymongo
cd pymongo
git checkout 3.6.1
sudo python setup.py install

1.4) Execute test cases

Access to MongoDB Server is required to execute test cases.

• If MongoDB Server is running on same machine then execute the following:

sudo python setup.py test

• If MongoDB Server is running on remote machine, then execute the following:

export DB_IP=<MongoDB_Server_IP>
sudo -E python setup.py test

Step 2:Basic validation test

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

2.1) Prerequisites

Python MongoDB Driver 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 MongoDB 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: 3.6.3 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.2) The Test Code

Create a file named test.py 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.

import pprint
import pymongo

from pymongo import MongoClient

server="localhost";
database="ibm_test_db";
collection="mongodb_python_driver";

serverdb="mongodb://" + server + ":27017/";

client = MongoClient(serverdb)

db = client[database];

db[collection].drop();

header = {"company": "IBM",
      "project": "MongoDB Driver",
      "language": "python",
      "version": "3.6.1"};

db[collection].insert_one(header);

for i in range (0, 3):
    doc = {"line": i};
    db[collection].insert_one (doc);

for gotdoc in db[collection].find():
    pprint.pprint(gotdoc);

2.3) Run Test Script

python test.py

The output from the above should look similar to:

{u'_id': ObjectId('560eb1ff051ba90001d927a0'),
u'company': u'IBM',
u'language': u'python',
u'project': u'MongoDB Driver',
u'version': u'3.6.1'}
{u'_id': ObjectId('560eb1ff051ba90001d927a1'), u'line': 0}
{u'_id': ObjectId('560eb1ff051ba90001d927a2'), u'line': 1}
{u'_id': ObjectId('560eb1ff051ba90001d927a3'), u'line': 2}

References:

• Python MongoDB installation