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 cassandra.types[0].keyspace setting of the values-tiles.yaml configuration file:
cassandra:
    hosts:
        - tiles-cassandra-1.storage.example.local
        - tiles-cassandra-2.storage.example.local
        - tiles-cassandra-3.storage.example.local
    replicaFactor: 3
    consistencyLevelRead: LOCAL_ONE
    consistencyLevelWrite: LOCAL_QUORUM
    types:
        - kind: web
        - kind: raster
          keyspace: TILES-KEYSPACE-NAME
    credentials:
        user: cassandrauser
        password: CASSANDRAPASSWORD-DWTYB05URKZJEDDN
        jmxUser: jmxuser
        jmxPassword: JMXPASSWORD-MNZLQTFH0MDDHIX8

On subsequent updates:​

  1. Disable automatic import and clean up of tile data by specifying the cassandra.types[0].importAndCleanerDisabled: true parameter in the values-tiles.yaml configuration file:
cassandra:
    hosts:
        - tiles-cassandra-1.storage.example.local
        - tiles-cassandra-2.storage.example.local
        - tiles-cassandra-3.storage.example.local
    replicaFactor: 3
    consistencyLevelRead: LOCAL_ONE
    consistencyLevelWrite: LOCAL_QUORUM
    types:
        - kind: web
        - kind: raster
          keyspace: TILES-KEYSPACE-NAME
          importAndCleanerDisabled: true
    credentials:
        user: cassandrauser
        password: CASSANDRAPASSWORD-DWTYB05URKZJEDDN
        jmxUser: jmxuser
        jmxPassword: JMXPASSWORD-MNZLQTFH0MDDHIX8