4 Using Oracle Big Data Appliance Configuration Generation Utility

This chapter describes how to use Oracle Big Data Appliance Configuration Generation Utility.

This chapter contains the following topics:

4.1 Overview of Oracle Big Data Appliance Configuration Generation Utility

Oracle Big Data Appliance Configuration Generation Utility acquires information from you, such as IP addresses and software preferences, that are required for deploying Oracle Big Data Appliance. After guiding you through a series of pages, the utility generates a set of configuration files. These files help automate the deployment process and ensure that Oracle Big Data Appliance is configured to your specifications.

Figure 4-1 shows a page of the Oracle Big Data Appliance Configuration Generation Utility.

Figure 4-1 Oracle Big Data Appliance Configuration Generation Utility

Description of Figure 4-1 follows
Description of "Figure 4-1 Oracle Big Data Appliance Configuration Generation Utility"

Note:

  • Oracle Big Data Appliance uses Cloudera's Distribution including Apache Hadoop (CDH). A Hadoop cluster on Oracle Big Data Appliance is called a CDH cluster.

  • The terms appliance and rack refer to Oracle Big Data Appliance, Oracle Big Data Appliance X3-2, and Oracle Big Data Appliance X4-2.

4.2 Generating the Configuration Files

The following procedures explain how to install Oracle Big Data Appliance Configuration Generation Utility and generate the configuration files.

To configure Oracle Big Data Appliance: 

  1. Download Oracle Big Data Appliance Configuration Generation Utility from Oracle Technology Network at

    http://www.oracle.com/technetwork/server-storage/engineered-systems/bigdata-appliance/downloads/index.html

    The file is named BDAConfigurator-version.zip. The system must run Oracle JRE 1.6 or later.

  2. Extract the files in BDAConfigurator-version.zip. This example extracts the files on a Linux system:

    $ unzip BDAConfigurator-2.0.zip
    Archive:  BDAConfigurator-2.0.zip
       creating: BDAConfigurator-2.0/
      inflating: BDAConfigurator-2.0/exagen.jar
      inflating: BDAConfigurator-2.0/oracle_ice.jar
      inflating: BDAConfigurator-2.0/passwd.jar
      inflating: BDAConfigurator-2.0/orai18n-utility.jar
         .
         .
         .
    
  3. Change to the BDAConfigurator-version directory.

  4. Run Oracle Big Data Appliance Configuration Generation Utility.

    • On Linux:

      $ sh bdaconf.sh
      
    • On Microsoft Windows, double-click bdaconf.cmd in Windows Explorer, or run the file from the command line:

      C:\ bdaconf.cmd
      
  5. If you are modifying a configuration, then click Import on the Welcome page to load the master.xml file with the saved configuration settings.

  6. Follow the steps of the wizard. On the Complete page, click Create Files.

  7. Validate the network configuration.

    See "Validating the Network Settings."

  8. Send the generated bda.zip file to your Oracle representative.

4.3 About the Configuration Files

Oracle Big Data Appliance Configuration Generation Utility generates the following files to use when you configure the system. You can select the directory where they are saved.

This is the basic structure of the directory:

company_name /
   bda-timestamp.zip
   bda-install-preview.html
   bda-preinstall-checkip.sh
   rack_name /
      BdaDeploy.json
   cluster_name /
      mammoth-rack_name.params
master.xml
bda-timestamp.zip

Contains a copy of the configuration files. If an Oracle customer service representative will perform the installation, then send this file to Oracle before the installation date. Otherwise, transfer the file to a USB drive for copying to Oracle Big Data Appliance.

bda-install-preview.html

Provides a report that lists all the details of the configuration. You can view the this report in a browser. Check it carefully to ensure that all of the settings are correct.

bda-preinstall-checkip.sh

Runs a series of tests to ensure the specified names and IP addresses for Oracle Big Data Appliance were added correctly to the name server, and they do not conflict with the existing network configuration.

mammoth-rack_name.params

Contains all the information for a cluster, including the network configuration, port numbers, user names, and passwords. The configuration utility creates a separate parameter file for each cluster. If several clusters are being configured, then each parameter file is located in a separate subdirectory.

If an in-rack expansion kit is being configured as an addition to an existing cluster, then the configuration utility does not generate a parameter file; the Mammoth utility generates it.

