Updating bdd.conf

You can update BDD's configuration by editing bdd.conf, then running the bdd-admin script to distribute your changes to the rest of the cluster.

Important: When making changes to your cluster's configuration, always use the post-install version of bdd.conf in $BDD_HOME/BDD_manager/conf/, and not the original one used during the installation. The post-install version contains a number of new properties added by the installer, which will be lost if you use the original one.

Be aware that it's not recommended to modify all properties in bdd.conf. In particular, you should avoid changing properties related to cluster topology, like <COMPONENT>_PORT and <COMPONENT>_SERVERS. Additionally, some Studio and Data Processing settings should be configured through either Studio or the Data Processing configuration files. For more information, see Configuring Studio Settings, Configuring Data Processing Settings, and the Data Processing Guide.

Also note that when you update bdd.conf, any component log levels you've set on specific nodes using the set-log-levels command will be overwritten by the DGRAPH_LOG_LEVELS and ENDECA_SERVER_LOG_LEVEL properties in the updated file.

When the script runs, it backs up the original version of $BDD_HOME/BDD_manager/conf/bdd.conf to bdd.conf.bak<num> so you can revert your changes, if necessary. It then copies the updated file to all BDD nodes.

To update your cluster configuration:

  1. On the Admin Server, copy $BDD_HOME/BBD_manager/conf/bdd.conf to a different directory.
  2. Open the copy in a text editor and make your desired changes.
    Be sure to save the file before closing.
  3. Go to $BDD_HOME/BDD_manager/bin and run: 
    ./bdd-admin.sh publish-config bdd <path>
    Where <path> is the absolute path to the modified copy of bdd.conf.
  4. Restart your cluster so the changes take effect: 
    ./bdd-admin.sh restart [-t <minutes>]