[/map {"- map/map "}) [/map/topicref {"- map/topicref "}) [/map/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicmeta/navtitle {"- topic/navtitle "}) The bdd-admin Script Reference (navtitle][/map/topicref/topicmeta/linktext {"- map/linktext "}) The bdd-admin Script Reference (linktext][/map/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can use the bdd-admin script to administer your BDD cluster from the command line. This section describes the script and its commands. (shortdesc] (topicmeta][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) About the bdd-admin script (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) About the bdd-admin script (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The bdd-admin script includes a number of commands that perform different administrative tasks for your cluster, like starting components and updating BDD's configuration. The script is located in the $BDD_HOME/BDD_manager/bin directory. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Lifecycle management commands (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Lifecycle management commands (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can use the bdd-admin script's lifecycle management commands to perform such operations as starting and stopping BDD components. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) start (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) start (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The start command starts components. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) stop (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) stop (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The stop command stops components. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) restart (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) restart (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The restart command restarts components regardless of whether they're currently running or stopped. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) System management commands (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) System management commands (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can use the bdd-admin script's system management commands to perform such operations as backing up your cluster and updating BDD's configuration. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) autostart (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) autostart (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The autostart command enables and disables autostart for components. Components that have autostart enabled restart automatically after their hosts are rebooted. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) backup (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) backup (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The backup command creates a backup of the cluster's data and metadata to a single TAR file that can later be used to restore it. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) restore (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) restore (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The restore command restores your BDD data and metadata from a backup TAR file created by the backup command. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) publish-config (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) publish-config (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The publish-config command publishes configuration changes to your BDD cluster. (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 "}) bdd (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) bdd (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The bdd configuration type publishes a modified version of bdd.conf to all BDD nodes. This updates the configuration of the entire 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 "}) hadoop (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) hadoop (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The hadoop configuration type makes changes to BDD's Hadoop configuration. (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 "}) kerberos (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) kerberos (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The kerberos configuration type updates to BDD's Kerberos configuration. (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 "}) cert (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) cert (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The cert configuration type refreshes BDD's TLS/SSL certificates for the HDFS, YARN, Hive, and KMS 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 "}) database (navtitle][/map/topicref/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) database (linktext][/map/topicref/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The database configuration type updates a component's database configuration, including its username, password, and JDBC URL. (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 "}) update-model (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) update-model (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The update-model command updates or resets the models used by some of the Data Enrichment modules. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) flush (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) flush (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The flush command flushes component caches. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) reshape-nodes (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) reshape-nodes (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The reshape-nodes command adds and removes Data Processing nodes from your BDD cluster. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) enable-components (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) enable-components (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The enable-components command enables components that are currently disabled. Note that this command can only be used for certain components. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) disable-components (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) disable-components (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The disable-components command disables specific components that are currently enabled. Note that this can only be used on components that were enabled by the enable-components command. (shortdesc] (topicmeta] (topicref] (topicref][/map/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) Diagnostics commands (navtitle][/map/topicref/topicref/topicmeta/linktext {"- map/linktext "}) Diagnostics commands (linktext][/map/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) You can use the bdd-admin script's diagnostics commands to perform such operations as checking the status of your cluster and retrieving component log files. (shortdesc] (topicmeta][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) get-blackbox (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) get-blackbox (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The get-blackbox command generates the Dgraph's on-demand tracing blackbox file and returns the name and location of the file. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) status (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) status (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The status command checks component statuses and the overall health of the BDD cluster. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) get-stats (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) get-stats (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The get-stats command obtains Dgraph statistics. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) reset-stats (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) reset-stats (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The reset-stats command resets the Dgraph statistics. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) get-log-levels (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) get-log-levels (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The get-log-levels command returns the list of component logs and their current levels. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) set-log-levels (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) set-log-levels (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The set-log-levels command sets component log levels and updates their configuration files so that the changes persist when the components are restarted. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) get-logs (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) get-logs (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The get-logs command collects requested log files and compresses them to a single zip file. (shortdesc] (topicmeta] (topicref][/map/topicref/topicref/topicref {"- map/topicref "}) [/map/topicref/topicref/topicref/topicmeta {"- map/topicmeta "}) [/map/topicref/topicref/topicref/topicmeta/navtitle {"- topic/navtitle "}) rotate-logs (navtitle][/map/topicref/topicref/topicref/topicmeta/linktext {"- map/linktext "}) rotate-logs (linktext][/map/topicref/topicref/topicref/topicmeta/shortdesc {"- map/shortdesc "}) The rotate-logs command rotates component logs. (shortdesc] (topicmeta] (topicref] (topicref] (topicref] (map]