Navigating the BDD directory structure

Your BDD installation consists of two main directories: $BDD_HOME and $DOMAIN_HOME.

$BDD_HOME

$BDD_HOME is the root directory of your BDD installation. Its default path is:
$ORACLE_HOME/BDD-<version>

$BDD_HOME contains the following subdirectories.

Directory name Description
/BDD_manager Directories related to the bdd-admin script:
  • /bin: Contains bdd-admin and other relevant scripts. You can use bdd-admin to administer your cluster from the command line.
  • /conf: Contains bdd.conf.
  • /linux: Additional scripts required by the bdd-admin script.
  • /log: Contains the bdd-admin log files.
  • version.txt: Contains version information for bdd-admin.

More information on the bdd-admin script is available in the Oracle Big Data Discovery Administrator's Guide.

Note: Because this directory is required for updating the cluster configuration after deployment and uninstalling BDD, it is created on all Managed Servers, Dgraph nodes, and YARN NodeManager nodes in the cluster. However, the bdd-admin script can only be run from the Admin Server.
/common/hadoop Files and directories BDD requires to communicate with Hadoop:
  • /conf: The configuration files for your Hadoop cluster.
  • /lib: The Hadoop fat jar generated from the Hadoop client libraries.
/dataprocessing Executables and packages for Data Processing, as well as the following subdirectories:
  • /edp/log: Data Processing log files.
  • /edp_cli: The CLI and related files. This directory is only available on the Managed Servers.
/dgraph Files and directories related to the Dgraph, including:
  • /bin: Scripts for administering the Dgraph.
  • /bin/trace_logs: The Dgraph Tracing Utility logs.
  • /conf: Stylesheets for Dgraph statistics pages and schemas for Dgraph queries and responses.
  • /dgraph-hdfs-agent: Scripts for administering the HDFS Agent and its libraries.
  • /doc
  • /empty_indexes: The empty indexes the installer uses to create the base index. This directory is only used if you set DGRAPH_INDEX_NAME to base.
  • /lib and /lib64: Dgraph libraries.
  • /msg: Localized messages for EQL queries.
  • /nls and /olt: Files related to the OLT.
  • /ssl: File for configuring SSL.
  • version.txt: Contains version information for the Dgraph and HDFS Agent components.
  • /xquery: XQuery documents for communications between the Dgraph and other services.
/logs Log files for the Dgraph Dgraph HDFS Agent, and Data Processing components.
/server Files and directories related to the Dgraph Gateway, including:
  • /endeca-cmd: Contains the endeca-cmd command line utility, which you use to administer the Dgraph Gateway from the command line.
  • /endeca-server: EAR file for the Dgraph Gateway application.
  • README_BDD.txt: The BDD release notes.
  • version.txt: Contains version information for the Dgraph Gateway component.
/studio Contains the EAR file for the Studio application, and a version file for Studio.
/uninstall The uninstall script and its required utilities.
version.txt Contains version information for your BDD installation.

$DOMAIN_HOME

$DOMAIN_HOME is the root directory of Studio, the Dgraph Gateway, and your WebLogic domain. Its default path is:
$ORACLE_HOME/user_projects/domains/bdd-<version>_domain

$DOMAIN_HOME contains the following subdirectories.

Directory name Description
/autodeploy Provides a way to quickly deploy applications to a development server. You can place J2EE applications in this directory; these will be automatically deployed to the WebLogic Server when it is started in development mode.
/bin Scripts for migrating servers and services, setting up domain and startup environments, and starting and stopping the WebLogic Server and other components.
/config Data sources and configuration files for Studio and the Dgraph Gateway.
/console-ext Console extensions. This directory is only used on the Admin Server.
edit.lok Ensures can only edit the domain's configuration one at a time. Don't edit this file.
/EndecaServer Contains files and libraries used by the Dgraph Gateway.
fileRealm.properties Configuration file for the file realm.
/init-info Schemas used by the Dgraph Gateway.
/lib The domain library. The JAR files in this directory are dynamically added to the end of the Dgraph Gateway's classpath when the Dgraph Gateway is started. You use this directory to add application libraries to the Dgraph Gateway's classpath.
/nodemanager Files used by the Node Manager. nodemanager.domains lists the locations of directories created by the configuration wizard, and nodemanager.properties configures the Node Manager.
/pending Stores pending configuration changes.
/security Files related to domain security.
/servers Log files and security information for each server in the cluster.
startWebLogic.sh Script for starting the WebLogic Server.
/tmp Temporary directory.