master.xml

Contains all the configuration settings in XML format so that Oracle Big Data Appliance Configuration Generation Utility can read it. To alter the configuration of an Oracle Big Data Appliance deployment, you can load this file, enter the changes, and regenerate the configuration files.

This file is not used for the actual configuration of Oracle Big Data Appliance.

rack_name-BdaDeploy.json

Contains the network configuration for a full rack, a starter rack, or a starter rack with one in-rack expansion kit. It contains information about all the servers, switches, and PDUs.

rack-name-BdaExpansion.json

Contains the network configuration for one or two in-rack expansion kits. It contains information about all the servers, but no information about the switches and PDUs. This file is generated only when an expansion kit is being installed and configured.

4.4 Validating the Network Settings

Validating the network settings before the Oracle Big Data Appliance hardware arrives at your site is a critical step. Network problems can cause extended delays in the installation.

To validate the network configuration settings: 

  1. Copy the bda-preinstall-checkip.sh file generated by Oracle Big Data Appliance Configuration Generation Utility to a Linux host on the same network that Oracle Big Data Appliance will use.

  2. Log in to the Linux host and run bda-preinstall-checkip.sh:

    $ sh bda-preinstall-checkip.sh
    

    This script checks your existing network for conflicts with the Oracle Big Data Appliance IP address pool.

  3. Correct any network problems discovered by the script before installation begins. Network problems during the installation can cause extensive delays.

  4. Run the network connections to the planned location for Oracle Big Data Appliance.

  5. Inform your Oracle representative when you have completed these steps.

4.5 Customer Details Page

The following table describes the customer details fields.

Table 4-1 Customer Details Page

Customer Details Field Description

Customer Name

The name of your enterprise. Required.

Region

The geographic area where Oracle Big Data Appliance will be installed.

Time Zone

The time zone for your installation. You must select the appropriate region before selecting the time zone.

Rack Base Name

The name of the Oracle Big Data Appliance rack.

Rack Start Index

A digit that uniquely identifies the rack. It is a suffix of the rack base name.

Server Base Name

Base name for all servers. A two-digit suffix uniquely identifies each server.

The rack name and server base name are used to generate the host names for all network interfaces: eth0, bondib0, bondeth0, and Oracle ILOM. For example, a rack base name of bda, a rack start index of 1, and a server base name of node results in host names of bda1node01, bda1node02, and so forth.

Admin Name Suffix

Suffix to the basic host name to form the eth0 host names

Private Name Suffix

Suffix to the basic host name to form the bondib0 host name

ILOM Name Suffix

Suffix to the basic host name to form the Oracle ILOM name

Switch Base Name

Suffix to the rack name to form the base name for all switches. For example, a rack name of bda and a switch base name of sw results in switch names of bda1sw-ip, bda1sw-ib1, and so forth.

Domain Name

Name of the domain in which Oracle Big Data Appliance operates. Required.


4.5.1 Using Standardized Host Names

The rack name is used in the assignment of standardized host names for all Oracle Big Data Appliance servers. The host name for all servers on the client network is in this format:

racknameNodeNN.domain

In this syntax:

  • NN is the position number of the server node in the rack (01 to 18).

  • domain is the domain name.

Host names must have fewer than 38 characters, which can be ASCII letters (a to z and A to Z), numbers (0 to 9), and hyphens (-) only. Do not begin or end the name with a hyphen.

4.5.2 Using Customized Host Names

You can change the suffixes used for the different network interfaces.

You can enter server host names that do not follow the naming conventions on the Review and Edit Details Page.

4.5.3 Naming Multirack Clusters

Oracle recommends that for a cluster of multiple racks, you use the cluster name as the rack name.

For example, in a three-rack cluster, if the cluster name is cluster1 and the domain name is example.com, then the fully qualified host name of the server at the bottom of the first rack is cluster101node01.example.com. For the top server in the third rack of this cluster, the host name is cluster103node18.example.com.

4.5.4 Connecting to Oracle Big Data Appliance Over the Networks

