5 Using Oracle Exadata Deployment Assistant
This chapter describes how to use the Oracle Exadata Deployment Assistant, which is not only used for Exadata but also Zero Data Loss Recovery Appliance and other Oracle Engineered Systems. The information that you enter in it is used to create the Recovery Appliance configuration files. These files work with installation utility to automate the installation process.
Overview of Oracle Exadata Deployment Assistant
Use Oracle Exadata Deployment Assistant (OEDA) to specify the system configuration details and drive the system configuration processes.
OEDA provides a graphical user interface to gather your configuration details and create the ZDLRA Rack configuration file. The configuration file drives the automated installation and configuration processes for ZDLRA Rack.
Note:
For ease of reading, ZDLRA Rack is used when information refers to both Recovery Appliance and Oracle Exadata Storage Expansion Rack.You can also use the OEDA command-line interface (OEDACLI) to perform ZDLRA Rack life-cycle management tasks.
You can download the latest version of OEDA from Exadata Database Machine and Exadata Storage Server Supported Versions (Doc ID 888828.1). OEDA is also available on Oracle Technology Network.
In addition to ZDLRA Rack, OEDA is also used for Oracle Zero Data Loss Recovery Appliance and Oracle SuperCluster.
Oracle Exadata System Software release 19.1.0 introduced the Web-based interface for OEDA. However, the overall process, described here, is the same regardless of whether you use the Web-based or Java-based user interface.
- Before your engineered system arrives, do the
following:
- Work with your network and database administrators to evaluate the current network settings, such as current IP address use and network configuration.
- Define the settings for the rack, such as network configuration and backup method.
- Download the latest version of OEDA from Oracle Technology Network.
- Unzip and run the configuration script on a supported platform, and select the type of system to configure.
- Go through every page in OEDA and supply values for all required fields. You cannot advance to the next page if you do not supply all of the required values. You must provide naming details and DNS, NTP, and networking details.
-
At the end of the dialogue with OEDA, configuration files are generated on the client. The files are also listed at the bottom of the
InstallationTemplate.html
file that is generated by OEDA. Depending on your engineered system and configuration, OEDA generates all or some of the following files:databasemachine.xml
CustomerName-rackname.xml
CustomerName-rackname-preconf_GUID.csv
CustomerName-rackname-InstallationTemplate.html
CustomerName-rackname-platinum.csv
CustomerName-rackname-checkip.sh
CustomerName-rackname.zip
pkey_GUID.csv
andpkey_racknamehostname_GUID.csv
— if you enabled InfiniBand partitioning for your virtual environments
The
CustomerName-hostname.zip
file contains all the generated files. - Review the
InstallationTemplate.html
file to check the entire configuration and verify all information was entered correctly.
- Shortly before your engineered system arrives, or is scheduled to be configured, validate the network configuration, as directed by Oracle. See Verifying the Network Configuration Prior to Configuring the Rack.
- After your engineered system arrives, the configuration files are copied to a database server, and the validation and installation is completed. See unresolvable-reference.html#GUID-01C85D18-A5AE-4285-97C3-DE246FC0BE79.
Accessibility Note: If you are using Oracle Exadata Deployment Assistant with assistive technology (for accessibility) on Windows, you need to enable Java Access Bridge.
Considerations and Requirement for Using OEDA
Review this information before using Oracle Exadata Deployment Assistant (OEDA).
-
Recovery Appliance ships with the Oracle Linux operating system installed on the servers.
-
The rack prefix is used to generate host names for all components. For example, if you specify
dbm0
for the rack prefix:- The database server host names are like
dbm0db01
- The storage server host names are like
dbm0cel01
- The InfiniBand Network Fabric
switch names are like
dbm0sw-iba1
- The RoCE Network Fabric switch
names are like
dbm0sw-rocea1
Note:
The rack prefix can contain a maximum of 20 letters and numbers. Spaces and symbols are not permitted; for example, exclamation (!), hyphen (-), and so on.In you have multiple racks, then, each rack prefix should be a unique value that identifies the rack. Oracle recommends using
dbm01
for the first rack,dbm02
for the second,dbm03
for the third, and so on. - The database server host names are like
-
The backup method and redundancy protection levels you use determine how to size the Oracle Automatic Storage Management (Oracle ASM) disk groups that are created during installation.
-
If you configure internal backups, then the database backups are created on disk in the Fast Recovery Area in the RECO disk group for the database. The Fast Recovery Area also contains Archived Redo Logs and Flashback Log Files. The division of disk space between the DATA disk group and the RECO disk group is 40% and 60%, respectively.
-
If you configure external backups, then database backups are created on disk or tape media that is external to currently deployed Recovery Appliance. The Fast Recovery Area contains only objects such as Archived Redo Logs and Flashback Log Files.
-
-
A valid time zone name is required when installing Recovery Appliance. Time zone values provided for Recovery Appliance and Oracle Linux comes from the Time Zone Database. You must specify a valid time zone name for each server using the
TZ
environment variable. The variable value is of the form Area/Location. For example,America/New_York
is a validTZ
value;EST
,EDT
, andUTC-4
are invalid values.
Related Topics
Getting Started with the OEDA Browser-based User Interface
The OEDA application server is available for Linux, OSX and Windows.
Note:
The OEDA Web-based user interface does not support Oracle SuperCluster. Instead, use
the configssc.sh
command.
The Oracle Exadata Deployment Assistant (OEDA) Web-based user interface is available starting with the October 2018 OEDA release. The OEDA Web-based interface can import previous OEDA XML configuration files created with the Java-based version of OEDA.
Note:
The OEDA Web-based interface is supported only on Chrome and Firefox browsers.
To set up the OEDA application server and start the Web-based user interface, perform the following steps.
-
Download the latest OEDA release from My Oracle Support note 888828.1 and copy the archive to the system where you want to run the OEDA application server.
-
On the system where you want to run the OEDA application server, extract the contents of the downloaded compressed file. The extracted contents is written to a directory based on the operating system, such as
linux-x64
,macosx-x64
, orwindows-i586
. This is referred to as the OEDA_HOME directory. -
On the system where you want to run the OEDA application server, install a signed SSL certificate.
-
Launch the OEDA application server.
Before you can use the Web-based user interface, you must install and run the OEDA application server. Choose from the following options depending on your circumstances:
-
If the system has Internet connectivity, then run the
installOedaServer
program located in the OEDA_HOME directory.-
On Linux, OSX, and UNIX run:
./installOedaServer.sh [-p port-number] [-g] [-proxy proxy-host-name:proxy-port-number]
-
On Microsoft Windows run:
installOedaServer.cmd [-p port-number] [-g] [-proxy proxy-host-name:proxy-port-number]
In the command:
-
-p port-number
— optionally specifies the port number for the OEDA application server.If not specified, the default port number is
7072
. However, you can specify any unused port number. It is not recommended to use port numbers less than1024
. -
-g
— optionally specifies that the OEDA application server accepts connections on all available network interfaces.If not specified, the OEDA application server only listens on the localhost interface (
127.0.0.1
). -
-proxy proxy-host-name:proxy-port-number
— optionally specifies the proxy server details for Internet connectivity.The proxy server details are specified using a colon-separated string where:
- proxy-host-name is the proxy server host name or IP address.
- proxy-port-number is the proxy server port number.
You can run the
installOedaServer
program using a non-privileged OS user account. You do not need to be logged in as an OS administrator.When you run the
installOedaServer
program, previous OEDA application server instances are stopped and removed before starting the latest OEDA application server version. -
-
If Internet connectivity is limited, use the
packageOfflineOeda
program to download and stage the required OEDA code packages.Afterward, you can run the
installOedaServer
program to launch the OEDA application server without requiring an Internet connection.OEDA contains the
packageOfflineOeda
program starting with the April 2021 release.-
On Linux, OSX, and UNIX run:
./packageOfflineOeda.sh [-proxy proxy-host-name:proxy-port-number]
-
On Microsoft Windows run:
packageOfflineOeda.cmd [-proxy proxy-host-name:proxy-port-number]
In the command,
-proxy proxy-host-name:proxy-port-number
optionally specifies the proxy server details for Internet connectivity. LikeinstallOedaServer
, the proxy server details are specified using a colon-separated string containing the proxy server host name or IP address, followed by the proxy server port number. -
-
If Internet connectivity or a signed SSL certificate is unavailable on the target system, then you can prepare the target system to run the OEDA application server, as follows:
-
Download and extract the latest OEDA release on another Internet-connected system with a signed SSL certificate.
-
On the Internet-connected system, run the
packageOfflineOeda
program download and stage the required OEDA code packages. -
Copy the following directories and files to the target system:
-
If the Internet-connected system and the target system share the same operating system (OS), then copy the entire OEDA_HOME directory and its contents to the target system.
-
If the Internet-connected system uses a different OS than the target system, then copy the
webApp
subdirectory and its contents to the OEDA_HOME directory on the target system.
-
Afterward, you can run the
installOedaServer
program on the target system to launch the OEDA application server without requiring an Internet connection. -
-
-
Access the OEDA Web-based user interface.
After you start the OEDA application server, you can access the Web-based interface by opening a browser and entering the following URL:
http://host-name:port-number/oeda
In the URL:
-
host-name is the application server host name.
-
port-number is the network port number that you specified when starting the
installOedaServer
program. For example,7072
.
If you did not specify the
-g
option when starting the OEDA application server, then you must run the browser on the same host as the OEDA application server and specifylocalhost
as the application server host name. -
Using the Browser-based Version of Oracle Exadata Deployment Assistant
Use the deployment assistant for initial configuration, and when adding to an existing deployment. You can import an existing configuration when adding new racks or components.
Have the following available before running the deployment assistant:
- IP addresses
- Machine names
- DNS information
- NTP information for the rack
The following options are available from the OEDA drop-down Menu:
- About: View version information for OEDA.
- New: Start a new configuration.
- Import: Import an existing configuration file. The file format is XML.
- Command Console: Opens a command console for the OEDA command-line interface (OEDACLI).
- Save: Save the current configuration to an XML file.
- Diagnostics: Creates a ZIP file that can be used to troubleshoot and diagnose issues with the OEDA Web interface.
- Preferences: Specify your preferences for how the Web interface behaves.
- Validate: Check the current configuration for completeness and correctness.
- CheckIp: Checks the IP addresses.
- Installation Template: Generates the Installation Template report, which summarizes the current configuration.
- Help: Describes the options and controls provided in the OEDA Web interface.
The following list describes the configuration flow in the OEDA Web interface. Use the Help menu option to display details about the options and controls provided in the OEDA Web interface.
- Select the hardware for the deployment on the Select Hardware page. Also provide customer information on this page.
- Enter the management network and private network information on the Rack Networks page.
- Specify the user and group configuration on the Users page. You can choose between Default, Role Separated, or a Custom configuration.
- Define the clusters on the Clusters page for each cluster.
- Define the disk group layout on the Diskgroups page.
- Specify the Oracle Database home information for each Oracle home on the Create Database Home page.
- Specify databases and their attributes on the Create Database page.
-
Enter the client and backup network information on the Cluster Networks page.
If an ingest network or replication network is needed, specify their information on the Cluster Networks page.
- Configure the email alerts, SNMP alerts, Auto Service Request, Oracle Config Manager, and Enterprise Manager alerting on the Alerting page.
- Answer the configuration questionnaire and provide additional information about the deployment in the text field on the Comments page. Information entered in this field appears at the bottom of the
InstallationTemplate.html
file. - Click Save and Download to create the configuration files. You are prompted to choose a location in which to save a ZIP file to your local computer.
- Copy the ZIP file to a directory on the first database server in Oracle Exadata Rack. Use a subdirectory of
/u01
, such as the/u01/oeda
directory. These files are used by the field engineer to configure the Oracle Exadata Rack.