Dgraph flags

The Oracle Endeca Server starts the Dgraph process for each data domain node in the data domain cluster.

When you create a data domain profile, you can optionally specify that its Dgraph processes start with any of the flags in the following table. When the data domain is created based on this data domain profile, all Dgraph nodes in this data domain use the Dgraph flags that you specified for this data domain profile.

To obtain a listing of the Dgraph process arguments, at the Oracle Endeca Server host and port, issue the put-dd-profile command with the --args --usage flag:
endeca-cmd put-dd-profile --args --usage

The following Dgraph flags allow you to adjust its configuration:

Flag Description
? Print the help message and exit.
-v Verbose mode.

Print information about each request to stdout.

--ancestor_counts Compute counts for root managed attribute values and any intermediate managed attribute value selections.

By default, the Dgraph only computes refinement counts for proper refinements (in other words, for actual managed attribute values).

It does not compute counts for root managed attribute values or for any intermediate managed attribute value selections.

--backlog-timeout <seconds> Specify the wait limit (in seconds) for a query that has been read and queued for processing.

This is the maximum number of seconds that a query is allowed to spend waiting in the processing queue before the Dgraph responds with a timeout message.

The default value is 0 seconds.

--esampmin <num> Specify the minimum number of records to sample during refinement computation. The default is 0.
Tuning recommendations:
  • For most applications, larger values reduce performance without improving dynamic refinement ranking quality.
  • For some applications with extremely large, non-hierarchical managed attributes (if they cannot be avoided), larger values can meaningfully improve dynamic refinement ranking quality with minor performance cost.
--implicit_exact Disable approximate computation of implicit refinements.

Use of this option is not recommended.

If this option is not enabled, managed attribute values without full coverage of the current result record set may sometimes be returned as implicit refinements, although the probability of such "false" implicit refinements is minuscule.

--implicit_sample <num> Set the maximum number of records to sample when computing implicit refinements (which are a performance tuning parameter).

The default value is 1024.

--net-timeout <num> Specify the maximum number of seconds the Dgraph waits for the client to download data from queries across the network.

The default network timeout value is 30 seconds.

--pidfile <pidfile-path> Specify the file to which to write the process ID (PID).

The default PID file is named datadomain.pid and is located in the logs directory of the Endeca Server.

--search_max <num> Specify the maximum number of terms for text search.

The default value is 10.

--snip_cutoff <num> Limit the number of words in an attribute that the Dgraph evaluates to identify the snippet.

If a match is not found within <num> words, the Dgraph does not return a snippet, even if a match occurs later in the attribute value.

If the flag is not specified, or <num> is not specified, the default is 500.

--snip_disable Globally disable snippeting.
--sslcafile <CA-certfile-path> Specify the path of the eneCA.pem Certificate Authority file that the Dgraph will use to authenticate SSL communications with other components that must communicate with the Dgraph.

If not given, SSL mutual authentication is not performed.

--sslcertfile <certfile-path> Specify the path of the eneCert.pem certificate file that the Dgraph will use to present to any client for SSL communications.

If not given, SSL is not enabled for Dgraph communications.

--sslcipher <cipher-list> Set one or more cipher names (such as RC4-SHA) that specify the minimum cryptographic algorithm that the Dgraph will use during the SSL negotiation.

If multiple ciphers are specified, the names must be separated by colons.

--stat-all Enable all available dynamic attribute value characteristics.

Note that this option has performance implications and is not intended for production use.

--stat-brel Create dynamic record attributes indicating the relevance rank assigned to full-text search result records.
--syslog Direct all output to syslog.
--unctrct Specify to the Dgraph not to compute implicit managed attributes, and to only compute and present explicitly specified managed attributes, when displaying refinements in navigation results.

Specifying this flag does not reduce the size of the resulting record set that is being displayed; however, it improves run-time performance of the Dgraph process.

Be aware that if you use this flag, in order to receive meaningful navigation refinements, you need to make top-level precedence rules work for ALL outbound queries.

--validate_data Validate that all processed data loads and then exit.
--wildcard_max <count> Specify the maximum number of terms that can match a wildcard term in a wildcard query that contains punctuation, such as ab*c.def*.

The default is 100.