[/map {"- map/map "}) [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) The Dgraph (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) The Dgraph (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes the Dgraph, its administrative operations and flags. It also describes various Dgraph characteristics and behavior, such as memory consumption, Dgraph cache, the index merge policy, and managing the Dgraph core dump files. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About the Dgraph (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About the Dgraph (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Dgraph uses proprietary data structures and algorithms that allow it to provide real-time responses to queries. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Memory consumption by the Dgraph (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Memory consumption by the Dgraph (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic discusses the logic used by the Dgraph to control its memory consumption. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Setting the limit of Dgraph memory consumption (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Setting the limit of Dgraph memory consumption (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) It is possible to specify the custom memory limit the Dgraph is allowed to use for processing. If the memory limit is changed, this overrides the default memory consumption setting in the Dgraph that is set to 80% of the machine's available RAM. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Setting the Dgraph internal cache size (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Setting the Dgraph internal cache size (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Dgraph cache size should be configured to be large enough to allow the Dgraph to operate smoothly under normal query load. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Managing an index merge policy (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Managing an index merge policy (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) An index merge policy controls how the Dgraph manages its index files. A balanced index merge policy is used by default, and, in the majority of deployments, you do not need to change it. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About an index merge policy (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About an index merge policy (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) An index merge policy determines how frequently the Dgraph merges incremental update generations in its index files. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Manually forcing a merge (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Manually forcing a merge (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Manually forcing a merge is considered a one-time option, because after the merge operation is performed (via a temporary `aggressive` change to the merge policy), the merge policy reverts to its previous setting. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Linux ulimit settings for merges (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Linux ulimit settings for merges (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) For purposes of generation merging, it is recommended that you set the Linux option `ulimit` `-v` and `-m` parameters to `unlimited`. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Managing Dgraph core dump files (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Managing Dgraph core dump files (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) In the rare case of a Dgraph crash, the Dgraph writes its core dump files on disk. It is recommended to use the `ulimit -c unlimited` setting for the Dgraph core dump files. Non-limited core files contain all Dgraph data that is resident in memory (RSS of the Dgraph process). (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Appointing a new Dgraph leader node (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Appointing a new Dgraph leader node (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can use the `appointNewDgraphLeader.sh` script to appoint a new Dgraph leader. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About Dgraph statistics (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About Dgraph statistics (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Dgraph statistics page provides information such as startup time, host, port, and process information, data and log paths, and so on. This information is useful to help to tune your Dgraph and useful for Oracle Support. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Dgraph administrative operations (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Dgraph administrative operations (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes how to perform administrative operations for the Dgraph using the `bdd-admin` script with the `dgraph-admin` command. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About the dgraph-admin command (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About the dgraph-admin command (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can perform a number of Dgraph administrative operations by running the `bdd-admin` script with the `dgraph-admin` command. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) flush (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) flush (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) `./bdd-admin.sh dgraph-admin flush <hostname>` flushes the Dgraph cache. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) merge (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) merge (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) `./bdd-admin.sh dgraph-admin merge [merge policy] <hostname>` merges update generations in the index. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) stickymerge (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) stickymerge (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) `./bdd-admin.sh dgraph-admin stickymerge <merge policy> <hostname>` changes the merge policy to the specified policy and forces a merge. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) stats (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) stats (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) `./bdd-admin.sh dgraph-admin stats <hostname>` returns the Dgraph statistics page. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) statsreset (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) statsreset (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) `./bdd-admin.sh dgraph-admin statsreset <hostname>` resets the Dgraph statistics. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) logroll (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) logroll (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) `./bdd-admin.sh dgraph-admin logroll <hostname>` forces a query logroll. This reinitializes the query log and archives the old log file. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) log-status (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) log-status (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) `./bdd-admin.sh dgraph-admin log-status <hostname>` returns a list of all possible logging variables with their statuses indicated by `true` or `false`. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) log-enable (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) log-enable (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) `./bdd-admin.sh dgraph-admin log-enable <features> <hostname>` enables the specified extended logging features. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) log-disable (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) log-disable (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) `./bdd-admin.sh dgraph-admin log-disable <features> <hostname>` disables the specified extended logging features. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Dgraph flags (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Dgraph flags (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Dgraph flags modify the Dgraph's configuration and behavior. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Dgraph HDFS Agent flags (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Dgraph HDFS Agent flags (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic describes the flags used by the Dgraph HDFS Agent. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) The Dgraph Gateway (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) The Dgraph Gateway (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes the Dgraph Gateway role in the Big Data Discovery cluster deployment. It also discusses its configuration file, and tells you how to start and stop the Dgraph Gateway through the Administration Console of the WebLogic Server. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About the Dgraph Gateway (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About the Dgraph Gateway (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Together with Studio, the Dgraph Gateway is a Java-based application that is co-hosted in the same WebLogic Server instance. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Dgraph Gateway configuration file (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Dgraph Gateway configuration file (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) A configuration file sets global parameters for the Dgraph Gateway, such as the default locations of files and directories. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Starting Dgraph Gateway (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Starting Dgraph Gateway (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) When you start the WebLogic Server in which the Dgraph Gateway application is deployed, it automatically starts the Dgraph Gateway. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Stopping Dgraph Gateway (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Stopping Dgraph Gateway (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can manually stop the Dgraph Gateway from the WebLogic Server Administration Console. (shortdesc] (topicmeta] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Administrating the Dgraph with the Dgraph Gateway Command Utility (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Administrating the Dgraph with the Dgraph Gateway Command Utility (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes the Dgraph Gateway commands (`endeca-cmd`) used for Dgraph nodes. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About the Dgraph Gateway Command Utility (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About the Dgraph Gateway Command Utility (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Dgraph Gateway has a command-line interface that lists Dgraph nodes, allocates bulk load port, provides version information, and performs cache warming operations for the Dgraphs. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Global options for host, port, and context root (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Global options for host, port, and context root (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The command utility has several global options that allow you to specify the host, port, and context root of the Dgraph Gateway. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Allocating a bulk load port (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Allocating a bulk load port (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The `allocate-bulk-load-port` operation returns a host name for the leader node and the port used for the internally-used Bulk Load Interface. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Returning version information (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Returning version information (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The `version` command lists the version of the Dgraph Gateway and the version of the Dgraph nodes (if the Dgraph nodes are currently running). (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Listing Dgraph nodes (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Listing Dgraph nodes (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The `list-compute-nodes` operation returns a list of running Dgraph nodes in a cluster. This includes both leader and follower nodes. The operation does not list Dgraphs that are stopped. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Returning Dgraph session information (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Returning Dgraph session information (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The `dump-session` operation returns session information from a Dgraph for a specified session ID. (Dgraph Gateway tracks which Dgraph instance is processing a request for a particular session.) (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Warming the Dgraph cache (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Warming the Dgraph cache (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The `warm-cache` command warms each Dgraph cache for all Dgraph instances in a cluster. (shortdesc] (topicmeta] (topicref] (topicref] (map]