The host names on the other networks have a short extension that follows the unit number. If you retained the default extensions, then use these formats to connect to Oracle Big Data Appliance after it is connected to the network:

  • For short host names over the administrative network:

    racknameNodeNN-adm

  • For the private InfiniBand network host names:

    racknameNodeNN-priv

  • For the Oracle Integrated Lights Out Manager (ILOM) host names:

    racknameNodeNN-ilom

  • For the switch host names:

    racknamesw-ibM

In this syntax:

  • NN is the position number of the server in the rack (01 to 18).

  • M is 1, 2, or 3, depending on the switch location in the rack.

4.6 Hardware Selection Page

The hardware page identifies one or more racks that you want to deploy at the same time. The racks must be cabled together.

For example, if you are deploying three full racks, then add Full Rack three times to your deployment.

The following table describes the hardware selection choices.

Table 4-2 Hardware Selection Page

Hardware Selection Field Description

Select interconnected hardware to deploy

Lists the available hardware configurations. Choose one or more racks. You can choose the same type of rack multiple times.

  • Full rack: Contains 18 servers.

  • Starter rack: Contains six servers.

  • Starter rack with Expansion Kit: Contains 12 servers.

This is your deployment

Lists the hardware selected for your site.

Will you use non-Oracle PDUs?

Oracle strongly recommends that the PDUs that are shipped with Oracle Big Data Appliance be used to supply power to its servers and switches.

However, if your data center has specific requirements that the Oracle-supplied PDUs do not meet, then you can use other PDUs to supply power to the Oracle Big Data Appliance servers and switches. Oracle does not support customer-supplied PDUs, and Oracle Enterprise Manager Cloud Control does not monitor them.


4.7 Rack Details

The rack details page identifies the optional network connections for a Oracle Big Data Appliance rack.

The following table describes the rack detail fields.

Table 4-3 Rack Details Page

Rack Detail Field Description

Rack Name

Enter the name of the rack.

Number of 10 GbE Connections

The two Sun Network QDR InfiniBand Gateway switches in every Oracle Big Data Appliance must have an equal number of 10 GbE links to the client network. Each gateway switch supports up to eight 10-GbE links, for a total of 16 links. Each server is assigned to one 10-Gbe link on each gateway switch.

Therefore, an Oracle Big Data Appliance full rack or starter rack with an extension kit can use up to 16 10-GbE links. A starter rack can use up to 12 10-GbE links.

Oracle recommends using as many 10 GbE links to the Oracle Big Data Appliance rack as the data center can support. The additional links increase the network bandwidth available between Oracle Big Data Appliance and the client network, and reduces the impact if a link fails.

Oracle uses this information to ensure that the correct number of cables is ordered or available at the installation site. It also lets the Oracle field engineer plan how many 10 GbE links to connect to the Oracle Big Data Appliance rack.


4.8 Networking Page

The networking page identifies the number of IP addresses required for each network. The administrative, client Ethernet, and InfiniBand networks are required. You must allocate the specified number of IP addresses for them.

Each IP address pool initially contains a range of consecutive IP addresses. If some IP addresses in the range are not available, then you can change individual addresses on the Review and Edit Details Page.

4.9 Client Ethernet Network Page

The values that you enter on this page are used to add the Oracle Big Data Appliance servers to your existing client Ethernet network. Client applications typically access Oracle Big Data Appliance using this network.

The following table describes the client network fields.

Table 4-4 Client Ethernet Page

Client Ethernet Field Description

Starting IP Address for Pool

The first IP address on the client network available for use by the Oracle Big Data Appliance servers.

Pool Size

The required number of IP addresses. All Oracle Big Data Appliance servers require an IP address on the client network. The pool size is calculated for the racks that you identified on the Hardware Selection Page.

Ending IP Address for Pool

The last IP address on the client network assigned to Oracle Big Data Appliance. This address is automatically calculated from the starting IP address and the pool size.

Ensure that all of the IP addresses are available for use in the pool defined by the starting and ending addresses. If they are not available, then you can either assign a different range or manually change individual IP addresses on the Review and Edit Details Page.

Subnet Mask

The subnet mask for the client network.

Gateway

The IP address for the client network gateway.

The gateway IP address is generated automatically, so verify that it is correct.


4.10 Administrative Network Page

