Skip Headers
Oracle® Big Data Appliance Owner's Guide
Release 1 (1.0.3)

Part Number E25960-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

4 Using the Oracle Big Data Appliance Configuration Utility

This chapter describes how to use Oracle Big Data Appliance Configuration Utility. It contains the following topics:

Note:

An Oracle representative typically completes the Oracle Big Data Appliance Configuration Utility from information provided by the customer in the Oracle Big Data Appliance Configuration Worksheets.

Overview of Oracle Big Data Appliance Configuration Utility

The information entered in the Oracle Big Data Appliance Configuration Utility is used to generate the installation and deployment files. After you enter values into the utility, the information is validated. Then the utility generates the files for Oracle Big Data Appliance.

The utility is implemented as a spreadsheet containing these worksheets:

Using Oracle Big Data Appliance Configuration Utility

This section explains how to use the Oracle Big Data Appliance Configuration Utility. It contains these topics:

Using Oracle Open Office Calc

You must use Oracle Open Office Calc 3.3 to configure the spreadsheet. Do not use other spreadsheet programs like Excel, which can modify the spreadsheet but not generate the files.

To obtain the Oracle Big Data Appliance Configuration Utility, refer to My Oracle Support Note 1434477.1.

To open the Oracle Big Data Appliance Configuration Utility: 

  1. Download Open Office from this website and follow the instructions for installing it.

    http://www.openoffice.org/

  2. Open Oracle Open Office Calc with bda_configurator.ods. If the current settings do not allow macros, you see an error message.

  3. To change the macro setting:

    1. From the Tools menu, choose Options.

    2. In the navigation tree, expand the Oracle Open Office folder and select Security.

    3. In the right pane, click Macro Security.

    4. Either lower the security level or enter a trusted source.

    5. Save your changes and reload the spreadsheet.

  4. To turn off AutoCorrect:

    1. From the Tools menu, choose AutoCorrect Options.

    2. Select the Options tab.

    3. Clear all check boxes, then click OK.

    AutoCorrect settings can make it difficult for you to enter passwords.

Generating the Configuration Files

This procedure describes how to use Oracle Big Data Appliance Configuration Utility to customize the default configuration settings for your installation. The other sections in this chapter provide detailed information on each field in the spreadsheet.

To generate the configuration files: 

  1. Open the spreadsheet with Oracle Open Office Calc as described in the previous procedure. The Welcome sheet opens.

  2. Click Next to edit the Network Configuration sheet.

  3. Enter the network configuration settings as specified in the Oracle Big Data Appliance Configuration Worksheets.

  4. Click Next. If your changes are invalid, then you see an error message. You must correct the errors before continuing to the Software Configuration sheet.

    To discard your changes, click Reset.

  5. Enter the software configuration settings as specified in the Oracle Big Data Appliance Configuration Worksheets.

  6. Click Preview to view the configuration settings defined by your entries. To make any changes, either click Previous or click the tab for a particular sheet. You must click Preview on the Software Configuration sheet for the changes to appear on the Preview sheet.

  7. When you are satisfied with the configuration, click Save Configuration on the Preview sheet to generate the configuration files.

    This step does not save the worksheet. To save your changes, click the Save icon.

  8. Choose a location for the configuration files in the Select Path dialog box. The files are created in a directory named bda-customer_name/rack_name in that location, such as bda-Example Inc/bda1.

  9. If you are configuring multiple racks as a single CDH cluster, then you are done. Otherwise, generate separate configuration files for every set of racks that will be configured as a single CDH cluster.

  10. Provide the network administrators and others at the site with a copy of the Configuration Templates to verify that the configuration is correct.

About the Configuration Files

The Oracle Big Data Appliance Configuration Utility generates three files to use when configuring the system:

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. See "Checking for Network Errors" for instructions on running this script.

BdaDeploy.json

Contains the network configuration. Copy this file to a USB drive for copying to Oracle Big Data Appliance. See "Configuring the Network".

mammoth-rack_name.params

Contains all information provided in the spreadsheet, including the network configuration, plus port numbers, default user names, and passwords. Copy this file to a USB drive for copying to Oracle Big Data Appliance. See "Using the Mammoth Utility".

bda-install-template.pdf

