/usr/share/doc/mapproxy/html/install_windows.html is in mapproxy-doc 1.9.0-3+deb9u1.
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 | <!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Installation on Windows — MapProxy 1.8.2a0 Docs</title>
<link rel="stylesheet" href="_static/basic.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/bootstrap-3.3.6/css/bootstrap.min.css" type="text/css" />
<link rel="stylesheet" href="_static/bootstrap-3.3.6/css/bootstrap-theme.min.css" type="text/css" />
<link rel="stylesheet" href="_static/bootstrap-sphinx.css" type="text/css" />
<link rel="stylesheet" href="_static/mapproxy.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '1.8.2a0',
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/js/jquery-1.11.0.min.js"></script>
<script type="text/javascript" src="_static/js/jquery-fix.js"></script>
<script type="text/javascript" src="_static/bootstrap-3.3.6/js/bootstrap.min.js"></script>
<script type="text/javascript" src="_static/bootstrap-sphinx.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="top" title="MapProxy 1.8.2a0 Docs" href="index.html" />
<link rel="next" title="Installation on OSGeo4W" href="install_osgeo4w.html" />
<link rel="prev" title="Installation" href="install.html" />
<meta charset='utf-8'>
<meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
<meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
<meta name="apple-mobile-web-app-capable" content="yes">
</head>
<body role="document">
<div id="navbar" class="navbar navbar-default ">
<div class="container">
<div class="navbar-header">
<!-- .btn-navbar is used as the toggle for collapsed navbar content -->
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a href="index.html" class="pull-left"><img src="_static/logo.png" height="50">
</a>
<a class="navbar-brand" href="index.html">
<span>
MapProxy</span>
<span>1.8.2a0</span>
</a>
</div>
<div class="collapse navbar-collapse nav-collapse">
<form class="navbar-form navbar-right" action="search.html" method="get">
<div class="form-group">
<input type="text" name="q" class="form-control" placeholder="Search" />
</div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
</div>
<div class="container">
<div class="row">
<div class="col-md-3">
<div id="sidebar" class="bs-sidenav" role="complementary"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="install.html">Installation</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Installation on Windows</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#virtualenv">Virtualenv</a></li>
<li class="toctree-l2"><a class="reference internal" href="#setuptools">Setuptools</a></li>
<li class="toctree-l2"><a class="reference internal" href="#dependencies">Dependencies</a></li>
<li class="toctree-l2"><a class="reference internal" href="#platform-dependent-packages">Platform dependent packages</a></li>
<li class="toctree-l2"><a class="reference internal" href="#check-installation">Check installation</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="install_osgeo4w.html">Installation on OSGeo4W</a></li>
<li class="toctree-l1"><a class="reference internal" href="tutorial.html">Tutorial</a></li>
<li class="toctree-l1"><a class="reference internal" href="configuration.html">Configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="services.html">Services</a></li>
<li class="toctree-l1"><a class="reference internal" href="sources.html">Sources</a></li>
<li class="toctree-l1"><a class="reference internal" href="caches.html">Caches</a></li>
<li class="toctree-l1"><a class="reference internal" href="seed.html">Seeding</a></li>
<li class="toctree-l1"><a class="reference internal" href="coverages.html">Coverages</a></li>
<li class="toctree-l1"><a class="reference internal" href="mapproxy_util.html">mapproxy-util</a></li>
<li class="toctree-l1"><a class="reference internal" href="mapproxy_util_autoconfig.html">mapproxy-util autoconfig</a></li>
<li class="toctree-l1"><a class="reference internal" href="deployment.html">Deployment</a></li>
<li class="toctree-l1"><a class="reference internal" href="configuration_examples.html">Configuration examples</a></li>
<li class="toctree-l1"><a class="reference internal" href="inspire.html">INSPIRE View Service</a></li>
<li class="toctree-l1"><a class="reference internal" href="labeling.html">WMS Labeling</a></li>
<li class="toctree-l1"><a class="reference internal" href="auth.html">Authentication and Authorization</a></li>
<li class="toctree-l1"><a class="reference internal" href="decorate_img.html">Decorate Image</a></li>
<li class="toctree-l1"><a class="reference internal" href="development.html">Development</a></li>
<li class="toctree-l1"><a class="reference internal" href="mapproxy_2.html">MapProxy 2.0</a></li>
</ul>
</div>
</div>
<div class="col-md-8">
<div class="section" id="installation-on-windows">
<h1>Installation on Windows<a class="headerlink" href="#installation-on-windows" title="Permalink to this headline">¶</a></h1>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">You can also <a class="reference internal" href="install_osgeo4w.html"><span class="doc">install MapProxy inside an existing OSGeo4W installation</span></a>.</p>
</div>
<p>At frist you need a working Python installation. You can download Python from: <a class="reference external" href="http://www.python.org/download/">http://www.python.org/download/</a>. MapProxy requires Python 2.7, 3.3 or 3.4. Python 2.6 should still work, but it is no longer officially supported.</p>
<div class="section" id="virtualenv">
<h2>Virtualenv<a class="headerlink" href="#virtualenv" title="Permalink to this headline">¶</a></h2>
<p><em>If</em> you are using your Python installation for other applications as well, then we advise you to install MapProxy into a <a class="reference external" href="http://guide.python-distribute.org/virtualenv.html">virtual Python environment</a> to avoid any conflicts with different dependencies. <em>You can skip this if you only use the Python installation for MapProxy.</em>
<a class="reference external" href="http://virtualenv.openplans.org/#what-it-does">Read about virtualenv</a> if you want to now more about the benefits.</p>
<p>To create a new virtual environment for your MapProxy installation and to activate it go to the command line and call:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">C</span><span class="p">:</span>\<span class="n">Python27</span>\<span class="n">python</span> <span class="n">path</span>\<span class="n">to</span>\<span class="n">virtualenv</span><span class="o">.</span><span class="n">py</span> <span class="n">c</span><span class="p">:</span>\<span class="n">mapproxy_venv</span>
<span class="n">C</span><span class="p">:</span>\<span class="n">mapproxy_venv</span>\<span class="n">Scripts</span>\<span class="n">activate</span><span class="o">.</span><span class="n">bat</span>
</pre></div>
</div>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">The last step is required every time you start working with your MapProxy installation. Alternatively you can always explicitly call <code class="docutils literal"><span class="pre">\mapproxy_venv\Scripts\<command></span></code>.</p>
</div>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Apache mod_wsgi does not work well with virtualenv on Windows. If you want to use mod_wsgi for deployment, then you should skip the creation the virtualenv.</p>
</div>
<p>After you activated the new environment, you have access to <code class="docutils literal"><span class="pre">python</span></code> and <code class="docutils literal"><span class="pre">easy_install</span></code>.
To install MapProxy with most dependencies call:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">easy_install</span> <span class="n">MapProxy</span>
</pre></div>
</div>
<p>This might take a minute. You can skip the next step.</p>
</div>
<div class="section" id="setuptools">
<h2>Setuptools<a class="headerlink" href="#setuptools" title="Permalink to this headline">¶</a></h2>
<p>MapProxy and most dependencies can be installed with the <code class="docutils literal"><span class="pre">easy_install</span></code> command.
You need to <a class="reference external" href="http://pypi.python.org/pypi/setuptools">install the setuptool package</a> to get the <code class="docutils literal"><span class="pre">easy_install</span></code> command.</p>
<p>After that you can install MapProxy with:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">c</span><span class="p">:</span>\<span class="n">Python27</span>\<span class="n">Scripts</span>\<span class="n">easy_install</span> <span class="n">MapProxy</span>
</pre></div>
</div>
<p>This might take a minute.</p>
</div>
<div class="section" id="dependencies">
<h2>Dependencies<a class="headerlink" href="#dependencies" title="Permalink to this headline">¶</a></h2>
<p>Read <a class="reference internal" href="install.html#dependency-details"><span class="std std-ref">Dependency details</span></a> for more information about all dependencies.</p>
<div class="section" id="pillow-and-yaml">
<h3>Pillow and YAML<a class="headerlink" href="#pillow-and-yaml" title="Permalink to this headline">¶</a></h3>
<p>Pillow and PyYAML are installed automatically by <code class="docutils literal"><span class="pre">easy_install</span></code>.</p>
</div>
<div class="section" id="pyproj">
<h3>PyProj<a class="headerlink" href="#pyproj" title="Permalink to this headline">¶</a></h3>
<p>Since libproj4 is generally not available on a Windows system, you will also need to install the Python package <code class="docutils literal"><span class="pre">pyproj</span></code>.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">easy_install</span> <span class="n">pyproj</span>
</pre></div>
</div>
</div>
<div class="section" id="shapely-and-geos-optional">
<h3>Shapely and GEOS <em>(optional)</em><a class="headerlink" href="#shapely-and-geos-optional" title="Permalink to this headline">¶</a></h3>
<p>Shapely can be installed with <code class="docutils literal"><span class="pre">easy_install</span> <span class="pre">Shapely</span></code>. This will already include the required <code class="docutils literal"><span class="pre">geos.dll</span></code>.</p>
</div>
<div class="section" id="gdal-optional">
<h3>GDAL <em>(optional)</em><a class="headerlink" href="#gdal-optional" title="Permalink to this headline">¶</a></h3>
<p>MapProxy requires GDAL/OGR for coverage support. MapProxy can either load the <code class="docutils literal"><span class="pre">gdal.dll</span></code> directly or use the <code class="docutils literal"><span class="pre">osgeo.ogr</span></code> Python package. You can <a class="reference external" href="http://www.gisinternals.com/sdk/">download and install inofficial Windows binaries of GDAL and the Python package</a> (e.g. <cite>gdal-19-xxxx-code.msi</cite>).</p>
<p>You need to add the installation path to the Windows <code class="docutils literal"><span class="pre">PATH</span></code> environment variable in both cases.
You can set the variable temporary on the command line (spaces in the filename need no quotes or escaping):</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nb">set</span> <span class="n">PATH</span><span class="o">=%</span><span class="n">PATH</span><span class="o">%</span><span class="p">;</span><span class="n">C</span><span class="p">:</span>\<span class="n">Program</span> <span class="n">Files</span> <span class="p">(</span><span class="n">x86</span><span class="p">)</span>\<span class="n">GDAL</span>
</pre></div>
</div>
<p>Or you can add it to your <a class="reference external" href="http://www.computerhope.com/issues/ch000549.htm">systems environment variables</a>.</p>
<p>You also need to set <code class="docutils literal"><span class="pre">GDAL_DRIVER_PATH</span></code> or <code class="docutils literal"><span class="pre">OGR_DRIVER_PATH</span></code> to the <code class="docutils literal"><span class="pre">gdalplugins</span></code> directory when you want to use the Oracle plugin (extra download from URL above):</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="nb">set</span> <span class="n">GDAL_DRIVER_PATH</span><span class="o">=</span><span class="n">C</span><span class="p">:</span>\<span class="n">Program</span> <span class="n">Files</span> <span class="p">(</span><span class="n">x86</span><span class="p">)</span>\<span class="n">GDAL</span>\<span class="n">gdalplugins</span>
</pre></div>
</div>
</div>
</div>
<div class="section" id="platform-dependent-packages">
<h2>Platform dependent packages<a class="headerlink" href="#platform-dependent-packages" title="Permalink to this headline">¶</a></h2>
<p>All Python packages are downloaded from <a class="reference external" href="http://pypi.python.org/">http://pypi.python.org/</a>, but not all platform combinations might be available as a binary package, especially if you run a 64bit version of Windows.</p>
<p>If you run into troubles during installation, because it is trying to compile something (e.g. complaining about <code class="docutils literal"><span class="pre">vcvarsall.bat</span></code>), you should look at Christoph Gohlke’s <a class="reference external" href="http://www.lfd.uci.edu/~gohlke/pythonlibs/">Unofficial Windows Binaries for Python Extension Packages</a>.</p>
<p>You can install the <code class="docutils literal"><span class="pre">.exe</span></code> packages with <code class="docutils literal"><span class="pre">easy_install</span></code>:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">easy_install</span> <span class="n">path</span>\<span class="n">to</span>\<span class="n">package</span><span class="o">-</span><span class="n">xxx</span><span class="o">.</span><span class="n">exe</span>
</pre></div>
</div>
</div>
<div class="section" id="check-installation">
<h2>Check installation<a class="headerlink" href="#check-installation" title="Permalink to this headline">¶</a></h2>
<p>To check if the MapProxy was successfully installed you can call <code class="docutils literal"><span class="pre">mapproxy-util</span></code>. You should see the installed version number.</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">mapproxy</span><span class="o">-</span><span class="n">util</span> <span class="o">--</span><span class="n">version</span>
</pre></div>
</div>
<p>Now continue with <a class="reference internal" href="install.html#create-configuration"><span class="std std-ref">Create a configuration</span></a> from the installation documentation.</p>
</div>
</div>
</div>
</div>
</div>
<footer class="footer">
<div class="container">
<p class="pull-right">
<a href="#">Back to top</a>
</p>
<p>
© Copyright Oliver Tonnhofer, Omniscale, <a href="http://mapproxy.org/about">Legal</a>
<br/>
Last updated on 2018-01-07
<br/>
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.4.9.
</p>
</div>
</footer>
</body>
</html>
|