/usr/share/doc/python-pymongo-doc/html/installation.html is in python-pymongo-doc 2.6.3-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Installing / Upgrading — PyMongo 2.6.3 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '2.6.3',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/sidebar.js"></script>
<link rel="top" title="PyMongo 2.6.3 documentation" href="index.html" />
<link rel="next" title="Tutorial" href="tutorial.html" />
<link rel="prev" title="PyMongo 2.6.3 Documentation" href="index.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="tutorial.html" title="Tutorial"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="index.html" title="PyMongo 2.6.3 Documentation"
accesskey="P">previous</a> |</li>
<li><a href="index.html">PyMongo 2.6.3 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="installing-upgrading">
<h1>Installing / Upgrading<a class="headerlink" href="#installing-upgrading" title="Permalink to this headline">¶</a></h1>
<p><strong>PyMongo</strong> is in the <a class="reference external" href="http://pypi.python.org/pypi/pymongo/">Python Package Index</a>.</p>
<div class="section" id="microsoft-windows">
<h2>Microsoft Windows<a class="headerlink" href="#microsoft-windows" title="Permalink to this headline">¶</a></h2>
<p>We recommend using the <cite>MS Windows installers</cite> available from the <a class="reference external" href="http://pypi.python.org/pypi/pymongo/">Python
Package Index</a>.</p>
</div>
<div class="section" id="installing-with-pip">
<h2>Installing with pip<a class="headerlink" href="#installing-with-pip" title="Permalink to this headline">¶</a></h2>
<p>We prefer <a class="reference external" href="http://pypi.python.org/pypi/pip">pip</a>
to install pymongo on platforms other than Windows:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>pip install pymongo
</pre></div>
</div>
<p>To get a specific version of pymongo:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>pip install <span class="nv">pymongo</span><span class="o">==</span>2.1.1
</pre></div>
</div>
<p>To upgrade using pip:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>pip install --upgrade pymongo
</pre></div>
</div>
</div>
<div class="section" id="installing-with-easy-install">
<h2>Installing with easy_install<a class="headerlink" href="#installing-with-easy-install" title="Permalink to this headline">¶</a></h2>
<p>If you must install pymongo using
<a class="reference external" href="http://pypi.python.org/pypi/setuptools">setuptools</a> do:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>easy_install pymongo
</pre></div>
</div>
<p>To upgrade do:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>easy_install -U pymongo
</pre></div>
</div>
</div>
<div class="section" id="dependencies-for-installing-c-extensions-on-unix">
<h2>Dependencies for installing C Extensions on Unix<a class="headerlink" href="#dependencies-for-installing-c-extensions-on-unix" title="Permalink to this headline">¶</a></h2>
<p>10gen does not provide statically linked binary packages for Unix flavors
other than OSX. To build the optional C extensions you must have the GNU C
compiler (gcc) installed. Depending on your flavor of Unix (or Linux
distribution) you may also need a python development package that provides
the necessary header files for your version of Python. The package name may
vary from distro to distro.</p>
<p>Debian and Ubuntu users should issue the following command:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>sudo apt-get install build-essential python-dev
</pre></div>
</div>
<p>RedHat, CentOS, and Fedora users should issue the following command:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>sudo yum install gcc python-devel
</pre></div>
</div>
</div>
<div class="section" id="osx">
<h2>OSX<a class="headerlink" href="#osx" title="Permalink to this headline">¶</a></h2>
<p>10gen provides pre-built egg packages for Apple provided Python versions on
Snow Leopard (2.5, 2.6), Lion (2.5, 2.6, 2.7) and Mountain Lion (2.5, 2.6, 2.7).
If you want to install PyMongo for other Python versions (or from source) you
will have to install the following to build the C extensions:</p>
<p><strong>Snow Leopard (10.6)</strong> - Xcode 3 with ‘UNIX Development Support’.</p>
<p><strong>Snow Leopard Xcode 4</strong>: The Python versions shipped with OSX 10.6.x
are universal binaries. They support i386, PPC, and (in the case of python2.6)
x86_64. Xcode 4 removed support for PPC, causing the distutils version shipped
with Apple’s builds of Python to fail to build the C extensions if you have
Xcode 4 installed. There is a workaround:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="c"># For Apple-supplied Python2.6 (installed at /usr/bin/python2.6) and</span>
<span class="c"># some builds from python.org</span>
<span class="nv">$ </span>env <span class="nv">ARCHFLAGS</span><span class="o">=</span><span class="s1">'-arch i386 -arch x86_64'</span> python -m easy_install pymongo
<span class="c"># For 32-bit-only Python (/usr/bin/python2.5) and some builds</span>
<span class="c"># from python.org</span>
<span class="nv">$ </span>env <span class="nv">ARCHFLAGS</span><span class="o">=</span><span class="s1">'-arch i386'</span> python -m easy_install pymongo
</pre></div>
</div>
<p>See <a class="reference external" href="http://bugs.python.org/issue11623">http://bugs.python.org/issue11623</a>
for a more detailed explanation.</p>
<p><strong>Lion (10.7)</strong> - PyMongo’s C extensions can be built against versions of Python
>= 3.2 downloaded from python.org. Building against versions older than 3.2.3
requires <strong>Xcode 4.1</strong>. Any version of Xcode 4 can be used to build the C
extensions against 3.2.3 and newer. In all cases Xcode must be installed with
‘UNIX Development Support’. See the following for more information:</p>
<p><a class="reference external" href="http://bugs.python.org/issue13590">http://bugs.python.org/issue13590</a></p>
<p><a class="reference external" href="http://hg.python.org/cpython/file/v3.2.3/Misc/NEWS#l198">http://hg.python.org/cpython/file/v3.2.3/Misc/NEWS#l198</a></p>
<p><strong>Mountain Lion (10.8)</strong> - PyMongo’s C extensions can be built against versions
of Python >= 3.3rc1 downloaded from python.org with no special requirements.
If you want to build against the python.org provided 3.2.3 you must have
MacOSX10.6.sdk in /Developer/SDKs. See the following for more information:</p>
<p><a class="reference external" href="http://bugs.python.org/issue14499">http://bugs.python.org/issue14499</a></p>
</div>
<div class="section" id="installing-from-source">
<h2>Installing from source<a class="headerlink" href="#installing-from-source" title="Permalink to this headline">¶</a></h2>
<p>If you’d rather install directly from the source (i.e. to stay on the
bleeding edge), install the C extension dependencies then check out the
latest source from github and install the driver from the resulting tree:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>git clone git://github.com/mongodb/mongo-python-driver.git pymongo
<span class="nv">$ </span><span class="nb">cd </span>pymongo/
<span class="nv">$ </span>python setup.py install
</pre></div>
</div>
<div class="section" id="installing-from-source-on-windows">
<h3>Installing from source on Windows<a class="headerlink" href="#installing-from-source-on-windows" title="Permalink to this headline">¶</a></h3>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">10gen provides pre-built exe installers for 32-bit and 64-bit Windows. We
recommend that users install those packages (<a class="reference external" href="http://pypi.python.org/pypi/pymongo/">available from pypi</a>).</p>
</div>
<p>If you want to install PyMongo with C extensions from source the following
directions apply to both CPython and ActiveState’s ActivePython:</p>
<div class="section" id="bit-windows">
<h4>64-bit Windows<a class="headerlink" href="#bit-windows" title="Permalink to this headline">¶</a></h4>
<p>For Python 3.3 install Visual Studio 2010. For Python 3.2 and older install
Visual Studio 2008. In either case you must use the full version as Visual
C++ Express does not provide 64-bit compilers. Make sure that you check the
“x64 Compilers and Tools” option under Visual C++.</p>
</div>
<div class="section" id="id2">
<h4>32-bit Windows<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h4>
<p>For Python 3.3 install Visual C++ 2010 Express.</p>
<p>For Python 2.6 through 3.2 install Visual C++ 2008 Express SP1.</p>
<p>For Python 2.4 or 2.5 you must install
<a class="reference external" href="http://www.mingw.org/wiki/InstallationHOWTOforMinGW">MingW32</a> then run the
following command to install:</p>
<div class="highlight-bash"><div class="highlight"><pre>python setup.py build -c mingw32 install
</pre></div>
</div>
</div>
</div>
</div>
<div class="section" id="installing-without-c-extensions">
<span id="install-no-c"></span><h2>Installing Without C Extensions<a class="headerlink" href="#installing-without-c-extensions" title="Permalink to this headline">¶</a></h2>
<p>By default, the driver attempts to build and install optional C
extensions (used for increasing performance) when it is installed. If
any extension fails to build the driver will be installed anyway but a
warning will be printed.</p>
<p>In <a class="reference internal" href="faq.html#using-with-mod-wsgi"><em>certain cases</em></a>, you might wish to
install the driver without the C extensions, even if the extensions
build properly. This can be done using a command line option to
<em>setup.py</em>:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>python setup.py --no_ext install
</pre></div>
</div>
</div>
<div class="section" id="building-pymongo-egg-packages">
<h2>Building PyMongo egg Packages<a class="headerlink" href="#building-pymongo-egg-packages" title="Permalink to this headline">¶</a></h2>
<p>Some organizations do not allow compilers and other build tools on production
systems. To install PyMongo on these systems with C extensions you may need to
build custom egg packages. Make sure that you have installed the dependencies
listed above for your operating system then run the following command in the
PyMongo source directory:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>python setup.py bdist_egg
</pre></div>
</div>
<p>The egg package can be found in the dist/ subdirectory. The file name will
resemble “pymongo-2.2-py2.7-linux-x86_64.egg” but may have a different name
depending on your platform and the version of python you use to compile.</p>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">These “binary distributions,” will only work on systems that resemble the
environment on which you built the package. In other words, ensure that
operating systems and versions of Python and architecture (i.e. “32” or “64”
bit) match.</p>
</div>
<p>Copy this file to the target system and issue the following command to install the
package:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>sudo easy_install pymongo-2.2-py2.7-linux-x86_64.egg
</pre></div>
</div>
</div>
<div class="section" id="installing-a-release-candidate">
<h2>Installing a release candidate<a class="headerlink" href="#installing-a-release-candidate" title="Permalink to this headline">¶</a></h2>
<p>10gen may occasionally tag a release candidate for testing by the community
before final release. These releases will not be uploaded to pypi but can be
found on the
<a class="reference external" href="https://github.com/mongodb/mongo-python-driver/tags">github tags page</a>.
They can be installed by passing the full URL for the tag to pip:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>pip install https://github.com/mongodb/mongo-python-driver/tarball/2.2rc1
</pre></div>
</div>
<p>or easy_install:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>easy_install https://github.com/mongodb/mongo-python-driver/tarball/2.2rc1
</pre></div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Installing / Upgrading</a><ul>
<li><a class="reference internal" href="#microsoft-windows">Microsoft Windows</a></li>
<li><a class="reference internal" href="#installing-with-pip">Installing with pip</a></li>
<li><a class="reference internal" href="#installing-with-easy-install">Installing with easy_install</a></li>
<li><a class="reference internal" href="#dependencies-for-installing-c-extensions-on-unix">Dependencies for installing C Extensions on Unix</a></li>
<li><a class="reference internal" href="#osx">OSX</a></li>
<li><a class="reference internal" href="#installing-from-source">Installing from source</a><ul>
<li><a class="reference internal" href="#installing-from-source-on-windows">Installing from source on Windows</a><ul>
<li><a class="reference internal" href="#bit-windows">64-bit Windows</a></li>
<li><a class="reference internal" href="#id2">32-bit Windows</a></li>
</ul>
</li>
</ul>
</li>
<li><a class="reference internal" href="#installing-without-c-extensions">Installing Without C Extensions</a></li>
<li><a class="reference internal" href="#building-pymongo-egg-packages">Building PyMongo egg Packages</a></li>
<li><a class="reference internal" href="#installing-a-release-candidate">Installing a release candidate</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="index.html"
title="previous chapter">PyMongo 2.6.3 Documentation</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="tutorial.html"
title="next chapter">Tutorial</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/installation.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="tutorial.html" title="Tutorial"
>next</a> |</li>
<li class="right" >
<a href="index.html" title="PyMongo 2.6.3 Documentation"
>previous</a> |</li>
<li><a href="index.html">PyMongo 2.6.3 documentation</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2008 - 2012, 10gen, Inc..
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.
</div>
</body>
</html>
|