Reproduces the Preview page of the spreadsheet in a printable format. This Installation Template is for the network administrator and others to verify the settings and make any last minute corrections.

Figure 4-1 shows part of the first page of the Installation Template.

Figure 4-1 Installation Template

Description of Figure 4-1 follows
Description of "Figure 4-1 Installation Template"

Checking for Network Errors

After providing the host names and IP addresses for the components of Oracle Big Data Appliance, the network administrator must add them to a name server.

Run the preinstall-checkip.sh script at these points in the installation process:

  • Before Oracle Big Data Appliance arrives at the site but after the network administrator has added the new names and IP addresses to the name server. This step ensures the network configuration parameters are valid and the network is ready to accept Oracle Big Data Appliance connections.

  • After Oracle Big Data Appliance arrives but before it is connected to the network to assure that the network has not changed and it is still ready to accept Oracle Big Data Appliance connections.

To check the network for conflicts: 

  1. Copy the preinstall-checkip.sh script to any Linux system with a 10 GB Ethernet connection to the subnet on which Oracle Big Data Appliance will be deployed.

  2. Ensure the script is executable:

    chmod +x preinstall-checkip.sh
    
  3. Execute the script:

    ./preinstall-checkip.sh
    
  4. If the script identifies errors, open the bda-checkip.out file for details. It contains information about every test the script performed. The output file is created in the same directory as the script.

  5. Resolve the conflicts if possible before proceeding.

    If you are unable to resolve all IP address conflicts between the existing network and Oracle Big Data Appliance, then you can proceed without connecting to the network up to "Configuring the Network". The procedures take longer to complete because of time-outs from attempts to connect to configured services such as Domain Name System (DNS) and NTP.

Example 4-1 shows success and error messages from preinstall-checkip.sh.

Example 4-1 Output from preinstall-checkip.sh

Big Data Appliance pre-installation network verification starting ...
 
Using name server 198.51.100.21 for all DNS lookups
 
Domain is example.com
 
Processing DNS name servers : SUCCESS
Processing NTP time servers : SUCCESS
Processing gateways : SUCCESS
Processing factory IP addresses : SUCCESS
Processing public node names (bondeth0) : SUCCESS
Processing private IP addresses (bondib0) : ERROR - see bda-checkip.out for details
Processing admin node names (eth0) : SUCCESS
Processing ILOM names : SUCCESS
Processing switch and PDU IP addresses : SUCCESS
Processing ASR hostname : SUCCESS
 
One or more checks report ERROR. Review bda-checkip.out for details

Network Configuration

Table 4-1 describes the general rack properties.

Table 4-1 Naming and Locale Information

Spreadsheet Field Description

Cluster Name

The name of the CDH cluster. Required.

Rack Name

The name of the Oracle Big Data Appliance Rack. By default, the rack name is derived from the cluster name, so that a CDH cluster named bda has racks named bda1, bda2, and so forth.

Server Base Name

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

The Rack Name and Server Base Name are used to generate the host names for all network interfaces: eth0, bondib0, bondeth0, and ILOM. For example, a cluster name of bda and a server base name of node results in host names of bda1node01, bda1node02, and so forth.

Admin Access Suffix

Suffix to the basic host name to form the bondeth0 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 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 bda02sw-ip, bda02sw-ib1, and so forth.

Customer Name

Name of the enterprise. Required.

Domain Name

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

Region

Region in which the Oracle Big Data Appliance is located. Click the field, then click the arrow for a list of regions.

Time Zone

Time zone for your installation. You must select a region before selecting the time zone. Click the field, then click the arrow for a list of time zones for your region.

Is this the only or primary rack in the cluster?

Yes or no. Required.


Table 4-2 describes the network properties for the entire rack.

Table 4-2 Network Properties

Spreadsheet Field Description

DNS Servers

Up to four IP addresses for the Domain Name Server.

NTP Servers

Up to four IP addresses for the Network Time Protocol Server.

Search Domains

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


Table 4-3 describes the network properties for individual servers in the rack. You specify the IP addresses assigned to server 01. Sequential numbers are assigned automatically to the other 17 servers. Ensure that ranges of 18 IP addresses are free for each type of access. If 18 sequential IP addresses are not available, then you can edit the output files generated by the Oracle Big Data Appliance Configuration Utility.

