Use bdacli to Patch Software and to Display Configuration Information
The Oracle Big Data Cloud Service command-line interface (bdacli) queries various configuration files to return information about the cluster, nodes, and software patches.
Syntax
bdacli action [parameters]
Actions
-
help
- Displays general usage information for
bdacli
, a list of actions, and a list of supported parameters for thegetinfo
action. -
{add | remove} patch patch_number
- Adds or removes a software patch on Oracle Big Data Cloud Service that matches patch_number. You must log in as
root
to useadd
orremove
. -
admin_cluster parameter node_name
-
Enables you to administer the nodes in a cluster in response to a failing node. The following table describes the parameters.
Parameter Description decommission
Removes the specified node from the cluster and decommissions the node in Cloudera Manager. It also updates the Mammoth files.
You can decommission a failing, noncritical node. Note that critical services on the node must be moved first.
recommission
Removes the node from the list of decommissioned nodes, and recommissions the node in Cloudera Manager. Use this command after decommissioning and repairing a failing node.
migrate
Moves the services from a critical node to a noncritical node, and decommissions the failing node in Cloudera Manager. You specify the name of the failing critical node, and the utility selects the noncritical node for the migration. When migration is complete, the new node has all of the functionality of the original critical node.
You can only migrate a critical node, and should do so only when it is failing.
reprovision
Restores a node to the cluster as a noncritical node, and recommissions the node in Cloudera Manager. Use this command after migrating the services of a critical node and repairing the failing node.
-
{start | stop | restart | status} service
-
Starts, stops, restarts, or returns the current status of a service on a cluster or a specific node.
The following table describes the service parameters:
Parameter Description big_data_sql_cluster
Oracle Big Data SQL on all nodes of the cluster big_data_sql_server node_name
Oracle Big Data SQL on a specified node of the cluster.
Use
bdacli
with this parameter only from the first node of the cluster, where the currentconfig.json
file is stored. -
getinfo [parameter]
-
Returns a list of
getinfo
parameters. If you include a parameter name in the command, thengetinfo
returns information about that system component:-
Cluster parameters: Describes a logical Oracle Big Data Cloud Service cluster. The bdacli command queries the current config.json file for the Hadoop cluster where the command executes. See Cluster Parameters.
-
Node parameters: Describes a node. The bdacli command queries the operating system of the node where the bdacli command executes. See Node Parameters.
-
One-off patch parameters: Provides information about one-off patches. See One-Off Patch Parameters.
Parameter names that end with an "s" return lists. Boolean parameters return a string of either
true
orfalse
. -
Cluster Parameters
The following tables describe the cluster parameters.
The following table describes the general cluster parameters for bdacli getinfo
.
General Cluster Parameters
Parameter | Returns |
---|---|
cluster_asr_installed |
true if Auto Service Request is configured for this cluster; false otherwise
|
cluster_big_data_sql_enabled |
true if Oracle Big Data SQL is enabled for this cluster; false otherwise.
|
cluster_cdh_version |
The version of Cloudera's Distribution including Apache Hadoop installed on this cluster, such as 4.5.0-ol6 .
|
cluster_cm_server |
The Cloudera Manager address, including the node name and port number, such as bda1node03.example.com:7180 .
|
cluster_cm_version |
The version of Cloudera Manager running on this cluster, such as 4.8.0-ol6 .
|
cluster_name |
The name of the cluster, such as cluster-c .
|
cluster_primary_host |
The unqualified host name of the node that hosts the puppet master. The Mammoth utility was deployed from this host, and any reconfiguration of the cluster must be done while logged in to that node. |
cluster_type |
The type of cluster (default: Hadoop ).
|
cluster_version |
The software version installed on this cluster by the Mammoth utility, such as 3.1.0. |
The following table describes describes the cluster parameters related to Oracle Big Data Connectors for bdacli getinfo
.
Oracle Big Data Connectors Status Parameters
Parameter | Returns |
---|---|
cluster_bdc_installed |
true if Oracle Big Data Connectors is installed; false otherwise |
cluster_odi_enabled |
true if the Oracle Data Integrator agent is enabled; false otherwise. |
cluster_odi_version |
The version of Oracle Data Integrator agent installed on the cluster. |
cluster_oraah_version |
The version of Oracle R Advanced Analytics for Hadoop installed on the cluster |
cluster_oraloader_version |
The version of Oracle Loader for Hadoop installed on the cluster |
cluster_osch_version |
The version of Oracle SQL Connector for HDFS installed on the cluster |
cluster_oxh_version |
The version of Oracle XQuery for Hadoop installed on the cluster |
The following table describes the cluster network parameters for bdacli getinfo
.
Cluster Network Parameters
Parameter | Returns |
---|---|
cluster_hosts_entries |
A list of Each entry is on a separate line with three parts: the InfiniBand IP address, the full client host name, and the short client host name. |
cluster_ilom_ips |
An ordered list of IP addresses for the Oracle ILOMs in the nodes, starting with the first node in the cluster |
cluster_ilom_names |
A list of unqualified host names on the administrative network for the Oracle ILOMs in the nodes, in order starting with the first node in the cluster |
cluster_node_ips |
The IP addresses on the client network of all nodes in this cluster |
cluster_node_names |
The host names on the client network of all nodes in the cluster, such as bda1node01 |
The following table describes the cluster security parameters for bdacli getinfo
.
Cluster Security Parameters
Parameter | Returns |
---|---|
cluster_av_admin |
The name of the Oracle Audit Vault and Database Firewall administration user. Returns an error if Audit Vault is not configured for this cluster. |
cluster_av_enabled |
true if Oracle Audit Vault and Database Firewall auditing is enabled; false otherwise
|
cluster_av_port |
The port number that the Audit Vault node listens on. Returns an error if Oracle Audit Vault and Database Firewall is not configured on this cluster. |
cluster_av_server |
The IP address of the Audit Vault node. Returns an error if Oracle Audit Vault and Database Firewall is not configured on this cluster. |
cluster_av_service |
The database service name for the Audit Vault node. Returns an error if Oracle Audit Vault and Database Firewall is not configured on this cluster. |
cluster_hdfs_encryption_enabled |
true if network encryption of Hadoop data is enabled for this cluster; false otherwise
|
cluster_hdfs_transparent_encryption_enabled |
true if HDFS Transparent Encryption of Hadoop data at rest is enabled for this cluster; false otherwise
|
cluster_kerberos_enabled |
true if Kerberos security is enabled; false otherwise.
|
cluster_kerberos_kdc_hosts |
A list of key distribution center (KDC) hosts external to Oracle Big Data Appliance. Returns an error if Kerberos is not enabled. |
cluster_kerberos_kdc_on_bda |
true if the Kerberos KDC is on Oracle Big Data Appliance; false otherwise. Returns an error if Kerberos is not enabled.
|
cluster_kerberos_realm |
The Kerberos realm for the cluster. Returns an error if Kerberos is not enabled. |
cluster_sentry_enabled |
true if Sentry is configured on the cluster; false otherwise.
|
Node Parameters
The following table describes the node parameters for bdacli getinfo
.
Parameter | Returns |
---|---|
server_mammoth_installed |
true if the Mammoth utility has deployed the Oracle Big Data Appliance software on this node; false otherwise.
|
server_name |
The name of this node on the client network, such as bda1node01. |
server_os_version |
The version of Oracle Linux on this node, such as 6.4. |
One-Off Patch Parameters
The following table describes the one-off patch parameters for bdacli getinfo
.
Parameter | Returns |
---|---|
available_patches |
A list of valid patches available for installation. A valid patch has a directory under /opt/oracle/bda/patches or /opt/oracle/BDAMammoth/patches that contains a file named inventory .
|
installed_patches |
A list of patches already installed. An installed patch has a directory in both /opt/oracle/bda/patches and /opt/oracle/BDAMammoth/patches .
|
Examples
The following commands provide information about the optional software on the cluster:
# bdacli getinfo cluster_bdc_installed
true
# bdacli getinfo cluster_odi_version
11.1.1.7.0
# bdacli getinfo cluster_hdfs_transparent_encryption_enabled
true
The following command lists all switches on the current InfiniBand fabric. In this example, three Oracle Big Data Cloud Service racks are on the fabric with the standard hardware configuration of one spine switch and two gateway switches each.
$ bdacli getinfo ib_switches
bda1sw-iba0 00:21:28:6c:c8:af:a0:a0 36P
bda1sw-ibb0 00:21:28:46:9e:3b:a0:a0 36P
bda1sw-ibs0 00:21:28:6c:c8:ae:a0:a0 36P
bda2sw-ib1 00:21:28:46:98:d3:a0:a0 36P
bda2sw-ib2 00:21:28:de:ae:4a:c0:a0 GTW
bda2sw-ib3 00:21:28:c3:70:9a:c0:a0 GTW
bda3sw-ib1 00:21:28:46:90:ee:a0:a0 36P
bda3sw-ib2 00:21:28:df:34:8a:c0:a0 GTW
bda3sw-ib3 00:21:28:df:0f:0a:c0:a0 GTW
bda4sw-ib1 00:21:28:e8:af:23:a0:a0 36P
bda4sw-ib2 00:10:e0:0c:48:a0:c0:a0 GTW
bda4sw-ib3 00:21:28:f4:82:ce:c0:a0 GTW
This example installs patch 1234:
$ bdacli add patch 1234