NOM persistence DBMS

Server installation is a two-step process. The first step, as described in this section, is to set up a Neo4j DBMS to act as persistence storage for NOM.

The NOM persistence DBMS is used to store all NOM data (topology, metrics, etc.). The DBMS and the NOM Server need to be running simultaneously, or the NOM Server will not work.

Self-managed DBMS

NOM comes with a license to run a Neo4j DBMS with up to 4 cores of CPU and up to 16 GB of RAM for the use as NOMs persistence.

Specifications

Install and prepare

Refer to the Operations Manual → Installation for information on how to install Neo4j.

Ensure that the Neo4j database to be used for NOM persistence fulfills the following requirements:

  • The database is empty and does not contain any indexes or constraints.

  • Cypher 5 is selected as default language for this database. For example, this can be done by executing the statement ALTER DATABASE neo4j SET DEFAULT LANGUAGE CYPHER 5. For more details see Cypher Manual → Select Cypher version.

NOM server installation requires specifying credentials of a Neo4j user. Ensure that it fulfills the following requirements:

  • If a built-in admin user (neo4j) is used, ensure it has a secure password.

  • If a new user is created, ensure it has full admin access.

AuraDB

An AuraDB Professional or Enterprise could be used for NOM persistence however consideration should be given to the following:

  • The AuraDB instance should be for exclusive use of the NOM server.

  • The NOM server and persistence should ideally be located on the same LAN segment to avoid performance being impacted by WAN traffic.

  • Future product developments may require features not currently available in AuraDB.

If the DBMS is not newly created, ensure the following:

  • That the default database for the user exists. This is done via the SHOW DATABASES command.

  • That the default database for the user is empty. This is done via MATCH (n) RETURN count(n) which should return 0.

  • That the default database for the user doesn’t contain any indexes or constraints. This is done via SHOW INDEXES and SHOW CONSTRAINTS.

The default database for a user is either the home database for that user if it is set or the default database for the DBMS. The default database for the DBMS is 'neo4j' if not explicitly configured.

The use or manipulation of the persistence database apart from through the NOM Server is highly discouraged and can negatively impact the stability and data correctness of NOM.