Building Python MongoDB Driver

Building Python MongoDB Driver

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

• RHEL (6.9, 7.1, 7.2, 7.3, 7.4)
• SLES (11 SP4, 12, 12 SP1, 12 SP2)
• Ubuntu (16.04, 17.04)

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

• RHEL (7.1, 7.2, 7.3, 7.4)

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

• SLES 11 SP4

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

• SLES (12, 12 SP1, 12 SP2)

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

• Ubuntu (16.04, 17.04)

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

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 /usr/bin/easy_install pip		

• RHEL (7.1, 7.2, 7.3, 7.4) and Ubuntu (16.04, 17.04)

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, 12 SP1, 12 SP2)

 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.5.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 python setup.py test

Note:

• If test_bad_encode test case fails with error: "TypeError: encoder expected a mapping type but got: {'a': {...}}", or if test_get_last_version test case fails with AssertionError then it might be an issue with Python version. Try installing Python 2.7.9 from Python recipe and re-run the test cases.

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: 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.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.5.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.5.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