## File: install_windows.rst

package info (click to toggle)
mapproxy 1.9.0-2~bpo8%2B1
 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113 Installation on Windows ======================= .. note:: You can also :doc:install MapProxy inside an existing OSGeo4W installation. At frist you need a working Python installation. You can download Python from: http://www.python.org/download/. MapProxy requires Python 2.7, 3.3 or 3.4. Python 2.6 should still work, but it is no longer officially supported. Virtualenv ---------- *If* you are using your Python installation for other applications as well, then we advise you to install MapProxy into a virtual Python environment_ to avoid any conflicts with different dependencies. *You can skip this if you only use the Python installation for MapProxy.* Read about virtualenv _ if you want to now more about the benefits. .. _virtual Python environment: http://guide.python-distribute.org/virtualenv.html To create a new virtual environment for your MapProxy installation and to activate it go to the command line and call:: C:\Python27\python path\to\virtualenv.py c:\mapproxy_venv C:\mapproxy_venv\Scripts\activate.bat .. note:: The last step is required every time you start working with your MapProxy installation. Alternatively you can always explicitly call \mapproxy_venv\Scripts\. .. note:: 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. After you activated the new environment, you have access to python and easy_install. To install MapProxy with most dependencies call:: easy_install MapProxy This might take a minute. You can skip the next step. Setuptools ---------- MapProxy and most dependencies can be installed with the easy_install command. You need to install the setuptool package _ to get the easy_install command. After that you can install MapProxy with:: c:\Python27\Scripts\easy_install MapProxy This might take a minute. Dependencies ------------ Read :ref:dependency_details for more information about all dependencies. Pillow and YAML ~~~~~~~~~~~~~~~ Pillow and PyYAML are installed automatically by easy_install. PyProj ~~~~~~ Since libproj4 is generally not available on a Windows system, you will also need to install the Python package pyproj. :: easy_install pyproj Shapely and GEOS *(optional)* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Shapely can be installed with easy_install Shapely. This will already include the required geos.dll. GDAL *(optional)* ~~~~~~~~~~~~~~~~~ MapProxy requires GDAL/OGR for coverage support. MapProxy can either load the gdal.dll directly or use the osgeo.ogr Python package. You can download and install inofficial Windows binaries of GDAL and the Python package _ (e.g. gdal-19-xxxx-code.msi). You need to add the installation path to the Windows PATH environment variable in both cases. You can set the variable temporary on the command line (spaces in the filename need no quotes or escaping):: set PATH=%PATH%;C:\Program Files (x86)\GDAL Or you can add it to your systems environment variables _. You also need to set GDAL_DRIVER_PATH or OGR_DRIVER_PATH to the gdalplugins directory when you want to use the Oracle plugin (extra download from URL above):: set GDAL_DRIVER_PATH=C:\Program Files (x86)\GDAL\gdalplugins Platform dependent packages --------------------------- All Python packages are downloaded from http://pypi.python.org/, but not all platform combinations might be available as a binary package, especially if you run a 64bit version of Windows. If you run into troubles during installation, because it is trying to compile something (e.g. complaining about vcvarsall.bat), you should look at Christoph Gohlke's Unofficial Windows Binaries for Python Extension Packages _. You can install the .exe packages with easy_install:: easy_install path\to\package-xxx.exe Check installation ------------------ To check if the MapProxy was successfully installed you can call mapproxy-util. You should see the installed version number. :: mapproxy-util --version Now continue with :ref:Create a configuration  from the installation documentation.