The values that you enter on this page are used to add the Oracle Big Data Appliance servers, switches, and PDUs to your existing administrative network. Each server has two network interfaces for administration. One interface provides access to the operating system, and the other provides access to Oracle Integrated Lights Out Manager (ILOM).

The following table describes the administrative network fields.

Table 4-5 Administrative Network Page

Administrative Network Field Description

Starting IP Address for Pool

The first IP address on the administrative network available for use by Oracle Big Data Appliance.

Pool Size

The required number of IP addresses on the administrative network.

The IP addresses for a rack are assigned in this order: Oracle Big Data Appliance servers (6, 12, or 18), Oracle ILOMs (6, 12, or 18), Ethernet switch, spine switch, leaf switches (2), and PDUs (2).

Ending IP Address for Pool

The last IP address on the administrative network assigned to Oracle Big Data Appliance. The value in this field is automatically calculated from the starting IP address and the pool size.

Ensure that all of the IP addresses are available for use in the pool defined by the starting and ending addresses. If they are not available, then you can either assign a different range or manually change individual IP addresses on the Review and Edit Details Page.

Subnet Mask

The subnet mask for the administrative network.

Gateway

The IP address for the gateway.

The gateway IP address is generated automatically, so verify that it is correct.


4.11 InfiniBand Network Page

The InfiniBand network connects the Oracle Big Data Appliance servers within a rack. It can also connect multiple racks to form a multirack Hadoop cluster, or to provide access to Oracle Big Data Appliance from Oracle Exadata Database Machine.

The following table describes the InfiniBand network fields.

Table 4-6 InfiniBand Network Page

InfiniBand Network Field Description

Starting IP Address for Pool

The first IP address on the private InfiniBand network available for use by the Oracle Big Data Appliance servers. The default is 192.168.10.1.

Pool Size

The required number of IP addresses. All Oracle Big Data Appliance servers require an IP address on the InfiniBand network. The pool size is calculated for the deployment that you identified on the Hardware Selection Page.

Ending IP Address for Pool

The last IP address assigned to the InfiniBand network for this deployment. This address is automatically calculated from the starting IP address and the pool size.

Ensure that all of the IP addresses are available for use in the pool defined by the starting and ending addresses. If they are not available, then you can either assign a different range or manually change individual IP addresses on the Review and Edit Details Page.

Subnet Mask

The subnet mask for the InfiniBand network. The default is 255.255.252.0.

BDA will be connected via InfiniBand to any Oracle engineered systems

Select this option if you are connecting this rack to another rack through the InfiniBand fabric.

When connecting multiple racks, ensure the following:

  • The InfiniBand IP addresses of all servers are unique, including the servers in other Oracle engineered systems.

  • All InfiniBand IP addresses are on the same network.

For example, if you connect an Oracle Big Data Appliance rack to Oracle Exadata Database Machine, then you must use the same netmask on the InfiniBand networks for both systems. Moreover, after you apply this netmask to the InfiniBand IP addresses of the Exadata database servers, the Exadata storage servers, and the Oracle Big Data Appliance servers, all IP addresses are in the same subnet.


4.12 General Network Properties Page

The client and administrative networks typically use the same Domain Name System (DNS) and Network Time Protocol (NTP) servers. If they are different on your networks, then enter the values for the client network first.

The following table describes the general network properties.

Table 4-7 General Network Properties Page

General Network Properties Field Description

DNS Servers

Up to six IP addresses for the DNS servers. At least one DNS server must be accessible on the client network.

DNS servers are not required on the administrative network, although Oracle Big Data Appliance uses them if they are available.

NTP Servers

Up to six IP addresses for the NTP servers. Both the client network and the administrative network must have access to at least one NTP server.

The NTP servers for the administrative network can be different from the NTP servers for the client network. If they are, then identify the NTP servers for the client network in this field.

Search Domains

Up to six domain names in which Oracle Big Data Appliance operates, such as example.com and us.example.com

Are administrative host name entries in DNS?

Select Yes or No:

  • Yes: Administrative host name DNS entries are validated during preinstall checks and network configuration.

  • No: Administrative host name DNS entries are not validated during preinstall checks and network configuration.


The next table describes the network properties for the administrative network if they are different from the client network. Typically, these properties are the same for both networks. They default to the values you entered for the general network properties.

Table 4-8 Advanced Network Properties