Table 4-3 Server Properties

Spreadsheet Field Description

Administrative - eth0

First IP address of 18 from the management network

Private - bondib0

First IP address of 18

Client Access - bondeth0

First IP address of 18 from the client access network

ILOM

First IP address of 18 from the management network


Table 4-4 describes the network properties for all switches. You configure the switches manually, as described in Chapter 8, "Configuring Oracle Big Data Appliance."

Table 4-4 Switch Properties

Spreadsheet Field Description

KVM Switch IP

IP address of the KVM switch

Cisco Switch IP

IP address of the Cisco switch

First InfiniBand Switch IP

First IP address of three for the InfiniBand switches


Table 4-5 describes the network properties for the power distribution units (PDUs). You configure the PDUs manually, as described in Chapter 8, "Configuring Oracle Big Data Appliance."

Table 4-5 PDU Properties

Spreadsheet Field Description

PDU A

IP address of the first power distribution unit

PDU B

IP address of the second power distribution unit


Software Configuration

Table 4-6 describes the optional software available for Oracle Big Data Appliance. For more information about these components, see the Oracle Big Data Appliance Software User's Guide.

Table 4-6 Installed Components

Spreadsheet 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 is a required component of Oracle Data Integrator, which is a graphical tool for performing extraction, transformation, and loading (ETL) of data into Oracle Database. To configure Oracle Data Integrator for use immediately, choose Yes.

Install Oracle NoSQL Database Community Edition?

Oracle NoSQL Database is a distributed key-value database that provides a storage option to Hadoop Distributed File System (HDFS). To configure Oracle NoSQL Database for use, choose Yes.

Total disk space to allocate for Oracle NoSQL Database in Terabytes

If you install Oracle NoSQL Database, you can allocate 54 or 108 TB for its use. Disk space allocated to Oracle NoSQL Database is not available for HDFS.

External backup NFS directory

The address of an NFS shared directed used to store a backup of the name node data. Enter the address in the form nfs-host:/remote/shared/path, where nfs-host is the fully qualified host name and /remote/shared/path is the directory path. The hdfs user must have write permission on this directory. See Step 11, "SetupMountPoints" for details on setting up this directory.


Table 4-7 describes the options for Auto Service Request (ASR). This service monitors the health of Oracle Big Data Appliance hardware. ASR Manager automatically submits a service request to Oracle Support Services when it detects a fault. See Chapter 14, "Maintaining Oracle Big Data Appliance," for more information about ASR.

Table 4-7 Oracle Auto Service Request

Spreadsheet Field Description

Enable Auto Service Request?

Although you can opt out of this service, Oracle strongly recommends that you enable ASR by choosing Yes.

ASR Manager Host

The fully qualified name 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.


Table 4-8 identifies the users, groups, and passwords that can be set during the software installation. If you leave the passwords blank, then the installation prompts for them. The Oracle IDs must match those of a connected Oracle Exadata Database Machine to support Network File System (NFS) protocol.

Table 4-8 Users /Groups

Spreadsheet Field Description

Cloudera Manager admin password

The password for the admin user for Cloudera Manager.

root operating system password

The root password on all servers in Oracle Big Data Appliance.

oracle operating system password

The oracle password on all servers in Oracle Big Data Appliance. Oracle applications run under this identity.

oracle user ID

The ID number of the oracle user. It must match the oracle user ID of a connected Oracle Exadata Database Machine.

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.

MySQL administration password

The password for the MySQL Database administrative user.

MySQL password for Oracle Data Integrator

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


Table 4-9 describes the configuration settings for the email server that Cloudera Manager uses to send alerts from the CDH cluster.

Table 4-9 Cloudera Manager Email Alerts

Spreadsheet Field Description

Email Server (SMTP) Host

The fully qualified name of the existing SMTP server the company uses on its internal network.

Email Server (SMTP) Port

The port used by the email server.

Email Server (SMTP) User Name

User name for Cloudera Manager to use for authentication on the SMTP server.

Email Server (SMTP) Password

Password for the user name.

Email Server uses SSL?

Yes or no.

Email Alert Recipients

One or more email addresses. These users receive the alerts from Cloudera Manager.