[/map {"- map/map "}) [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Introduction (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Introduction (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes the stage at which you take control of the operation and maintenance of your application powered by the Oracle Endeca Server. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Taking ownership of your implementation (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Taking ownership of your implementation (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) As a system administrator, you take ownership of the Oracle Endeca Server implementation at a certain stage. This topic describes the context in which you will perform administrative tasks to maintain the stable operation of a properly functioning implementation. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Overview of administrator tasks (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Overview of administrator tasks (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic provides a brief overview of the administrator tasks described in this guide. (shortdesc] (topicmeta] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Oracle Endeca Server (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Oracle Endeca Server (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section provides an overview of the Oracle Endeca Server and describes some administration and configuration tasks. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Overview of Oracle Endeca Server (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Overview of Oracle Endeca Server (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Endeca Server is the control center for Endeca data stores. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Starting the Oracle Endeca Server (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Starting the Oracle Endeca Server (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic describes how to start the Oracle Endeca Server. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Endeca Server configuration (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Endeca Server configuration (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can set the locations of the Endeca data store components and other settings in the configuration script. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Increasing the maximum idle time (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Increasing the maximum idle time (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The maxIdleTime configuration property sets the maximum Idle time (in milliseconds) for a connection. (shortdesc] (topicmeta] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Oracle Endeca Server Commands (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Oracle Endeca Server Commands (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes the commands of the Oracle Endeca Server's endeca-cmd command-line interface. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Endeca Server operational model (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Endeca Server operational model (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Endeca Server has a command-line interface that lets you control Endeca data stores. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Command global options (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Command global options (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Endeca Server command interface has several global options that let you specify a host and port of the Oracle Endeca Server, and enable the interface for SSL. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Global options for --host and --port (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Global options for --host and --port (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Two global options let you specify host name and port information for the Endeca Server. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Global options for SSL (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Global options for SSL (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The --ssl, --keystore and --truststore options are used to support SSL-enabled communications with an Oracle Endeca Server running over SSL. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) create-ds command (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) create-ds command (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The create-ds command creates an Endeca data store, attaches it, and starts it. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) attach-ds command (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) attach-ds command (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The attach-ds command attaches and starts an Endeca data store. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) detach-ds command (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) detach-ds command (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The detach-ds command detaches an attached Endeca data store. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) start-ds command (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) start-ds command (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The start-ds command starts an Endeca data store. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) stop-ds command (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) stop-ds command (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The stop-ds command stops a started Endeca data store. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) status-ds command (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) status-ds command (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The status-ds command shows the status of an Endeca data store. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) list-ds command (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) list-ds command (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The list-ds command lists all the Endeca data stores that are attached to this Endeca Server. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) list-jobs command (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) list-jobs command (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The list-jobs command lists the jobs on a specific Endeca data store. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) version command (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) version command (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The version command lists the version of the Oracle Endeca Server and the versions of the Dgraph processes powering each of the data stores (if the Dgraph processes for these data stores are currently running). (shortdesc] (topicmeta] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Using the Administration Web Service (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Using the Administration Web Service (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes how to use the Administration Web Service with the Oracle Endeca Server. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About the Administration Web Service (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About the Administration Web Service (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Administration Web Service enables IT engineers to administer and maintain the Endeca data stores. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Accessing the Administration Web Service (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Accessing the Administration Web Service (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Administration Web Service is declared in admin.wsdl. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Using the Administration Web Service (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Using the Administration Web Service (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Administration Web Service contains administrative operations for creating a snapshot, listing running jobs and canceling jobs that have been scheduled but have not started in a specific data store. (shortdesc] (topicmeta] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Job Monitoring and Canceling (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Job Monitoring and Canceling (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes how tou can monitor running and pending jobs, and cancel pending jobs in the data store, using the Administration Web Service. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About job monitoring (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About job monitoring (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) In many instances, it is useful to have more information about the jobs that are scheduled to be processed for a specific data store but have not yet started to run, as well as obtain a list of jobs that are currently being processed. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About jobs (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About jobs (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can monitor or cancel several types of jobs. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Obtaining a list of running or pending jobs (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Obtaining a list of running or pending jobs (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Using the listJobsOperation of the Administration Web Service, you can make a job monitoring request for a list of jobs that are currently running or pending in the queue. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Canceling pending jobs (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Canceling pending jobs (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) To cancel a job that has been scheduled but has not yet run, obtain a list of jobs that are either running or waiting in the queue and then issue the cancelJobOperation of the Administration Web Service. (shortdesc] (topicmeta] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Capturing Snapshots (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Capturing Snapshots (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes how you can create snapshots of a running Dgraph process for a specific data store and use them as a part of your backup and archiving strategy. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About snapshots (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About snapshots (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) A snapshot represents a consistent view of the state of the data files at a specific point in time. By taking a snapshot, you can capture the state of the data files without shutting down the Dgraph process for a particular data store. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Restrictions for taking a snapshot (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Restrictions for taking a snapshot (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The following restrictions apply when taking snapshots. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Creating a snapshot (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Creating a snapshot (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You create a snapshot with the createSnapshotOperation interface in the Administration Web Service. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Restoring data files from a snapshot (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Restoring data files from a snapshot (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can restore data files from an archived snapshot using the cpmdex command. The command copies files from the archived snapshot into the data files of the specific Endeca data store. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) cpmdex syntax (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) cpmdex syntax (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic contains syntax for the cpmdex command. (shortdesc] (topicmeta] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Dgraph Administrative Tasks (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Dgraph Administrative Tasks (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes some basic administrative tasks for the Dgraph, contains Dgraph troubleshooting tips, and describes the Dgraph logs. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Checking the status of the Dgraph (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Checking the status of the Dgraph (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) A quick way of checking the health of a Dgraph is to get its status from the Endeca Server. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About connecting Web browsers to the data store (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About connecting Web browsers to the data store (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) For security reasons, you should never allow user Web browsers to connect directly to the machine hosting the Endeca Server and the Endeca data stores. (shortdesc] (topicmeta] (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. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Managing Dgraph crash dump files on Windows (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Managing Dgraph crash dump files on Windows (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) On Windows, all Dgraph crash dump files are saved on disk by default. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Managing Dgraph core dump files on Linux (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Managing Dgraph core dump files on Linux (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) It is recommended to use the ulimit -c unlimited setting for the Dgraph process core dump files. Non-limited core files contain all Dgraph data that is resident in memory (RSS of the Dgraph process). (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Collecting debugging information (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Collecting debugging information (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Before attempting to debug an issue with the data store, collect the following information. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Logs created by the Dgraph (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Logs created by the Dgraph (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Dgraph creates several logs, although some of these logs depend on your implementation and the components that you may be using. This topic provides a summary of these logs. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Running multiple Dgraphs on the same Windows machine (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Running multiple Dgraphs on the same Windows machine (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) If you have more than one Endeca data store running on a single Windows machine, the Endeca Server, by default, assigns each Dgraph a port that does not conflict with other Dgraph ports on that machine. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Identifying connection errors (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Identifying connection errors (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) If the Dgraph standard out log contains connection broken messages, although it may look like the problem occurred with the Dgraph, the actual cause of the problem is usually a broken connection between the server that hosts the front-end application and the server that hosts the Dgraph. (shortdesc] (topicmeta] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Administrative Operations (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Administrative Operations (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Oracle Endeca Server supports many Dgraph administrative and configuration operations that you can access through simple URLs. You can use these operations to control the behavior of the Dgraph processes that are running under the Oracle Endeca Server. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About administrative and configuration operations (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About administrative and configuration operations (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Administrative and configuration operations make it possible to check Dgraph statistics, and enable or disable diagnostic flags without having to stop a running Dgraph. This section lists the supported administrative and configuration URLs, describes the functions of each URL, and defines the syntax of those URLs. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) List of administrative operations (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) List of administrative operations (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Administrative (or admin) operations listed in this topic allow you to control the behavior of an Endeca data store's Dgraph process. (shortdesc] (topicmeta][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) help (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) help (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=help returns the usage page for all of the administrative operations. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) flush (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) flush (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=flush flushes the Dgraph cache. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) logroll (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) logroll (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=logroll forces a query log roll. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) merge (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) merge (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=merge forces a merge, and (optionally) changes the merge policy of a running Dgraph. In a cluster of Dgraph nodes, this command should be used on the leader node only. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) ping (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) ping (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=ping checks the aliveness of a Dgraph and returns a lightweight message. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) reload-services (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) reload-services (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=reload-services reloads the application's main and library modules for the Web services. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) stats (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) stats (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=stats returns the Dgraph Server Statistics page. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) statsreset (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) statsreset (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=statsreset resets the Dgraph Server Statistics page. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) updateaspell (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) updateaspell (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The admin/datastore?op=updateaspell administrative operation lets you rebuild the aspell dictionary for spelling correction from the data corpus while continuing to issue queries and updates to the Dgraph and without stopping and restarting it. (shortdesc] (topicmeta] (topicref] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About logging variables for the Dgraph (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About logging variables for the Dgraph (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can use logging variables with config operations. This lets you obtain detailed information about Dgraph processing, to help diagnose unexpected application behavior or performance problems, without stopping and restarting the Dgraph or requiring a configuration update. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Logging variable operation syntax (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Logging variable operation syntax (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Dgraph logging variables are toggled using the /config/dstore?op=log-enable&name=<variable-name> and /config/dstore?op=log-disable&name=<variable-name> operations. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) List of configuration operations (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) List of configuration operations (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Configuration (or config) operations listed in this topic allow you to modify configuration and logging information for the Dgraph from within the system. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) List of supported logging variables (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) List of supported logging variables (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The following table describes the supported logging variables that you can use with related config operations to toggle logging verbosity for specified features. (shortdesc] (topicmeta][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) log-enable (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) log-enable (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The log-enable operation lets you turn on verbose logging. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) log-disable (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) log-disable (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The log-disable operation turns off verbose logging. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) log-status (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) log-status (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The log-status operation returns a list of all logging variables with their values (true or false). (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) help (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) help (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /config/dstore?op=help returns the usage page for all of the config operations. (shortdesc] (topicmeta] (topicref] (topicref] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Configuring Endeca Server as a Service (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Configuring Endeca Server as a Service (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes how to control the Endeca Server from the Windows Services utility or from the Linux inittab. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Running the Endeca Server as a Windows service (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Running the Endeca Server as a Windows service (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can create a Windows service for running the Endeca Server in service mode. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) SC Create command syntax (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) SC Create command syntax (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic describes the various options of the SC command with the Create command option. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Creating the Endeca Server Windows service (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Creating the Endeca Server Windows service (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Use the SC command's Create option to create the Endeca Server Windows service. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Setting a service description (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Setting a service description (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Use the SC command's Description option to set a description for the Endeca Server Windows service. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Modifying the service configuration (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Modifying the service configuration (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Use the SC command's Config option to modify the configuration of the Endeca Server service. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Deleting the Endeca Server Windows service (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Deleting the Endeca Server Windows service (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Use the SC command's Delete option to remove the Endeca Server Windows service. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Using the Windows Services utility (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Using the Windows Services utility (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Windows Services utility allows you to control and configure the Endeca Server service. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Logging in service mode (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Logging in service mode (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Endeca Server logging is supported in service mode. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Starting the Endeca Server from inittab (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Starting the Endeca Server from inittab (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) In a Linux production environment, Endeca Server can be started by init from inittab. (shortdesc] (topicmeta] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Managing the Merge Policy (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Managing the Merge Policy (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes how to set and manage a merge policy for each Endeca data store. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Using a merge policy for incremental updates (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Using a merge policy for incremental updates (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) A merge policy determines how frequently the Dgraph merges incremental update generations in its data files, for a specific data store. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Types of merge policies (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Types of merge policies (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can set the merge policy to one of two settings: balanced or aggressive. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Setting or changing the merge policy (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Setting or changing the merge policy (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The mdex-config_MergePolicy attribute in the Global Configuration Record (or GCR) sets the merge policy for the Endeca data store. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Setting the merge policy with the Configuration Web Service (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Setting the merge policy with the Configuration Web Service (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can use the Configuration Web Service to programmatically retrieve and set the merge policy in the GCR. (shortdesc] (topicmeta][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Retrieving the merge policy with the Configuration Web Service (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Retrieving the merge policy with the Configuration Web Service (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can retrieve the Global Configuration Record to see the current setting for the merge policy. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Setting the merge policy with the Configuration Web Service (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Setting the merge policy with the Configuration Web Service (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can programmatically set the merge policy for the data store by updating the Global Configuration Record. (shortdesc] (topicmeta] (topicref] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Changing the merge policy of a running data store (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Changing the merge policy of a running data store (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The URL /admin/datastore?op=merge command can be used to change the merge policy of a running Endeca data store. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Forcing a merge (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Forcing a merge (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The URL /admin/datastore?op=merge command can also be used to force a merge. (shortdesc] (topicmeta] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Deploying a Cluster of Oracle Endeca Servers (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Deploying a Cluster of Oracle Endeca Servers (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section discusses how to deploy a cluster with multiple Oracle Endeca Servers. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Cluster overview (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Cluster overview (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic introduces the cluster of Oracle Endeca Server nodes and describes its capabilities. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Oracle Endeca Server cluster architecture (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Oracle Endeca Server cluster architecture (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic discusses cluster architecture in the development and production environments. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Important cluster concepts (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Important cluster concepts (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic introduces the leader and follower nodes and the Cluster Coordinator. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Before you begin (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Before you begin (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section discusses requirements for installation related to deploying a cluster, as well as tips for planning your cluster architecture. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) System and hardware requirements (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) System and hardware requirements (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section outlines the operating system and hardware requirements for deploying Oracle Endeca Servers in a clustered environment. (shortdesc] (topicmeta][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Operating system requirements (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Operating system requirements (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) A cluster of nodes can be deployed on either Windows or Linux. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Shared file system requirements (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Shared file system requirements (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic describes the requirements for the shared file system in a cluster. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Load balancer requirements (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Load balancer requirements (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) In most production deployments, it is desirable to configure a load balancer in front of the cluster. This topic discusses the considerations for this load balancer. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About the Cluster Coordinator (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About the Cluster Coordinator (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The cluster coordinator provides a mechanism for the nodes (represented by the Dgraph processes running on each of the servers) to communicate with each other while ensuring increased availability of the Oracle Endeca Server. (shortdesc] (topicmeta][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Starting and stopping the Cluster Coordinator service (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Starting and stopping the Cluster Coordinator service (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) To ensure that nodes can function together in a cluster, the Cluster Coordinator service must be running on the leader node and all the nodes must be started with references to the host name and port of the Cluster Coordinator service. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Configuration file for the Cluster Coordinator (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Configuration file for the Cluster Coordinator (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Cluster Coordinator service uses a configuration file to specify its settings. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Planning cluster nodes (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Planning cluster nodes (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) To plan cluster nodes, you specify which ones will serve as follower nodes. The one node in a cluster that is not a follower is the leader node. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Cluster behavior (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Cluster behavior (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Cluster Coordinator ensures that the nodes (represented by the Dgraph processes) in the cluster provide query processing that is stable in the face of individual follower node failures. This topic discusses cluster behavior in various scenarios, such as cluster startup, updates to the data files, and response to a node failure. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Building a cluster (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Building a cluster (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section discusses how to build a cluster by starting the leader node and adding follower nodes. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Starting the Dgraph process as the leader node (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Starting the Dgraph process as the leader node (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) When you start the data store without specifying a follower node flag for the Dgraph process, this node serves as the leader node. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Adding a follower node (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Adding a follower node (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can add a follower node to the cluster after the leader node has been started, by specifying the --follower flag for the follower Dgraph process. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Summary of operations handled by the leader node and any node (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Summary of operations handled by the leader node and any node (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic summarizes which specific requests to the Oracle Endeca Server should be directed to the leader node and which can be handled by any node. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Connecting the leader node with Integrator (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Connecting the leader node with Integrator (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The connectors in Integrator that send data to the Oracle Endeca Server must be configured to reference the host name and port of the leader node. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Maintaining a cluster (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Maintaining a cluster (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section contains tasks you need to perform for cluster maintenance. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Removing a follower node (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Removing a follower node (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) To remove a follower node, stop the data store and its associated Dgraph process on this server with the endeca-cmd stop-ds <datastore> command. This command gracefully shuts down a running Dgraph process. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Changing the name of the leader node (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Changing the name of the leader node (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) To change the leader node, stop the existing cluster by stopping all Dgraph processes on each of the servers, start the Cluster Coordinator on another node, and recreate the cluster with the new leader node. (shortdesc] (topicmeta] (topicref] (topicref] (topicref] [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) Configuring SSL (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) Configuring SSL (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes how configure Oracle Endeca Server to use SSL. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About configuring SSL in Endeca Server (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About configuring SSL in Endeca Server (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Configuring SSL in Endeca Server enables SSL communication among all the components. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Configuring SSL on Jetty (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Configuring SSL on Jetty (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes the tasks necessary to enable SSL on the Jetty application server. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Creating a keystore (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Creating a keystore (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic describes how to create a JKS keystore. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Obfuscating passwords (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Obfuscating passwords (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You should obfuscate the SSL connector keystore password for greater security. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Configuring Endeca Server Jetty files (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Configuring Endeca Server Jetty files (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You must modify Jetty files for SSL, as well as changing the start-up port for Endeca Server. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Enabling SSL for the endeca-cmd interface (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Enabling SSL for the endeca-cmd interface (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You must use endeca-cmd interface global options to specify the location of the keystore and truststore files. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Configuring SSL on the Dgraph (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Configuring SSL on the Dgraph (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes how to configure SSL on the Dgraph. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Certificate files used by components connecting with the Dgraph (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Certificate files used by components connecting with the Dgraph (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You configure SSL among the components by using a set of certificate 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 "}) Using enecerts to generate SSL certificates (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Using enecerts to generate SSL certificates (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can use the enecerts utility program to generate new SSL certificate files. (shortdesc] (topicmeta][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Generating standard SSL certificates on Linux (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Generating standard SSL certificates on Linux (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This procedure shows how to generate the set of standard certificates with a 1024-bit private key size on Linux platforms. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Generating standard SSL certificates on Windows (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Generating standard SSL certificates on Windows (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This procedure shows how to generate the set of standard certificates with a 1024-bit private key size on Windows platforms. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Generating custom certificates (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Generating custom certificates (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can use the enecerts utility to generate customized certificates. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Copying the SSL certificates to other machines (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Copying the SSL certificates to other machines (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) All machines that are running your deployment must use the same SSL certificates. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Configuring the Dgraph for SSL mutual authentication (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Configuring the Dgraph for SSL mutual authentication (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic describes high level steps required to configure an SSL mutual authentication between the Dgraph and an external machine. The authentication uses certificates signed by a certificate authority (CA). This setup may apply if your Dgraph and external machines are hosted outside the firewall, or if a two-way authentication is required between them. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Converting PEM-format keys to JKS format (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Converting PEM-format keys to JKS format (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic describes how to convert PEM-format certificates to the standard Java KeyStore (JKS) format. (shortdesc] (topicmeta] (topicref] (topicref] (topicref] [/map/reltable {"- map/reltable "}) [/map/reltable/relheader {"- map/relheader "}) [/map/reltable/relheader/relcolspec {"- map/relcolspec "}) (relcolspec][/map/reltable/relheader/relcolspec {"- map/relcolspec "}) (relcolspec] (relheader] [/map/reltable/relrow {"- map/relrow "}) [/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) Managing the Merge Policy (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) Managing the Merge Policy (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This section describes how to set and manage a merge policy for each Endeca data store. (shortdesc] (topicmeta] (topicref] (relcell][/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) merge (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) merge (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=merge forces a merge, and (optionally) changes the merge policy of a running Dgraph. In a cluster of Dgraph nodes, this command should be used on the leader node only. (shortdesc] (topicmeta] (topicref] (relcell] (relrow] (reltable] [/map/reltable {"- map/reltable "}) [/map/reltable/relheader {"- map/relheader "}) [/map/reltable/relheader/relcolspec {"- map/relcolspec "}) (relcolspec][/map/reltable/relheader/relcolspec {"- map/relcolspec "}) (relcolspec] (relheader] [/map/reltable/relrow {"- map/relrow "}) [/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) Collecting debugging information (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) Collecting debugging information (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Before attempting to debug an issue with the data store, collect the following information. (shortdesc] (topicmeta] (topicref] (relcell][/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) Logs created by the Dgraph (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) Logs created by the Dgraph (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Dgraph creates several logs, although some of these logs depend on your implementation and the components that you may be using. This topic provides a summary of these logs. (shortdesc] (topicmeta] (topicref] (relcell] (relrow] [/map/reltable/relrow {"- map/relrow "}) [/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) Managing Dgraph core dump files (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) Managing Dgraph core dump files (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) In the rare case of a Dgraph crash, the Dgraph writes its core dump files on disk. (shortdesc] (topicmeta] (topicref] (relcell][/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) Managing Dgraph crash dump files on Windows (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) Managing Dgraph crash dump files on Windows (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) On Windows, all Dgraph crash dump files are saved on disk by default. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) Managing Dgraph core dump files on Linux (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) Managing Dgraph core dump files on Linux (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) It is recommended to use the ulimit -c unlimited setting for the Dgraph process core dump files. Non-limited core files contain all Dgraph data that is resident in memory (RSS of the Dgraph process). (shortdesc] (topicmeta] (topicref] (relcell] (relrow] (reltable][/map/reltable {"- map/reltable "}) [/map/reltable/relheader {"- map/relheader "}) [/map/reltable/relheader/relcolspec {"- map/relcolspec "}) (relcolspec][/map/reltable/relheader/relcolspec {"- map/relcolspec "}) (relcolspec] (relheader] [/map/reltable/relrow {"- map/relrow "}) [/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) List of administrative operations (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) List of administrative operations (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Administrative (or admin) operations listed in this topic allow you to control the behavior of an Endeca data store's Dgraph process. (shortdesc] (topicmeta] (topicref] (relcell][/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) help (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) help (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=help returns the usage page for all of the administrative operations. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) flush (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) flush (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=flush flushes the Dgraph cache. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) logroll (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) logroll (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=logroll forces a query log roll. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) merge (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) merge (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=merge forces a merge, and (optionally) changes the merge policy of a running Dgraph. In a cluster of Dgraph nodes, this command should be used on the leader node only. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) ping (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) ping (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=ping checks the aliveness of a Dgraph and returns a lightweight message. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) reload-services (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) reload-services (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=reload-services reloads the application's main and library modules for the Web services. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) stats (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) stats (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=stats returns the Dgraph Server Statistics page. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) statsreset (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) statsreset (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /admin/datastore?op=statsreset resets the Dgraph Server Statistics page. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) updateaspell (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) updateaspell (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The admin/datastore?op=updateaspell administrative operation lets you rebuild the aspell dictionary for spelling correction from the data corpus while continuing to issue queries and updates to the Dgraph and without stopping and restarting it. (shortdesc] (topicmeta] (topicref] (relcell] (relrow] [/map/reltable/relrow {"- map/relrow "}) [/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) About logging variables for the Dgraph (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) About logging variables for the Dgraph (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can use logging variables with config operations. This lets you obtain detailed information about Dgraph processing, to help diagnose unexpected application behavior or performance problems, without stopping and restarting the Dgraph or requiring a configuration update. (shortdesc] (topicmeta] (topicref] (relcell][/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) Logging variable operation syntax (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) Logging variable operation syntax (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Dgraph logging variables are toggled using the /config/dstore?op=log-enable&name=<variable-name> and /config/dstore?op=log-disable&name=<variable-name> operations. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) List of configuration operations (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) List of configuration operations (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) Configuration (or config) operations listed in this topic allow you to modify configuration and logging information for the Dgraph from within the system. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) List of supported logging variables (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) List of supported logging variables (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The following table describes the supported logging variables that you can use with related config operations to toggle logging verbosity for specified features. (shortdesc] (topicmeta] (topicref] (relcell] (relrow] [/map/reltable/relrow {"- map/relrow "}) [/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) List of supported logging variables (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) List of supported logging variables (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The following table describes the supported logging variables that you can use with related config operations to toggle logging verbosity for specified features. (shortdesc] (topicmeta] (topicref] (relcell][/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) log-enable (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) log-enable (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The log-enable operation lets you turn on verbose logging. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) log-disable (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) log-disable (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The log-disable operation turns off verbose logging. (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) log-status (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) log-status (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The log-status operation returns a list of all logging variables with their values (true or false). (shortdesc] (topicmeta] (topicref] [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) help (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) help (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) /config/dstore?op=help returns the usage page for all of the config operations. (shortdesc] (topicmeta] (topicref] (relcell] (relrow] (reltable][/map/reltable {"- map/reltable "}) [/map/reltable/relheader {"- map/relheader "}) [/map/reltable/relheader/relcolspec {"- map/relcolspec "}) (relcolspec] [/map/reltable/relheader/relcolspec {"- map/relcolspec "}) (relcolspec] (relheader] [/map/reltable/relrow {"- map/relrow "}) [/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) Important cluster concepts (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) Important cluster concepts (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) This topic introduces the leader and follower nodes and the Cluster Coordinator. (shortdesc] (topicmeta] (topicref] (relcell][/map/reltable/relrow/relcell {"- map/relcell "}) [/map/reltable/relrow/relcell/topicref {"- map/topicref "}) [/map/reltable/relrow/relcell/topicref/topicmeta {"- map/topicmeta "}) [/map/reltable/relrow/relcell/topicref/topicmeta/navtitle {"- topic/navtitle "}) Cluster behavior (navtitle][/map/reltable/relrow/relcell/topicref/topicmeta/linktext {"- map/linktext "}) Cluster behavior (linktext][/map/reltable/relrow/relcell/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The Cluster Coordinator ensures that the nodes (represented by the Dgraph processes) in the cluster provide query processing that is stable in the face of individual follower node failures. This topic discusses cluster behavior in various scenarios, such as cluster startup, updates to the data files, and response to a node failure. (shortdesc] (topicmeta] (topicref] (relcell] (relrow] (reltable] (map]