Advanced Network Properties Field Description

Advanced Network Configuration

Select this option if the client and administrative networks are isolated on your system and use different DNS and NTP servers, different domains, or both. You can then complete the fields for the administrative network.

Admin DNS Servers

Up to four IP addresses for the administrative Domain Name System server, if they are different from the client network.

Admin NTP Servers

Up to four IP addresses for the administrative Network Time Protocol server, if they are different from the client network.

Admin Search Domains

Up to four domain names in which Oracle Big Data Appliance administrative network operates, if they are different from the client network.


4.13 Review and Edit Details Page

Use this page to review and modify the network configuration settings.

If you specified a range of IP addresses for any of the networks that includes addresses already in use, then replace those IP addresses on this page. Otherwise, the network configuration of Oracle Big Data Appliance will fail, causing unnecessary delays. Then click Regenerate using changed base values.

4.14 Define Clusters Page

Use the define clusters page to identify the number of clusters to create and the servers that compose each cluster. You can configure clusters for either CDH or Oracle NoSQL Database.

You can configure multiple clusters in a single rack, or a single cluster can span multiple racks. Each CDH cluster must have at least six servers, and each Oracle NoSQL Database cluster must have at least three servers. Thus, a starter rack supports one CDH cluster, a starter rack with one in-rack expansion supports up to two CDH clusters, and a full rack supports up to three CDH clusters.

The following table describes the cluster definition choices.

Table 4-9 Define Clusters Page

Define Clusters Field Description

Number of clusters to create

Select the number of clusters. For each cluster, a new tab appears on the page, and a new page appears in Oracle Big Data Appliance Configuration Generation Utility. Be sure to complete all tabs before continuing to the next page.

Cluster Name

Enter a unique name for the cluster. The name must begin with a letter and can consist of alphanumeric characters, underscores, (_) and dashes (-).

Cluster Type

Choose the type of cluster:

  • CDH cluster: Installs Cloudera's Distribution including Apache Hadoop and optional software on cluster of new servers

  • NoSQL DB cluster: Installs Oracle NoSQL Database on a cluster of new servers

  • Adding to existing cluster: Installs the same software on the new servers as the rest of the cluster.

Unassigned Servers

From the list on the left, select the servers for the cluster and move them to the list of assigned servers on the right.

Assigned Servers

Lists the servers selected for the cluster. A CDH cluster must have a minimum of six servers, and an Oracle NoSQL Database cluster must have a minimum of three servers. All clusters must be composed of multiples of three servers.


4.15 Cluster Page

Select the software to install on this cluster. The fields displayed on this field depend on the type of cluster being configured:

4.15.1 Adding to an Existing Cluster

You are done with the software configuration. The Mammoth utility configures the software for the new servers in the same way as the other servers in the cluster.

See "Adding Servers to a Cluster."

4.15.2 A New Oracle NoSQL Database Cluster

The following table describes the User/Groups fields for an Oracle NoSQL Database cluster. Passwords are optional, but you must enter them during the software installation if you do not provide them here.

Table 4-10 User /Groups for a New Oracle NoSQL Database Cluster

User/Groups Field Description

OS password for root user

The root password on all servers in the cluster.

OS password for oracle user

The oracle password on all servers in the cluster. Oracle applications run under this identity.

oracle user ID

The ID number of the oracle user. It must match the oracle UID of a connected Oracle Exadata Database Machine. The UID ensures that the oracle user can log in from Oracle Big Data Appliance to the correct account in Oracle Database. Required.

oinstall group ID

The ID number of the Oracle Inventory Group (oinstall). It must match the oinstall group ID of a connected Oracle Exadata Database Machine.

dba group ID

The ID number of the dba group. It must match the dba group ID of a connected Oracle Exadata Database Machine.

Oracle NoSQL Database Edition

Choose between Community Edition and Enterprise Edition:

  • Community Edition is included in the license for Oracle Big Data Appliance.

  • Enterprise Edition requires a separate license. You must have this license to install Enterprise Edition on Oracle Big Data Appliance.


4.15.3 A New CDH Cluster

The cluster page for new CDH clusters has the following sections:

4.15.3.1 User/Groups

The following table describes the user name, groups, and password fields for a new CDH cluster. Passwords are optional, but you must enter them during the software installation if you do not provide them here.

