Appboard/2.4/builder/widgets/tile map/offline data: Difference between revisions

imported>Jason.nicholls
No edit summary
imported>Jason.nicholls
Line 12: Line 12:
Edge can provide some packaged OSM tiles for offline use, please contact support. Otherwise it is possible to build your own offline tilesets using a variety of sources and tools (see the Building section below).
Edge can provide some packaged OSM tiles for offline use, please contact support. Otherwise it is possible to build your own offline tilesets using a variety of sources and tools (see the Building section below).


# Open a terminal window (i.e., CMD/shell prompt)
# shutdown AppBoard
# Shutdown the AppBoard server
# in a terminal change into <tt>[INSTALL_HOME]/server/bin</tt>
# Change directory to [Install_Home]/server/bin/
# Run the following command: <tt>portal FilesImport -jar <OfflineTilePackage></tt>
# Run the following command:
#* UNIX: <tt>./portal.sh FilesImport -jar <OfflineTilePackage></tt>
#* Windows: <tt>portal.bat FilesImport -jar <OfflineTilePackage></tt>
 
{{Note|Due to the size of tilesets these are '''not''' backed up by default. That means both the tiles and the tile registry file are excluded. It is recommended to have a restore/migration procedure that includes installing any custom offline tilesets as an additional step in the process.}}


{{Note|Due to the size of tilesets these are '''not''' backed up by default. That means both the tiles and the tile registry file are excluded from backup archives. It is recommended to have a restore/migration procedure that includes installing any custom offline tilesets as an additional step in the process.}}


== Building Offline Tileset Packs ==
== Building Offline Tileset Packs ==

Revision as of 12:38, 2 October 2013


The Tile Map Widget can be configured to use multiple base layer tilesets and multiple overlay tilesets, including tilesets served up by the AppBoard server removing the need for external Internet access.

Viewer clients connected to AppBoard will fetch the tilesets from the AppBoard server, to which they must already have network access.

It's important to understand that the size of the offline tileset grows exponentially for each additional zoom level. Levels 0 through 7 of the default OpenStreetMap (OSM) tiles is roughly 100MB, but online you can zoom through to level 20. Attempting to have an offline tileset with this deep level of zoom would be ... big.


Importing Offline Tilesets

Edge can provide some packaged OSM tiles for offline use, please contact support. Otherwise it is possible to build your own offline tilesets using a variety of sources and tools (see the Building section below).

  1. shutdown AppBoard
  2. in a terminal change into [INSTALL_HOME]/server/bin
  3. Run the following command: portal FilesImport -jar <OfflineTilePackage>
Template-note.png
Due to the size of tilesets these are not backed up by default. That means both the tiles and the tile registry file are excluded from backup archives. It is recommended to have a restore/migration procedure that includes installing any custom offline tilesets as an additional step in the process.

Building Offline Tileset Packs