Warning, /education/marble/tools/vectorosm-tilecreator/setup/etc/apache2/mod_tile.conf is written in an unsupported language. File is not indexed.

0001 # Based on https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf
0002 
0003 # Specify the default base storage path for where tiles live. A number of different storage backends
0004 # are available, that can be used for storing tiles.  Currently these are a file based storage, a memcached
0005 # based storage and a RADOS based storage.
0006 # The file based storage uses a simple file path as its storage path ( /path/to/tiledir )
0007 # The RADOS based storage takes a location to the rados config file and a pool name ( rados://poolname/path/to/ceph.conf )
0008 # The memcached based storage currently has no configuration options and always connects to memcached on localhost ( memcached:// )
0009 #
0010 # The storage path can be overwritten on a style by style basis from the style TileConfigFile
0011 ModTileTileDir /k/osm/tirex/tiles
0012 
0013 # You can either manually configure each tile set with the default png extension and mimetype
0014 #AddTileConfig /folder/ TileSetName
0015 
0016 # or manually configure each tile set, specifying the file extension 
0017 #AddTileMimeConfig /folder/ TileSetName js
0018 
0019 # or load all the tile sets defined in the configuration file into this virtual host.
0020 # Some tile set specific configuration parameters can only be specified via the configuration file option
0021 LoadTileConfigFile /etc/tirex/mod_tile.conf
0022 
0023 # Specify if mod_tile should keep tile delivery stats, which can be accessed from the URL /mod_tile
0024 # The default is On. As keeping stats needs to take a lock, this might have some performance impact,
0025 # but for nearly all intents and purposes this should be negligable ans so it is safe to keep this turned on.
0026 ModTileEnableStats On
0027 
0028 # Turns on bulk mode. In bulk mode, mod_tile does not request any dirty tiles to be rerendered. Missing tiles
0029 # are always requested in the lowest priority. The default is Off.
0030 ModTileBulkMode Off
0031 
0032 # Timeout before giving up for a tile to be rendered
0033 ModTileRequestTimeout 3
0034 
0035 # Timeout before giving up for a tile to be rendered that is otherwise missing
0036 ModTileMissingRequestTimeout 10
0037 
0038 # If tile is out of date, don't re-render it if past this load threshold (users gets old tile)
0039 ModTileMaxLoadOld 16
0040 
0041 # If tile is missing, don't render it if past this load threshold (user gets 404 error)
0042 ModTileMaxLoadMissing 50
0043 
0044 # Sets how old an expired tile has to be to be considered very old and therefore get elevated priority in rendering
0045 ModTileVeryOldThreshold 31536000000000
0046 
0047 # Unix domain socket where we connect to the rendering daemon
0048 #ModTileRenderdSocketName /var/run/renderd/renderd.sock
0049 ModTileRenderdSocketName /var/lib/tirex/modtile.sock
0050 
0051 # Alternatively you can use a TCP socket to connect to renderd. The first part
0052 # is the location of the renderd server and the second is the port to connect to.
0053 #   ModTileRenderdSocketAddr renderd.mydomain.com 7653
0054 
0055 ##
0056 ## Options controlling the cache proxy expiry headers. All values are in seconds.
0057 ##
0058 ## Caching is both important to reduce the load and bandwidth of the server, as
0059 ## well as reduce the load time for the user. The site loads fastest if tiles can be
0060 ## taken from the users browser cache and no round trip through the internet is needed.
0061 ## With minutely or hourly updates, however there is a trade-off between cacheability
0062 ## and freshness. As one can't predict the future, these are only heuristics, that
0063 ## need tuning.
0064 ## If there is a known update schedule such as only using weekly planet dumps to update the db,
0065 ## this can also be taken into account through the constant PLANET_INTERVAL in render_config.h
0066 ## but requires a recompile of mod_tile
0067 
0068 ## The values in this sample configuration are not the same as the defaults
0069 ## that apply if the config settings are left out. The defaults are more conservative
0070 ## and disable most of the heuristics.
0071 
0072 
0073 ##
0074 ## Caching is always a trade-off between being up to date and reducing server load or
0075 ## client side latency and bandwidth requirements. Under some conditions, like poor
0076 ## network conditions it might be more important to have good caching rather than the latest tiles.
0077 ## Therefor the following config options allow to set a special hostheader for which the caching
0078 ## behaviour is different to the normal heuristics
0079 ##
0080 ## The CacheExtended parameters overwrite all other caching parameters (including CacheDurationMax)
0081 ## for tiles being requested via the hostname CacheExtendedHostname
0082 #ModTileCacheExtendedHostname cache.tile.openstreetmap.org
0083 #ModTileCacheExtendedDuration 2592000
0084 
0085 # Upper bound on the length a tile will be set cacheable, which takes
0086 # precedence over other settings of cacheing
0087 ModTileCacheDurationMax 604800
0088 
0089 # Sets the time tiles can be cached for that are known to by outdated and have been
0090 # sent to renderd to be rerendered. This should be set to a value corresponding
0091 # roughly to how long it will take renderd to get through its queue. There is an additional
0092 # fuzz factor on top of this to not have all tiles expire at the same time
0093 ModTileCacheDurationDirty 900
0094 
0095 # Specify the minimum time mod_tile will set the cache expiry to for fresh tiles. There
0096 # is an additional fuzz factor of between 0 and 3 hours on top of this.
0097 ModTileCacheDurationMinimum 10800
0098 
0099 # Lower zoom levels are less likely to change noticeable, so these could be cached for longer
0100 # without users noticing much.
0101 # The heuristic offers three levels of zoom, Low, Medium and High, for which different minimum
0102 # cacheing times can be specified.
0103 
0104 #Specify the zoom level below  which Medium starts and the time in seconds for which they can be cached
0105 ModTileCacheDurationMediumZoom 13 86400
0106 
0107 #Specify the zoom level below which Low starts and the time in seconds for which they can be cached
0108 ModTileCacheDurationLowZoom 9 518400
0109 
0110 # A further heuristic to determine cacheing times is when was the last time a tile has changed.
0111 # If it hasn't changed for a while, it is less likely to change in the immediate future, so the
0112 # tiles can be cached for longer.
0113 # For example, if the factor is 0.20 and the tile hasn't changed in the last 5 days, it can be cached
0114 # for up to one day without having to re-validate.
0115 ModTileCacheLastModifiedFactor 0.20
0116 
0117 ## Tile Throttling
0118 ## Tile scrapers can often download large numbers of tiles and overly straining tileserver resources
0119 ## mod_tile therefore offers the ability to automatically throttle requests from ip addresses that have
0120 ## requested a lot of tiles.
0121 ## The mechanism uses a token bucket approach to shape traffic. I.e. there is an initial pool of n tiles
0122 ## per ip that can be requested arbitrarily fast. After that this pool gets filled up at a constant rate
0123 ## The algorithm has two metrics. One based on overall tiles served to an ip address and a second one based on
0124 ## the number of requests to renderd / tirex to render a new tile. 
0125 
0126 ## Overall enable or disable tile throttling
0127 ModTileEnableTileThrottling Off
0128 # Specify if you want to use the connecting IP for throtteling, or use the X-Forwarded-For header to determin the
0129 # IP address to be used for tile throttling. This can be useful if you have a reverse proxy / http accellerator
0130 # in front of your tile server.
0131 # 0 - don't use X-Forward-For and allways use the IP that apache sees
0132 # 1 - use the client IP address, i.e. the first entry in the X-Forwarded-For list. This works through a cascade of proxies.
0133 #     However, as the X-Forwarded-For is written by the client this is open to manipulation and can be used to circumvent the throttling
0134 # 2 - use the last specified IP in the X-Forwarded-For list. If you know all requests come through a reverse proxy
0135 #     that adds an X-Forwarded-For header, you can trust this IP to be the IP the reverse proxy saw for the request
0136 ModTileEnableTileThrottlingXForward 0
0137 ## Parameters (poolsize in tiles and topup rate in tiles per second) for throttling tile serving. 
0138 ModTileThrottlingTiles 10000 1 
0139 ## Parameters (poolsize in tiles and topup rate in tiles per second) for throttling render requests. 
0140 ModTileThrottlingRenders 128 0.2
0141 
0142 ###
0143 ###    
0144 # increase the log level for more detailed information
0145     LogLevel debug