Table 4-11 User /Groups for a New CDH Cluster

User/Groups Field Description

OS password for root user

The root password on all servers in the cluster.

OS password for oracle user

The oracle password on all servers in the cluster. Oracle applications run under this identity.

oracle user ID

The ID number of the oracle user. It must match the oracle UID of a connected Oracle Exadata Database Machine. The UID ensures that the oracle user can log in from Oracle Big Data Appliance to the correct account in Oracle Database. Required.

oinstall group ID

The ID number of the Oracle Inventory Group (oinstall). It must match the oinstall group ID of a connected Oracle Exadata Database Machine.

dba group ID

The ID number of the dba group. It must match the dba group ID of a connected Oracle Exadata Database Machine.

Cloudera Manager admin password

The password for the admin user for Cloudera Manager.

MySQL admin password

The password for the MySQL Database administrative user.


4.15.3.2 Installed Components

You can install Oracle Big Data Connectors on a CDH cluster. You must have a separate license for this product. The following table describes the installed components field.

Table 4-12 Installed Components

Component Field Description

Are Big Data Connectors licensed?

Oracle Big Data Connectors facilitate data access between data stored in the CDH cluster and Oracle Database. The connectors require a separate license. If you have a license, choose Yes.

Install Oracle Data Integrator Agent?

The agent supports Oracle Data Integrator Application Adapter for Hadoop, which is one of the Oracle Big Data Connectors.To configure Oracle Data Integrator for use immediately, choose Yes.

You must have a license for Oracle Big Data Connectors.

MySQL password for Oracle Data Integrator Agent?

The password for the Oracle Data Integrator user in MySQL Database.


4.15.3.3 Kerberos

Kerberos authentication is a security option for CDH clusters. It is included with your Oracle Big Data Appliance license.

To use a key distribution center (KDC) elsewhere on the network (that is, not on Oracle Big Data Appliance), you must complete several steps before installing the software. See "Installation Prerequisites."

The following table describes the Kerberos fields.

Table 4-13 Kerberos

Kerberos Field Description

Enable Kerberos-based authentication?

Select this option to support Kerberos on Oracle Big Data Appliance.

Set up key distribution center on BDA

Choose Yes to set up a key distribution center (KDC) on Oracle Big Data Appliance. Otherwise, a KDC must always be available on the network to all clients.

Kerberos KDC database password

A password for the KDC database, if it is being created on Oracle Big Data Appliance.

Non-BDA key distribution center hosts

List the fully qualified names or the IP addresses of the KDCs, available on the same network, that can serve as either the primary or backup KDC for Oracle Big Data Appliance.

Kerberos realm

Enter the name of the realm for Oracle Big Data Appliance, such as EXAMPLE.COM.

Enable network encryption

Select this option to protect your data as it travels over the network.


4.15.3.4 Audit Vault

You can configure CDH clusters on Oracle Big Data Appliance as secured targets for Oracle Audit Vault and Database Firewall. The Audit Vault plug-in on Oracle Big Data Appliance collects audit and logging data from MapReduce, HDFS, and Oozie services. You can then use Audit Vault Server to monitor these services on Oracle Big Data Appliance.

Oracle Audit Vault and Database Firewall Server Release 12.1.1 or later must be up and running on a separate server on the same network as Oracle Big Data Appliance before you perform the actual configuration.

The following table describes the Audit Vault fields.

Table 4-14 Audit Vault

Audit Vault Field Description

Enable Audit Vault

Select this option to support Oracle Audit Vault and Database Firewall on Oracle Big Data Appliance.

Audit Vault server

The IP address of the Audit Vault server.

Audit Vault port

The port number that Audit Vault Server listens on.

Audit Vault database service name

The database service name for Audit Vault Server.

Audit Vault admin user

The name of the Audit Vault administrative user.

Audit Vault admin user password

The password for the administrative user.


4.15.3.5 Auto Service Request

ASR monitors the health of Oracle Big Data Appliance hardware and automatically submits a service request when it detects a fault. Although you can opt out of this program, Oracle recommends that you enable ASR.

