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: The bdd-admin script, which you can use to administer your cluster from the command line.
  • /commands: Scripts invoked by bdd-admin.
  • /conf: Contains bdd.conf.
  • /lib: Additional files required by bdd-admin.
  • /log: The bdd-admin log files.
  • version.txt: Version information for bdd-admin.

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

Note: Although the bdd-admin script can only be run from the Admin Server, this directory is created on all nodes BDD is installed on because it's required for updating cluster configuration post-installation.
/bdd-shell Files related to the optional BDD Shell component. For more information, see the BDD Shell Guide.
/clusteringservice For use by Oracle Support, only. Files and directories related to the Cluster Analysis service.
/common Files and directories required by all BDD components:
  • /edp: Libraries and OLT files required by Data Processing.
  • /hadoop: The Hadoop fat JAR generated from the client libraries, and other Hadoop configuration files required by BDD.
  • /security/cacerts: Only available when BDD is installed on secure Hadoop clusters. Contains the certificates for HDFS, YARN, Hive, and the KMS services.
  • /templates: Additional JARs required by BDD components.
/csfmanagerservice Install location of the Credential Store Framework (CSF) management utilities, which store the credentials the Transform Service and Workflow Manager Service used to connect to other components.
/dataprocessing/edp_cli The DP CLI and related files.
/dgraph Files and directories related to the Dgraph, including:
  • /bin: Scripts for administering the Dgraph.
  • /bin/trace_logs: The Dgraph Tracing Utility logs.
  • /bin/zk_session: ZooKeeper session information.
  • /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: Schemas for communications between the Dgraph and other services.
  • /hdfs_root: The mount point for the HDFS root directory, which enables the Dgraph to access the databases. This is only used if your databases are on HDFS.
  • /lib and /lib64: Dgraph libraries.
  • /msg: Localized messages for EQL queries.
  • /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.
/jetty The Jetty installation location.
/logs BDD log files.
/microservices The Jetty and OPSS installation packages.
/opss and /opss_standalone Install locations of the Oracle Platform Security Services application, which provides the CSF required by the Transform Service and Workflow Manager Service.
/server Files and directories related to the Dgraph Gateway, including:
  • /common: JARs required by the Dgraph Gateway.
  • /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.
/transformservice Scripts and other resources required by the Transform Service.
/uninstall The uninstall script and required utilities.
version.txt Version information for your BDD installation.
/workflowmanager Files and directories related to the Workflow Manager Service, including:
  • /dp/config: Workflow Manager Service configuration files.
  • /logs: Workflow Manager Service logs.

$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.
fileRealm.properties Configuration file for the file realm.
/init-info Schemas used by the Dgraph Gateway.
/lib The domain library. JAR files placed in this directory will be 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.