Skip to main content

Advanced steps for installing maps API

Creating and connecting the Cassandra keyspace​

To store data about tiles, the service uses Cassandra keyspaces.

If Cassandra's security settings allow automatic creation of keyspaces, the keyspace for storing tiles data will be automatically recreated when installing or updating the map service.

The name of the keyspace is constructed based on:

  • the data type (web, raster or native);
  • the value of the cassandra.environment parameter;
  • the Cassandra cluster name;
  • the Unix time when the manifest was generated.

Keyspace name example: dgis_tileserver_web_test_1653477379.

If Cassandra's security settings do not allow automatic creation of keyspaces, perform the following actions.

On initial installation​

  1. Create a keyspace manually.

  2. Specify the name of this keyspace in the types[0].keyspace setting of the values-tiles.yaml configuration file:

    types:
      - kind: web
      - kind: raster
      keyspace: TILES-KEYSPACE-NAME

On subsequent updates​

Disable automatic import and clean up of tile data by specifying the types[0].importAndCleanerDisabled: true parameter in the values-tiles.yaml configuration file:

types:
  - kind: web
  - kind: raster
  keyspace: TILES-KEYSPACE-NAME
  importAndCleanerDisabled: true