Use bdacli to Patch Software and to Display Configuration Information

Syntax

bdacli action [parameters]

Actions

help

Displays general usage information for bdacli, a list of actions, and a list of supported parameters for the getinfo 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 use add or remove.

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

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 current `config.json` file is stored.

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 current config.json file is stored.

getinfo [parameter]

Returns a list of getinfo parameters. If you include a parameter name in the command, then getinfo 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 or false.

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 `/etc/hosts` entries that you can append to the `/etc/hosts` file on any device on the same InfiniBand fabric as the Oracle Big Data Cloud Service cluster, to ensure that Hadoop traffic uses the InfiniBand network. Do not add these entries to a device on a different fabric. 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