ASR Manager must be installed and configured to run on a separate server outside of Oracle Big Data Appliance before the software is installed and configured on Oracle Big Data Appliance. The software installation fails with an error if Enable Auto Service Request is selected, but ASR Manager is not accessible using the specified host address and port number. The Mammoth utility does not install ASR Manager.

The software on Oracle Big Data Appliance must be able to connect to ASR Manager. ASR Manager must be able to route to the Internet, either directly or through a proxy, to send event information that automatically opens service requests.

The following table describes the Auto Service Request fields.

Table 4-15 Auto Service Request

ASR Field Description

Enable Auto Service Request

Select this option to support Auto Service Request.

ASR Manager Host Name

The fully qualified name or the IP address of a Linux server on the network where ASR will be installed

ASR Manager Port

The port number for ASR Manager. The default port is 162.

ASR Server Root Password

Password for root on the ASR Manager host


4.15.3.6 Enterprise Management Cloud Control

The Mammoth utility deploys and validates agents on Oracle Big Data Appliance that Enterprise Manager uses to monitor the appliance. Mammoth does not install Oracle Enterprise Manager Cloud Control.

Before you can configure Oracle Big Data Appliance for the Enterprise Manager system monitoring plugin, you must install and configure Enterprise Manager to run on a separate server outside of Oracle Big Data Appliance. The Oracle Big Data Appliance software installation fails with an error if you choose the Enterprise Manager option, but Enterprise Manager is not installed and accessible using the specified host address, port numbers, and so forth.

The following table describes the Enterprise Manager Cloud Control fields.

Table 4-16 Oracle Enterprise Manager Cloud Control

Cloud Control Field Description

Enable Oracle Enterprise Manager Cloud Control Agent

Select this option to use the Oracle Enterprise Manager system monitoring plugin.

OMS Host Name

The fully qualified name or the IP address of the server where Oracle Management Server (OMS) is installed with the plugin for Oracle Big Data Appliance.

OMS HTTPS Console Port

The port number for the Oracle Enterprise Manager Cloud Control web interface.

To obtain the HTTPS port numbers, use an emctl status oms -details command from the Enterprise Manager host.

OMS HTTPS Upload Port

The HTTP upload port number for Oracle Enterprise Manager Cloud Control web interface.

EM Super Admin User

A Cloud Control user with super-administrative privileges to perform administrative emcli commands. Typically, this user is sysman.

EM Super Admin Password

Password for the Cloud Control user name.

EM Agent Registration Password

The password for validating the Oracle Management agents on Oracle Big Data Appliance.

The Agent Registration password is part of the security setup of Enterprise Manager. To obtain the password in Enterprise Manager, click Setup at the top right of the window, Security, and then Registration Passwords.

Cloud Control SYS password

The SYS password for the Cloud Control repository.

Inventory location

The full path of the oraInventory directory for the system where Oracle Enterprise Manager is installed.


4.15.3.7 Email Alerting

Cloudera Manager sends email alerts when it detects a problem in the CDH cluster.

The following table describes the email alert fields.

Table 4-17 Email Alerting Page

Email Alerting Field Description

SMTP Server

The fully qualified name or the IP address of the existing SMTP server that the company uses on its internal network. Required.

Uses SSL

Select Yes if a Secure Sockets Layer (SSL) connection is required.

SMTP Port

The port number used by the email server

Requires Authentication

Select this option if your SMTP server requires authentication. You can then enter a user name and a password.

SMTP User Name

User name for Cloudera Manager to log in to the SMTP server.

This field is hidden when authentication not selected.

SMTP Password

Password for the user name.

This field is hidden when authentication is not selected.

Recipient Addresses

The email addresses of users who need to get alerts from Cloudera Manager. Click this button to display the Email Alert Recipients dialog box. Then enter each email address on a separate line. Required.

The field to the right indicates the number of email addresses entered in the dialog box.


4.16 Complete Page

You have now set all the installation and configuration options. Click Back to return to a page and change its settings. The Back button does not clear the pages; your settings remain unless you change them.

The text box on this page provides a place for you to record any notes that might be useful at a later date. They are saved in a file named master.xml, which you can use to reload these configuration settings into Oracle Big Data Appliance Configuration Generation Utility.

To generate the configuration files, click Create Files and click Yes in response to the prompt. An operating system window automatically opens in the directory where the files are saved.