Oracle Exadata Database Service Cloudcustomer
Oracle Exadata Database Service Cloudcustomer
F41226-58
November 2022
Oracle Exadata Exadata Database Service on Cloud@Customer Administrator's Guide,
F41226-58
Contributors: Abhilash Gudasi, Akhila Prabhu, Alan Williams, Alexander Prince Mathew, Ankit Mahale, Ankur
Raina, Ankur Sinha, Ashutosh Chetal, Barb Lundhild, Behkam Aminzadeh, Bhargavi Amancharla, Bob
Thome, Boming Zhang, Brad Nowrouzi, Bryce Cracco, Charan Chaudary Lekkalapudi, Cynthia Varela, David
Jimenez Alvarez, Douglas Williams, Gabriel Melendez, Gorev Khanna, Guruprasad Hegde, Jai Krishnani,
Jean-Francois Verrier, Jose Ricardo Ortiz Olivares, Karina Ledesma, Kishore Sridhar, Kris Bhanushali,
Lakshmi Sneha Kandukuri, Lisa Grant, Luqman, Manini Chattopadhyay, Manish Mahawar, Manish Shah,
Manu Sinha, Mark Bauer, Michael Fitch, Monika Gupta, Namratha Mandya Subramanya, Nayana Vishwa,
Neil Hebert, Nishith Pandey, Nithin Kovoor, Omar Briseno Safa, Oscar Gallegos, Pablo Sainz Albanez, Peter
Fusek, Peter Liu, Peter Sciarra, Pradeep Bhat, Pravin Jha, Raj Ojha, Ranganath Srirangapatna
Ramachandra, Rhonda Day, Robert Greene, Rodrigo Gonzalez Alba, Rohan Anand, Rudregowda
Mallegowda, Sanjay Narvekar, Santosh Uttam Bobade, Saravanan Sabapathy, Sarita Nori, Sheila Ray,
Shravan Thatikonda, Smitha Gurunathakrishnan, Somnath Lahiri, Sonali Purdhani, Syam Vasa, Tammy
Bednar, Terence Buencamino, Tushar Pandit, Vedavathi Eagala, Vedika Joshi, Vira Goorah, Vivek Nama,
Vrishali Hajare, Xiao Pan, Youngju Cho
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software, software documentation, data (as defined in the Federal Acquisition Regulation), or related
documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S.
Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software,
any programs embedded, installed, or activated on delivered hardware, and modifications of such programs)
and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government end
users are "commercial computer software," "commercial computer software documentation," or "limited rights
data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental
regulations. As such, the use, reproduction, duplication, release, display, disclosure, modification, preparation
of derivative works, and/or adaptation of i) Oracle programs (including any operating system, integrated
software, any programs embedded, installed, or activated on delivered hardware, and modifications of such
programs), ii) Oracle computer documentation and/or iii) other Oracle data, is subject to the rights and
limitations specified in the license contained in the applicable contract. The terms governing the U.S.
Government's use of Oracle cloud services are defined by the applicable contract for such services. No other
rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
Oracle®, Java, and MySQL are registered trademarks of Oracle and/or its affiliates. Other names may be
trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are
used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Epyc,
and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered
trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise
set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be
responsible for any loss, costs, or damages incurred due to your access to or use of third-party content,
products, or services, except as set forth in an applicable agreement between you and Oracle.
Contents
iii
Control Plane Server (CPS) Offline Diagnostic Report 2-9
Enhanced Infrastructure Maintenance Controls 2-10
Manage Pluggable Databases on Exadata Cloud@Customer 2-11
Allow Customers to Choose Data Guard Type 2-11
Specify the Same SID for Primary and Standby Databases in a Data Guard Association 2-11
Specify db_unique_name and SID for Primary and Standby Databases in Data Guard
Association 2-12
VM Cluster Node Subsetting 2-12
X9M-2 System Support 2-13
Customize SCAN Listener Port 2-13
Creating DG Association/Standby Database Using Existing Database Home 2-14
Upgrading Oracle Grid Infrastructure on an Exadata Cloud@Customer VM Cluster 2-14
Updating Guest VM Operating System 2-14
Upgrading Oracle Databases 2-15
Download Network Validation Report 2-15
Elastic Storage Expansion 2-15
Oracle Database Software Images 2-16
Exadata Cloud@Customer Infrastructure Patching Automation 2-17
Customer Maintenance Contacts 2-17
X8M-2 System Support 2-18
Enable and Manage Data Guard Associations 2-18
Oracle Exadata Cloud@Customer Deployment Assistant 2-19
Oracle Grid Infrastructure and Oracle Database Patching 2-19
Per-Second Billing for OCPU Usage 2-20
Shared Database Home Resource Tags 2-20
Create and Manage Multiple Virtual Machines per Exadata System (MultiVM) 2-21
Scale OCPUs Without Cloud Connectivity 2-21
Configure Oracle Database Character Set and National Character Set 2-22
Specify a Time Zone While Provisioning Oracle Exadata Database Service on
Cloud@Customer Infrastructure 2-22
Shared Database Homes for Oracle Exadata Database Service on Cloud@Customer 2-23
X7-2 System Support 2-24
iv
Receiving, Unpacking, and Access for Oracle Exadata Database Service on
Cloud@Customer Racks 3-4
Flooring for Oracle Exadata Database Service on Cloud@Customer Racks 3-5
Electrical Power for Oracle Exadata Database Service on Cloud@Customer Racks 3-5
Temperature and Humidity Ranges for Oracle Exadata Database Service on
Cloud@Customer 3-7
Ventilation for Oracle Exadata Database Service on Cloud@Customer Racks 3-8
Network Requirements for Oracle Exadata Database Service on Cloud@Customer 3-9
Network Requirements for Oracle Exadata Database Service on Cloud@Customer 3-9
Data Center Network Services for Exadata Database Service on Cloud@Customer 3-15
IP Addresses and Subnets for Exadata Database Service on Cloud@Customer 3-16
Uplinks for Exadata Database Service on Cloud@Customer 3-17
Network Cabling for Exadata Database Service on Cloud@Customer 3-18
Establish a Secure Connection Between Your CPS and OCI Using OCI’s FastConnect
Service 3-18
Storage Configuration Requirements for Oracle Exadata Database Service on
Cloud@Customer 3-21
About Storage Configuration for Oracle Exadata Database Service on
Cloud@Customer 3-22
Allocation of Storage Space Options on Oracle Exadata Storage Servers 3-22
Allocation Proportions for DATA, RECO and SPARSE Disk Groups 3-23
Virtual Machine File System Structure for Exadata Cloud@Customer 3-24
Checklists for Exadata Database Service on Cloud@Customer Deployments 3-24
System Components Checklist for Exadata Database Service on Cloud@Customer 3-25
Data Center Room Checklist for Exadata Database Service on Cloud@Customer 3-25
Data Center Environment Checklist for Oracle Exadata Database Service on
Cloud@Customer 3-26
Access Route Checklist for Oracle Exadata Database Service on Cloud@Customer 3-26
Facility Power Checklist for Oracle Exadata Database Service on Cloud@Customer 3-27
Safety Checklist for Oracle Exadata Database Service on Cloud@Customer 3-27
Logistics Checklist for Exadata Database Service on Cloud@Customer 3-28
Network Configuration Checklist for Oracle Exadata Database Service on
Cloud@Customer 3-29
Reracking Checklist for Oracle Exadata Database Service on Cloud@Customer 3-29
v
Step 1: Pre-Installation 4-9
Step 2: Onsite Installation 4-10
Step 3: Post-Installation 4-10
Overview of Elastic Storage Expansion 4-10
Using the Console to Provision Exadata Database Service on Cloud@Customer
Infrastructure 4-13
Using the Console to Create Oracle Exadata Database Service on Cloud@Customer
Infrastructure 4-14
Enabling or Disabling the Control Plane Server Diagnostic Offline Report 4-19
Viewing the Control Plane Server Diagnostic Offline Report 4-20
Using the Console to View Exadata Infrastructure Network Configuration Details 4-20
Using the Console to Edit Oracle Exadata Database Service on Cloud@Customer
Infrastructure Networking Configuration 4-20
Using the Console to Download a File Containing Configuration Data 4-23
Using the Console to Activate Exadata Database Service on Cloud@Customer
Infrastructure 4-23
Using the Console to Check the Status of Exadata Database Service on
Cloud@Customer Infrastructure 4-24
Configuring Oracle-Managed Infrastructure Maintenance 4-25
About Oracle Managed Exadata Cloud@Customer Infrastructure Maintenance Updates 4-25
Overview of the Quarterly Infrastructure Maintenance Process 4-26
Infrastructure Maintenance Contacts 4-28
Using the Console to Configure Oracle-Managed Infrastructure Updates 4-28
View or Edit Quarterly Infrastructure Maintenance Preferences for Exadata
Cloud@Customer Infrastructure 4-29
View or Edit a Scheduled Quarterly Maintenance for Exadata Cloud@Customer
Infrastructure 4-31
View the Maintenance History of Exadata Cloud@Customer Infrastructure 4-33
Monitor Infrastructure Maintenance Using Lifecycle State Information 4-33
Receive Notifications about Your Infrastructure Maintenance Updates 4-34
Creating First VM Cluster Network on Exadata Cloud@Customer 4-35
About Managing VM Cluster Networks on Exadata Database Service on
Cloud@Customer 4-35
Using the Console to Create a VM Cluster Network 4-36
Using the Console to Edit a VM Cluster Network 4-39
Using the Console to Download a File Containing the VM Cluster Network
Configuration Details 4-40
Using the Console to Validate a VM Cluster Network 4-41
Provisioning the First VM Cluster on an Exadata Cloud@Customer System 4-41
About Managing VM Clusters on Exadata Database Service on Cloud@Customer 4-42
Prerequisites for VM Clusters on Exadata Database Service on Cloud@Customer 4-42
Using the Console to Create a VM Cluster 4-42
Creating Database Backup Destinations for Exadata Cloud@Customer 4-47
vi
About Managing Backup Destinations for Exadata Database Service on
Cloud@Customer 4-48
Prerequisites for Backup Destinations for Exadata Database Service on
Cloud@Customer 4-49
Using the Console for Backup Destinations for Exadata Database Service on
Cloud@Customer 4-50
Using the Console to Create a Backup Destination 4-50
Using the Console to Edit a Backup Destination 4-52
Using the Console to Move a Backup Destination to Another Compartment 4-53
Using the Console to Delete a Backup Destination 4-53
Creating First Database Home on an Exadata Database Service on Cloud@Customer
System 4-54
About Creating Oracle Database Homes on an Exadata Database Service on
Cloud@Customer System 4-54
Using the Console to Create Oracle Database Home on Exadata Database Service on
Cloud@Customer 4-55
Using the API to Create Oracle Database Home on Exadata Cloud@Customer 4-56
Creating First Database on an Exadata Database Service on Cloud@Customer System 4-57
Prerequisites and Limitations for Creating and Managing Oracle Databases on Oracle
Exadata Database Service on Cloud@Customer 4-57
Oracle Database Releases Supported by Oracle Exadata Database Service on
Cloud@Customer 4-58
About Provisioning and Configuring Oracle Databases on Oracle Exadata Database
Service on Cloud@Customer 4-58
Using the Console to Create a Database 4-59
Connecting to an Exadata Database Service on Cloud@Customer System 4-64
Connecting to a Virtual Machine with SSH 4-64
Prerequisites for Connecting to an Exadata Database Service on
Cloud@Customer System 4-65
Connecting to a Virtual Machine from a Microsoft Windows System Using PuTTY 4-65
Accessing a Database After You Connect to the Virtual Machine 4-66
Connecting from a Unix-Style System 4-68
Connecting to a Database with Oracle Net Services 4-68
Using Oracle Net Services to Connect to a Database 4-68
Prerequisites for Connecting to a Database with Oracle Net Services 4-69
Connecting to a Database Using SCAN 4-69
Connecting to a Database Using a Node Listener 4-71
5 How-to Guides
Connect to the Exadata Database Service on Cloud@Customer Service 5-2
Connecting to a Virtual Machine with SSH 5-2
Prerequisites for Connecting to an Exadata Database Service on
Cloud@Customer System 5-3
vii
Connecting to a Virtual Machine from a Microsoft Windows System Using PuTTY 5-3
Connecting from a Unix-Style System 5-4
Accessing a Database After You Connect to the Virtual Machine 5-5
Connecting to a Database with Oracle Net Services 5-6
Using Oracle Net Services to Connect to a Database 5-6
Prerequisites for Connecting to a Database with Oracle Net Services 5-7
Connecting to a Database Using SCAN 5-7
Connecting to a Database Using a Node Listener 5-9
Manage Exadata Database Service on Cloud@Customer Infrastructure 5-10
About Provisioning Oracle Exadata Database Service on Cloud@Customer Systems 5-11
Overview of Elastic Storage Expansion 5-11
Using the Console to Provision Exadata Database Service on Cloud@Customer
Infrastructure 5-14
Using the Console to Create Oracle Exadata Database Service on
Cloud@Customer Infrastructure 5-15
Using the Console to View Exadata Infrastructure Network Configuration Details 5-20
Using the Console to Edit Oracle Exadata Database Service on Cloud@Customer
Infrastructure Networking Configuration 5-21
Using the Console to Download a File Containing Configuration Data 5-23
Using the Console to Activate Exadata Database Service on Cloud@Customer
Infrastructure 5-23
Using the Console to Check the Status of Exadata Database Service on
Cloud@Customer Infrastructure 5-24
Using the Console to Scale Infrastructure Compute and Storage 5-25
Using the Console to Download Scale Infrastructure Compute and Storage
Configuration File 5-25
Using the Console to Activate New Database and Storage Servers 5-26
Using the Console to Make Storage Capacity from New Server Available for VM
Clusters Consumption 5-26
Using the Console to View Details of Exadata Cloud@Customer Infrastructure with
Scaled Compute and Storage Capacity 5-27
Using the Console to Move Exadata Database Service on Cloud@Customer
Infrastructure 5-28
Using the Console to Delete Exadata Database Service on Cloud@Customer
Infrastructure 5-28
Using the Console to Manage Tags for Your Exadata Cloud@Customer Resources 5-29
Managing Infrastructure Maintenance Contacts 5-29
Using the API to Manage Exadata Cloud@Customer Infrastructure 5-32
Configure Oracle-Managed Infrastructure Maintenance 5-33
About Oracle Managed Exadata Cloud@Customer Infrastructure Maintenance Updates 5-33
Overview of the Quarterly Infrastructure Maintenance Process 5-34
Overview of Monthly Security Maintenance 5-36
Infrastructure Maintenance Contacts 5-37
Using the Console to Configure Oracle-Managed Infrastructure Updates 5-38
viii
View or Edit Quarterly Infrastructure Maintenance Preferences for Exadata
Cloud@Customer Infrastructure 5-39
View or Edit a Scheduled Quarterly Maintenance for Exadata Cloud@Customer
Infrastructure 5-41
View or Edit a Scheduled Security Maintenance for Exadata Cloud@Customer
Infrastructure 5-43
View the Maintenance History of Exadata Cloud@Customer Infrastructure 5-43
View and Edit Quarterly Maintenance While Maintenance is In Progress or Waiting
for Custom Action 5-44
Monitor Infrastructure Maintenance Using Lifecycle State Information 5-46
Receive Notifications about Your Infrastructure Maintenance Updates 5-47
Using the API to Manage Exadata Cloud@Customer Infrastructure Maintenance
Controls 5-47
Manage VM Cluster Networks 5-48
About Managing VM Cluster Networks on Exadata Database Service on
Cloud@Customer 5-48
Using the Console to Create a VM Cluster Network 5-49
Using the Console to View SCAN Listener Port Configured 5-52
Using the Console to Edit a VM Cluster Network 5-52
Using the Console to Download a File Containing the VM Cluster Network
Configuration Details 5-54
Using the Console to Validate a VM Cluster Network 5-54
Using the Console to Download Network Validation Report 5-55
Using the Console to Terminate a VM Cluster Network 5-56
Using the Console to Add Another DB Server to the VM Cluster Network 5-57
Using the Console to Remove DB Servers from a VM Cluster Network 5-58
Manage VM Clusters 5-58
About Managing VM Clusters on Exadata Database Service on Cloud@Customer 5-59
Overview of VM Cluster Node Subsetting 5-59
Overview of Health Metrics and Log Collection 5-60
Incident Logs and Trace Files 5-61
Health Metrics 5-66
Introduction to Scale Up or Scale Down Operations 5-72
Scaling Up or Scaling Down the VM Cluster Resources 5-72
Calculating the Minimum Required Memory 5-73
Calculating the ASM Storage 5-74
Estimating How Much Local Storage You Can Provision to Your VMs 5-76
Scaling Local Storage Down 5-78
Using the Console to Manage VM Clusters on Exadata Cloud@Customer 5-78
Using the Console to Create a VM Cluster 5-79
Using the Console to Enable, Partially Enable, or Disable Diagnostics Collection 5-84
Using the Console to Add VMs to a Provisioned Cluster 5-85
Using the Console to View a List of DB Servers on an Exadata Infrastructure 5-86
ix
Using the Console to Remove a VM from a VM Cluster 5-87
Using the Console to Update the License Type on a VM Cluster 5-87
Using the Console to Add SSH Keys After Creating a VM Cluster 5-88
Using the Console to Scale the Resources on a VM Cluster 5-88
Using the Console to Stop, Start, or Reboot a VM Cluster Virtual Machine 5-90
Using the Console to Check the Status of a VM Cluster Virtual Machine 5-91
Using the Console to Move a VM Cluster to Another Compartment 5-91
Using the Console to Terminate a VM Cluster 5-92
Using the API to Manage Exadata Cloud@Customer VM Clusters 5-92
Manage Oracle Database Software Images 5-93
Creation and Storage of Database Software Images 5-94
Using a Database Software Image with an Exadata Cloud@Customer System 5-95
Using the Console to Create a Database Software Image 5-96
Using the OPatch lsinventory Command to Verify the Patches Applied to an Oracle
Home 5-96
Using the Console to Delete a Database Software Image 5-97
Using the Console to View the Patch Information of a Database Software Image 5-97
Using the Console to Move Database Software Image to a Different Compartment 5-98
Using the API for Managing Oracle Database Software Images 5-98
Create Oracle Database Homes on an Exadata Database Service on Cloud@Customer
System 5-99
About Creating Oracle Database Homes on an Exadata Database Service on
Cloud@Customer System 5-99
Using the Console to Create Oracle Database Home on Exadata Database Service on
Cloud@Customer 5-99
Using the API to Create Oracle Database Home on Exadata Cloud@Customer 5-101
Manage Oracle Database Homes on Exadata Database Service on Cloud@Customer
Systems 5-101
About Managing Oracle Database Homes on Exadata Database Service on
Cloud@Customer Systems 5-102
Manage Database Home Using the Console 5-102
Using the Console to View Information About an Oracle Database Home 5-102
Using the Console to Delete an Oracle Database Home 5-103
Using the API to Manage Oracle Database Home on Exadata Database Service on
Cloud@Customer 5-103
Differences Between Managing Resources with dbaascli and the Database API 5-104
Manage Databases on Exadata Database Service on Cloud@Customer 5-105
Prerequisites and Limitations for Creating and Managing Oracle Databases on Oracle
Exadata Database Service on Cloud@Customer 5-105
Oracle Database Releases Supported by Oracle Exadata Database Service on
Cloud@Customer 5-106
About Provisioning and Configuring Oracle Databases on Oracle Exadata Database
Service on Cloud@Customer 5-106
x
Using the Console to Manage Databases on Oracle Exadata Database Service on
Cloud@Customer 5-107
Using the Console to Create a Database 5-108
Using the Console to Move a Database to Another Database Home 5-112
Using the Console to Terminate a Database 5-113
Using the API to Manage Oracle Database Components 5-113
Changing the Database Passwords 5-114
To Change the SYS Password for an Exadata Database Service on
Cloud@Customer Database 5-115
To Change Database Passwords in a Data Guard Environment 5-115
To Change the TDE Wallet Password for an Exadata Database Service on
Cloud@Customer Database 5-115
Manage Pluggable Databases on Exadata Database Service on Cloud@Customer 5-116
Pluggable Database Operations 5-116
Manage Database Backup and Recovery on Oracle Exadata Database Service on
Cloud@Customer 5-126
Backup Destinations 5-127
About Managing Backup Destinations for Exadata Database Service on
Cloud@Customer 5-127
Prerequisites for Backup Destinations for Exadata Database Service on
Cloud@Customer 5-128
Using the Console for Backup Destinations for Exadata Database Service on
Cloud@Customer 5-129
Using the API to Manage Exadata Cloud@Customer Backup Destinations 5-133
Oracle Database Backup Methods in Exadata Cloud 5-133
Oracle Managed Backup 5-134
User Configured Backup 5-147
Configuring and Customizing Backups with bkup_api 5-155
Customizing Backup Settings by Using a Generated Configuration File 5-156
Customizing Which System Files Are Backed Up 5-162
Customizing Which Database Configuration Files Are Backed Up 5-163
Creating an On-Demand Backup by Using the bkup_api Utility 5-164
Disabling Automatic Backups to Facilitate Manual Backup and Recovery Management 5-166
Customizing Real Time Redo Transport (RTRT) Behavior for Recovery Appliance
Backups 5-168
Alternative Backup Methods 5-169
Recovering a Database Using Oracle Recovery Manager (RMAN) 5-170
Patch and Update an Exadata Database Service on Cloud@Customer System 5-171
Perform User Managed Maintenance Updates 5-171
Patching and Updating an Exadata Database Service on Cloud@Customer System 5-171
Patching and Updating VM Clusters and Database Homes 5-172
Updating Guest VM Operating System 5-178
Upgrading Oracle Grid Infrastructure on an Exadata Cloud@Customer VM Cluster 5-181
xi
Upgrading Oracle Databases 5-184
Patching and Updating an Exadata Database Service on Cloud@Customer System
Manually 5-189
Updating Software Manually 5-190
Updating the Guest VM Operating System Manually 5-190
Use Oracle Data Guard with Exadata Database Service on Cloud@Customer 5-200
About Using Oracle Data Guard with Exadata Database Service on Cloud@Customer 5-200
Prerequisites for Using Oracle Data Guard with Exadata Database Service on
Cloud@Customer 5-201
Compute Nodes 5-201
Password 5-201
Working with Data Guard 5-201
Switchover 5-202
Failover 5-202
Reinstate 5-202
Using the Console to Manage Oracle Data Guard Associations 5-202
Using the Console to Enable Data Guard on an Exadata Database Service on
Cloud@Customer System 5-203
Using the Console To View and Edit Data Guard Associations 5-206
Using the Console To Perform a Database Switchover 5-207
Using the Console To Perform a Database Failover 5-207
Using the Console To Reinstate a Database 5-208
Using the Console To Terminate a Data Guard Association on an Exadata
Database Service on Cloud@Customer System 5-208
Using the API to Manage Data Guard Associations on an Exadata Database Service
on Cloud@Customer System 5-209
Migrate to Exadata Database Service on Cloud@Customer 5-209
Moving to Oracle Cloud Using Zero Downtime Migration 5-210
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata
Database Service on Cloud@Customer Gen2 Infrastructure 5-210
Scope for Exadata Cloud@Customer Gen1 to Gen2 Out-of-Place Cloud Upgrade 5-211
Hardware and Software Required for Out-of-Place Cloud Upgrade to New Exadata
Cloud@Customer Gen2 Infrastructure 5-212
Using Oracle Zero Downtime Migration (ZDM) to Migrate Oracle Databases 5-213
During Out-of-Place Cloud Upgrade to New Exadata Cloud@Customer Gen2
Infrastructure 5-218
Post Out-of-Place Cloud Upgrade to New Exadata Cloud@Customer Gen2
Infrastructure 5-218
Best Practices for Out-of-Place Cloud Upgrade to New Exadata Cloud@Customer
Gen2 Infrastructure 5-219
xii
Configure Non-Default SCAN Listener Ports 6-2
Clone an Autonomous Database Across Exadata Infrastructure Within the Same
Region 6-3
Character Set Selection 6-3
Enhanced Resource Tracking for Autonomous Database 6-3
Longer Database Name 6-6
Create a New Autonomous Database Instance from Backup 6-6
Multiple Autonomous VM Cluster Support 6-7
Automatic Failover with a Standby Autonomous Container Database 6-8
X9M-2 System Support 6-8
Fractional OCPU and GB Storage 6-8
Autonomous Data Guard Enabled Autonomous Database and Oracle Key Vault (OKV)
Integration 6-9
Infrastructure Patching 6-9
Access Control List (ACL) to Restrict Access to Autonomous Data Guard Enabled
Autonomous Databases 6-9
ADB-D on Exadata Cloud@Customer: Monitor Performance with Autonomous
Database Metrics 6-10
ADB-D on Exadata Cloud@Customer: Autonomous Data Guard 6-10
Access Control List (ACL) to Restrict Access to Autonomous Databases 6-10
Oracle Key Vault (OKV) Integration 6-11
X8M-2 System Support 6-11
Per-Second Billing for Autonomous Database OCPU Usage 6-11
Oracle Autonomous Database on Oracle Exadata Database Service on
Cloud@Customer 6-11
Introduction to ADB-D on Exadata Cloud@Customer 6-12
Database System Architecture Overview 6-12
Resource Types 6-12
Deployment Order 6-13
User Roles 6-14
Available Exadata Infrastructure Hardware Shapes 6-14
Access Control Lists (ACLs) for ADB-D on Exadata Cloud@Customer 6-16
Managing Autonomous Exadata VM Clusters 6-17
About Autonomous Exadata VM Clusters 6-17
Create an Autonomous Exadata VM Cluster 6-18
View a List of Autonomous Exadata VM Clusters 6-21
View Details of an Autonomous Exadata VM Cluster 6-21
Schedule Oracle-Managed Infrastructure Updates 6-22
Set the Automatic Maintenance Schedule for Autonomous Exadata VM Cluster 6-22
View or Edit the Time of the Next Scheduled Maintenance for Autonomous
Exadata VM Cluster 6-23
View the Maintenance History of Autonomous Exadata VM Cluster 6-23
Change the License Type on an Autonomous VM Cluster 6-24
xiii
Move an Autonomous Exadata VM Cluster to Another Compartment 6-24
Terminate an Autonomous Exadata VM Cluster 6-24
Using the API to Manage Autonomous Exadata VM Clusters 6-25
Managing Encryption Keys on External Devices 6-25
About Oracle Key Vault 6-26
Overview of Key Store 6-26
Required IAM Policy for Managing OKV on Oracle Exadata Database Service on
Cloud@Customer 6-27
Tagging Resources 6-27
Moving Resources to a Different Compartment 6-27
Setting Up Your Exadata Cloud@Customer to Work With Oracle Key Vault 6-28
Step 1: Create a Vault in OCI Vault Service and Add a Secret to the Vault to Store
OKV REST Administrator Password 6-29
Step 2: Create a Dynamic Group and a Policy Statement for Key Store to Access
Secret in OCI Vault 6-29
Step 3: Create a Dynamic Group and a Policy Statement for Exadata Infrastructure
to Key Store 6-30
Step 4: Create a Policy Statement for Database Service to Use Secret from OCI
Vault Service 6-30
Step 5: Create Key Store 6-31
Managing Your Key Store 6-32
View Key Store Details 6-32
Edit Key Store Details 6-32
Move a Key Store to Another Compartment 6-33
Delete a Key Store 6-33
View Key Store Associated Autonomous Container Database Details 6-33
Using the API to Manage Key Store 6-33
Managing Autonomous Container Databases 6-34
Create an Autonomous Container Database 6-35
View a List of Autonomous Container Databases 6-37
View the List of Autonomous Container Databases in an Autonomous Exadata VM
Cluster 6-37
View the List of Autonomous Container Databases in a Compartment 6-38
View Details of an Autonomous Container Database 6-38
Rotate CDB Encryption Key 6-38
Change the Backup Retention Policy of an Autonomous Container Database 6-39
Change the Maintenance Schedule of an Autonomous Container Database 6-40
Restart an Autonomous Container Database 6-40
Move an Autonomous Container Database to Another Compartment 6-41
Terminate an Autonomous Container Database 6-41
Using the API to Manage Autonomous Container Databases 6-42
Managing Autonomous Databases 6-42
Create an Autonomous Database 6-43
xiv
Manage Access Control List of an Autonomous Database 6-46
View a List of Autonomous Databases 6-47
View Details of an Autonomous Database 6-47
Rotate ADB Encryption Key 6-47
Set the Password of an Autonomous Database's ADMIN User 6-48
Scale the CPU Core Count or Storage of an Autonomous Database 6-49
Enable or Disable Auto Scaling for an Autonomous Database 6-50
Move an Autonomous Database to Another Compartment 6-51
Stop or Start an Autonomous Database 6-51
Restart an Autonomous Database 6-52
Back Up an Autonomous Database Manually 6-52
Restore an Autonomous Database 6-53
Restore from a Backup 6-53
Restore to a Point in Time 6-54
Clone an Autonomous Database 6-54
Clone an Autonomous Database Backup 6-57
Clone a Standby Database 6-61
Clone a Standby Database Backup 6-64
Terminate an Autonomous Database 6-67
API to Manage Autonomous Databases 6-68
Monitor Performance with Autonomous Database Metrics 6-68
View Top Six Metrics for an Autonomous Database 6-69
View Aggregated Metrics for Autonomous Databases in a Compartment 6-69
Autonomous Database Metrics and Dimensions 6-70
Connecting to Autonomous Databases 6-70
Download the Wallet for an Autonomous Database 6-71
Get the APEX and SQL Developer Web URLs for an Autonomous Database 6-72
Patching ADB on Exadata Cloud@Customer Infrastructure 6-72
Overview of ADB on Exadata Cloud@Customer Infrastructure Patching 6-73
Specifying When Maintenance Can Occur 6-73
Specifying What Kind of Patches to Apply 6-74
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer 6-74
Enabling Autonomous Data Guard on an Autonomous Container Database 6-74
Create an Autonomous Data Guard Enabled Autonomous Container Database 6-75
View Details of a Data Guard Enabled Primary or Standby Autonomous Container
Database 6-79
Rotate CDB Encryption Key 6-79
Managing a Standby Autonomous Container Database 6-79
Perform a Failover to Standby Autonomous Container Database 6-81
Perform a Switchover to Standby or Primary Autonomous Container Database 6-81
Reinstate Data Guard Enabled Standby Autonomous Container Database 6-82
xv
Terminate a Data Guard Enabled Primary Autonomous Container Database 6-82
Terminate a Data Guard Enabled Standby Autonomous Container Database 6-83
Operations Performed Using the APIs 6-83
Enabling Autonomous Data Guard on an Autonomous Database 6-84
View Autonomous Data Guard Enablement 6-85
Create an Autonomous Data Guard Enabled Autonomous Database 6-85
View Details of a Data Guard Enabled Primary or Standby Autonomous Database 6-87
Rotate ADB Encryption Key 6-88
Maintenance Scheduling and Patching Data Guard Enabled Autonomous Container
Database 6-88
Configure Automatic Maintenance Schedule for a Data Guard Enabled
Autonomous Container Database 6-88
View the Next Scheduled Maintenance Run of a Data Guard Enabled Autonomous
Container Database 6-90
View the Maintenance History of a Data Guard Enabled Autonomous Container
Database 6-90
Immediately Patch a Data Guard Enabled Autonomous Container Database 6-91
Reschedule or Skip scheduled Maintenance for Data Guard Enabled Autonomous
Container Database 6-91
Using Performance Hub to Analyze Database Performance 6-92
Performance Hub Features 6-92
Time Range Selector 6-93
Time Zone Selector 6-94
ASH Analytics Tab 6-94
SQL Monitoring Tab 6-94
Blocking Sessions Tab 6-95
Using the Oracle Cloud Infrastructure Console 6-95
Navigate to Performance Hub in the Oracle Cloud Infrastructure Console Interface
of an Autonomous Database 6-95
View the Average Active Sessions Data by a Selected Dimension 6-95
Filter Average Active sessions Data 6-96
View the SQL Monitoring Report 6-97
View the Blocking and Waiting Sessions 6-97
xvi
To Change the SYS Password for an Exadata Database Service on
Cloud@Customer Database 7-8
To Change Database Passwords in a Data Guard Environment 7-8
To Change the TDE Wallet Password for an Exadata Database Service on
Cloud@Customer Database 7-9
Managing Exadata Database Service on Cloud@Customer Software Images Using the
Dbaascli Utility 7-9
Listing Available Software Images and Versions for Database and Grid
Infrastructure 7-9
To download a software image 7-11
Patching Oracle Grid Infrastructure and Oracle Databases Using dbaascli 7-12
Patching Databases using dbaascli 7-12
Patching Oracle Grid Infrastructure 7-14
Listing Available Software Images and Versions for Database and Grid
Infrastructure 7-15
Performing a Precheck Before Patching Databases and Grid Infrastructure 7-17
Resuming or Rolling Back a Patching Operation 7-19
Updating Cloud Tooling Using dbaascli 7-21
Release Notes 7-22
Release 22.3.1.1.0 (221003) 7-22
Release 22.3.1.0.1 (220831) 7-23
Release 22.2.1.1.0 (220713) 7-23
Release 22.2.1.0.1 (220504) 7-24
Release 22.1.1.1.0 (220301) 7-25
Release 22.1.1.0.1 (220223) 7-25
Release 21.4.1.1.0 7-26
Release 21.3.1.2.0 7-27
Release 21.3.1.1.0 7-27
Release 21.3.1.0.1 7-27
Release 21.2.1.x.x 7-28
dbaascli Command Reference 7-29
dbaascli admin updateStack 7-34
dbaascli cpuscale get_status 7-34
dbaascli cpuscale update 7-35
dbaascli cswlib deleteLocal 7-36
dbaascli cswlib download 7-36
dbaascli cswlib listLocal 7-37
dbaascli cswlib showImages 7-38
dbaascli database addInstance 7-38
dbaascli database backup 7-39
dbaascli database bounce 7-40
dbaascli database changepassword 7-41
xvii
dbaascli database convertToPDB 7-42
dbaascli database create 7-43
dbaascli database delete 7-45
dbaascli database deleteInstance 7-45
dbaascli database duplicate 7-47
dbaascli database getPDBs 7-48
dbaascli database modifyParameters 7-49
dbaascli database move 7-49
dbaascli database recover 7-50
dbaascli database runDatapatch 7-51
dbaascli database start 7-52
dbaascli database stop 7-53
dbaascli database upgrade 7-53
dbaascli dataguard prepareStandbyBlob 7-55
dbaascli dataguard updateDGConfigAttributes 7-55
dbaascli dbhome create 7-55
dbaascli dbHome delete 7-56
dbaascli dbhome getDatabases 7-56
dbaascli dbHome getDetails 7-57
dbaascli dbHome patch 7-57
dbaascli diag collect 7-58
dbaascli diag healthCheck 7-59
dbaascli grid configureTCPS 7-60
dbaascli grid patch 7-61
dbaascli grid rotateTCPSCert 7-62
dbaascli grid upgrade 7-63
dbaascli job getStatus 7-64
dbaascli patch db apply 7-65
dbaascli patch db prereq 7-65
dbaascli pdb backup 7-66
dbaascli pdb bounce 7-67
dbaascli pdb close 7-68
dbaascli pdb connectString 7-69
dbaascli pdb create 7-69
dbaascli pdb delete 7-71
dbaascli pdb getDetails 7-71
dbaascli pdb list 7-72
dbaascli pdb localClone 7-73
dbaascli pdb open 7-74
dbaascli pdb recover 7-74
dbaascli pdb relocate 7-75
xviii
dbaascli pdb remoteClone 7-76
dbaascli system getDBHomes 7-79
dbaascli tde addSecondaryHsmKey 7-79
dbaascli tde changePassword 7-80
dbaascli tde enableWalletRoot 7-80
dbaascli tde encryptTablespacesInPDB 7-81
dbaascli tde fileToHsm 7-82
dbaascli tde getHsmKeys 7-83
dbaascli tde getMkidForKeyVersionOCID 7-84
dbaascli tde getPrimaryHsmKey 7-84
dbaascli tde hsmToFile 7-85
dbaascli tde listKeys 7-86
dbaascli tde removeSecondaryHsmKey 7-87
dbaascli tde setKeyVersion 7-88
dbaascli tde setPrimaryHsmKey 7-89
dbaascli tde status 7-89
Monitoring and Managing Exadata Storage Servers with ExaCLI 7-90
About the ExaCLI Command 7-90
Exadata Storage Server Username and Password 7-91
ExaCLI Command 7-91
Connecting to a Storage Server with ExaCLI 7-97
Oracle Exadata Database Service on Cloud@Customer Events 7-98
About Event Types on Exadata Cloud@Customer 7-99
Exadata Infrastructure Event Types 7-100
VM Cluster Network Event Types 7-102
VM Cluster Event Types 7-103
Backup Destination Event Types 7-105
Database Node Event Types (Cloud@Customer) 7-106
Database Home Event Types (Cloud@Customer) 7-107
Database Event Types (Cloud@Customer) 7-108
Database and Grid Infrastructure Patching Event Types 7-109
Autonomous VM Cluster Event Types 7-112
Autonomous Container Database Event Types 7-116
Autonomous Database Event Types 7-117
Data Guard Event Types 7-118
Autonomous Data Guard Association Event Types 7-121
Key Store Event Types 7-125
Exadata Cloud@Customer Infrastructure Maintenance Event Types 7-126
Storage Expansion Event Types 7-144
Database Software Images Event Types 7-146
Database Upgrade Event Types 7-155
xix
Pluggable Database Event Types 7-162
VM Node Subsetting Event Types 7-164
Database Service Events 7-168
Overview of Database Service Events 7-168
Receive Notifications about Database Service Events 7-171
Database Service Event Types 7-172
Temporarily Restrict Automatic Diagnostic Collections for Specific Events 7-183
Remediation 7-187
Compute Expansion Event Types 7-204
Policy Details for Exadata Database Service on Cloud@Customer 7-208
About Resource-Types 7-209
Resource-Types for Exadata Database Service on Cloud@Customer 7-209
Supported Variables 7-210
Details for Verb + Resource-Type Combinations 7-211
Database-Family Resource Types 7-212
exadata-infrastructures 7-212
vmcluster-networks 7-213
vmclusters 7-214
backup-destinations 7-215
db-nodes 7-216
db-homes 7-217
databases 7-218
backups 7-219
database-software-image 7-219
autonomous-vmclusters 7-220
autonomous-container-databases 7-221
autonomous-databases 7-222
key-stores 7-223
pluggable-databases (PDBs) 7-223
dbServers 7-224
Permissions Required for Each API Operation 7-225
Managing Exadata Resources with Oracle Enterprise Manager Cloud Control 7-231
Overview of Oracle Enterprise Manager Cloud Control 7-231
Features of Enterprise Manager Cloud Control 7-232
Security Guide for Exadata Database Service on Cloud@Customer Systems 7-232
Security Configurations and Default Enabled Features 7-233
Responsibilities 7-233
Guiding Principles Followed for Security Configuration Defaults 7-233
Security Features 7-235
Guest VM Default Fixed Users 7-236
Guest VM Default Security Settings 7-238
xx
Guest VM Default Processes 7-239
Guest VM Network Security 7-240
Additional Procedures for Updating Security Posture 7-242
Customer Responsibilities 7-242
Enabling Additional Security Capabilities 7-243
Troubleshooting Exadata Database Service on Cloud@Customer Systems 7-247
Patching Failures on Exadata Database Service on Cloud@Customer Systems 7-247
Determining the Problem 7-248
Troubleshooting and Diagnosis 7-248
Obtaining Further Assistance 7-249
Collecting Cloud Tooling Logs 7-250
Collecting Oracle Diagnostics 7-250
VM Operating System Update Hangs During Database Connection Drain 7-250
Adding a VM to a VM Cluster Fails 7-252
Nodelist is not Updated for Data Guard-Enabled Databases 7-252
CPU Offline Scaling Fails 7-253
xxi
1
Exadata Database Service on
Cloud@Customer Overview
This topic is an overview of the Exadata Database Service on Cloud@Customer service.
• Oracle Exadata Database Service on Cloud@Customer Service Description
Learn how you can leverage the combined capabilities of Oracle Exadata and Oracle
Cloud Infrastructure with Oracle Exadata Database Service on Cloud@Customer
• Exadata Cloud Management Interfaces
Exadata Database Service on Cloud@Customer provides a variety of management
interfaces to fit your use case and automation needs.
Note:
For information related to the ADB-D service on Exadata Cloud@Customer please
refer to Autonomous Database on Exadata Cloud@Customer.
1-1
Chapter 1
Oracle Exadata Database Service on Cloud@Customer Service Description
Related Topics
• Autonomous Database on Exadata Cloud@Customer
Note:
For more information on technical architecture, see Oracle Exadata
Cloud@Customer (ExaC@C) Technical Architecture.
1-2
Chapter 1
Oracle Exadata Database Service on Cloud@Customer Service Description
capacity of your Oracle Exadata system, there is no set maximum for the number of
databases that you can create.
Related Topics
• Overview of the Database Service
• Oracle Exadata Cloud@Customer (ExaC@C) Technical Architecture
Note:
Oracle doesn't stop billing when a VM or VM Cluster is stopped. To stop billing for a
VM Cluster, lower the OCPU count to zero.
1-3
Chapter 1
Oracle Exadata Database Service on Cloud@Customer Service Description
For Oracle Database release and software support timelines, see Release Schedule of
Current Database Releases (Doc ID 742060.1) in the My Oracle Support portal.
Related Topics
• Release Schedule of Current Database Releases (Doc ID 742060.1)
1-4
Chapter 1
Oracle Exadata Database Service on Cloud@Customer Service Description
1-5
Chapter 1
Oracle Exadata Database Service on Cloud@Customer Service Description
1-6
Chapter 1
Exadata Cloud Management Interfaces
1-7
Chapter 1
Exadata Cloud Management Interfaces
Note:
For more information and best practices on how these interfaces align for
various Exadata Cloud database management use cases, refer to My Oracle
Support note: Exadata Cloud API/CLI Alignment Matrix (Doc ID 2768569.1).
Related Topics
• Using the Console
• https://support.oracle.com/epmos/faces/DocContentDisplay?id=2768569.1
1-8
Chapter 1
Exadata Cloud Management Interfaces
signatures. Exadata Cloud@Customer specific OCI REST APIs can be found throughout
the documentation in the Using the API sections:
– Using the API to Manage Exadata Cloud@Customer Infrastructure
– Using the API to Manage Exadata Cloud@Customer Backup Destinations
– Using the API to Manage Exadata Cloud@Customer VM Clusters
– Using the API to Create Oracle Database Home on Exadata Cloud@Customer
– Using the API to Manage Oracle Database Home on Exadata Cloud@Customer
– Using the API to Manage Oracle Database Components
– Using the API to Manage Data Guard Associations on an Exadata Cloud@Customer
System
– Using the API to Manage Database Backup and Recovery
– Using the API to Patch an Exadata Cloud@Customer System
Related Topics
• Command Line Interface (CLI)
• Software Development Kits
• DevOps Tools and Plug-ins
• Terraform Provider
• Resource Manager
• Ansible Collection
• Cloud Shell
• Appendix and Reference
• REST APIs
• Using the API to Manage Exadata Cloud@Customer Infrastructure
Oracle Exadata Database Service on Cloud@Customer uses the same API as Oracle
Cloud Infrastructure.
• Using the API to Manage Exadata Cloud@Customer Backup Destinations
Review the list of API calls to manage your Exadata Database Service on
Cloud@Customer backup destinations.
• Using the API to Manage Exadata Cloud@Customer VM Clusters
Review the list of API calls to manage your Exadata Database Service on
Cloud@Customer VM cluster networks and VM clusters.
• Using the API to Create Oracle Database Home on Exadata Cloud@Customer
To create an Oracle Database home, review the list of API calls.
• Using the API to Manage Oracle Database Home on Exadata Database Service on
Cloud@Customer
Review the list of API calls to manage Oracle Database home.
• Using the API to Manage Oracle Database Components
Use various API features to help manage your databases on Oracle Exadata Database
Service on Cloud@Customer.
1-9
Chapter 1
Exadata Cloud Management Interfaces
1-10
Chapter 1
Exadata Cloud Management Interfaces
Related Topics
• About Using the dbaascli Utility on Exadata Database Service on Cloud@Customer
You can use the dbaascli utility to perform various database lifecycle and administration
operations on Exadata Cloud@Customer such as creating an Oracle Database, patching
an Oracle Database, managing pluggable databases (PDBs), scaling the CPU core count
in disconnected mode, and more.
• Creating an On-Demand Backup by Using the bkup_api Utility
You can use the bkup_api utility to create an on-demand backup of a complete
database or an individual pluggable database (PDB):
• Customizing Backup Settings by Using a Generated Configuration File
You can customize backup settings for a database deployment by generating a file
containing the current customizable settings, editing the file, and then using the file to
update the backup settings.
• Monitoring and Managing Exadata Storage Servers with ExaCLI
Learn to use the ExaCLI command-line utility to perform monitoring and management
functions on Exadata storage servers in the Exadata Cloud Service.
• Updating Cloud Tooling Using dbaascli
To update the cloud tooling release for Oracle Exadata Database Service on
Cloud@Customer, complete this procedure.
1-11
2
What’s New in Oracle Exadata Database
Service on Cloud@Customer Gen2
Oracle is constantly adding new capabilities to Oracle Exadata Database Service on
Cloud@Customer. This section provides a brief overview of new features as they are
released.
Note:
For information on new features for Autonomous Database on Oracle Exadata
Cloud@Customer see What’s New in ADB-D on Oracle Exadata Cloud@Customer
2-1
Chapter 2
Health Metrics and Log Collection
Note:
Health Metrics and Log Collection feature has been rolled out only to the MRS
region. It will be rolled out to other regions in a phased manner.
This feature extends the Database Service Events feature implementation that
enables you to get notified about health issues with your Oracle Databases or other
components on the Guest VM. With this enhancement, you can allow:
• Oracle to proactively collect detailed health metrics for diagnosis and issue
resolution
• Oracle to reactively collect Incident logs and trace files on demand for a deeper
diagnosis and issue resolution
2-2
Chapter 2
Elastic Compute Expansion
Collecting Guest VM events, health metrics, incident logs, and trace files, will help Oracle to
enhance service operations as well as provide proactive support by early detection and
correlation.
Related Topics
• Overview of Health Metrics and Log Collection
By enabling diagnostics collection and notifications, Oracle Cloud Operations and you will
be able to identify, investigate, track, and resolve guest VM issues quickly and effectively.
Subscribe to Events to get notified about resource state changes.
• Incident Logs and Trace Files
This section lists all of the files that can be collected by Oracle Support if you opt-in for
incident logs and trace collection.
• Health Metrics
Review the list of database and non-database health metrics collected by Oracle Trace
File Analyzer.
• Database Service Events
The Database Service emits events, which are structured messages that indicate
changes in resources.
• Using the Console to Create a VM Cluster
To create your VM cluster, be prepared to provide values for the fields required for
configuring the infrastructure.
• Using the Console to Enable, Partially Enable, or Disable Diagnostics Collection
You can enable, partially enable, or disable diagnostics collection for your Guest VMs
after provisioning the VM cluster. Enabling diagnostics collection at the VM cluster level
applies the configuration to all the resources such as DB home, Database, and so on
under the VM cluster.
Note:
Elastic Compute Expansion feature has been rolled out only to the MEL, SYD, JED,
and SCL regions. It will be rolled out to other regions in a phased manner.
2-3
Chapter 2
Elastic Compute Expansion
Related Topics
• Using the Console to Create Oracle Exadata Database Service on
Cloud@Customer Infrastructure
To create your Oracle Exadata Database Service on Cloud@Customer
infrastructure, be prepared to provide values for the fields required for configuring
the infrastructure.
• Using the Console to Download a File Containing Configuration Data
To download an Oracle Exadata Database Service on Cloud@Customer
configuration file, complete this procedure.
• Using the Console to Activate Exadata Database Service on Cloud@Customer
Infrastructure
To activate Oracle Exadata Database Service on Cloud@Customer infrastructure,
ensure that you meet the prerequisites, and complete this procedure.
• Using the Console to Create a VM Cluster Network
To create your VM cluster network with the Console, be prepared to provide values
for the fields required for configuring the infrastructure.
• Using the Console to Validate a VM Cluster Network
You can only validate a VM cluster network if its current state is Requires
Validation, and if the underlying Exadata infrastructure is activated.
• Using the Console to Scale Infrastructure Compute and Storage
To scale infrastructure compute and storage, complete this procedure.
• Using the Console to Download Scale Infrastructure Compute and Storage
Configuration File
To download an Oracle Exadata Cloud@Customer scale configuration file,
complete this procedure.
• Using the Console to Activate New Database and Storage Servers
To download an Oracle Exadata Cloud@Customer scale configuration file,
complete this procedure.
• Using the Console to Add Another DB Server to the VM Cluster Network
To a DB server to the VM Cluster Network, complete this procedure.
• Using the Console to Add VMs to a Provisioned Cluster
To add virtual machines to a provisioned cluster, use this procedure.
• Using the Console to Remove a VM from a VM Cluster
To remove a virtual machine from a provisioned cluster, use this procedure.
• Using the Console to Remove DB Servers from a VM Cluster Network
To remove a database server, use this procedure.
• Using the Console to Edit a VM Cluster Network
You can only edit a VM cluster network that is not associated with a VM cluster.
• Using the Console to Make Storage Capacity from New Server Available for VM
Clusters Consumption
To make storage capacity from the new servers for VM clusters consumption,
complete this procedure.
• Using the Console to View Details of Exadata Cloud@Customer Infrastructure with
Scaled Compute and Storage Capacity
To view the storage capacity from the new storage server, or scaled compute
capacity, use this procedure.
2-4
Chapter 2
Oracle Standard Tagging for Resources on Oracle Exadata Database Service on Cloud@Customer
Note:
The Infrastructure Security Maintenance implementation has been rolled out only to
the MRS, AMS, and HYD regions. It will be rolled out to other regions in a phased
manner.
2-5
Chapter 2
Enhanced Control to Rollback or Retry Failed Guest VM Operating System Update
Related Topics
• Overview of Monthly Security Maintenance
Security maintenance, performed alongside the quarterly maintenance, is
executed in months when important security updates are needed and includes
fixes for vulnerabilities with CVSS scores greater than 7.
• View or Edit a Scheduled Security Maintenance for Exadata Cloud@Customer
Infrastructure
Learn how to view and edit the next scheduled security maintenance.
• Exadata Cloud@Customer Infrastructure Maintenance Event Types
Review the list of event types that Exadata Cloud@Customer Infrastructure
Maintenance emits.
• Overview of the Quarterly Infrastructure Maintenance Process
By default, infrastructure maintenance updates the Exadata database server hosts
in a rolling fashion, followed by updating the storage servers.
• Using the Console to Configure Oracle-Managed Infrastructure Updates
Full Exadata infrastructure software updates are scheduled on a quarterly basis. In
addition, important security updates are scheduled monthly. While you cannot opt-
out of these infrastructure updates, Oracle alerts you in advance through the
Cloud Notification Portal and allows scheduling flexibility to help you plan for them.
• View or Edit Quarterly Infrastructure Maintenance Preferences for Exadata
Cloud@Customer Infrastructure
To edit your Oracle Exadata Database Service on Cloud@Customer infrastructure
quarterly maintenance preferences, be prepared to provide values for the
infrastructure configuration. The changes you make will only apply to future
maintenance runs, not those already scheduled.
• View or Edit a Scheduled Quarterly Maintenance for Exadata Cloud@Customer
Infrastructure
Learn how to view and edit the time of the next scheduled maintenance.
• View the Maintenance History of Exadata Cloud@Customer Infrastructure
Learn how to view the maintenance history for an Exadata Cloud@Customer
Infrastructure.
• View and Edit Quarterly Maintenance While Maintenance is In Progress or Waiting
for Custom Action
While maintenance is in progress, you can enable or disable custom action and
change the custom action timeout. While maintenance is waiting for a custom
action, you can resume the maintenance prior to the timeout or extend the timeout.
2-6
Chapter 2
Concurrently Create or Terminate Oracle Databases in a VM Cluster
Related Topics
• Using the Console to Rollback or Retry Failed Guest VM Operating System Update
To update the guest VM operating system with the Console, be prepared to provide
values for the fields required.
2-7
Chapter 2
VM Guest Exadata OS Image Major Version Update
Related Topics
• Using the Console to Create a Database
To create an Oracle Database with the console, use this procedure.
• Using the Console to Create Oracle Database Home on Exadata Database
Service on Cloud@Customer
To create an Oracle Database home in an existing VM cluster with the Console, be
prepared to provide values for the fields required.
2-8
Chapter 2
Control Plane Server (CPS) Offline Diagnostic Report
Note:
• You cannot enable or disable Control Plane Server (CPS) Offline Diagnostic
Report if the Exadata Infrastructure is in DISCONNECTED mode.
• Every hour, even if no issues are detected on the CPS, the system will still
generate and save a diagnostic report in HTML and JSON formats. Whenever a
connectivity issue arises between CPS and OCI endpoints, the system
generates a report immediately.
• At any given point in time, the report is available only at the primary Control
Plane Server. When generating a report, if the first IP address specified for the
Control Plane Servers does not work, then you may try the second IP.
For more information, see ExaCC gen2: Troubleshooting VPN/WSS connection from
Customer Side (Doc ID 2745571.1).
Related Topics
• Using the Console to Create Oracle Exadata Database Service on Cloud@Customer
Infrastructure
To create your Oracle Exadata Database Service on Cloud@Customer infrastructure, be
prepared to provide values for the fields required for configuring the infrastructure.
2-9
Chapter 2
Enhanced Infrastructure Maintenance Controls
2-10
Chapter 2
Manage Pluggable Databases on Exadata Cloud@Customer
2-11
Chapter 2
Specify db_unique_name and SID for Primary and Standby Databases in Data Guard Association
Note:
VM Cluster Node Subsetting feature is now available in all OCI commercial
regions.
2-12
Chapter 2
X9M-2 System Support
2-13
Chapter 2
Creating DG Association/Standby Database Using Existing Database Home
2-14
Chapter 2
Upgrading Oracle Databases
2-15
Chapter 2
Oracle Database Software Images
2-16
Chapter 2
Exadata Cloud@Customer Infrastructure Patching Automation
2-17
Chapter 2
X8M-2 System Support
Related Topics
• Using the Console to Create Oracle Exadata Database Service on
Cloud@Customer Infrastructure
To create your Oracle Exadata Database Service on Cloud@Customer
infrastructure, be prepared to provide values for the fields required for configuring
the infrastructure.
• Managing Infrastructure Maintenance Contacts
Learn to manage your Exadata infrastructure maintenance contacts.
2-18
Chapter 2
Oracle Exadata Cloud@Customer Deployment Assistant
Enable a Data Guard association between databases, change the role of a database in a
Data Guard association using either a switchover or a failover operation, and reinstate a
failed database.
For more information, see:
• Using Oracle Data Guard with Exadata Cloud@Customer
• Using the API To Manage Data Guard Associations on an Exadata Cloud@Customer
System
• Permissions Required for Each API Operation
• Data Guard Event Types
Related Topics
• Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
Learn to configure and manage Data Guard associations in your VM cluster.
• Using the API to Manage Data Guard Associations on an Exadata Database Service on
Cloud@Customer System
Learn how to use the API to manage Data Guard associations on an Exadata Database
Service on Cloud@Customer system.
• Permissions Required for Each API Operation
Review the list of API operations for Exadata Database Service on Cloud@Customer
resources in a logical order, grouped by resource type.
• Data Guard Event Types
Review the list of event types that Data Guard associations emit.
2-19
Chapter 2
Per-Second Billing for OCPU Usage
2-20
Chapter 2
Create and Manage Multiple Virtual Machines per Exadata System (MultiVM)
2-21
Chapter 2
Configure Oracle Database Character Set and National Character Set
Related Topics
• About Using the dbaascli Utility on Exadata Database Service on
Cloud@Customer
You can use the dbaascli utility to perform various database lifecycle and
administration operations on Exadata Cloud@Customer such as creating an
Oracle Database, patching an Oracle Database, managing pluggable databases
(PDBs), scaling the CPU core count in disconnected mode, and more.
• dbaascli cpuscale get_status
To check the status of current or last scale request performed when network
connectivity between the Control Plane Server and OCI region is disrupted, use
the dbaascli cpuscale get_status command.
• dbaascli cpuscale update
To scale up or down the CPU core count for a virtual machine in a VM cluster
when network connectivity between the Control Plane Server and OCI region is
disrupted, use the dbaascli cpuscale update command.
• Exadata Infrastructure Event Types
Review the list of event types that Exadata Infrastructure instances emit.
2-22
Chapter 2
Shared Database Homes for Oracle Exadata Database Service on Cloud@Customer
The default time zone for the Oracle Exadata Database Service on Cloud@Customer
infrastructure is UTC. The time is displayed in the UTC format at the operating system and
database level. You can choose a different Time Zone while provisioning your Oracle Exadata
Database Service on Cloud@Customer infrastructure. However, Oracle recommends setting
the database time zone to UTC (0:00), as no conversion of time zones will be required.
For information and instructions, see Using the Console to Create Infrastructure.
Related Topics
• Using the Console to Create Oracle Exadata Database Service on Cloud@Customer
Infrastructure
To create your Oracle Exadata Database Service on Cloud@Customer infrastructure, be
prepared to provide values for the fields required for configuring the infrastructure.
2-23
Chapter 2
X7-2 System Support
2-24
3
Preparing for Exadata Database Service on
Cloud@Customer
Review OCI as well as the site, network and storage requirements to prepare and deploy
Exadata Database Service on Cloud@Customer in your data center.
• Oracle Cloud Infrastructure (OCI) Requirements for Oracle Exadata Database Service on
Cloud@Customer
Learn the basic concepts to get started using Oracle Cloud Infrastructure.
• Site Requirements for Oracle Exadata Database Service on Cloud@Customer
Review the requirements for provisioning Oracle Exadata Database Service on
Cloud@Customer at your site.
• Network Requirements for Oracle Exadata Database Service on Cloud@Customer
Review the network requirements for provisioning Oracle Exadata Database Service on
Cloud@Customer at your site.
• Storage Configuration Requirements for Oracle Exadata Database Service on
Cloud@Customer
Review the storage requirements for the ASM disk groups and VM file systems to plan
the best options for your enterprise needs.
• Checklists for Exadata Database Service on Cloud@Customer Deployments
To determine your readiness for an Exadata Database Service on Cloud@Customer
deployment, review the deployment checklists.
3-1
Chapter 3
Oracle Cloud Infrastructure (OCI) Requirements for Oracle Exadata Database Service on Cloud@Customer
• Managing Regions
This topic describes the basics of managing your region subscriptions.
• Managing Compartments
This topic describes the basics of working with compartments.
• Managing Users
This topic describes the basics of working with users.
• Managing Groups
This topic describes the basics of working with groups.
• Required IAM Policy for Exadata Database Service on Cloud@Customer
Review the identity access management (IAM) policy for provisioning Oracle
Exadata Database Service on Cloud@Customer systems.
Related Topics
• OCI Getting Started Guide
• Setting Up Your Tenancy
• Managing Regions
• Managing Compartments
• Managing Users
• Managing Groups
3-2
Chapter 3
Site Requirements for Oracle Exadata Database Service on Cloud@Customer
If you're new to policies, then see "Getting Started with Policies" and "Common Policies". If
you want to dig deeper into writing policies for databases, then see "Details for the Database
Service".
For more details on writing policies specific to Exadata Cloud@Customer resources see
"Policy Details for Exadata Cloud@Customer".
Related Topics
• Let database admins manage DB systems
• Getting Started with Policies
• Common Policies
• Details for the Database Service
• Policy Details for Exadata Database Service on Cloud@Customer
Learn to write policies to control access to Exadata Database Service on
Cloud@Customer resources.
3-3
Chapter 3
Site Requirements for Oracle Exadata Database Service on Cloud@Customer
If your loading dock meets the height and ramp requirements for a standard freight
carrier truck, then you can use a pallet jack to unload the rack. If the loading dock does
3-4
Chapter 3
Site Requirements for Oracle Exadata Database Service on Cloud@Customer
not meet the requirements, then you must provide a standard forklift, or other means to
unload the rack. You can also request that the rack is shipped in a truck with a lift gate.
Use a conditioned space to remove the packaging material to reduce particles before
entering the data center. Allow enough space for unpacking it from its shipping cartons.
Use the information in the following table to ensure that there is a clear pathway for moving
the Exadata Database Service on Cloud@Customer rack. Also, the entire access route to the
installation site should be free of raised-pattern flooring that can cause vibration.
3-5
Chapter 3
Site Requirements for Oracle Exadata Database Service on Cloud@Customer
The following list outlines the available PDUs for Exadata Database Service on
Cloud@Customer, depending on your region. Follow each of the links to access
detailed specifications for each PDU type:
• Americas, Japan, and Taiwan
– Low-Voltage 15 kVA Single-Phase
– Low-Voltage 15 kVA Three-Phase
– Low-Voltage 22 kVA Single-Phase
– Low-Voltage 24 kVA Three-Phase
• Europe, the Middle East and Africa (EMEA), and Asia Pacific (APAC), except for
Japan and Taiwan
– High-Voltage 15 kVA Three-Phase
– High-Voltage 22 kVA Single-Phase
– High-Voltage 24 kVA Three-Phase
Note:
Electrical work and installations must comply with applicable local, state, or
national electrical codes.
PDU power cords are 4 meters (13.12 feet) long, and 1–1.5 meters (3.3–4.9
feet) of the cord is routed within the rack cabinet. The installation site AC
power receptacle must be within 2 meters (6.6 feet) of the rack.
3-6
Chapter 3
Site Requirements for Oracle Exadata Database Service on Cloud@Customer
Note:
Electrical work and installations must comply with applicable local, state, or national
electrical codes.
Note:
Studies have shown that temperature increases of 10 degrees Celsius (15 degrees
Fahrenheit) above 20 degrees Celsius (70 degrees Fahrenheit) reduce long-term
electronics reliability by 50 percent.
3-7
Chapter 3
Site Requirements for Oracle Exadata Database Service on Cloud@Customer
3-8
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
Use perforated tiles, approximately 400 CFM/tile, in front of the rack for cold air intake. The
tiles can be arranged in any order in front of the rack, as long as cold air from the tiles can
flow into the rack. Inadequate cold air flow could result in a higher inlet temperature in the
servers because of exhaust air recirculation. The following is the recommended number of
floor tiles:
• Four floor tiles for an Exadata Database Service on Cloud@Customer Full Rack.
• Three floor tiles for an Exadata Database Service on Cloud@Customer Half Rack.
• One floor tile for an Exadata Database Service on Cloud@Customer Quarter Rack or
Base System.
3-9
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
https://
wss.exacc.oci_regi
on.oci.oraclecloud
.com
Secure Tunnel Service for 443 outbound Use these URL formats,
remote Oracle operator replacing oci_region with
access your region:
https://
mgmthe1.exacc.oci_
region.oci.oraclec
loud.com
https://
mgmthe2.exacc.oci_
region.oci.oraclec
loud.com
3-10
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
https://
objectstorage.oci_
region.oraclecloud
.com
https://
swiftobjectstorage
.oci_region.oracle
cloud.com
Identity Service for name 443 outbound Use this URL format,
resolution of Oracle replacing oci_region with
operators your region:
https://
identity.oci_regio
n.oraclecloud.com
https://
wsshe.adbd-
exacc.oci_region.o
ci.oraclecloud.com
3-11
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
* https://
frontend.loggin
g.ad2.oci_regio
n.oracleiaas.co
m/
* https://
frontend.loggin
g.ad3.oci_regio
n.oracleiaas.co
m/
* https://
controlplane.lo
gging.ad1.oci_r
egion.oracleiaa
s.com/
* https://
controlplane.lo
gging.ad2.oci_r
egion.oracleiaa
s.com/
* https://
controlplane.lo
gging.ad3.oci_r
egion.oracleiaa
s.com/
Note that the Control Plane Server must be able to establish TCP Port 443
outbound access only. While outbound connections on Port 443 must be
3-12
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
allowed, TCP Port 443 inbound access is not required, and it may be desirable
from a security standpoint to block inbound connections. (Functionally, bi-
directional traffic is still possible over the connection once the secure outbound
connection is established.)
The Control Plane Server requires customer DNS and NTP services to be
functional. Minimum bandwidth requirements for the Control Plane Server
internet connection to OCI are 50/10 mbs download/upload.
Some customers have security policies requiring the use of proxies for all internet
connections to IT infrastructure. Customer HTTP proxy, for example, passive/
corporate proxy supported for the Control Plane Server connection to OCI.
Customer HTTPS, challenge proxy, and traffic inspection are not supported.
If you are using IP address filtering based firewall rules, due to the dynamic
nature of cloud interfaces, you must allow traffic with all the relevant IP CIDR
ranges associated with your OCI region as identified by https://
docs.oracle.com/en-us/iaas/tools/public_ip_ranges.json.
– Administration Network
This network connects Exadata Database Service on Cloud@Customer servers and
switches to the two control plane servers that are located in the Exadata Database
Service on Cloud@Customer rack. It facilitates customer-initiated operations using
the Oracle Cloud Infrastructure Console and APIs. It also facilitates monitoring and
administration of the Oracle-managed infrastructure components in Exadata
Database Service on Cloud@Customer.
This network is fully contained within the Exadata Database Service on
Cloud@Customer rack, and does not connect to your corporate network. However,
the Exadata infrastructure is indirectly connected to your corporate network through
the control plane servers. This connection is required to provide Domain Name
System (DNS) and Network Time Protocol (NTP) services to the Exadata
infrastructure. Therefore, the IP addresses that are allocated to the administration
network must not exist elsewhere in your corporate network.
Each Oracle Database server and Exadata Storage Server has two network
interfaces connected to the administration network. One provides management
access to the server through one of the embedded Ethernet ports (NET0). The other
provides access to the Integrated Lights-Out Management (ILOM) subsystem
through a dedicated ILOM Ethernet port. Exadata Database Service on
Cloud@Customer is delivered with the ILOM and NET0 ports connected to the
Ethernet switch in the rack. Cabling or configuration changes to these interfaces are
not permitted.
– InfiniBand or RDMA Over Converged Ethernet (ROCE) Network
This network connects the database servers, Exadata Storage Servers, and control
plane servers using the InfiniBand or ROCE switches on the rack. Each server
contains two InfiniBand network interfaces (IB0 and IB1) or ROCE interface (re0 and
re1) that are connected to separate InfiniBand or ROCE switches in the rack.
Primarily, Oracle Database uses this network for Oracle RAC cluster interconnect
traffic, and for accessing data on Exadata Storage Servers.
This non-routable network is fully contained within the Exadata Cloud@Customer
rack, and does not connect to your corporate network. However, because the control
plane servers are connected to the InfiniBand or ROCE network and to your
corporate network, the IP addresses that are allocated to the InfiniBand or ROCE
network must not exist elsewhere in your corporate network.
3-13
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
Note:
When you enable Data Guard, replication of data happens only over
the client network.
– Backup Network
This network is similar to the client access network, as it connects the Exadata
Database Service on Cloud@Customer Oracle Database servers to your
existing network. It can be used for access to the virtual machines for various
purposes, including backups and bulk data transfers.
Like the client network, the backup network uses a pair of network interfaces
on each database server, which are connected to the customer network.
Physically connecting the backup network to a customer network is required.
If the customer's on-premises storage (NFS or ZDLRA) is to be used
exclusively as a backup destination for databases, then no external
connectivity to OCI is required for the backup network.
Exadata Cloud@Customer also offers an Oracle-managed cloud object
storage backup destination. If Oracle's Object Storage Service is to be
leveraged as a backup destination for database backups, then ensure that the
backup network can reach the Object Storage Service through external
connection. You must enable TCP port 443 outbound access for the backup
network as follows:
3-14
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
https://
objectstorage.oci_reg
ion.oraclecloud.com
https://
swiftobjectstorage.oc
i_region.oraclecloud.
com
Related Topics
• Object Storage Service API
• Monitoring API
• Identity and Access Management Service API
3-15
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
/23
/16
/22
/19
3-16
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
addresses depends on the Exadata system shape. These network configuration details,
including host names and IP addresses, are specified when you create a VM cluster network.
All IP addresses must be statically assigned IP addresses, not dynamically assigned (DHCP)
addresses. The client network and the backup network require separate subnets.
The following table outlines the IP address requirements for the client and backup networks.
The table specifies the maximum and recommended CIDR block prefix length for each
network. The maximum CIDR block prefix length defines the smallest block of IP addresses
that are required for the network. To allow for possible future expansion within Exadata
Database Service on Cloud@Customer, a smaller CIDR block prefix length is recommended,
which reserves more IP addresses for the network.
/28 /27
/27 /26
Backup network Maximum CIDR block prefix Maximum CIDR block prefix
length: length:
/29 /28
/28 /27
3-17
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
On Quarter Rack, Half Rack, or Full Rack systems, you can choose to use 10 Gbps
RJ45 copper, 10 Gbps SFP+ fiber, or 25Gbps SFP28 fiber network connections to
your corporate network. However, you cannot mix copper and fiber networks on the
same physical server. For example, you cannot use fiber for the client network and
copper for the backup network.
On Base System configurations, the options are more limited because of the physical
network interfaces that are available on each database server. On Base Systems, you
can choose to use copper or fiber network connections only for the client network,
while the backup network uses a fiber connection.
You can also use shared network interfaces on the Base System for the client network
and the backup network, which reduces the uplink requirement to two uplinks for each
database server. Using shared network interfaces also enables you to use copper
network connections to support both the client and backup networks on Base System
configurations. However, in general, Oracle recommends that you do not use shared
network interfaces, because sharing networks compromises the bandwidth and
availability of both networks. Shared network interfaces are not supported for Quarter,
Half, and Full Rack configurations.
3-18
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
ExaDB-C@C Service
Endpoints
Customer CPE
SW/Router Object
Storage
Identity
Service
As shown in the figure, the Oracle Exadata Database Service on Cloud@Customer Control
Plane network egresses to FastConnect provider and to Oracle edge. Customers who may
already have existing FastConnect connectivity can use it to connect Oracle Exadata
Database Service on Cloud@Customer to the OCI region using public peering.
3-19
Chapter 3
Network Requirements for Oracle Exadata Database Service on Cloud@Customer
3-20
Chapter 3
Storage Configuration Requirements for Oracle Exadata Database Service on Cloud@Customer
Note:
If you are looking for information to plan the local VM storage available on your VM
Clusters refer to Estimating How Much Local Storage You Can Provision to Your
VMs
3-21
Chapter 3
Storage Configuration Requirements for Oracle Exadata Database Service on Cloud@Customer
3-22
Chapter 3
Storage Configuration Requirements for Oracle Exadata Database Service on Cloud@Customer
Exadata Storage Server Configuration Allocation With Exadata Snapshot Storage and
No Local Backup
When you select Allocate Storage for Exadata Snapshots: Yes and Enable Backups on
Local Exadata Storage: No, so that storage is allocated for Exadata snapshots, then
storage allocation is as follows:
• DATA Disk Group: 60%
• RECO Disk Group: 20%
• SPARSE Disk Group 20%
Exadata Storage Server Configuration Allocation With Both Exadata Snapshot Storage
and Local Backup Enabled
When you select Allocate Storage for Exadata Snapshots: Yes and Enable Backups on
Local Exadata Storage: Yes, so that storage is allocated for Exadata snapshots, and
storage is allocated for local backups, then storage allocation is as follows:
• DATA Disk Group: 35%
• RECO Disk Group: 50%
3-23
Chapter 3
Checklists for Exadata Database Service on Cloud@Customer Deployments
Filesystem Mounted On
devtmpfs /dev
tmpfs /dev/shm
tmpfs /run
tmpfs /sys/fs/cgroup
tmpfs /run/user/0
/dev/mapper/VGExaDb-LVDbSys1 /
/dev/mapper/VGExaDb-LVDbOra1 /u01
/dev/mapper/VGExaDb-LVDbTmp /tmp
/dev/mapper/VGExaDb-LVDbVar1 /var
/dev/mapper/VGExaDb-LVDbVarLog /var/log
/dev/mapper/VGExaDb-LVDbHome /home
/dev/mapper/VGExaDbDisk.u02_extra.img- /u02
LVDBDisk
/dev/mapper/VGExaDb-LVDbVarLogAudit /var/log/audit
/dev/sda1 /boot
/dev/mapper/ /u01/app/19.0.0.0/grid
VGExaDbDisk.grid19.0.0.0.200414.img-
LVDBDisk
/dev/asm/acfsvol01-142 /acfs01
Related Topics
• Estimating How Much Local Storage You Can Provision to Your VMs
3-24
Chapter 3
Checklists for Exadata Database Service on Cloud@Customer Deployments
3-25
Chapter 3
Checklists for Exadata Database Service on Cloud@Customer Deployments
3-26
Chapter 3
Checklists for Exadata Database Service on Cloud@Customer Deployments
– Do the elevator doors meet the height and width requirements for moving the rack?
– Does the elevator meet the weight requirements for transporting the rack?
• Can the complete access route support the weight of the rack?
• Is the access route onto the raised floor rated for dynamic loading of the rack?
3-27
Chapter 3
Checklists for Exadata Database Service on Cloud@Customer Deployments
3-28
Chapter 3
Checklists for Exadata Database Service on Cloud@Customer Deployments
For example:
– Stair walkers
– Lifters
– Ramps
– Steel plates
– Floor covers
• Does the delivery carrier require any special equipment, such as non-floor damaging
rollers, transport dollies, pallet jacks, or fork lifts?
Note:
• Reracking requires prior approval. The checklist below provides high level
guidance on re-racking requirements. Oracle maintains a detailed internal
checklist that must be approved prior to performing reracking.
• You must purchase the Oracle Reracking service.
• Oracle does not provide technical support for customer-supplied equipment.
Answer yes, no, not applicable, or add your comments. Or, let the site survey team to fill in
the requested information.
• Have you purchased the Oracle Reracking Service?
• Is there a cart capable of carrying the weight of the servers to move the components and
associated cabling from the supplied rack to the rack that you supply?
• Is the target rack empty?
3-29
Chapter 3
Checklists for Exadata Database Service on Cloud@Customer Deployments
Note:
Two-post racks are not compatible.
• Does the target rack's horizontal opening and unit vertical pitch conform to
ANSI/EIA 310-D-1992 or IEC 60297 standards?
• Does the target rack have RETMA rail support?
Note:
Oracle Exadata rack requires 19 inches (483 mm) for RETMA rail
spacing width. The minimum rack width of 600 mm (23.63 inches) is
recommended to accommodate the PDU and cable harnesses on the
side. If the rack is less than 600 mm wide, then it must have additional
depth to accommodate mounting behind the server cable management
arms.
3-30
Chapter 3
Checklists for Exadata Database Service on Cloud@Customer Deployments
3-31
4
Getting Started with Exadata Database
Service on Cloud@Customer Deployment
After completing the preparation tasks in Preparing for Exadata Database Service on
Cloud@Customer, get started with deploying your Exadata Database Service on
Cloud@Customer system following these procedures.
• About Provisioning Oracle Exadata Database Service on Cloud@Customer Systems
To provision an Oracle Exadata Database Service on Cloud@Customer system, you
must work with Oracle to set up and configure the system.
• Tagging Oracle Exadata Database Service on Cloud@Customer Resources
Tagging is a powerful foundational service for Oracle Cloud Infrastructure (OCI) that
enables users to search, control access, and do bulk actions on a set of resources based
on the tag.
• Oracle Exadata Cloud@Customer Deployment Assistant
Oracle Exadata Cloud@Customer Deployment Assistant is an automated installation and
configuration tool that enables you to set up your Oracle Exadata Cloud@Customer
machine and create an Oracle Database instance with minimal effort.
• Overview of Elastic Storage Expansion
With elastic storage expansion, you can dynamically increase your storage capacity to
meet your growing workload requirements.
• Using the Console to Provision Exadata Database Service on Cloud@Customer
Infrastructure
Learn how to provision an Exadata Database Service on Cloud@Customer system.
• Configuring Oracle-Managed Infrastructure Maintenance
Oracle performs the updates to all of the Oracle-managed infrastructure components on
Exadata Cloud@Customer.
• Creating First VM Cluster Network on Exadata Cloud@Customer
Follow the steps in the following sections to create your first VM Cluster Network.
• Provisioning the First VM Cluster on an Exadata Cloud@Customer System
Learn how to create the first VM cluster on your Exadata Cloud@Customer system.
• Creating Database Backup Destinations for Exadata Cloud@Customer
Exadata Cloud@Customer provides a backup facility, which you can configure
individually on each database.
• Creating First Database Home on an Exadata Database Service on Cloud@Customer
System
After provisioning a VM Cluster, create your first Oracle Database Home on Exadata
Cloud@Customer.
• Creating First Database on an Exadata Database Service on Cloud@Customer System
After provisioning an Oracle Database Home and any needed backup destinations, you
are ready to create your first database on Exadata Cloud@Customer.
4-1
Chapter 4
About Provisioning Oracle Exadata Database Service on Cloud@Customer Systems
Caution:
Importance of Tagging
Using the Oracle Cloud Infrastructure (OCI) tagging system, you can tag resources per
your organizational scheme allowing you to group resources, manage costs, and give
insights into usage. Tags also help you build a governance model around security and
4-2
Chapter 4
Tagging Oracle Exadata Database Service on Cloud@Customer Resources
Maximum Availability Architecture (MAA). As your organization expands its cloud footprint, it
can become challenging to keep track of the deployment architectures, security best
practices, MAA, application tier, and so on. Using metadata tags to identify workload
attributes can help keep up with the security and availability of your tenancy without cost
overruns.
To enable customers to manage OCI resources securely and cost-effectively, Oracle provides
a set of pre-defined tags in line with best practices for tagging resources. These tags are
grouped into two namespaces, the oracleStandard namespace, and the
OracleApplicationName namespace. You can think of a tag namespace as a container for
your tag keys.
Consider a scenario where your organization has multiple cloud resources such as Consider
a scenario where your organization has multiple cloud resources such as Exadata
Infrastructure, VM Cluster, DB Home, Oracle Database, Autonomous Exadata VM Cluster,
Autonomous Container Database, Autonomous Database, and VM Cluster Networks across
multiple compartments in your tenancy. across multiple compartments in your tenancy.
Suppose you wish to track these cloud resources for specific purposes, report on them, or
take bulk actions. In that case, you will need a system that lets you group these resources
based on different criteria such as environment, criticality, target users, application, etc. You
can achieve this by applying appropriate tags to these resources.
For example, you may tag all resources in your development stack with Oracle-
Standard.Environment=Dev or for a business-critical application stack set Oracle-
Standard.Criticality=High or Extreme. In the event of service disruptions due to various
reasons, you would then be able to quickly identify all OCI resources associated with an
application or business function or be able to separate critical and non-critical workloads.
Tagging can also help you deploy optimized configurations based on workload attributes
identified via tags. For example, database deployments for the PeopleSoft application require
a specific configuration. Setting the ApplicationName and AppMajorVersion tags while
deploying an Oracle Database or an Oracle Autonomous Database can ensure that the
database is configured and ready for the particular application, for example, PeopleSoft out of
the box.
Moreover, integration with the Cloud Advisor OCI service can provide you with direct, deep
insight into how well your cloud services adhere to the corporate guidelines and help your
management govern with a vision. See Cloud Advisor Overview for more details.
Adding Tags
You can tag resources using the Oracle Cloud Infrastructure (OCI) console, command-line
interface, or SDK.
There are many cloud resources that can be tagged in an Oracle Exadata Database Service
on Cloud@Customer deployment. Exadata Infrastructure, VM Cluster, DB Home, Oracle
Database, Autonomous Exadata VM Cluster, Autonomous Container Database, Autonomous
Database, and VM Cluster Networks are some of them. Tags can either be applied while
creating the resources or modified later. For example, you can apply tags to an Autonomous
Container Database (ACD) while provisioning the ACD or add them later from its Details
page.
See How Tagging Works for more details on using tags. Tagging integrates with Oracle Cloud
Infrastructure authorization system. You can use IAM policy controls to enable delegation or
restriction of tag manipulation. See Authentication and Authorization to learn about the
permissions required to work with defined and free-form tags. (Required) Enter introductory
text here, including the definition and purpose of the concept.
4-3
Chapter 4
Tagging Oracle Exadata Database Service on Cloud@Customer Resources
Tip:
For a "try it out" tutorial that demonstrates implementing tags in Oracle
Autonomous Database, refer to Lab 14: Oracle Standard Tags in Oracle
Autonomous Database Dedicated for Fleet Administrators Workshop on
Oracle LiveLabs.
Your tenancies come with a library of standard tags that would apply to most
resources. These tags are currently available as a set of Tag Namespaces that your
governance administrators can deploy. OCI best practices recommend applying these
tags to all resources a standard tag can be applied to. Besides reporting and
governance, OCI service automation can deliver workload-specific optimizations
based on standard tag values.
For example, database deployments for the PeopleSoft application require a specific
configuration. By setting the appropriate application tag key in the Oracle-
ApplicationName tag namespace while deploying an Autonomous Database, can
ensure that the database is configured ready for the particular application, for
example, PeopleSoft out of the box.
4-4
Chapter 4
Tagging Oracle Exadata Database Service on Cloud@Customer Resources
4-5
Chapter 4
Tagging Oracle Exadata Database Service on Cloud@Customer Resources
Regulation Description
PCI DSS Payment Card Industry Data Security
Standard
HIPAA Health Insurance Portability and Accountability
Act
ISO International Standards Organization
SOC1 System and Organization Controls 1
SOC 2 System and Organization Controls 2
4-6
Chapter 4
Tagging Oracle Exadata Database Service on Cloud@Customer Resources
Regulation Description
FedRamp Federal Risk and Authorization Management
Program
GLBA Gramm–Leach–Bliley Act
CCPA California Consumer Privacy Act
SOX Sarbanes Oxley
NIST National Institute of Standards and Technology
- Cyber Security
FISMA Federal Information Security Management
HITECH Health Information Technology for Economic
and Clinical Health Act
FERPA Family Educational Rights and Privacy Act
( Student privacy)
FACTA Fair and Accurate Credit Transaction Act
Texas HB300 Texas Medical Records Privacy Act
CIS Center for Internet Security
CJIS Criminal Justice Information Services Security
Policy
C-TPAT Customs-Trade Partnership Against Terrorism
COPPA Children's Online Privacy Protection Act
PIPED Act, or PIPEDA Personal Information Protection and Electronic
Documents Act
GDPR General Data Protection Regulation
PIPL Personal Information Protection Law
4-7
Chapter 4
Oracle Exadata Cloud@Customer Deployment Assistant
Related Topics
• Cloud Advisor Overview
• Oracle Autonomous Database Dedicated for Fleet Administrators Workshop
• How Tagging Works
• Authentication and Authorization
• Managing Tag Namespaces
• Using Predefined Values
4-8
Chapter 4
Oracle Exadata Cloud@Customer Deployment Assistant
file. The configuration file drives the automated installation and configuration processes for
Oracle Exadata Cloud@Customer infrastructure.
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 Oracle Exadata Cloud@Customer infrastructure configuration file.
During deployment, if you find any discrepancies at any stage, then click Close and
complete later to exit Oracle Exadata Cloud@Customer Deployment Assistant. You will lose
all of your settings and you will have to start afresh the next time.
Step 1: Pre-Installation
Create Exadata Cloud@Customer infrastructure, VM cluster network, and download the
infrastructure configuration file before your engineered system arrives at your premises.
1. Create Oracle Exadata Database Service on Cloud@Customer infrastructure.
4-9
Chapter 4
Overview of Elastic Storage Expansion
For more information and instructions, see Using the Console to Create Oracle
Exadata Database Service on Cloud@Customer Infrastructure.
2. Create VM cluster network.
For more information and instructions, see Using the Console to Create a VM
Cluster Network.
3. Download the Oracle Exadata Database Service on Cloud@Customer
configuration file.
For more information and instructions, see Using the Console to Download a File
Containing Configuration Data.
Step 3: Post-Installation
Create a VM cluster, install Oracle Database, and validate your installation before
performing any administrative tasks.
1. Create VM cluster.
For more information and instructions, see Using the Console to Create a VM
Cluster.
2. Create Oracle Database.
For more information and instructions, see Using the Console to Create a
Database.
4-10
Chapter 4
Overview of Elastic Storage Expansion
Expand the storage capacity on-demand by scaling up the infrastructure with additional
storage servers without being constrained by the standard supported shapes. You can
allocate additional storage capacity available from the newly added storage servers to the
already deployed VM Cluster without disrupting the current running workloads. Additional
storage capacity from newly added storage servers is also available for provisioning new VM
Clusters on the infrastructure.
With the elastic storage expansion capability, you can now:
• Provision new Exadata Infrastructure with custom storage capacity.
• Start with a smaller storage footprint for the Exadata Infrastructure at install time.
• Expand the storage capacity on existing deployed Exadata Infrastructure on-demand in
an automated, elastic fashion.
• Allocate additional storage capacity available from newly added storage servers to
already deployed VM clusters and/or use them for provisioning new VM clusters on the
infrastructure.
4-11
Chapter 4
Overview of Elastic Storage Expansion
4-12
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
Related Topics
• Using the Console to Scale Infrastructure Compute and Storage
To scale infrastructure compute and storage, complete this procedure.
• Using the Console to Download Scale Infrastructure Compute and Storage Configuration
File
To download an Oracle Exadata Cloud@Customer scale configuration file, complete this
procedure.
• Using the Console to Activate New Database and Storage Servers
To download an Oracle Exadata Cloud@Customer scale configuration file, complete this
procedure.
• Using the Console to Make Storage Capacity from New Server Available for VM Clusters
Consumption
To make storage capacity from the new servers for VM clusters consumption, complete
this procedure.
• Using the Console to View Details of Exadata Cloud@Customer Infrastructure with
Scaled Compute and Storage Capacity
To view the storage capacity from the new storage server, or scaled compute capacity,
use this procedure.
4-13
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
4-14
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
infrastructure is created. Therefore, check the displayed region to ensure that you are
using the most appropriate region for your infrastructure.
See step 2 (earlier in this procedure) for further considerations. To switch regions
now, use the Region menu at the top of the console.
• Choose a compartment: From the list of available compartments, choose the
compartment that you want to contain the Oracle Exadata infrastructure.
For more information, see Understanding Compartments.
• Provide the display name: The display name is a user-friendly name that you can
use to identify the Exadata infrastructure. The name doesn't need to be unique,
because an Oracle Cloud Identifier (OCID) uniquely identifies the Oracle Exadata
infrastructure.
• Select the Exadata system model: From the list, choose an Oracle Exadata
hardware.
The Oracle Exadata system model and system shape combine to define the amount
of CPU, memory, and storage resources that are available in the Exadata
infrastructure. For more information, see System Configuration.
– Base model: The base system comes with reduced capacity compute and
storage servers. Select this checkbox if it is a base system of the system model
selected above.
• Compute and storage configuration:
– Database servers: You can add a minimum of 2 and extend up to a maximum of
8 database servers.
– Storage servers: You can add a minimum of 3 and extend up to a maximum of
12 storage servers. For each storage server you add, the storage capacity that
will be added is displayed on the right.
• Configure the cloud control plane server network
Each Oracle Exadata Database Service on Cloud@Customer system contains two
control plane servers, which enable connectivity to Oracle Cloud Infrastructure. The
control plane servers are connected to the control plane network, which is a subnet
on your corporate network. The following settings define the network parameters:
– Control Plane Server 1 IP Address: Provide the IP address for the first control
plane server. This IP address is for the network interface that connects the first
control plane server to your corporate network using the control plane network.
– Control Plane Server 2 IP Address: Provide the IP address for the second
control plane server. This IP address is for the network interface that connects
the second control plane server to your corporate network using the control plane
network.
– Netmask: Specify the IP netmask for the control plane network.
– Gateway: Specify the IP address of the control plane network gateway.
– HTTP Proxy: (Optional) You can choose to use this field to specify your
corporate HTTP proxy. The expected format is as follows, where server is the
server name, domain is the domain name, and port is the assigned port:
http://server.domain:port
4-15
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
For example:
http://proxy.example.com:80
For enhanced security, when possible, Oracle recommends that you use
an HTTP proxy.
– Enable Control Plane Server Offline Report: Enabling the Control Plane
Server (CPS) offline report helps in diagnosing connectivity issues
between the CPS and OCI endpoints, should they arise.
To view the report, do the following:
a. Find the CPS IP addresses.
For more information, see Using the Console to View Exadata
Infrastructure Network Configuration Details.
b. From your local network, access the report over HTTP.
To view the report in HTML format, use http://
<CPSPublicIP>:18080/report
To view the report in JSON format, use http://
<CPSPublicIP>:18080/report/json
For more information, see ExaCC gen2: Troubleshooting VPN/WSS
connection from Customer Side.
• Configure the Oracle Exadata system networks
Each Oracle Exadata Database Service on Cloud@Customer system contains
two system networks, which are not connected to your corporate network. The
following settings define IP address allocations for these networks:
– Administration Network CIDR Block: Specifies the IP address range for
the administration network using CIDR notation. The administration
network provides connectivity that enables Oracle to administer the
Exadata system components, such as the Exadata compute servers,
storage servers, network switches, and power distribution units. You can
accept the suggested default, or specify a custom value.
The maximum CIDR block prefix length is /23, which defines the smallest
block of IP addresses that are required for the network. To allow for
possible future expansion within Exadata Database Service on
Cloud@Customer, a smaller CIDR block prefix length is recommended,
which reserves more IP addresses for the network. The minimum CIDR
block prefix length is /16.
Note:
You cannot change this value in the future. Consider all future
expansions when making this choice. Otherwise, your future
expandability may be limited.
Ensure that the IP address range does not conflict with other hosts of your
corporate network, and does not overlap with the InfiniBand network CIDR
block.
4-16
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
• InfiniBand Network CIDR Block: Specifies the IP address range for the Exadata
InfiniBand network using CIDR notation. The Exadata InfiniBand network provides
the high-speed low-latency interconnect used by Exadata software for internal
communications between various system components. You can accept the
suggested default, or specify a custom value.
The maximum CIDR block prefix length is /22, which defines the smallest block of IP
addresses that are required for the network. To allow for possible future expansion
within Exadata Database Service on Cloud@Customer, a smaller CIDR block prefix
length is recommended, which reserves more IP addresses for the network. The
minimum CIDR block prefix length is /19.
Ensure that the IP address range does not conflict with other hosts your corporate
network, and does not overlap with the administration network CIDR block.
• Configure DNS and NTP services
Each Exadata Database Service on Cloud@Customer system requires access to
Domain Names System (DNS) and Network Time Protocol (NTP) services. The
following settings specify the servers that provide these services to the Exadata
infrastructure:
– DNS Servers: Provide the IP address of a DNS server that is accessible using
the control plane network. You may specify up to three DNS servers.
– NTP Servers: Provide the IP address of an NTP server that is accessible using
the control plane network. You may specify up to three NTP servers.
– Time Zone: The default time zone for the Exadata Infrastructure is UTC, but you
can specify a different time zone. The time zone options are those supported in
both the Java.util.TimeZone class and the Oracle Linux operating system.
Note:
If you want to set a time zone other than UTC or the browser-detected
time zone, then select the Select another time zone option, select a
Region or country, and then select the corresponding Time zone.
If you do not see the region or country you want, then select
Miscellaneous, and then select an appropriate Time zone.
4-17
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
Note:
After creating the infrastructure, you can find the maintenance
method, maintenance schedule, DB Server version, and Storage
Server version details under the Maintenance and Version
sections on the Infrastructure Details page.
4-18
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
want. When you promote a secondary contact to primary, the current primary
contact will be demoted automatically to secondary.
• Show Advanced Options
You have the option to configure advanced options.
– Tags: (Optional) You can choose to apply tags. If you have permission to create
a resource, then you also have permission to apply free-form tags to that
resource. To apply a defined tag, you must have permission to use the tag
namespace. For more information about tagging, see Resource Tags. If you are
not sure if you should apply tags, then skip this option (you can apply tags later)
or ask your administrator.
6. Click Create Exadata Infrastructure.
If all of your inputs are valid, then the Infrastructure Details page appears. The page
outlines the next steps in the provisioning process. Initially, after creation, the state of the
Oracle Exadata infrastructure is Requires-Activation.
Related Topics
• Understanding Compartments
• System Configuration Options for Oracle Exadata Database Service on
Cloud@Customer
To meet the needs of your enterprise, you can select from one of the four Oracle Exadata
X9M-2, X8M-2, X8-2, or X7-2 System Models.
• ExaCC gen2: Troubleshooting VPN/WSS connection from Customer Side
• Resource Tags
Note:
• You cannot enable or disable Control Plane Server diagnostic offline report if
the Exadata Infrastructure is in DISCONNECTED mode.
• At any given point in time, the report is available only at the primary Control
Plane Server. When generating a report, if the first IP address specified for the
Control Plane Servers does not work, then you may try the second IP.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Under Region, select the region that you want to associate with the Oracle Exadata
infrastructure.
3. Click Exadata Infrastructure.
4. From the list of infrastructures, click the name of the infrastructure that you're interested
in.
5. On the Infrastructure Details page, find the Control Plane Server Offline Report details
under the Network section.
4-19
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
Related Topics
• Using the Console to View Exadata Infrastructure Network Configuration Details
To view network configuration details, follow these steps. Save this information for
later use to troubleshoot if you face network issues.
4-20
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
infrastructure is Requires Activation. Also, ensure that you do not edit the Exadata
infrastructure after you download the configuration file and provide it to Oracle.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Select Region and Compartment, and provide the region and the compartment where
the Oracle Exadata infrastructure you want to edit is located.
3. Click Exadata Infrastructure.
4. Click the name of the Exadata infrastructure that you want to edit.
The Infrastructure Details page displays information about the selected Oracle Exadata
infrastructure.
5. Click Edit Infrastructure Networking.
6. Use the Edit Infrastructure Networking dialog to edit the Oracle Exadata infrastructure
networking:
a. Configure the cloud control plane network
Each Oracle Exadata Database Service on Cloud@Customer system contains two
Control Plane Servers, which enable connectivity to Oracle Cloud Infrastructure. The
Control Plane Servers are connected to the control plane network, which is a subnet
on your corporate network. The following settings define the network parameters:
• Control Plane Server 1 IP Address: Provide the IP address for the first control
plane server. This IP address is for the network interface that connects the first
Control Plane Server to your corporate network using the control plane network.
• Control Plane Server 2 IP Address: Provide the IP address for the second
control plane server. This IP address is for the network interface that connects
the second Control Plane Server to your corporate network using the control
plane network.
• Netmask: Specify the IP netmask for the control plane network.
• Gateway: Specify the IP address of the control plane network gateway.
• HTTP Proxy: Optionally, you can use this field to specify your corporate HTTP
proxy to use for the HTTPS connection from the Control Plane Server to Oracle
Cloud Infrastructure. The expected format is:
http://server.domain:port
For example:
http://proxy.example.com:80
For enhanced security, when possible, Oracle recommends that you use an
HTTP proxy.
b. Configure the Exadata system networks
Each Oracle Exadata Database Service on Cloud@Customer system contains two
system networks, which are not connected to your corporate network. The following
settings define IP address allocations for these networks:
• Administration Network CIDR Block: Specifies the IP address range for the
administration network using CIDR notation. The administration network provides
connectivity that enables Oracle to administer the Exadata system components,
4-21
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
Note:
If you want to set a time zone other than UTC or the browser-
detected time zone, then select the Select another time zone
option, select a Region or country, and then select the
corresponding Time zone.
If you do not see the region or country you want, then select
Miscellaneous, and then select an appropriate Time zone.
4-22
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
4-23
Chapter 4
Using the Console to Provision Exadata Database Service on Cloud@Customer Infrastructure
The Infrastructure Details page displays information about the selected Oracle
Exadata infrastructure.
6. Click Activate on the banner displayed.
The Activate button is only available if the Oracle Exadata infrastructure requires
activation. You cannot activate Oracle Exadata infrastructure multiple times.
7. Use the Activate dialog to upload the activation file, and then click Activate Now.
The activation file includes all the relevant details for the additional storage servers
included as part of the create infrastructure flow.
After activation, the state of the Oracle Exadata infrastructure changes to Active.
4-24
Chapter 4
Configuring Oracle-Managed Infrastructure Maintenance
4-25
Chapter 4
Configuring Oracle-Managed Infrastructure Maintenance
For example, database server patching typically requires a reboot. In such cases,
wherever possible, the database servers are restarted in a rolling manner, one at a
time, to ensure that the service remains available throughout the process. However,
each database server is unavailable for a short time while it restarts, and the overall
service capacity diminishes accordingly. If your applications cannot tolerate the
restarts, then take mitigating action as needed. For example, shut down an application
while database server patching occurs.
• Overview of the Quarterly Infrastructure Maintenance Process
By default, infrastructure maintenance updates the Exadata database server hosts
in a rolling fashion, followed by updating the storage servers.
4-26
Chapter 4
Configuring Oracle-Managed Infrastructure Maintenance
precheck is run approximately 24 hours prior to maintenance start. If the prechecks identify
an issue that requires rescheduling the maintenance notification is sent to the maintenance
contacts.
The time taken to update infrastructure components varies depending on the number of
database servers and storage servers in the Exadata infrastructure, the maintenance
method, and whether custom action has been enabled. The approximate times provided are
estimates. Time for custom action, if configured, is not included in the estimates below.
Database server maintenance time may vary depending on the time required to shutdown
each VM before the update and then start each VM and associated resources after the
update of each node before proceeding to the next node. The storage server maintenance
time will vary depending on the time required for the ASM rebalance, which is not included in
the estimates below. If issues are encountered during maintenance this may also delay
completion beyond the approximate time listed. In such a situation, if Oracle cloud operations
determine resolution would extend beyond the expected window, they will send a notification
and may reschedule the maintenance.
• Rolling:
– Each database server takes 90 minutes on average.
– Each storage server takes 60 minutes on average.
– Each InfiniBand or RoCE fabric switches take 30 minutes on average.
– The approximate total time for infrastructure maintenance is as follows:
* Base and Quarter Rack (2 Database Servers/3 Storage Servers):
Approximately 7 hours
2 Database Servers X 90 = 180 minutes
3 Storage Servers X 60 = 180 minutes
2 InfiniBand or RoCE Fabric Switch X 30 = 60 minutes
* Half Rack (4 Database Servers/6 Storage Servers): Approximately 13 hours
4 Database Servers X 90 = 360 minutes
6 Storage Servers X 60 = 360 minutes
2 InfiniBand or RoCE Fabric Switch X 30 = 60 minutes
* Full Rack (8 Database Servers/12 Storage Servers): Approximately 26 hours
8 Database Servers X 90 = 720 minutes
12 Storage Servers X 60 = 720 minutes
2 InfiniBand or RoCE Fabric Switch X 30 = 60 minutes
• Non-Rolling:
– All database servers take 180 minutes on average.
– All storage servers take 60 minutes on average.
– Storage Servers and Database servers are brought back online prior to starting fabric
switch maintenance.
– Network fabric switches are still updated in a rolling method and take 30 minutes
each on average.
– The approximate total time for infrastructure maintenance is 5 hours regardless of
shape:
4-27
Chapter 4
Configuring Oracle-Managed Infrastructure Maintenance
4-28
Chapter 4
Configuring Oracle-Managed Infrastructure Maintenance
Note:
Changes made to maintenance preferences apply only to future maintenance,
not the maintenance that has already been scheduled. To modify scheduled
maintenance, see View or Edit a Scheduled Maintenance for Exadata
Cloud@Customer Infrastructure.
4-29
Chapter 4
Configuring Oracle-Managed Infrastructure Maintenance
4-30
Chapter 4
Configuring Oracle-Managed Infrastructure Maintenance
* Under Lead Time, specify the minimum number of weeks ahead of the
maintenance event you would like to receive a notification message. Your
lead time ensures that a newly released maintenance update is scheduled to
account for your required minimum period of advanced notification.
7. Click Save Changes.
If you switch from rolling to non-rolling maintenance method, then Confirm Non-rolling
Maintenance Method dialog is displayed.
a. Enter the name of the infrastructure in the field provided to confirm the changes.
b. Click Save Changes.
Note:
An information block is displayed 6 hours before the start of a maintenance run,
regardless of whether you've chosen rolling or non-rolling maintenance method.
When the maintenance begins, it is automatically removed.
5. On the Infrastructure Details page, under Maintenance, click the view link in the Next
Quarterly Maintenance field.
The Exadata Infrastructure Maintenance page is displayed.
6. On the Exadata Infrastructure Maintenance page, scheduled maintenance details are
listed.
Target DB Server Version and Target Storage Server Version: These fields display the
Exadata software version to be applied by the scheduled maintenance. The version
applied will be the most recent certified update for Exadata infrastructures in the cloud. If
the next quarterly update is not yet certified when the maintenance is scheduled, then the
versions may show "LATEST" until the new quarterly update becomes available. Once
the update becomes available the new version will be displayed.
To find information on the Database Server Exadata software version or the Storage
Server Exadata software version, see My Oracle Support note Exadata Database
Machine and Exadata Storage Server Supported Versions (Doc ID 888828.1).
7. To change the next scheduled maintenance settings, click Edit Maintenance Run.
On the Edit Maintenance page, do the following:
4-31
Chapter 4
Configuring Oracle-Managed Infrastructure Maintenance
Note:
If you select the Non-rolling option, an information block appears
stating that components will be updated simultaneously, resulting in
full system downtime.
4-32
Chapter 4
Configuring Oracle-Managed Infrastructure Maintenance
a. To view the number of VMs that will be restarted as part of Database Server
maintenance, click the Show details link.
The VM Location dialog is displayed.
b. In the VM Cluster Name field, you can find out what VM cluster a particular VM
belongs to.
c. Click Close.
9. Click Close to close the Estimated Maintenance Time Details page.
Related Topics
• https://support.oracle.com/epmos/faces/DocContentDisplay?id=888828.1
4-33
Chapter 4
Configuring Oracle-Managed Infrastructure Maintenance
• If you specify a maintenance window, then patching begins at your specified start
time. The infrastructure resource's lifecycle state changes from Available to
Maintenance in Progress.
Note:
The prechecks are now done prior to the start of the maintenance.
4-34
Chapter 4
Creating First VM Cluster Network on Exadata Cloud@Customer
Related Topics
• Oracle Exadata Database Service on Cloud@Customer Events
Exadata Cloud@Customer resources emit events, which are structured messages that
indicate changes in resources.
• Overview of Events
• Notifications Overview
• Managing Infrastructure Maintenance Contacts
Learn to manage your Exadata infrastructure maintenance contacts.
4-35
Chapter 4
Creating First VM Cluster Network on Exadata Cloud@Customer
Note:
Avoid entering confidential information when assigning descriptions, tags, or
friendly names to your cloud resources through the Oracle Cloud
Infrastructure Console, API, or CLI.
4-36
Chapter 4
Creating First VM Cluster Network on Exadata Cloud@Customer
• VLAN ID: Provide a virtual LAN identifier (VLAN ID) for the client network
between 1 and 4094, inclusive. To specify no VLAN tagging, enter "1". (This is
equivalent to a "NULL" VLAN ID tag value.)
Note:
The values "0" and "4095" are reserved and cannot be entered.
Note:
The values "0" and "4095" are reserved, and cannot be entered.
4-37
Chapter 4
Creating First VM Cluster Network on Exadata Cloud@Customer
4-38
Chapter 4
Creating First VM Cluster Network on Exadata Cloud@Customer
Related Topics
• Resource Tags
Note:
The values "0" and "4095" are reserved and cannot be entered.
4-39
Chapter 4
Creating First VM Cluster Network on Exadata Cloud@Customer
Note:
The values "0" and "4095" are reserved and cannot be entered.
4-40
Chapter 4
Provisioning the First VM Cluster on an Exadata Cloud@Customer System
4-41
Chapter 4
Provisioning the First VM Cluster on an Exadata Cloud@Customer System
Note:
Avoid entering confidential information when assigning descriptions, tags, or
friendly names to your cloud resources through the Oracle Cloud
Infrastructure Console, API, or CLI.
ssh-rsa AAAAB3NzaC1yc2EAAAABJQAA....lo/gKMLVM2xzc1xJr/
Hc26biw3TXWGEakrK1OQ== rsa-key-20160304
Related Topics
• Managing Key Pairs on Linux Instances
4-42
Chapter 4
Provisioning the First VM Cluster on an Exadata Cloud@Customer System
Note:
4-43
Chapter 4
Provisioning the First VM Cluster on an Exadata Cloud@Customer System
g. Specify the OCPU count per VM: Specify the OCPU count for each
individual VM. The minimum value is 2 OCPUs per VM (for a live VM
condition), unless you are specifying zero OCPUs (for a shutdown VM
condition).
If you specify a value of zero, then the VM cluster virtual machines are all shut
down at the end of the cluster creation process. In this case, you can later
start the virtual machines by scaling the OCPU resources. See Using the
Console to Scale the Resources on a VM Cluster.
The value for OCPU count for the whole VM Cluster will be calculated
automatically based upon the per VM OCPU count you have specified and the
number of physical Database Servers configured for the system. There is one
VM created on each physical Database Server available.
OCPU: An Oracle Compute Unit (OCPU) provides CPU capacity equivalent of
one physical core of an Intel Xeon processor with hyperthreading enabled.
Each OCPU corresponds to two hardware execution threads, known as
vCPUs.
See, Oracle Platform as a Service and Infrastructure as a Service – Public
Cloud Service DescriptionsMetered & Non-Metered.
h. Requested OCPU count for the VM Cluster: Displays the total number of
CPU cores allocated to the VM cluster based on the value you specified in the
Specify the OCPU count per VM field. This field is not editable.
i. Specify the memory per VM (GB): Specify the memory for each individual
VM. The value must be a multiple of 1 GB and is limited by the available
memory on the Exadata infrastructure.
j. Requested memory for the VM Cluster (GB): Displays the total amount of
memory allocated to the VM cluster based on the value you specified in the
Specify the memory per VM (GB) field. This field is not editable.
k. Specify the local file system size per VM (GB): Specify the local file system
size for each individual VM. The value must be a multiple of 1 GB and is
limited by the available size of the file system on the X8-2 and X7-2
infrastructures.
Note that the minimum size of local system storage must be 60 GB. In addition
to the 60 GB, each node of the VM must have at least 137 GB free for
miscellaneous VM files. Each time when you create a new VM cluster, the
space remaining out of the total available space is utilized for the new VM
cluster.
For more information and instructions to specify the size for each individual
VM, see Introduction to Scale Up or Scale Down Operations.
l. Reserved local storage per VM (GB): Displays the local storage size
reserved internally for root file systems, Oracle Grid Infrastructure Homes, and
diagnostic logs. This field is not editable.
m. Configure the Exadata Storage: The following settings define how the
Exadata storage is configured for use with the VM cluster. These settings
cannot be changed after creating the VM cluster.
• Specify Usable Exadata Storage: Specify the size for each individual
VM. The minimum recommended size is 2 TB.
• Allocate Storage for Exadata Snapshots: Check this option to create a
sparse disk group, which is required to support Exadata snapshot
4-44
Chapter 4
Provisioning the First VM Cluster on an Exadata Cloud@Customer System
Storage Allocation DATA Disk Group RECO Disk Group SPARSE Disk Group
Exadata Snapshots: 80% 20% 0% (The SPARSE disk
No group is not created.)
Enable Backups on
Local Exadata
Storage: No
Exadata Snapshots: 40% 60% 0% (The SPARSE disk
No group is not created.)
Enable Backups on
Local Exadata
Storage: Yes
Allocate Storage for 60% 20% 20%
Exadata Snapshots:
Yes
Enable Backups on
Local Exadata
Storage: No
Allocate Storage for 35% 50% 15%
Exadata Snapshots:
Yes
Enable Backups on
Local Exadata
Storage: Yes
n. Add SSH Key: Specify the public key portion of an SSH key pair that you want to
use to access the VM cluster virtual machines. You can upload a file containing the
key, or paste the SSH key string.
To provide multiple keys, upload multiple key files or paste each key into a separate
field. For pasted keys, ensure that each key is on a single, continuous line. The
length of the combined keys cannot exceed 10,000 characters.
o. Choose a license type:
• Bring Your Own License (BYOL): Select this option if your organization already
owns Oracle Database software licenses that you want to use on the VM cluster.
• License Included: Select this option to subscribe to Oracle Database software
licenses as part of Exadata Database Service on Cloud@Customer.
p. Diagnostics Collection:
By enabling diagnostics collection and notifications, Oracle Cloud Operations and
you will be able to identify, investigate, track, and resolve guest VM issues quickly
and effectively. Subscribe to Events to get notified about resource state changes. For
more information, see Getting Started with Events.
4-45
Chapter 4
Provisioning the First VM Cluster on an Exadata Cloud@Customer System
Note:
You are opting in with the understanding that the list of events,
metrics, and log files collected can change in the future. You can opt
out of this feature at any time.
Note:
If you want to set a time zone other than UTC or the browser-
detected time zone, then select the Select another time zone
option, select a Region or country, and then select the
corresponding Time zone.
If you do not see the region or country you want, then select
Miscellaneous, and then select an appropriate Time zone.
• Tags: Optionally, you can apply tags. If you have permission to create a
resource, you also have permission to apply free-form tags to that
resource. To apply a defined tag, you must have permission to use the tag
namespace. For more information about tagging, see Resource Tags. If
you are not sure if you should apply tags, skip this option (you can apply
tags later) or ask your administrator.
6. Click Create VM Cluster.
4-46
Chapter 4
Creating Database Backup Destinations for Exadata Cloud@Customer
The VM Cluster Details page is now displayed. While the creation process is running, the
state of the VM cluster is Pending. When the VM cluster creation process completes, the
state of the VM cluster changes to Available.
Related Topics
• Oracle Exadata Database Service on Cloud@Customer Service Description
Learn how you can leverage the combined capabilities of Oracle Exadata and Oracle
Cloud Infrastructure with Oracle Exadata Database Service on Cloud@Customer
• Using the Console to Scale the Resources on a VM Cluster
Starting in Exadata Database Service on Cloud@Customer Gen2, you can scale up or
down multiple resources at the same time. You can also scale up or down resources one
at a time.
• Introduction to Scale Up or Scale Down Operations
With the Multiple VMs per Exadata system (MultiVM) feature release, you can scale up or
scale down your VM cluster resources.
• Estimating How Much Local Storage You Can Provision to Your VMs
• Resource Tags
• Oracle PaaS/IaaS Cloud Service Description documents
• Oracle Platform as a Service and Infrastructure as a Service – Public Cloud Service
DescriptionsMetered & Non-Metered
• Getting Started with Events
• Overview of Database Service Events
• Overview of Health Metrics and Log Collection
By enabling diagnostics collection and notifications, Oracle Cloud Operations and you will
be able to identify, investigate, track, and resolve guest VM issues quickly and effectively.
Subscribe to Events to get notified about resource state changes.
• Incident Logs and Trace Files
This section lists all of the files that can be collected by Oracle Support if you opt-in for
incident logs and trace collection.
• Health Metrics
Review the list of database and non-database health metrics collected by Oracle Trace
File Analyzer.
• Using the Console to Enable, Partially Enable, or Disable Diagnostics Collection
You can enable, partially enable, or disable diagnostics collection for your Guest VMs
after provisioning the VM cluster. Enabling diagnostics collection at the VM cluster level
applies the configuration to all the resources such as DB home, Database, and so on
under the VM cluster.
4-47
Chapter 4
Creating Database Backup Destinations for Exadata Cloud@Customer
Note:
Avoid entering confidential information when assigning descriptions, tags, or
friendly names to your cloud resources through the Oracle Cloud
Infrastructure Console, API, or CLI.
4-48
Chapter 4
Creating Database Backup Destinations for Exadata Cloud@Customer
Related Topics
• Zero Data Loss Recovery Appliance
• Manage Oracle Database Homes on Exadata Database Service on Cloud@Customer
Systems
Learn to manage Oracle Database homes on Exadata Database Service on
Cloud@Customer.
• Using the Console to Create a Backup Destination
To create a backup destination, be prepared to provide values for the backup destination
configuration.
• Manage Database Backup and Recovery on Oracle Exadata Database Service on
Cloud@Customer
Learn how to work with the backup and recovery facilities provided by Oracle Exadata
Database Service on Cloud@Customer.
4-49
Chapter 4
Creating Database Backup Destinations for Exadata Cloud@Customer
* If permissions are being controlled at the user level, then the uid:gid of the
oracle user for the Autonomous VM cluster is 1001:1001.
4-50
Chapter 4
Creating Database Backup Destinations for Exadata Cloud@Customer
Note:
You can also set OCI Object Store as a backup destination. However, you
cannot set it from this screen. You can configure OCI Object Store as a
backup destination when creating a database. For more information, see
Backup Destination Type in Using the Console to Create a Database.
4-51
Chapter 4
Creating Database Backup Destinations for Exadata Cloud@Customer
Note:
You cannot edit a Backup Destination if there is already a database
attached to it.
• If you are editing a Zero Data Loss Recovery Appliance backup destination:
– Provide the Recovery Appliance connection string: Specify the Oracle
Net Services connection string that connects to the Recovery Appliance.
This information is typically provided by the Recovery Appliance
administrator.
– Provide the Virtual Private Catalog (VPC) Users: Provide a VPC user
name for connecting to the Recovery Appliance. You can specify multiple
VPC user names in case you want to use the Recovery Appliance as a
backup destination for multiple databases. This information is typically
provided by the Recovery Appliance administrator.
• If you are editing an NFS backup destination:
– Self-mount for non-autonomous databases:
Provide the local NFS mount point path: Specify the local directory path
on each VM cluster node where the NFS server location is mounted. The
local directory path and the NFS server location must each be the same
across all of the VM cluster nodes.
– Auto-mount for Autonomous Databases:
Use this destination for Autonomous Databases:
* NFS server: Specify the IP address of the NFS server. Optionally, you
can specify up to four IP addresses.
4-52
Chapter 4
Creating Database Backup Destinations for Exadata Cloud@Customer
* NFS export share: Specify the directory path where the exported file system
is mounted.
7. Click Save Changes.
4-53
Chapter 4
Creating First Database Home on an Exadata Database Service on Cloud@Customer System
6. In the resulting dialog, enter the backup destination name and click Delete
Backup Destination to confirm the action.
Note:
Avoid entering confidential information when assigning descriptions, tags, or
friendly names to your cloud resources through the Oracle Cloud
Infrastructure Console, API, or CLI.
You can also add and remove Database homes, and perform other management tasks
on a Database home by using the dbaascli utility.
Related Topics
• Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Learn to use the dbaascli utility on Exadata Cloud@Customer.
4-54
Chapter 4
Creating First Database Home on an Exadata Database Service on Cloud@Customer System
Note:
For the Oracle Database major version releases available in Oracle Cloud
Infrastructure, images are provided for the current version plus the three
most recent older versions (N through N - 3). For example, if an instance is
using Oracle Database 19c, and the latest version of 19c offered is
19.8.0.0.0, images available for provisioning are for versions 19.8.0.0.0,
19.7.0.0, 19.6.0.0 and 19.5.0.0.
A Database Software Image will not be available for Database Home creation if:
4-55
Chapter 4
Creating First Database Home on an Exadata Database Service on Cloud@Customer System
Related Topics
• Resource Tags
4-56
Chapter 4
Creating First Database on an Exadata Database Service on Cloud@Customer System
4-57
Chapter 4
Creating First Database on an Exadata Database Service on Cloud@Customer System
4-58
Chapter 4
Creating First Database on an Exadata Database Service on Cloud@Customer System
• Each database is configured with default instance parameter settings. While the defaults
are reasonable for many cases, you should review the instance parameter settings to
ensure that they meet your specific application needs.
In particular, review the Oracle Database system global area (SGA) and program global
area (PGA) instance parameter settings, especially if your VM cluster supports multiple
databases. Also, ensure that the sum of all Oracle Database memory allocations never
exceeds the available physical memory on each virtual machine.
• Exadata Database Service will only create databases with 8K block size. This parameter
cannot be changed.
• Each database using Oracle Database 12c Release 1 or a later release is configured as
a container database (CDB). One pluggable database (PDB) is created inside the CDB.
By default:
– The first PDB is configured with a local PDB administration user account, named
PDBADMIN.
– The PDBADMIN user account is initially configured with the same administration
password as the CDB SYS and SYSTEM users.
– The PDBADMIN user account is initially configured with basic privileges assigned
through two roles; CONNECT and PDB_DBA. However, for most practical administrative
purposes you must assign extra privileges to the PDBADMIN user account, or to the
PDB_DBA role.
You can use native Oracle Database facilities to create extra PDBs, and to manage all of
your PDBs. The dbaascli utility also provides a range of convenient PDB management
functions.
Note:
Avoid entering confidential information when assigning descriptions, tags, or friendly
names to your cloud resources through the Oracle Cloud Infrastructure Console,
API, or CLI.
4-59
Chapter 4
Creating First Database on an Exadata Database Service on Cloud@Customer System
Note:
You cannot modify the db_name, db_unique_name, and SID prefix after
creating the database.
• Provide the database name: Specify a user-friendly name that you can use
to identify the database. The database name must contain only the permitted
characters.
Review the following guidelines when selecting a database name.
– maximum of 8 characters
– contain only alphanumeric characters
– begin with an alphabetic character
– cannot be part of first 8 characters of a db_unique_name on the VM cluster
– unique within a VM cluster
– DO NOT use grid because grid is a reserved name
– DO NOT use ASM because ASM is a reserved name
• Provide a unique name for the database: Optionally, specify a unique name
for the database. This attribute defines the value of the db_unique_name
database parameter. The value is case insensitive.
The db_unique_name must contain only the permitted characters. Review the
following guidelines when selecting a database name.
– maximum of 30 characters
– can contain alphanumeric and underscore (_) characters
– begin with an alphabetic character
– unique across the fleet/tenancy
If a unique name is not provided, then the db_unique_name defaults to the
following format <db_name>_<3 char unique string>_<region-name>.
If you plan to configure the database for backup to a Recovery Appliance
backup destination, then the unique database name must match the name
that is configured in the Recovery Appliance.
• Select a database version: From the list, choose the Oracle Database
software release that you want to deploy.
4-60
Chapter 4
Creating First Database on an Exadata Database Service on Cloud@Customer System
Note:
For the Oracle Database major version releases available in Oracle
Cloud Infrastructure, images are provided for the current version
plus the three most recent older versions (N through N - 3). For
example, if an instance is using Oracle Database 19c, and the
latest version of 19c offered is 19.8.0.0.0, images available for
provisioning are for versions 19.8.0.0.0, 19.7.0.0, 19.6.0.0 and
19.5.0.0.
• Provide the name of the first PDB: (Optional) Specify the name for the first PDB. A
PDB is created with the database.
To avoid potential service name collisions when using Oracle Net Services to connect
to the PDB, ensure that the PDB name is unique across the entire VM cluster. If you
do not provide the name of the first PDB, then a system-generated name is used.
• Provide the administration password: Provide and confirm the Oracle Database
administration password. This password is used for administration accounts and
functions in the database, including:
– The password for the Oracle Database SYS and SYSTEM users.
– The Transparent Data Encryption (TDE) Keystore password.
For Oracle Database 12c Release 1 or later releases, the password for the PDB
administration user in the first PDB (PDBADMIN) must be nine to 30 characters and
contain at least two uppercase, two lowercase, two numeric, and two special
characters. The special characters must be _, #, or -. In addition, the password must
not contain the name of the tenancy or any reserved words, such as Oracle or Table,
regardless of casing.
– Use the administrator password for the TDE wallet: When this option is
checked, the password entered for the SYS user is also used for the TDE wallet.
4-61
Chapter 4
Creating First Database on an Exadata Database Service on Cloud@Customer System
To set the TDE wallet password manually, uncheck this option and enter
the TDE wallet password.
• Choose the database workload type: Select the workload type that best
suits your application from one of the following options:
– Transactional Processing: Select this option to configure the database
for a transactional workload, with a bias toward high volumes of random
data access.
– Data Warehouse: Select this option to configure the database for decision
support or data warehouse workload, with a bias toward large data
scanning operations.
• Backup Destination Type: Select a backup destination for the database.
From the list, choose an option:
– None: Select to not define a backup configuration for the database.
– Local: Select to store backups locally in the Oracle Exadata Storage
Servers on your Oracle Exadata Cloud at Customer system.
This option is available only if you enabled backups on local Oracle
Exadata storage in the VM cluster that you want to host the database.
– Object Storage: Select to store backups in an Oracle-managed object
storage container on Oracle Cloud Infrastructure.
To use this option, your Oracle Exadata Cloud@Customer system must
have egress connectivity to Oracle Cloud Infrastructure Object Storage.
– NFS: Select to store backups in one of your previously defined backup
destinations that use Network File System (NFS) storage. For more
information, refer to the information about backup destinations in this
publication.
If you select this option, then you must also choose from the list of NFS
Backup Destinations.
– Recovery Appliance: Select to store backups in one of your previously
defined backup destinations that use Oracle Zero Data Loss Recovery
Appliance. Refer to the information about backup destination options in
this document.
If you select Oracle Zero Data Loss Recovery Appliance as your backup
option, then you must also:
* Choose from the list of appliance Backup Destinations.
* Choose from the VPC User list, which contains the list of virtual
private catalog (VPC) user names that are defined in the Oracle Zero
Data Loss Recovery Appliance backup destination.
* Provide the Password for the VPC user.
Note:
If you select a backup destination, then you cannot change a
backup location after the database is created. However, if you
select None now, then you can select a backup destination after
the database is created.
4-62
Chapter 4
Creating First Database on an Exadata Database Service on Cloud@Customer System
– Enable automatic backups: Select this option to enable daily backups using the
policy for automatic backups.
This option is only enabled when you select a Backup Destination Type other
than None. You can change this setting after database creation.
• (Optional) Select Show Advanced Options. From this window, you can select the
following options:
– Provide the Oracle SID prefix:
Note:
Entering a SID prefix is only available for 12.1 databases and above.
Optionally, specify the Oracle SID prefix for the database. The instance number
is automatically appended to the SID prefix to become the instance_name
database parameter. If not provided, then the SID prefix defaults to the db_name.
Review the following guidelines when selecting a database name:
* maximum of 12 characters
* contain only alphanumeric characters
* begin with an alphabetic character
* unique in the VM cluster
– Backup retention period: From the list, you can choose the length of time that
you want automatic backups to be retained.
For backups to local Exadata storage, you can choose a retention period of 7
days or 14 days. The default retention period is 7 days.
For backups to Oracle Cloud Infrastructure Object Storage, or to an NFS backup
destination, you can choose one of the following preset retention periods: 7 days,
14 days, 30 days, 45 days, or 60 days. The default retention period is 30 days.
This option does not apply to Oracle Zero Data Loss Recovery Appliance backup
destinations. For backups to Oracle Zero Data Loss Recovery Appliance, the
retention policy that is implemented in the appliance controls the retention period.
– Character set: The character set for the database. The default is AL32UTF8.
– National character set: The national character set for the database. The default
is AL16UTF16.
– Tags: (Optional) You can choose to apply tags. If you have permissions to create
a resource, you also have permissions to apply free-form tags to that resource.
To apply a defined tag, you must have permissions to use the tag namespace.
For more information about tagging, refer to information about resource tags.If
you are not sure if you should apply tags, then skip this option (you can apply
tags later), or ask your administrator.
6. Click Create Database.
Related Topics
• Resource Tags
4-63
Chapter 4
Connecting to an Exadata Database Service on Cloud@Customer System
4-64
Chapter 4
Connecting to an Exadata Database Service on Cloud@Customer System
Note:
The public keys are stored in the authorized_keys file at ~/.ssh/
authorized_keys. Separate authorized_keys files are located under the home
directories of the operating system users. By default, only the opc user account
has an authorized_keys entry and is able to log in remotely. Do not remove or
alter the automatically generated entry in authorized_keys for the opc user.
• The host name or IP address for the virtual machine that you want to access.
See, Using the Console to Check the Status of a VM Cluster Virtual Machine.
Related Topics
• Using the Console to Check the Status of a VM Cluster Virtual Machine
Review the health status of a VM cluster virtual machine.
4-65
Chapter 4
Connecting to an Exadata Database Service on Cloud@Customer System
5. In the Category tree, expand Connection if necessary and then click Data.
The Data panel is displayed.
6. In the Auto-login username field, enter the operating system user you want to
connect as:
• Connect as the user opc to perform operations that require root or oracle
access to the virtual machine, such as backing up or patching; this user can
use the sudo command to gain root or oracle access to the VM.
7. Confirm that the When username is not specified option is set to Prompt.
8. In the Category tree, expand SSH and then click Auth.
The Auth panel is displayed.
9. Click the Browse button next to the Private key file for authentication field.
Then, in the Select private key file window, navigate to and open the private key
file that matches the public key that is associated with the deployment.
10. In the Category tree, click Session.
The PuTTY Configuration window closes and the PuTTY terminal window
displays.
If this is the first time you are connecting to the VM, the PuTTY Security Alert
window is displayed, prompting you to confirm the public key. Click Yes to
continue connecting.
4. Identify the database instances for the database that you want to access. For
example:
4-66
Chapter 4
Connecting to an Exadata Database Service on Cloud@Customer System
5. Configure the environment settings for the database that you want to access. For
example:
. oraenv
ORACLE_SID = [oracle] ? s12c
The Oracle base has been set to /u02/app/oracle
export ORACLE_SID=s12c1
6. You can use the svrctl command to display more detailed information about the
database. For example:
sqlplus / as sysdba
Connected to:
Oracle Database 12c EE Extreme Perf Release 12.2.0.1.0 - 64bit Production
4-67
Chapter 4
Connecting to an Exadata Database Service on Cloud@Customer System
4-68
Chapter 4
Connecting to an Exadata Database Service on Cloud@Customer System
Note:
This documentation provides basic requirements for connecting to your Exadata
Database Service on Cloud@Customer databases by using Oracle Net Services.
4-69
Chapter 4
Connecting to an Exadata Database Service on Cloud@Customer System
Connecting to a Database Using a Connect Descriptor that References All of the SCAN
VIPs
You can set up a connect descriptor for Oracle Exadata Database Service on
Cloud@Customer System using multiple SCAN listeners.
This approach requires you to supply all of the single client access name (SCAN)
virtual IP (VIP) addresses, and enables Oracle Net Services to connect to an available
SCAN listener.
• Use the following template to define a Net Services alias, which is typically used to
provide a convenient name for the connect descriptor:
alias-name = (DESCRIPTION=
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=tcp)(HOST=SCAN-VIP-1)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=SCAN-VIP-2)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=SCAN-VIP-3)(PORT=1521)))
(CONNECT_DATA=(sid-or-service-entry)))
Where:
alias-name is the name you use to identify the alias.
SCAN-VIP-[1–3] are the IP addresses for the SCAN VIPs.
sid-or-service-entry identifies the database SID or service name using one of
the following formats:
• SID=sid-name. For example: SID=S12C1.
• SERVICE_NAME=service-name. For example:
SERVICE_NAME=PDB1.example.yourcloud.com.
Note:
By default, Oracle Net Services randomly selects one of the addresses
in the address list to balance the load between the SCAN listeners.
4-70
Chapter 4
Connecting to an Exadata Database Service on Cloud@Customer System
• Use the following template to define a Net Services alias that references the custom
SCAN name:
alias-name = (DESCRIPTION=
(ADDRESS_LIST=(ADDRESS=(PROTOCOL=tcp)(HOST=scan-name)(PORT=1521)))
(CONNECT_DATA=(sid-or-service-entry)))
Where:
alias-name is the name you use to identify the alias.
scan-name is the custom SCAN name.
sid-or-service-entry identifies the database SID or service name using one of the
following formats:
• SID=sid-name. For example: SID=S12C1.
• SERVICE_NAME=service-name. For example:
SERVICE_NAME=PDB1.example.yourcloud.com.
Alternatively, you can use the easy connect method to specify a connect descriptor with
the following format:
scan-name:1521/sid-or-service-entry
For example:
exa1scan.example.com:1521/S12C1
Or
exa1scan.example.com:1521/PDB1.example.yourcloud.com
alias-name = (DESCRIPTION=
(CONNECT_TIMEOUT=timeout)
(ADDRESS_LIST=(ADDRESS=(PROTOCOL=tcp)(HOST=node)(PORT=1521)))
(CONNECT_DATA=(sid-or-service-entry)))
4-71
Chapter 4
Connecting to an Exadata Database Service on Cloud@Customer System
Where:
alias-name is the name you use to identify the alias.
timeout specifies a timeout period (in seconds), which enables you to terminate a
connection attempt without having to wait for a TCP timeout. The
(CONNECT_TIMEOUT=timeout) parameter is optional.
node is the hostname or IP address for the virtual machine that you want to use.
sid-or-service-entry identifies the database SID or service name using one of the
following formats:
• SID=sid-name. For example, SID=S12C1.
• SERVICE_NAME=service-name. For example,
SERVICE_NAME=PDB1.example.oraclecloudatcust.com.
Alternatively, you can use the easy connect method to specify a connect descriptor
with the following format:
node:1521/sid-or-service-entry
For example:
exa1node01.example.com:1521/S12C1
Or
exa1node01.example.com:1521/PDB1.example.oraclecloudatcust.com
4-72
5
How-to Guides
A collection of tasks and procedures for managing Exadata Cloud
5-1
Chapter 5
Connect to the Exadata Database Service on Cloud@Customer Service
5-2
Chapter 5
Connect to the Exadata Database Service on Cloud@Customer Service
Note:
The public keys are stored in the authorized_keys file at ~/.ssh/
authorized_keys. Separate authorized_keys files are located under the home
directories of the operating system users. By default, only the opc user account
has an authorized_keys entry and is able to log in remotely. Do not remove or
alter the automatically generated entry in authorized_keys for the opc user.
• The host name or IP address for the virtual machine that you want to access.
See, Using the Console to Check the Status of a VM Cluster Virtual Machine.
Related Topics
• Using the Console to Check the Status of a VM Cluster Virtual Machine
Review the health status of a VM cluster virtual machine.
5-3
Chapter 5
Connect to the Exadata Database Service on Cloud@Customer Service
5. In the Category tree, expand Connection if necessary and then click Data.
The Data panel is displayed.
6. In the Auto-login username field, enter the operating system user you want to
connect as:
• Connect as the user opc to perform operations that require root or oracle
access to the virtual machine, such as backing up or patching; this user can
use the sudo command to gain root or oracle access to the VM.
7. Confirm that the When username is not specified option is set to Prompt.
8. In the Category tree, expand SSH and then click Auth.
The Auth panel is displayed.
9. Click the Browse button next to the Private key file for authentication field.
Then, in the Select private key file window, navigate to and open the private key
file that matches the public key that is associated with the deployment.
10. In the Category tree, click Session.
The PuTTY Configuration window closes and the PuTTY terminal window
displays.
If this is the first time you are connecting to the VM, the PuTTY Security Alert
window is displayed, prompting you to confirm the public key. Click Yes to
continue connecting.
5-4
Chapter 5
Connect to the Exadata Database Service on Cloud@Customer Service
4. Identify the database instances for the database that you want to access. For example:
5. Configure the environment settings for the database that you want to access. For
example:
. oraenv
ORACLE_SID = [oracle] ? s12c
The Oracle base has been set to /u02/app/oracle
export ORACLE_SID=s12c1
6. You can use the svrctl command to display more detailed information about the
database. For example:
5-5
Chapter 5
Connect to the Exadata Database Service on Cloud@Customer Service
sqlplus / as sysdba
Connected to:
Oracle Database 12c EE Extreme Perf Release 12.2.0.1.0 - 64bit
Production
5-6
Chapter 5
Connect to the Exadata Database Service on Cloud@Customer Service
By default, the SCAN is associated with three virtual IP addresses (VIPs). Each SCAN VIP is
also associated with a SCAN listener that provides a connection endpoint for Oracle
Database connections using Oracle Net Services. To maximize availability, Oracle Grid
Infrastructure distributes the SCAN VIPs and SCAN listeners across the available cluster
nodes. In addition, if there is a node shutdown or failure, then the SCAN VIPs and SCAN
listeners are automatically migrated to a surviving node. By using SCAN connections, you
enhance the ability of Oracle Database clients to have a reliable set of connection endpoints
that can service all of the databases running in the cluster.
The SCAN listeners are in addition to the Oracle Net Listeners that run on every node in the
cluster, which are also known as the node listeners. When an Oracle Net Services connection
comes through a SCAN connection, the SCAN listener routes the connection to one of the
node listeners, and plays no further part in the connection. A combination of factors, including
listener availability, database instance placement, and workload distribution, determines
which node listener receives each connection.
Note:
This documentation provides basic requirements for connecting to your Exadata
Database Service on Cloud@Customer databases by using Oracle Net Services.
5-7
Chapter 5
Connect to the Exadata Database Service on Cloud@Customer Service
Connecting to a Database Using a Connect Descriptor that References All of the SCAN
VIPs
You can set up a connect descriptor for Oracle Exadata Database Service on
Cloud@Customer System using multiple SCAN listeners.
This approach requires you to supply all of the single client access name (SCAN)
virtual IP (VIP) addresses, and enables Oracle Net Services to connect to an available
SCAN listener.
• Use the following template to define a Net Services alias, which is typically used to
provide a convenient name for the connect descriptor:
alias-name = (DESCRIPTION=
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=tcp)(HOST=SCAN-VIP-1)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=SCAN-VIP-2)(PORT=1521))
(ADDRESS=(PROTOCOL=tcp)(HOST=SCAN-VIP-3)(PORT=1521)))
(CONNECT_DATA=(sid-or-service-entry)))
Where:
alias-name is the name you use to identify the alias.
SCAN-VIP-[1–3] are the IP addresses for the SCAN VIPs.
sid-or-service-entry identifies the database SID or service name using one of
the following formats:
• SID=sid-name. For example: SID=S12C1.
• SERVICE_NAME=service-name. For example:
SERVICE_NAME=PDB1.example.yourcloud.com.
Note:
By default, Oracle Net Services randomly selects one of the addresses
in the address list to balance the load between the SCAN listeners.
5-8
Chapter 5
Connect to the Exadata Database Service on Cloud@Customer Service
• Use the following template to define a Net Services alias that references the custom
SCAN name:
alias-name = (DESCRIPTION=
(ADDRESS_LIST=(ADDRESS=(PROTOCOL=tcp)(HOST=scan-name)(PORT=1521)))
(CONNECT_DATA=(sid-or-service-entry)))
Where:
alias-name is the name you use to identify the alias.
scan-name is the custom SCAN name.
sid-or-service-entry identifies the database SID or service name using one of the
following formats:
• SID=sid-name. For example: SID=S12C1.
• SERVICE_NAME=service-name. For example:
SERVICE_NAME=PDB1.example.yourcloud.com.
Alternatively, you can use the easy connect method to specify a connect descriptor with
the following format:
scan-name:1521/sid-or-service-entry
For example:
exa1scan.example.com:1521/S12C1
Or
exa1scan.example.com:1521/PDB1.example.yourcloud.com
alias-name = (DESCRIPTION=
(CONNECT_TIMEOUT=timeout)
(ADDRESS_LIST=(ADDRESS=(PROTOCOL=tcp)(HOST=node)(PORT=1521)))
(CONNECT_DATA=(sid-or-service-entry)))
5-9
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
Where:
alias-name is the name you use to identify the alias.
timeout specifies a timeout period (in seconds), which enables you to terminate a
connection attempt without having to wait for a TCP timeout. The
(CONNECT_TIMEOUT=timeout) parameter is optional.
node is the hostname or IP address for the virtual machine that you want to use.
sid-or-service-entry identifies the database SID or service name using one of the
following formats:
• SID=sid-name. For example, SID=S12C1.
• SERVICE_NAME=service-name. For example,
SERVICE_NAME=PDB1.example.oraclecloudatcust.com.
Alternatively, you can use the easy connect method to specify a connect descriptor
with the following format:
node:1521/sid-or-service-entry
For example:
exa1node01.example.com:1521/S12C1
Or
exa1node01.example.com:1521/PDB1.example.oraclecloudatcust.com
5-10
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
Caution:
Avoid entering confidential information when assigning descriptions, tags, or friendly names
to your cloud resources through the Oracle Cloud Infrastructure Console, the APIs, or the
command-line interface.
5-11
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
• Allocate additional storage capacity available from newly added storage servers to
already deployed VM clusters and/or use them for provisioning new VM clusters
on the infrastructure.
5-12
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
5-13
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
Related Topics
• Using the Console to Scale Infrastructure Compute and Storage
To scale infrastructure compute and storage, complete this procedure.
• Using the Console to Download Scale Infrastructure Compute and Storage
Configuration File
To download an Oracle Exadata Cloud@Customer scale configuration file,
complete this procedure.
• Using the Console to Activate New Database and Storage Servers
To download an Oracle Exadata Cloud@Customer scale configuration file,
complete this procedure.
• Using the Console to Make Storage Capacity from New Server Available for VM
Clusters Consumption
To make storage capacity from the new servers for VM clusters consumption,
complete this procedure.
• Using the Console to View Details of Exadata Cloud@Customer Infrastructure with
Scaled Compute and Storage Capacity
To view the storage capacity from the new storage server, or scaled compute
capacity, use this procedure.
5-14
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
5-15
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
5-16
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
– HTTP Proxy: (Optional) You can choose to use this field to specify your
corporate HTTP proxy. The expected format is as follows, where server is the
server name, domain is the domain name, and port is the assigned port:
http://server.domain:port
For example:
http://proxy.example.com:80
For enhanced security, when possible, Oracle recommends that you use an
HTTP proxy.
– Enable Control Plane Server Offline Report: Enabling the Control Plane
Server (CPS) offline report helps in diagnosing connectivity issues between the
CPS and OCI endpoints, should they arise.
To view the report, do the following:
a. Find the CPS IP addresses.
For more information, see Using the Console to View Exadata Infrastructure
Network Configuration Details.
b. From your local network, access the report over HTTP.
To view the report in HTML format, use http://<CPSPublicIP>:18080/
report
To view the report in JSON format, use http://<CPSPublicIP>:18080/
report/json
For more information, see ExaCC gen2: Troubleshooting VPN/WSS connection
from Customer Side.
• Configure the Oracle Exadata system networks
Each Oracle Exadata Database Service on Cloud@Customer system contains two
system networks, which are not connected to your corporate network. The following
settings define IP address allocations for these networks:
– Administration Network CIDR Block: Specifies the IP address range for the
administration network using CIDR notation. The administration network provides
connectivity that enables Oracle to administer the Exadata system components,
such as the Exadata compute servers, storage servers, network switches, and
power distribution units. You can accept the suggested default, or specify a
custom value.
The maximum CIDR block prefix length is /23, which defines the smallest block
of IP addresses that are required for the network. To allow for possible future
expansion within Exadata Database Service on Cloud@Customer, a smaller
CIDR block prefix length is recommended, which reserves more IP addresses for
the network. The minimum CIDR block prefix length is /16.
Note:
You cannot change this value in the future. Consider all future expansions
when making this choice. Otherwise, your future expandability may be
limited.
5-17
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
Ensure that the IP address range does not conflict with other hosts of your
corporate network, and does not overlap with the InfiniBand network CIDR
block.
• InfiniBand Network CIDR Block: Specifies the IP address range for the
Exadata InfiniBand network using CIDR notation. The Exadata InfiniBand
network provides the high-speed low-latency interconnect used by Exadata
software for internal communications between various system components.
You can accept the suggested default, or specify a custom value.
The maximum CIDR block prefix length is /22, which defines the smallest
block of IP addresses that are required for the network. To allow for possible
future expansion within Exadata Database Service on Cloud@Customer, a
smaller CIDR block prefix length is recommended, which reserves more IP
addresses for the network. The minimum CIDR block prefix length is /19.
Ensure that the IP address range does not conflict with other hosts your
corporate network, and does not overlap with the administration network CIDR
block.
• Configure DNS and NTP services
Each Exadata Database Service on Cloud@Customer system requires access
to Domain Names System (DNS) and Network Time Protocol (NTP) services.
The following settings specify the servers that provide these services to the
Exadata infrastructure:
– DNS Servers: Provide the IP address of a DNS server that is accessible
using the control plane network. You may specify up to three DNS servers.
– NTP Servers: Provide the IP address of an NTP server that is accessible
using the control plane network. You may specify up to three NTP servers.
– Time Zone: The default time zone for the Exadata Infrastructure is UTC,
but you can specify a different time zone. The time zone options are those
supported in both the Java.util.TimeZone class and the Oracle Linux
operating system.
Note:
If you want to set a time zone other than UTC or the browser-
detected time zone, then select the Select another time zone
option, select a Region or country, and then select the
corresponding Time zone.
If you do not see the region or country you want, then select
Miscellaneous, and then select an appropriate Time zone.
5-18
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
Note:
After creating the infrastructure, you can find the maintenance method,
maintenance schedule, DB Server version, and Storage Server version
details under the Maintenance and Version sections on the
Infrastructure Details page.
5-19
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
Optionally, you can add a maximum of nine secondary contacts. Both the
primary and secondary contacts receive all notifications about hardware
replacement, network issues, and software maintenance runs. Note that
you can promote any secondary contacts as the primary anytime you
want. When you promote a secondary contact to primary, the current
primary contact will be demoted automatically to secondary.
• Show Advanced Options
You have the option to configure advanced options.
– Tags: (Optional) You can choose to apply tags. If you have permission to
create a resource, then you also have permission to apply free-form tags
to that resource. To apply a defined tag, you must have permission to use
the tag namespace. For more information about tagging, see Resource
Tags. If you are not sure if you should apply tags, then skip this option
(you can apply tags later) or ask your administrator.
6. Click Create Exadata Infrastructure.
If all of your inputs are valid, then the Infrastructure Details page appears. The
page outlines the next steps in the provisioning process. Initially, after creation, the
state of the Oracle Exadata infrastructure is Requires-Activation.
Related Topics
• Understanding Compartments
• System Configuration Options for Oracle Exadata Database Service on
Cloud@Customer
To meet the needs of your enterprise, you can select from one of the four Oracle
Exadata X9M-2, X8M-2, X8-2, or X7-2 System Models.
• ExaCC gen2: Troubleshooting VPN/WSS connection from Customer Side
• Resource Tags
5-20
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
http://server.domain:port
For example:
http://proxy.example.com:80
5-21
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
For enhanced security, when possible, Oracle recommends that you use
an HTTP proxy.
b. Configure the Exadata system networks
Each Oracle Exadata Database Service on Cloud@Customer system contains
two system networks, which are not connected to your corporate network. The
following settings define IP address allocations for these networks:
• Administration Network CIDR Block: Specifies the IP address range for
the administration network using CIDR notation. The administration
network provides connectivity that enables Oracle to administer the
Exadata system components, such as the Exadata compute servers,
storage servers, network switches, and power distribution units.
The maximum CIDR block prefix length is /23, which defines the smallest
block of IP addresses that are required for the network. To allow for
possible future expansion within Oracle Exadata Database Service on
Cloud@Customer, a smaller CIDR block prefix length is recommended,
which reserves more IP addresses for the network. The minimum CIDR
block prefix length is /16.
Ensure that the IP address range does not conflict with other hosts your
corporate network, and does not overlap with the InfiniBand network CIDR
block.
• InfiniBand Network CIDR Block: Specifies the IP address range for the
Exadata InfiniBand network using CIDR notation. The Exadata InfiniBand
network provides the high-speed low-latency interconnect used by
Exadata software for internal communications between various system
components.
The maximum CIDR block prefix length is /22, which defines the smallest
block of IP addresses that are required for the network. To allow for
possible future expansion within Oracle Exadata Database Service on
Cloud@Customer, a smaller CIDR block prefix length is recommended,
which reserves more IP addresses for the network. The minimum CIDR
block prefix length is /19.
Ensure that the IP address range does not conflict with other hosts your
corporate network, and does not overlap with the administration network
CIDR block.
c. Configure DNS and NTP services
Each Oracle Exadata Database Service on Cloud@Customer system requires
access to Domain Names System (DNS) and Network Time Protocol (NTP)
services. The following settings specify the servers that provide these services
to the Exadata infrastructure:
• DNS Servers: Provide the IP address of a DNS server that is accessible
using the control plane network. You can specify up to three DNS servers.
• NTP Servers: Provide the IP address of an NTP server that is accessible
using the control plane network. You may specify up to three NTP servers.
• Time zone: The default time zone for the Exadata Infrastructure is UTC,
but you can specify a different time zone. The time zone options are those
supported in both the Java.util.TimeZone class and the Oracle Linux
operating system.
5-22
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
Note:
If you want to set a time zone other than UTC or the browser-detected
time zone, then select the Select another time zone option, select a
Region or country, and then select the corresponding Time zone.
If you do not see the region or country you want, then select
Miscellaneous, and then select an appropriate Time zone.
5-23
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
2. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
3. Choose Region and Compartment, and select the region and compartment that
contains the Oracle Exadata infrastructure that you want to activate.
4. Click Exadata Infrastructure.
5. Click the name of the Oracle Exadata infrastructure that you want to activate.
The Infrastructure Details page displays information about the selected Oracle
Exadata infrastructure.
6. Click Activate on the banner displayed.
The Activate button is only available if the Oracle Exadata infrastructure requires
activation. You cannot activate Oracle Exadata infrastructure multiple times.
7. Use the Activate dialog to upload the activation file, and then click Activate Now.
The activation file includes all the relevant details for the additional storage servers
included as part of the create infrastructure flow.
After activation, the state of the Oracle Exadata infrastructure changes to Active.
5-24
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
• Activation Failed: Red icon. An error condition currently prevents the activation of
the Oracle Exadata infrastructure. Typically, this state is auto-correcting, and does
not require user intervention.
Note:
You can add database servers and storage servers together or add them
individually.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Choose the Region and Compartment that contains the Oracle Exadata infrastructure
that you are interested in.
3. Click Exadata Infrastructure.
4. Click the name of the Oracle Exadata infrastructure for which you want to download a file
containing the infrastructure configuration details.
The Infrastructure Details page displays information about the selected Oracle Exadata
infrastructure.
5. Click Scale Infrastructure.
6. Select the number of database servers from the Additional database servers field.
7. Select the number of storage servers from the Additional storage servers field.
8. Click Scale Infrastructure.
5-25
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
Note:
When you provide the generated infrastructure configuration file to
Oracle, ensure that it has not been altered in any way. Also, ensure that
you do not edit the Oracle Exadata infrastructure after you download the
configuration file and provide it to Oracle.
Note:
Once the activation file is uploaded and the activate process is initiated, you
cannot change the Scale Infrastructure request or cancel this whole
operation. If there is an activation failure, then contact the field engineer to
resolve the issue.
Using the Console to Make Storage Capacity from New Server Available for
VM Clusters Consumption
To make storage capacity from the new servers for VM clusters consumption,
complete this procedure.
1. Download the activation file.
2. Open the navigation menu. Under Oracle Databases, click Exadata Database
Service on Cloud@Customer.
5-26
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
3. Choose the Region and Compartment that contains the Oracle Exadata infrastructure
that you are interested in.
4. Click Exadata Infrastructure.
5. Click the name of the Oracle Exadata infrastructure that you want to activate.
The Infrastructure Details page displays information about the selected Oracle Exadata
infrastructure.
6. Click Add Storage Capacity.
7. Review the advisory on the Add Storage Capacity dialog, and then click Add Storage
Capacity.
Note:
While Add Storage Capacity operation is in progress,
• The system rebalances the storage to ensure that the capacity from the newly
added storage servers is available for VM Cluster consumption. This rebalance
will run with a ASM power limit of 4 independent of what you have set within
your ASM configuration. If you would like the rebalance to complete faster, you
can update the power limit after the rebalance process has begun. Monitor the
ASM rebalance process to ensure it successfully completes (which will allow
the add storage capacity workflow to complete).
• You cannot create or delete VM Clusters.
• Existing VM Clusters provisioned are in the Available life cycle state. However,
they do not support scale up or down of resources allocated to the VM cluster,
except for OCPU allocation. OCPU allocation changes are allowed even while
Add Storage Capacity operation is in progress.
Note:
When you perform scale VM Cluster Exadata storage operation, newly added
Exadata storage capacity is also available for consumption. Similarly, when you
create a VM cluster, the Console displays the newly added Exadata storage
capacity (shared Exadata storage) as available storage.
5-27
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
Related Topics
• Introduction to Scale Up or Scale Down Operations
With the Multiple VMs per Exadata system (MultiVM) feature release, you can
scale up or scale down your VM cluster resources.
• Using the Console to Create a VM Cluster
To create your VM cluster, be prepared to provide values for the fields required for
configuring the infrastructure.
5-28
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
Using the Console to Manage Tags for Your Exadata Cloud@Customer Resources
1. Open the navigation menu. Under Oracle Database, click Exadata Cloud@Customer.
2. Choose your Compartment.
3. Find the Exadata Infrastructure, VM Cluster Network, VM Cluster, Backup Destination,
Database Home, or Database resource you're interested in, and click the name.
4. Click the Tags tab to view or edit the existing tags. Or, click More Actions and then
Apply Tags to add new ones.
Related Topics
• Resource Tags
5-29
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
5-30
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
5-31
Chapter 5
Manage Exadata Database Service on Cloud@Customer Infrastructure
2. Select Region and Compartment, and provide the region and compartment that
contains the Oracle Exadata infrastructure for which you want to remove a
secondary contact.
3. Click Exadata Infrastructure.
4. Click the name of the Oracle Exadata infrastructure for which you want to remove
a secondary contact.
The Infrastructure Details page displays information about the selected Oracle
Exadata infrastructure.
5. Click Manage Contacts.
6. In the Manage Exadata Infrastructure Contacts window, click the actions button,
and then select Remove.
7. In the Remove Infrastructure Contact dialog, click Remove.
Related Topics
• REST APIs
• Security Credentials
• Software Development Kits and Command Line Interface
• ActivateExadataInfrastructure
• CreateExadataInfrastructure
• DeleteExadataInfrastructure
• DownloadExadataInfrastructureConfigFile
• GenerateRecommendedVmClusterNetwork
5-32
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
• GetExadataInfrastructure
• ListExadataInfrastructure
• UpdateExadataInfrastructure
• AddStorageCapacityExadataInfrastructure
5-33
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
In all but rare exceptional circumstances, you receive advance communication about
these updates to help you plan for them. If there are corresponding recommended
updates for your VM cluster virtual machines (VMs), then Oracle provides notifications
about them.
Wherever possible, scheduled updates are performed in a manner that preserves
service availability throughout the update process. However, there can be some
noticeable impact on performance and throughput while individual system components
are unavailable during the update process.
For example, database server patching typically requires a reboot. In such cases,
wherever possible, the database servers are restarted in a rolling manner, one at a
time, to ensure that the service remains available throughout the process. However,
each database server is unavailable for a short time while it restarts, and the overall
service capacity diminishes accordingly. If your applications cannot tolerate the
restarts, then take mitigating action as needed. For example, shut down an application
while database server patching occurs.
• Overview of the Quarterly Infrastructure Maintenance Process
By default, infrastructure maintenance updates the Exadata database server hosts
in a rolling fashion, followed by updating the storage servers.
• Overview of Monthly Security Maintenance
Security maintenance, performed alongside the quarterly maintenance, is
executed in months when important security updates are needed and includes
fixes for vulnerabilities with CVSS scores greater than 7.
5-34
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
5-35
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
5-36
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
instead, wait and be executed immediately following the quarterly maintenance. If the
quarterly maintenance is subsequently rescheduled, then the monthly security
maintenance will begin immediately. Oracle, therefore, recommends scheduling quarterly
and monthly maintenance at the same time. As a result, if you reschedule the quarterly at
the last moment, the monthly maintenance will run at the scheduled time instead of
immediately upon editing the schedule. You can also reschedule the monthly security
maintenance when rescheduling the quarterly maintenance as long as you keep the
monthly within the current maintenance window. Monthly maintenance can be
rescheduled to another time in the maintenance window, but cannot be skipped.
• If you are unable to select the same time slot because the time selected for quarterly
maintenance is not available in the monthly scheduler (grayed out), then you will need to
select the next available time slot.
Note:
If the Exadata Infrastructure is provisioned before Oracle schedules the security
maintenance, then it will be eligible for security maintenance.
5-37
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
Related Topics
• Using the Console to Create Oracle Exadata Database Service on
Cloud@Customer Infrastructure
To create your Oracle Exadata Database Service on Cloud@Customer
infrastructure, be prepared to provide values for the fields required for configuring
the infrastructure.
• Managing Infrastructure Maintenance Contacts
Learn to manage your Exadata infrastructure maintenance contacts.
5-38
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
Note:
Changes made to maintenance preferences apply only to future maintenance,
not the maintenance that has already been scheduled. To modify scheduled
maintenance, see View or Edit a Scheduled Maintenance for Exadata
Cloud@Customer Infrastructure.
5-39
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
5-40
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
Note:
An information block is displayed 6 hours before the start of a maintenance run,
regardless of whether you've chosen rolling or non-rolling maintenance method.
When the maintenance begins, it is automatically removed.
5. On the Infrastructure Details page, under Maintenance, click the view link in the Next
Quarterly Maintenance field.
The Exadata Infrastructure Maintenance page is displayed.
6. On the Exadata Infrastructure Maintenance page, scheduled maintenance details are
listed.
Target DB Server Version and Target Storage Server Version: These fields display the
Exadata software version to be applied by the scheduled maintenance. The version
applied will be the most recent certified update for Exadata infrastructures in the cloud. If
the next quarterly update is not yet certified when the maintenance is scheduled, then the
versions may show "LATEST" until the new quarterly update becomes available. Once
the update becomes available the new version will be displayed.
To find information on the Database Server Exadata software version or the Storage
Server Exadata software version, see My Oracle Support note Exadata Database
Machine and Exadata Storage Server Supported Versions (Doc ID 888828.1).
7. To change the next scheduled maintenance settings, click Edit Maintenance Run.
On the Edit Maintenance page, do the following:
• Select a maintenance method, Rolling or Non-rolling.
Note:
If you select the Non-rolling option, an information block appears stating
that components will be updated simultaneously, resulting in full system
downtime.
5-41
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
5-42
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
Related Topics
• https://support.oracle.com/epmos/faces/DocContentDisplay?id=888828.1
Note:
Certain black-out dates are not available for security maintenance and are
grayed out in the rescheduling calendar.
5-43
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
Note:
Maintenance In Progress status is displayed in the Next Quarterly
Maintenance field.
5-44
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
Note:
You can only make edits to the custom action configuration, not the
maintenance method or scheduled start time. Enabling or disabling the custom
action or modifying the custom action timeout while maintenance is in progress
will apply to all database servers that have yet to be updated.
View and Edit Maintenance While Maintenance is Waiting for Custom Action
1. Click the View link in the Next Quarterly Maintenance field.
Exadata Infrastructure Maintenance page is displayed.
5-45
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
Note:
Note:
The prechecks are now done prior to the start of the maintenance.
5-46
Chapter 5
Configure Oracle-Managed Infrastructure Maintenance
5-47
Chapter 5
Manage VM Cluster Networks
• ListExadataInfrastructures
• UpdateExadataInfrastructure
• UpdateMaintenanceRun
• GetMaintenanceRun
• ListMaintenanceRuns
5-48
Chapter 5
Manage VM Cluster Networks
Before you can create any databases on your Exadata Cloud@Customer infrastructure, you
must create a VM cluster network, and you must associate it with a VM cluster.
The VM cluster network specifies network resources, such as IP addresses and host names,
that reside in your corporate data center and are allocated to Exadata Cloud@Customer. The
VM cluster network includes definitions for the Exadata client network and the Exadata
backup network. The client network and backup network contain the network interfaces that
you use to connect to the VM cluster virtual machines, and ultimately the databases that
reside on those virtual machines.
Note:
Avoid entering confidential information when assigning descriptions, tags, or friendly
names to your cloud resources through the Oracle Cloud Infrastructure Console,
API, or CLI.
5-49
Chapter 5
Manage VM Cluster Networks
Note:
The values "0" and "4095" are reserved and cannot be entered.
5-50
Chapter 5
Manage VM Cluster Networks
Note:
The values "0" and "4095" are reserved, and cannot be entered.
5-51
Chapter 5
Manage VM Cluster Networks
5-52
Chapter 5
Manage VM Cluster Networks
The VM Cluster Network Details page displays information about the selected VM cluster
network.
6. Click Edit VM Cluster Network.
7. Use the Edit dialog to edit the VM cluster network attributes:
a. Client Network
The client network is the primary channel for application connectivity to Exadata
Database Service on Cloud@Customer resources. You can edit the following client
network settings:
• VLAN ID: Provide a virtual LAN identifier (VLAN ID) for the client network
between 1 and 4094, inclusive. To specify no VLAN tagging, enter "1". (This is
equivalent to a "NULL" VLAN ID tag value.)
Note:
The values "0" and "4095" are reserved and cannot be entered.
Note:
The values "0" and "4095" are reserved and cannot be entered.
• Hostname: Specify the hostname for each address in the backup network.
• IP Address: Specify the IP address for each address in the backup network.
c. Configure DNS and NTP Servers
The VM cluster network requires access to Domain Names System (DNS) and
Network Time Protocol (NTP) services. You can edit the following settings:
• DNS Servers: Provide the IP address of a DNS server that is accessible using
the client network. You may specify up to three DNS servers.
• NTP Servers: Provide the IP address of an NTP server that is accessible using
the client network. You may specify up to three NTP servers.
8. Click Save Changes.
5-53
Chapter 5
Manage VM Cluster Networks
5-54
Chapter 5
Manage VM Cluster Networks
You cannot download the network validation report for the following VM Cluster Network
State life cycle states:
• Validated (Successful validation run does not generate a results file)
• Requires Validation
• Updating
• Allocated
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Choose the Region and Compartment that contains the Exadata infrastructure that is
associated with the VM cluster network that you want to validate.
3. Click Exadata Infrastructure.
4. Click the name of the Exadata infrastructure that is associated with the VM cluster
network that you are interested in.
The Infrastructure Details page displays information about the selected Exadata
infrastructure.
5. Click the name of the VM cluster network for which you want to download a file
containing the VM cluster network configuration details.
The VM Cluster Network Details page displays information about the selected VM cluster
network.
6. Click Download Report.
Example 5-2 Validation Report
{
"Physical_Links":[
"Issue detected with Physical Links. Please check the cables connected
to ExaCC, or contact Oracle Support."
5-55
Chapter 5
Manage VM Cluster Networks
],
"VLAN":[
"Gateway <G1> is not accessible from source <ipaddr > with vlan
id <vlanId>. Please ensure vlan Id, IP address and Gateway are
correct",
"Gateway <G2> is not accessible from source <ipaddr > with vlan
id <vlanId>. Please ensure vlan Id, IP address and Gateway are correct"
],
"Gateway":[
"Gateway <G1> is not accessible from source <ipaddr > with vlan
id <vlanId>. Please ensure vlan Id, IP address and Gateway are
correct",
"Gateway <G2> is not accessible from source <ipaddr > with vlan
id <vlanId>. Please ensure vlan Id, IP address and Gateway are correct"
],
"DNS":[
"Missing reverse DNS entry(ies) <hostname> for <IP addr> in the
DNS server <dnsIP>. Please update the DNS Server with appropriate
entry(ies).",
"Missing DNS entry(ies) <IP> for <hostname> in the DNS server
<dnsIP>. Please update the DNS Server with appropriate entry(ies).",
"Wrong reverse DNS entry(ies) <hostname> found for <IP addr> in
the DNS server <dnsIP>. Please update the DNS Server with appropriate
entry(ies).",
"Wrong DNS entry(ies) <IP addr> found for <hostname> in the DNS
server <dnsIP>. Please update the DNS Server with appropriate
entry(ies)."
],
"NTP":[
"NTP <ntpIP> is not accessible from source <domU_ipaddr> with
vlan id <vlanId> using gateway <gatewayIP>. Please ensure NTP, VlanId,
IP address, Gateway are correct."
],
"IP_Availability":[
"IP <IP1> is already in use. Please ensure this IP is
available.",
"IP <IP2> is already in use. Please ensure this IP is
available.",
"IP <IP3> is already in use. Please ensure this IP is available."
]
}
5-56
Chapter 5
Manage VM Cluster Networks
4. Click the name of the Exadata infrastructure that is associated with the VM cluster
network that you are interested in.
The Infrastructure Details page displays information about the selected Exadata
infrastructure.
5. Click the name of the VM cluster network that you want to terminate.
The VM Cluster Network Details page displays information about the selected VM cluster
network.
6. Click Terminate.
7. In the resulting dialog, enter the name of the VM cluster network, and click Terminate VM
Cluster Network to confirm the action.
Note:
Oracle strongly recommends that customers use the latest GI version, or at least GI
version 19.11.
1. Click the name of the VM Cluster Network that you want to edit.
Exadata Infrastructure Details page displays the configured DB servers.
2. Click Add DB Servers to Network to assign IP addresses.
Add DB Servers to Network page is displayed.
3. Select one or more DB servers from the list.
4. Click Add DB Servers to Network.
5. Enter IP addresses in the Client network and Backup network sections.
6. Click Add DB Server to Network IP.
Exadata Infrastructure Details page displays a banner with the count of DB servers
selected.
If you want to change the IP addresses, click Edit VM Cluster Network. Make changes
on the Edit VM Cluster Network page and then click Save Changes.
7. Click Validate VM Cluster Network.
Validate VM Cluster Network goes into validating state.
The statuses of the DB servers change to Validated if the validation is successful.
5-57
Chapter 5
Manage VM Clusters
Note:
You cannot remove network resources that are currently allocated to a virtual
machine.
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Under Infrastructure, click Exadata Infrastructure.
3. In the list of Exadata Infrastructures, click the display name of the infrastructure
you wish to view details.
4. Click the VM Cluster Network from the list of VM Cluster Networks.
VM Cluster Network Details page is displayed.
5. Under Network Configuration, in the Client network or Backup network
section, identify the database server that you want to remove.
6. Click the Actions icon (three dots) for a virtual machine, and then click Remove.
7. Click Remove on the confirmation dialog displayed.
Manage VM Clusters
Learn how to manage your VM clusters on Exadata Database Service on
Cloud@Customer.
• About Managing VM Clusters on Exadata Database Service on Cloud@Customer
The VM cluster provides a link between your Exadata Database Service on
Cloud@Customer infrastructure and Oracle Databases you deploy.
• Overview of VM Cluster Node Subsetting
VM Cluster Node Subsetting enables you to allocate a subset of database servers
to new and existing VM clusters to enable maximum flexibility in the allocation of
compute (CPU, memory, local storage) resources.
• Overview of Health Metrics and Log Collection
By enabling diagnostics collection and notifications, Oracle Cloud Operations and
you will be able to identify, investigate, track, and resolve guest VM issues quickly
and effectively. Subscribe to Events to get notified about resource state changes.
• Incident Logs and Trace Files
This section lists all of the files that can be collected by Oracle Support if you opt-
in for incident logs and trace collection.
• Health Metrics
Review the list of database and non-database health metrics collected by Oracle
Trace File Analyzer.
5-58
Chapter 5
Manage VM Clusters
Note:
Avoid entering confidential information when assigning descriptions, tags, or friendly
names to your cloud resources through the Oracle Cloud Infrastructure Console,
API, or CLI.
5-59
Chapter 5
Manage VM Clusters
• All VMs across a VM cluster will have the same resource allocation per VM
irrespective of whether the VM was created during cluster provisioning or added
later by extending an existing VM cluster.
• Any VM cluster should have a minimum of 2 VMs even with the node subsetting
capability. We currently do not support clusters with a single VM.
• Each VM cluster network is pre-provisioned with IP addresses for every DB Server
in the infrastructure. One cluster network can only be used by a single VM cluster
and is validated to ensure the IP addresses do not overlap with other cluster
networks. Adding or removing VMs to the cluster does not impact the pre-
provisioned IP addresses assigned to each DB server in the associated cluster
network.
• You can host a maximum of 8 VMs on X8M and above generation of DB Servers.
X7 and X8 generations can only support a maximum of 6 and 5 VMs per DB
Server, respectively.
• Exadata Infrastructures with X8M and above generation of DB Servers can
support a maximum of 16 VM clusters across all DB Servers. X7 and X8
generation Exadata Infrastructure DB Servers can only support a maximum of 12
and 10 VM clusters, respectively.
Maximum number of clusters across the infrastructure depends on the resources
available per DB server and is subject to the per DB Server maximum VM limit.
Related Topics
• Using the Console to Create a VM Cluster
To create your VM cluster, be prepared to provide values for the fields required for
configuring the infrastructure.
• Using the Console to Add VMs to a Provisioned Cluster
To add virtual machines to a provisioned cluster, use this procedure.
• Using the Console to View a List of DB Servers on an Exadata Infrastructure
To view a list of database server hosts on an Oracle Exadata Cloud@Customer
system, use this procedure.
• Using the Console to Remove a VM from a VM Cluster
To remove a virtual machine from a provisioned cluster, use this procedure.
5-60
Chapter 5
Manage VM Clusters
Allow Oracle to collect incident logs and traces to enable fault diagnosis and issue
resolution. For more information, see Incident Logs and Trace Files.
Diagnostics Collection is:
• Enabled: When you choose to collect diagnostics, health metrics, incident logs, and
trace files (all three options).
• Disabled: When you choose not to collect diagnostics, health metrics, incident logs, and
trace files (all three options).
• Partially Enabled: When you choose to collect diagnostics, health metrics, incident logs,
and trace files (one or two options).
Disabling diagnostic events and health monitoring will only stop the collection and notification
of data/events from the time you uncheck the checkboxes tied to the options. However,
historical data will not be purged from Oracle Cloud Operations data repositories.
Related Topics
• Database Service Events
The Database Service emits events, which are structured messages that indicate
changes in resources.
• Incident Logs and Trace Files
This section lists all of the files that can be collected by Oracle Support if you opt-in for
incident logs and trace collection.
• Health Metrics
Review the list of database and non-database health metrics collected by Oracle Trace
File Analyzer.
• Using the Console to Create a VM Cluster
To create your VM cluster, be prepared to provide values for the fields required for
configuring the infrastructure.
• Using the Console to Enable, Partially Enable, or Disable Diagnostics Collection
You can enable, partially enable, or disable diagnostics collection for your Guest VMs
after provisioning the VM cluster. Enabling diagnostics collection at the VM cluster level
applies the configuration to all the resources such as DB home, Database, and so on
under the VM cluster.
Note:
• Oracle will create a service request (SR) against the infrastructure Customer
Support Identifier (CSI) when an issue is detected and needs customer
interaction to resolve.
• The customer's Oralce Cloud Infrastructure tenancy admin email will be used
as the CSI contact to create SR and attach logs to it. Ensure tenancy admin is
added as a CSI contact in My Oracle Support (MOS).
5-61
Chapter 5
Manage VM Clusters
Note:
If have previously opted in for incident log and trace file collection and decide
to opt out when Oracle Cloud operations run a log collection job, then the job
will run its course and will not cancel. Future log collections won't happen
until you opt-in again to the incident logs and trace file collection option.
TFA is shipped with scripts that run when a particular component is
requested, for example, for CRS component, crscollect.pl will run a
number of crsctl commands and gather the input. By default, TFA does not
redact collected logs.
Table 5-5 Oracle Trace File Analyze (TFA) Component Driven Logs Collections
5-62
Chapter 5
Manage VM Clusters
Table 5-5 (Cont.) Oracle Trace File Analyze (TFA) Component Driven Logs
Collections
5-63
Chapter 5
Manage VM Clusters
Table 5-5 (Cont.) Oracle Trace File Analyze (TFA) Component Driven Logs
Collections
5-64
Chapter 5
Manage VM Clusters
Table 5-5 (Cont.) Oracle Trace File Analyze (TFA) Component Driven Logs
Collections
5-65
Chapter 5
Manage VM Clusters
Related Topics
• Overview of Health Metrics and Log Collection
By enabling diagnostics collection and notifications, Oracle Cloud Operations and
you will be able to identify, investigate, track, and resolve guest VM issues quickly
and effectively. Subscribe to Events to get notified about resource state changes.
• Health Metrics
Review the list of database and non-database health metrics collected by Oracle
Trace File Analyzer.
• Using the Console to Create a VM Cluster
To create your VM cluster, be prepared to provide values for the fields required for
configuring the infrastructure.
• Using the Console to Enable, Partially Enable, or Disable Diagnostics Collection
You can enable, partially enable, or disable diagnostics collection for your Guest
VMs after provisioning the VM cluster. Enabling diagnostics collection at the VM
cluster level applies the configuration to all the resources such as DB home,
Database, and so on under the VM cluster.
Health Metrics
Review the list of database and non-database health metrics collected by Oracle Trace
File Analyzer.
Note:
Oracle may add more metrics in the future, but if you have already chosen to
collect metrics, you need not update your opt-in value. It will remain enabled/
disabled based on your current preference.
5-66
Chapter 5
Manage VM Clusters
5-67
Chapter 5
Manage VM Clusters
5-68
Chapter 5
Manage VM Clusters
5-69
Chapter 5
Manage VM Clusters
5-70
Chapter 5
Manage VM Clusters
Related Topics
• Overview of Health Metrics and Log Collection
By enabling diagnostics collection and notifications, Oracle Cloud Operations and you will
be able to identify, investigate, track, and resolve guest VM issues quickly and effectively.
Subscribe to Events to get notified about resource state changes.
• Incident Logs and Trace Files
This section lists all of the files that can be collected by Oracle Support if you opt-in for
incident logs and trace collection.
• Using the Console to Create a VM Cluster
To create your VM cluster, be prepared to provide values for the fields required for
configuring the infrastructure.
• Using the Console to Enable, Partially Enable, or Disable Diagnostics Collection
You can enable, partially enable, or disable diagnostics collection for your Guest VMs
after provisioning the VM cluster. Enabling diagnostics collection at the VM cluster level
5-71
Chapter 5
Manage VM Clusters
applies the configuration to all the resources such as DB home, Database, and so
on under the VM cluster.
Note:
Oracle doesn't stop billing when a VM or VM Cluster is stopped. To stop
billing for a VM Cluster, lower the OCPU count to zero.
5-72
Chapter 5
Manage VM Clusters
Note:
cat input.json
{
"object": "db",
"action": "get",
"operation": "precheck_memory_resize",
"params": {
"dbname": "grid",
"new_mem_size" : "30 gb",
"infofile": "/tmp/result.json"
},
"outputfile": "/tmp/info.out",
"FLAGS": ""
}
dbaasapi -i input.json
5-73
Chapter 5
Manage VM Clusters
cat /tmp/result.json
{
"is_new_mem_sz_allowed" : 0,
"min_req_mem" : 167
}
The result indicates that 30 GB is not sufficient and the minimum required memory is
167 GB, and that is the maximum you can reshape down to. On a safer side, you must
choose a value greater than 167 GB, as there could be fluctuations of that order
between this calculation and the next reshape attempt.
/u01/app/19.0.0.0/grid/bin/asmcmd lsdg
ASMCMD>
State Type Rebal Sector Logical_Sector Block AU Total_MB
Free_MB Req_mir_free_MB Usable_file_MB Offline_disks
Voting_files Name
MOUNTED HIGH N 512 512 4096 4194304 12591936
10426224 1399104 3009040
0 Y DATAC5/
MOUNTED HIGH N 512 512 4096 4194304 3135456
3036336 348384 895984
0 N RECOC5/
ASMCMD>
• With SPARSE:
/u01/app/19.0.0.0/grid/bin/asmcmd lsdg
ASMCMD>
State Type Rebal Sector Logical_Sector Block AU
Total_MB Free_MB Req_mir_free_MB Usable_file_MB
5-74
Chapter 5
Manage VM Clusters
Note:
The listed values of all attributes for SPARSE diskgroup (SPRC5) present the
virtual size. In Exadata DB Systems and Exadata Cloud@Customer, we use the
ratio of 1:10 for physicalSize:virtualSize. Hence, for all purposes of our
calculation we must use 1/10th of the values displayed above in case of
SPARSE for those attributes.
5-75
Chapter 5
Manage VM Clusters
Above resize will go through. If above conditions are not met by the new size, then
resize will fail the precheck.
Estimating How Much Local Storage You Can Provision to Your VMs
#VMs Fixed Storage All X8-2 Space for X7-2 Space for
VMs (GB) ALL /u02 (GB) ALL /u02 (GB)
1 137 900 1100
2 274 763 963
3 411 626 826
4 548 489 689
5 685 352 552
6 822 N/A 415
For an X8-2, to get the max space available for the nth VM, take the number in the
table above and subtract anything previously allocated for /u02 to the other VMs. So if
you allocated 60 GB to VM1, 70 GB to VM2, 80 GB to VM3, 60 GB to VM4 (total 270
GB) in an X8-2, the maximum available for VM 5 would be 352 - 270 = 82 GB.
In ExaC@C Gen 2, we require a minimum of 60 GB per /u02, so with that minimum
size there is a maximum of 5 VMs in X8-2 and 6 VMs in X7-2.
X8M-2 Systems
The maximum number of VMs for an X8M-2 will be 8, regardless of whether there is
local disk space or other resources available.
For an X8M-2 system, the fixed consumption per VM is 160 GB.
Total space available to all VMs on an ExaC@C X8M databases node is 2500 GB.
Although there is 2500 GB per database node, with a single VM, you can allocate a
maximum of 900 GB local storage. Similarly, for the second VM, there is 1800 GB local
storage available given the max limit of 900 GB per VM. With the third VM, the amount
of space available is 2500 - (160Gb * 3) = 2020 GB. And so on for 4 and more VMs.
• Total space available for VM images (X8M Base System): 1237 GB
5-76
Chapter 5
Manage VM Clusters
#VMs Fixed Storage All VMs X8M-2 Base System X8M-2 Quarter/Half/
(GB) Space for All /u02 Full Rack Space for
(GB) All /u02 (GB)
1 160 900 900*
2 320 740 1800*
3 480 580 2020
4 640 420 1860
5 800 N/A 1700
6 960 N/A 1540
7 1120 N/A 1380
8 1280 N/A 1220
X9M-2 Systems
• Total Available for VM Images (Base System): 1077 GB
• Total Available for VM Images (Qtr/Half/Full Racks): 2243 GB
• Fixed overhead per VM: 184 GB
#VMs Fixed Storage All VMs X9M-2 Base System X9M-2 Qtr/Half/Full
(GB) Space All /u02 (GB) Racks All /u02 (GB)
1 184 892 900*
2 368 708 1800*
3 552 524 1691
4 736 340 1507
5 920 N/A 1323
6 1104 N/A 1139
7 1288 N/A 955
8 1472 N/A 771
5-77
Chapter 5
Manage VM Clusters
5-78
Chapter 5
Manage VM Clusters
5-79
Chapter 5
Manage VM Clusters
Note:
5-80
Chapter 5
Manage VM Clusters
j. Requested memory for the VM Cluster (GB): Displays the total amount of memory
allocated to the VM cluster based on the value you specified in the Specify the
memory per VM (GB) field. This field is not editable.
k. Specify the local file system size per VM (GB): Specify the local file system size
for each individual VM. The value must be a multiple of 1 GB and is limited by the
available size of the file system on the X8-2 and X7-2 infrastructures.
Note that the minimum size of local system storage must be 60 GB. In addition to the
60 GB, each node of the VM must have at least 137 GB free for miscellaneous VM
files. Each time when you create a new VM cluster, the space remaining out of the
total available space is utilized for the new VM cluster.
For more information and instructions to specify the size for each individual VM, see
Introduction to Scale Up or Scale Down Operations.
l. Reserved local storage per VM (GB): Displays the local storage size reserved
internally for root file systems, Oracle Grid Infrastructure Homes, and diagnostic logs.
This field is not editable.
m. Configure the Exadata Storage: The following settings define how the Exadata
storage is configured for use with the VM cluster. These settings cannot be changed
after creating the VM cluster.
• Specify Usable Exadata Storage: Specify the size for each individual VM. The
minimum recommended size is 2 TB.
• Allocate Storage for Exadata Snapshots: Check this option to create a sparse
disk group, which is required to support Exadata snapshot functionality. Exadata
snapshots enable space-efficient clones of Oracle databases that can be created
and destroyed very quickly and easily.
• Allocate Storage for Local Backups: Check this option to configure the
Exadata storage to enable local database backups. If you select this option, more
space is allocated to the RECO disk group to accommodate the backups. If you
do not select this option, you cannot use local Exadata storage as a backup
destination for any databases in the VM cluster.
Storage Allocation DATA Disk Group RECO Disk Group SPARSE Disk Group
Exadata Snapshots: 80% 20% 0% (The SPARSE disk
No group is not created.)
Enable Backups on
Local Exadata
Storage: No
Exadata Snapshots: 40% 60% 0% (The SPARSE disk
No group is not created.)
Enable Backups on
Local Exadata
Storage: Yes
Allocate Storage for 60% 20% 20%
Exadata Snapshots:
Yes
Enable Backups on
Local Exadata
Storage: No
5-81
Chapter 5
Manage VM Clusters
Storage Allocation DATA Disk Group RECO Disk Group SPARSE Disk Group
Allocate Storage for 35% 50% 15%
Exadata Snapshots:
Yes
Enable Backups on
Local Exadata
Storage: Yes
n. Add SSH Key: Specify the public key portion of an SSH key pair that you
want to use to access the VM cluster virtual machines. You can upload a file
containing the key, or paste the SSH key string.
To provide multiple keys, upload multiple key files or paste each key into a
separate field. For pasted keys, ensure that each key is on a single,
continuous line. The length of the combined keys cannot exceed 10,000
characters.
o. Choose a license type:
• Bring Your Own License (BYOL): Select this option if your organization
already owns Oracle Database software licenses that you want to use on
the VM cluster.
• License Included: Select this option to subscribe to Oracle Database
software licenses as part of Exadata Database Service on
Cloud@Customer.
p. Diagnostics Collection:
By enabling diagnostics collection and notifications, Oracle Cloud Operations
and you will be able to identify, investigate, track, and resolve guest VM issues
quickly and effectively. Subscribe to Events to get notified about resource state
changes. For more information, see Getting Started with Events.
Note:
You are opting in with the understanding that the list of events,
metrics, and log files collected can change in the future. You can opt
out of this feature at any time.
5-82
Chapter 5
Manage VM Clusters
Note:
If you want to set a time zone other than UTC or the browser-detected
time zone, then select the Select another time zone option, select a
Region or country, and then select the corresponding Time zone.
If you do not see the region or country you want, then select
Miscellaneous, and then select an appropriate Time zone.
• Tags: Optionally, you can apply tags. If you have permission to create a
resource, you also have permission to apply free-form tags to that resource. To
apply a defined tag, you must have permission to use the tag namespace. For
more information about tagging, see Resource Tags. If you are not sure if you
should apply tags, skip this option (you can apply tags later) or ask your
administrator.
6. Click Create VM Cluster.
The VM Cluster Details page is now displayed. While the creation process is running, the
state of the VM cluster is Pending. When the VM cluster creation process completes, the
state of the VM cluster changes to Available.
Related Topics
• Oracle Exadata Database Service on Cloud@Customer Service Description
Learn how you can leverage the combined capabilities of Oracle Exadata and Oracle
Cloud Infrastructure with Oracle Exadata Database Service on Cloud@Customer
• Using the Console to Scale the Resources on a VM Cluster
Starting in Exadata Database Service on Cloud@Customer Gen2, you can scale up or
down multiple resources at the same time. You can also scale up or down resources one
at a time.
• Introduction to Scale Up or Scale Down Operations
With the Multiple VMs per Exadata system (MultiVM) feature release, you can scale up or
scale down your VM cluster resources.
• Estimating How Much Local Storage You Can Provision to Your VMs
• Resource Tags
• Oracle PaaS/IaaS Cloud Service Description documents
• Oracle Platform as a Service and Infrastructure as a Service – Public Cloud Service
DescriptionsMetered & Non-Metered
5-83
Chapter 5
Manage VM Clusters
Note:
• You are opting in with the understanding that the list of events, metrics,
and log files collected can change in the future. You can opt-out of this
feature at any time.
• Oracle may add more metrics in the future, but if you have already
chosen to collect metrics, you need not update your opt-in value. It will
remain enabled/disabled based on your current preference.
• If have previously opted in for incident log and trace file collection and
decide to opt out when Oracle Cloud operations run a log collection job,
then the job will run its course and will not cancel. Future log collections
won't happen until you opt-in again to the incident logs and trace file
collection option.
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Choose the Region that contains your Exadata infrastructure.
3. Click VM Clusters.
4. Click the name of the VM cluster you want to enable or disable diagnostic data
collection.
5-84
Chapter 5
Manage VM Clusters
5. On the VM Cluster Details page, under General Information, enable, partially enable,
or disable Diagnostics Collection.
6. Click Edit.
Edit Diagnostics Collection Settings window is displayed.
7. Select or clear the checkboxes and then click Save Changes.
Related Topics
• Overview of Health Metrics and Log Collection
By enabling diagnostics collection and notifications, Oracle Cloud Operations and you will
be able to identify, investigate, track, and resolve guest VM issues quickly and effectively.
Subscribe to Events to get notified about resource state changes.
• Incident Logs and Trace Files
This section lists all of the files that can be collected by Oracle Support if you opt-in for
incident logs and trace collection.
• Health Metrics
Review the list of database and non-database health metrics collected by Oracle Trace
File Analyzer.
• Using the Console to Create a VM Cluster
To create your VM cluster, be prepared to provide values for the fields required for
configuring the infrastructure.
5-85
Chapter 5
Manage VM Clusters
3. Click the name of a VM cluster where you want to add virtual machines.
4. In the VM Cluster Details page, under Resources, click Virtual Machines, and
then click Add Virtual Machines.
5. On the Add Virtual Machines dialog, select additional DB servers on which to
add the VM.
You cannot unselect existing DB Servers. The maximum resources available per
VM get updated based on the newly added DB servers.
DB Server Statuses include In this VM cluster, Network not configured,
Available to add, and Insufficient resources. You can only add DB servers with
the Available to add status.
DB servers that do not have a network configured are not available to add. To
configure the network, edit the VM Cluster Network of the associated
infrastructure. For more information, see Using the Console to Add Another DB
Server to the VM Cluster Network.
6. Select the DB servers with the Available to add status and then click Save
Changes.
The statuses of the DB servers change to Allocated.
Note:
You cannot remove an allocated DB server.
To extend the database instance for Data Guard-enabled databases for the newly
added VMs, see Nodelist is not Updated for Data Guard-Enabled Databases.
Related Topics
• Using the Console to Add Another DB Server to the VM Cluster Network
To a DB server to the VM Cluster Network, complete this procedure.
• Adding a VM to a VM Cluster Fails
• Nodelist is not Updated for Data Guard-Enabled Databases
5-86
Chapter 5
Manage VM Clusters
Note:
Terminating a VM from a cluster requires the removal of any database which is part
of a Data Guard configuration (either primary or standby) from the VM to proceed
with the terminate flow. For more information on manual steps, see My Oracle
Support note 2811352.1.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Choose the Region and Compartment that contains the VM cluster for which you want
to scale the CPU resources.
3. Click VM Clusters.
4. Click the name of the VM cluster for which you want to remove a virtual machine.
5. Under Resources, click Virtual Machines.
6. In the list of virtual machines, click the Actions icon (three dots) for a virtual machine,
and then click Remove.
7. On the Terminate Virtual Machine dialog, enter the name of the virtual machine, and then
click Remove.
VM removed from the cluster. VM Cluster Details page displays the updated resource
allocation details under VM Cluster Resource Allocation.
Related Topics
• https://support.oracle.com/rs?type=doc&id=2811352.1
5-87
Chapter 5
Manage VM Clusters
5-88
Chapter 5
Manage VM Clusters
• Local storage
• Exadata storage
Each scale down operation can take approximately 15 minutes to complete. If you run
multiple scale down operations, then all the operations are performed in a series. For
example, if you scale down memory and local storage from the Console, then scaling down
happens one after the other. Scaling down local storage and memory takes more time than
the time taken to scale down OCPU and Exadata storage.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Choose the Region and Compartment that contains the VM cluster for which you want
to scale the CPU resources.
3. Click VM Clusters.
4. Click the name of the VM cluster for which you want to scale the CPU resources.
The VM Cluster Details page displays information about the selected VM cluster.
5. Click Scale Up/Down.
6. In the dialog box, adjust any or all of the following:
• OCPU Count:
The OCPU Count value must be a multiple of the number of virtual machines so that
every virtual machine has the same number of CPU cores enabled.
If you set the OCPU Count to zero, then the VM cluster virtual machines are all shut
down. If you change from a zero setting, then the VM cluster virtual machines are all
started. Otherwise, modifying the number of enabled CPU cores is an online
operation, and virtual machines are not rebooted because of this operation. See also
System Configuration.
Note:
If you have explicitly set the CPU_COUNT database initialization parameter,
that setting is not affected by modifying the number of CPU cores that are
allocated to the VM cluster. Therefore, if you have enabled the Oracle
Database instance caging feature, the database instance does not use
extra CPU cores until you alter the CPU_COUNT setting. If CPU_COUNT is set to
0 (the default setting), then Oracle Database continuously monitors the
number of CPUs reported by the operating system and uses the current
count.
• Memory:
Specify the memory for each individual VM. The value must be a multiple of 1 GB
and is limited by the available memory on the Exadata infrastructure.
When you scale up or down the memory, the associated virtual machines are
rebooted in a rolling manner one virtual machine at a time to minimize the impact on
the VM cluster.
• Local file system size:
Specify the size for each individual VM. The value must be a multiple of 1 GB and is
limited by the available size of the file system on the Exadata infrastructure.
5-89
Chapter 5
Manage VM Clusters
When you scale up or down the local file system size, the associated virtual
machines are rebooted in a rolling manner one virtual machine at a time to
minimize the impact on the VM cluster.
Reserved local storage per VM (GB): Displays the size reserved internally
for root file systems, Oracle Grid Infrastructure Homes, and diagnostic logs.
• Usable Exadata storage size:
Specify the total amount of Exadata storage that is allocated to the VM cluster.
This storage is allocated evenly from all of the Exadata Storage Servers. The
minimum recommended size is 2 TB.
You may reduce the Exadata storage allocation for a VM cluster. However, you
must ensure that the new amount covers the existing contents, and you should
also allow for anticipated data growth.
Note:
When you downsize, the new size must be at least 15% more than
the currently used size.
5-90
Chapter 5
Manage VM Clusters
b. Stop: Shuts down the node. After the node is stopped, the Start action is enabled.
c. Reboot: Shuts down the node, and then restarts it.
5-91
Chapter 5
Manage VM Clusters
VM clusters:
• CreateVmCluster
• DeleteVmCluster
5-92
Chapter 5
Manage Oracle Database Software Images
• GetVmCluster
• ListVmClusters
• UpdateVmCluster
5-93
Chapter 5
Manage Oracle Database Software Images
• Using the OPatch lsinventory Command to Verify the Patches Applied to an Oracle
Home
OPatch utility enables you to apply the interim patches to Oracle Database
software. You can find opatch utility in the $ORACLE_HOME/Opatch directory.
• Using the Console to Delete a Database Software Image
• Using the Console to View the Patch Information of a Database Software Image
To view the Oracle Database version, update information (PSU/BP/RU level), and
included one-off (interim) patches of a database software image, use the following
instructions:
• Using the Console to Move Database Software Image to a Different Compartment
Follow these steps to move a Database Software Image to a different
compartment of your choice:
• Using the API for Managing Oracle Database Software Images
Review the list of API calls to manage Oracle Database Software Image.
Related Topics
• Using the Console to Create Oracle Database Home on Exadata Database
Service on Cloud@Customer
To create an Oracle Database home in an existing VM cluster with the Console, be
prepared to provide values for the fields required.
• Using the Console to Perform a Patch Operation on a Database Home
Learn to apply patches on a Database Home.
5-94
Chapter 5
Manage Oracle Database Software Images
Note:
The Database Software Images are created and managed by the customer and
they are available for use until explicitly deleted.
Related Topics
• Using the Console to Create Oracle Database Home on Exadata Database Service on
Cloud@Customer
To create an Oracle Database home in an existing VM cluster with the Console, be
prepared to provide values for the fields required.
• Patching and Updating an Exadata Database Service on Cloud@Customer System
Learn how to perform patching operations on Exadata database virtual machines and
Database Homes by using the Console, API, or the CLI.
• Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
Learn to configure and manage Data Guard associations in your VM cluster.
5-95
Chapter 5
Manage Oracle Database Software Images
Related Topics
• Release Update Introduction and FAQ (Doc ID 2285040.1)
• Using the OPatch lsinventory Command to Verify the Patches Applied to an Oracle
Home
OPatch utility enables you to apply the interim patches to Oracle Database
software. You can find opatch utility in the $ORACLE_HOME/Opatch directory.
• Resource Tags
1. Run the opatch lsinventory command to get the list of interim patches applied.
$ORACLE_HOME/OPatch/opatch lsinventory
Oracle Interim Patch Installer version 12.2.0.1.21
Copyright (c) 2021, Oracle Corporation. All rights reserved.
5-96
Chapter 5
Manage Oracle Database Software Images
2. Use the lsinventory output file to extract the additional One Off Patches applied to a
specific Oracle Home.
5-97
Chapter 5
Manage Oracle Database Software Images
5-98
Chapter 5
Create Oracle Database Homes on an Exadata Database Service on Cloud@Customer System
Note:
Avoid entering confidential information when assigning descriptions, tags, or friendly
names to your cloud resources through the Oracle Cloud Infrastructure Console,
API, or CLI.
You can also add and remove Database homes, and perform other management tasks on a
Database home by using the dbaascli utility.
Related Topics
• Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Learn to use the dbaascli utility on Exadata Cloud@Customer.
5-99
Chapter 5
Create Oracle Database Homes on an Exadata Database Service on Cloud@Customer System
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
VM Clusters is selected by default.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of VM clusters, click the VM cluster on which you want to create the
Database Home.
4. Under Resources, click Database Homes.
5. Click Create Database Home.
6. In the Create Database Home dialog, enter the following:
• Database Home display name: The display name for the Database Home.
• Database image: Determines what Oracle Database version is used for the
database. You can mix database versions on the Exadata VM Cluster, but not
editions. By default, the latest Oracle-published database software image is
selected.
Click Change Database Image to use an older Oracle-published image or a
custom Database Software Image that you have created in advance, then
select an Image Type.
Oracle Provided Database Software Images: These images contain
generally available versions of Oracle Database software.
Custom Database Software Images: These images are created by your
organization and contain customized configurations of software updates and
patches. Use the Select a compartment and Select a Database version
selectors to limit the list of custom Database Software Images to a specific
compartment or Oracle Database software major release version.
After choosing a software image, click Select to return to the Create Database
Home dialog.
Note:
For the Oracle Database major version releases available in Oracle
Cloud Infrastructure, images are provided for the current version plus
the three most recent older versions (N through N - 3). For example,
if an instance is using Oracle Database 19c, and the latest version of
19c offered is 19.8.0.0.0, images available for provisioning are for
versions 19.8.0.0.0, 19.7.0.0, 19.6.0.0 and 19.5.0.0.
A Database Software Image will not be available for Database Home creation
if:
– The database version of Database Software Image is out of support. For
example, Database Software Images created using 11.2.0.4 will not be
available for Database Home provisioning after 31-Dec-2022.
– The Exadata model should support the PSU/RU version of the Database
Software Image. For example, for the 19c release, the X8M-2 model
supports RU version 19.4 and greater.
5-100
Chapter 5
Manage Oracle Database Homes on Exadata Database Service on Cloud@Customer Systems
Related Topics
• Resource Tags
5-101
Chapter 5
Manage Oracle Database Homes on Exadata Database Service on Cloud@Customer Systems
Note:
Avoid entering confidential information when assigning descriptions, tags, or
friendly names to your cloud resources through the Oracle Cloud
Infrastructure Console, API, or CLI.
Related Topics
• Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Learn to use the dbaascli utility on Exadata Cloud@Customer.
5-102
Chapter 5
Manage Oracle Database Homes on Exadata Database Service on Cloud@Customer Systems
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
VM Clusters is selected by default.
2. Click Compartment, and select your compartment.
A list of VM Clusters is displayed for the compartment you selected.
3. In the list of VM clusters, click the VM cluster that contains the Database Home in which
you are interested.
4. Under Resources, click Database Homes.
5. In the list of Database Homes, find the Database Home you want to view, and then click
the Database Home name to display details about it.
5-103
Chapter 5
Manage Oracle Database Homes on Exadata Database Service on Cloud@Customer Systems
• GetDbHome
• DeleteDbHome
If you terminate a Database Home using the dbaascli or dbaasapi, the status of the
Database Home is displayed as Terminated in the Database Service REST API based
tools. If you terminate a database, the status of the database is displayed as Failed.
5-104
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
5-105
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
of the Enterprise Edition options, such as Oracle Database In-Memory, and Oracle
Real Application Clusters (Oracle RAC). If you use your own Oracle Database
licenses, then your ability to use various features is limited by your license holdings.
TDE Encryption is required for all cloud databases. All new tablespaces will
automatically be enabled for encryption.
5-106
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
• Each database is created in an Oracle home, which uses a separate set of Oracle
binaries in a separate Oracle home location.
• Each database is configured with default instance parameter settings. While the defaults
are reasonable for many cases, you should review the instance parameter settings to
ensure that they meet your specific application needs.
In particular, review the Oracle Database system global area (SGA) and program global
area (PGA) instance parameter settings, especially if your VM cluster supports multiple
databases. Also, ensure that the sum of all Oracle Database memory allocations never
exceeds the available physical memory on each virtual machine.
• Exadata Database Service will only create databases with 8K block size. This parameter
cannot be changed.
• Each database using Oracle Database 12c Release 1 or a later release is configured as
a container database (CDB). One pluggable database (PDB) is created inside the CDB.
By default:
– The first PDB is configured with a local PDB administration user account, named
PDBADMIN.
– The PDBADMIN user account is initially configured with the same administration
password as the CDB SYS and SYSTEM users.
– The PDBADMIN user account is initially configured with basic privileges assigned
through two roles; CONNECT and PDB_DBA. However, for most practical administrative
purposes you must assign extra privileges to the PDBADMIN user account, or to the
PDB_DBA role.
You can use native Oracle Database facilities to create extra PDBs, and to manage all of
your PDBs. The dbaascli utility also provides a range of convenient PDB management
functions.
Note:
Avoid entering confidential information when assigning descriptions, tags, or friendly
names to your cloud resources through the Oracle Cloud Infrastructure Console,
API, or CLI.
5-107
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
Note:
You cannot modify the db_name, db_unique_name, and SID prefix after
creating the database.
• Provide the database name: Specify a user-friendly name that you can use
to identify the database. The database name must contain only the permitted
characters.
Review the following guidelines when selecting a database name.
– maximum of 8 characters
– contain only alphanumeric characters
– begin with an alphabetic character
– cannot be part of first 8 characters of a db_unique_name on the VM cluster
– unique within a VM cluster
– DO NOT use grid because grid is a reserved name
– DO NOT use ASM because ASM is a reserved name
5-108
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
• Provide a unique name for the database: Optionally, specify a unique name for the
database. This attribute defines the value of the db_unique_name database
parameter. The value is case insensitive.
The db_unique_name must contain only the permitted characters. Review the
following guidelines when selecting a database name.
– maximum of 30 characters
– can contain alphanumeric and underscore (_) characters
– begin with an alphabetic character
– unique across the fleet/tenancy
If a unique name is not provided, then the db_unique_name defaults to the following
format <db_name>_<3 char unique string>_<region-name>.
If you plan to configure the database for backup to a Recovery Appliance backup
destination, then the unique database name must match the name that is configured
in the Recovery Appliance.
• Select a database version: From the list, choose the Oracle Database software
release that you want to deploy.
• Database Home: Select an existing Database Home or create one as applicable.
Note that this field is not available when you create a Database from the Database
Home details page.
– Select an existing Database Home: If one or more Database Homes already
exist for the database version you have selected, then this option is selected by
default. And, you will be presented with a list of Database Homes. Select a
Database Home from the list.
– Create a new Database Home: If no Database Homes exist for the database
version you have selected, then this option is selected by default.
a. Enter Database Home display name.
b. Click Change Database Image to select your software version.
Select a Database Software Image window is displayed.
c. Select an Image Type, Oracle Provided Database Software Images, or
Custom Database Software Images.
If you choose Oracle Provided Database Software Images, then you can
use the Display all available version switch to choose from all available
PSUs and RUs. The most recent release for each major version is indicated
with a latest label.
Note:
For the Oracle Database major version releases available in Oracle
Cloud Infrastructure, images are provided for the current version
plus the three most recent older versions (N through N - 3). For
example, if an instance is using Oracle Database 19c, and the
latest version of 19c offered is 19.8.0.0.0, images available for
provisioning are for versions 19.8.0.0.0, 19.7.0.0, 19.6.0.0 and
19.5.0.0.
5-109
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
• Provide the name of the first PDB: (Optional) Specify the name for the first
PDB. A PDB is created with the database.
To avoid potential service name collisions when using Oracle Net Services to
connect to the PDB, ensure that the PDB name is unique across the entire VM
cluster. If you do not provide the name of the first PDB, then a system-
generated name is used.
• Provide the administration password: Provide and confirm the Oracle
Database administration password. This password is used for administration
accounts and functions in the database, including:
– The password for the Oracle Database SYS and SYSTEM users.
– The Transparent Data Encryption (TDE) Keystore password.
For Oracle Database 12c Release 1 or later releases, the password for the
PDB administration user in the first PDB (PDBADMIN) must be nine to 30
characters and contain at least two uppercase, two lowercase, two numeric,
and two special characters. The special characters must be _, #, or -. In
addition, the password must not contain the name of the tenancy or any
reserved words, such as Oracle or Table, regardless of casing.
– Use the administrator password for the TDE wallet: When this option
is checked, the password entered for the SYS user is also used for the
TDE wallet. To set the TDE wallet password manually, uncheck this option
and enter the TDE wallet password.
• Choose the database workload type: Select the workload type that best
suits your application from one of the following options:
– Transactional Processing: Select this option to configure the database
for a transactional workload, with a bias toward high volumes of random
data access.
– Data Warehouse: Select this option to configure the database for decision
support or data warehouse workload, with a bias toward large data
scanning operations.
• Backup Destination Type: Select a backup destination for the database.
From the list, choose an option:
– None: Select to not define a backup configuration for the database.
– Local: Select to store backups locally in the Oracle Exadata Storage
Servers on your Oracle Exadata Cloud at Customer system.
This option is available only if you enabled backups on local Oracle
Exadata storage in the VM cluster that you want to host the database.
– Object Storage: Select to store backups in an Oracle-managed object
storage container on Oracle Cloud Infrastructure.
To use this option, your Oracle Exadata Cloud@Customer system must
have egress connectivity to Oracle Cloud Infrastructure Object Storage.
– NFS: Select to store backups in one of your previously defined backup
destinations that use Network File System (NFS) storage. For more
information, refer to the information about backup destinations in this
publication.
If you select this option, then you must also choose from the list of NFS
Backup Destinations.
5-110
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
Note:
If you select a backup destination, then you cannot change a backup
location after the database is created. However, if you select None
now, then you can select a backup destination after the database is
created.
– Enable automatic backups: Select this option to enable daily backups using the
policy for automatic backups.
This option is only enabled when you select a Backup Destination Type other
than None. You can change this setting after database creation.
• (Optional) Select Show Advanced Options. From this window, you can select the
following options:
– Provide the Oracle SID prefix:
Note:
Entering a SID prefix is only available for 12.1 databases and above.
Optionally, specify the Oracle SID prefix for the database. The instance number
is automatically appended to the SID prefix to become the instance_name
database parameter. If not provided, then the SID prefix defaults to the db_name.
Review the following guidelines when selecting a database name:
* maximum of 12 characters
* contain only alphanumeric characters
* begin with an alphabetic character
* unique in the VM cluster
– Backup retention period: From the list, you can choose the length of time that
you want automatic backups to be retained.
For backups to local Exadata storage, you can choose a retention period of 7
days or 14 days. The default retention period is 7 days.
5-111
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
5-112
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
Note:
Oracle recommends using Database Homes, which are running the latest (N) to
3 versions from the latest (N-3) RU versions when updating the software
version of the database by moving them to a target DB Home. Only DB Homes
provisioned with database versions, which meet this best practice criterion are
available as target homes to move your database.
5-113
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
• DeleteDbHome
• GetDbHome
• ListDbHomes
Databases:
• CreateDatabase
• GetDatabase
• ListDatabases
• UpdateDatabase
• UpdateDatabaseDetails
Nodes:
• GetDbNode
• List DbNodes
Use UpdateDatabase to move a database to a different Database Home, thereby
updating the database to the same version as the target Database Home.
For the complete list of APIs, see "Database Service API".
Related Topics
• REST APIs
• Security Credentials
• Software Development Kits and Command Line Interface
• CreateDbHome
• DeleteDbHome
• GetDbHome
• ListDbHomes
• CreateDatabase
• GetDatabase
• ListDatabases
• UpdateDatabase
• UpdateDatabaseDetails
• GetDbNode
• List DbNodes
• Database Service API
5-114
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
set as the password for the SYS, SYSTEM, TDE wallet, and PDB administrator credentials.
Use the following procedures if you need to change passwords for an existing database.
Note:
if you are enabling Data Guard for a database, then the SYS password and the
TDE wallet password of the primary and standby databases must all be the same.
Note:
Using the dbaascli to change the SYS password will ensure the backup/restore
automation can parallelize channels across all nodes in the cluster.
2. Copy the blob file created to all the standby databases and update the file ownership to
oracle user.
3. Run the following command on all the standby databases:
5-115
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
5-116
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
– List backups:
• Restore operations are performed at the CDB level. OCI Control Plane does not support
restoring individual PDBs. However, bkup_api supports PDB restore operations.
Examples:
– Recover a PDB with least or no data loss possible:
Related Topics
• Configuring and Customizing Backups with bkup_api
In addition to the console-based automated backup option, there is a command line
backup utility, bkup_api, which can allow for further customization. If configuring backups
using bkup_api instead of the console, then do not enable backups for your database in
the console.
5-117
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
3. In the list of cloud VM clusters, click the name of the cluster in which you want to
create the PDB, and then click its name to display the database details page.
4. In the lower-left corner of the database details page, click Pluggable Databases.
A list of existing PDBs in this database is displayed.
5. Click Create Pluggable Database.
The Create Pluggable Database dialog box is displayed.
6. In the Create Pluggable Database dialog box, enter the following:
• Provide the name of the PDB Enter a name for the PDB. The name must
begin with an alphabetic character and can contain a maximum of 30
alphanumeric characters.
• Unlock my PDB Admin Account:
– To enter the administrator's password, check this check box.
* PDB Admin Password: Enter PDB admin password. The password
must contain:
* a minimum of 9 and a maximum of 30 characters
* at least two uppercase characters
* at least two lowercase characters
* at least two special characters. The valid special characters are
underscore ( _ ), a pound or hash sign (#), and dash (-). You can
use two of the same characters or any combination of two of the
same characters.
* at least two numeric characters (0 - 9)
* Confirm PDB Admin Password: Enter the same PDB Admin
password in the confirmation field.
– To skip entering the administrator's password, uncheck this check box. If
you uncheck this check box, then the PDB is created but you cannot use
it. To use the PDB, you must reset the administrator password.
Note:
When you create a new PDB, a local user in the PDB is created
as the administrator and granted the PDB_DBA role locally to the
administrator.
5-118
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
• TDE Wallet password: Enter a wallet password for the CDB. This password has the
same rules as the PDB Admin Password.
• Advanced Options:
– Tags: Optionally, you can apply tags. If you have permission to create a
resource, you also have permission to apply free-form tags to that resource. To
apply a defined tag, you must have permission to use the tag namespace. For
more information about tagging, see Resource Tags. If you are not sure if you
should apply tags, skip this option (you can apply tags later) or ask your
administrator.
7. Click Create Pluggable Database.
The system starts the creation process and opens the Work Request page for the new
PDB. The Work request page shows the status of the creation process of the new PDB.
By default, the Work Request details page shows the log messages created by the
system. Click Error Messages or Associated Resources to see any error messages or
associated resources for the creation process, in the Resources area on the left side of
the page.
Note:
The numbers at the right side of the Log Messages, Error Messages, and
Associated Resources links indicate how many of each item exists.
Related Topics
• Administering a CDB
• Administering PDBs
5-119
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
5-120
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
5-121
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
5-122
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
5-123
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
Note:
You must have the TDE wallet password of the PDB's parent CDB to clone
the PDB.
1. Open the navigation menu Under Oracle Database, and click Exadata
Cloud@Customer.
VM Clusters is selected by default.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of VM clusters, click the name of the VM cluster that contains the PDB
you want to clone, and then click its name to display the details page.
4. Under Databases, find the database containing the PDB you want to clone.
5. Click Pluggable Databases in the Resources section of the page.
A list of existing PDBs in this database is displayed.
6. Click the name of the PDB that you want to clone.
The pluggable details page is displayed.
7. Click Clone.
8. In the Clone PDB dialog box, enter the following:
• VM Cluster: Use the menu to select the source VM cluster.
• Destination database: Use the menu to select an existing database where
the PDB is created. This database can be the same database as the source
PDB is in or a different CDB.
• Source Database Admin password: Enter the database admin password.
This field is disabled if the source PDB and cloned PDB are in the same CDB.
• New PDB name for the clone: The name must begin with an alphabetic
character and can contain up to 30 characters.
• Database TDE wallet password: Enter the TDE wallet password for the
parent CDB of the source PDB.
• Unlock my PDB Admin Account:
– To enter the administrator's password, check this check box.
* PDB Admin Password: Enter PDB admin password. The password
must contain:
5-124
Chapter 5
Manage Databases on Exadata Database Service on Cloud@Customer
Note:
When you create a new PDB, a local user in the PDB is created as the
administrator and granted the PDB_DBA role locally to the administrator.
5-125
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
• Backup Destinations
• Oracle Database Backup Methods in Exadata Cloud
Oracle Exadata Cloud@Customer offers two approaches to configure and take
backups as a recommended solution: Oracle Managed Backup and User
Configured Backup.
• Configuring and Customizing Backups with bkup_api
In addition to the console-based automated backup option, there is a command
line backup utility, bkup_api, which can allow for further customization. If
configuring backups using bkup_api instead of the console, then do not enable
backups for your database in the console.
5-126
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Backup Destinations
5-127
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
cloud object storage or local Exadata storage are available directly when you create a
database.
Note:
Avoid entering confidential information when assigning descriptions, tags, or
friendly names to your cloud resources through the Oracle Cloud
Infrastructure Console, API, or CLI.
Related Topics
• Zero Data Loss Recovery Appliance
• Manage Oracle Database Homes on Exadata Database Service on
Cloud@Customer Systems
Learn to manage Oracle Database homes on Exadata Database Service on
Cloud@Customer.
• Using the Console to Create a Backup Destination
To create a backup destination, be prepared to provide values for the backup
destination configuration.
• Manage Database Backup and Recovery on Oracle Exadata Database Service on
Cloud@Customer
Learn how to work with the backup and recovery facilities provided by Oracle
Exadata Database Service on Cloud@Customer.
5-128
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
* The NFS-mounted file system must be readable and writable by the oracle
operating system user on all of the VM cluster nodes.
– Exadata Database Service on Cloud@Customer Autonomous Databases:
* To ensure that the Autonomous VM cluster can access the NFS server over the
Backup Network, enter valid Backup Network IP addresses while configuring VM
Cluster Network.
* The NFS-mounted file system must be readable and writable by the oracle
operating system user on all of the VM cluster nodes.
* If permissions are being controlled at the user level, then the uid:gid of the
oracle user for the Autonomous VM cluster is 1001:1001.
Using the Console for Backup Destinations for Exadata Database Service on
Cloud@Customer
Learn how to use the console to create, edit, move, and terminate a backup destination for
your infrastructure for Oracle Exadata Database Service on Cloud@Customer.
• Using the Console to Create a Backup Destination
To create a backup destination, be prepared to provide values for the backup destination
configuration.
• Using the Console to Edit a Backup Destination
To edit a backup destination, be prepared to provide values for the backup destination
configuration.
• Using the Console to Move a Backup Destination to Another Compartment
To move a backup destination, be prepared to provide values for the backup destination
configuration.
• Using the Console to Delete a Backup Destination
To delete a backup destination, be prepared to provide values for the backup destination
configuration.
5-129
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Specify a user-friendly name that you can use to identify the backup
destination. The name doesn't need to be unique because an Oracle Cloud
Identifier (OCID) uniquely identifies the backup destination.
c. Choose either a Zero Data Loss Recovery Appliance or a network file system
(NFS) backup destination.
Note:
You can also set OCI Object Store as a backup destination.
However, you cannot set it from this screen. You can configure OCI
Object Store as a backup destination when creating a database. For
more information, see Backup Destination Type in Using the Console
to Create a Database.
5-130
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
tags, then skip this option (you can apply tags later), or ask your administrator.
6. Click Create Backup Destination.
The Backup Destination Details page displays the newly created backup destination.
Related Topics
• Using the Console to Create a Database
To create an Oracle Database with the console, use this procedure.
• Resource Tags
Note:
You cannot edit a Backup Destination if there is already a database attached to
it.
• If you are editing a Zero Data Loss Recovery Appliance backup destination:
– Provide the Recovery Appliance connection string: Specify the Oracle Net
Services connection string that connects to the Recovery Appliance. This
information is typically provided by the Recovery Appliance administrator.
– Provide the Virtual Private Catalog (VPC) Users: Provide a VPC user name
for connecting to the Recovery Appliance. You can specify multiple VPC user
names in case you want to use the Recovery Appliance as a backup destination
for multiple databases. This information is typically provided by the Recovery
Appliance administrator.
• If you are editing an NFS backup destination:
– Self-mount for non-autonomous databases:
Provide the local NFS mount point path: Specify the local directory path on
each VM cluster node where the NFS server location is mounted. The local
5-131
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
directory path and the NFS server location must each be the same across
all of the VM cluster nodes.
– Auto-mount for Autonomous Databases:
Use this destination for Autonomous Databases:
* NFS server: Specify the IP address of the NFS server. Optionally, you
can specify up to four IP addresses.
* NFS export share: Specify the directory path where the exported file
system is mounted.
7. Click Save Changes.
5-132
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
5-133
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Backup Destinations
5-134
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Note:
Avoid entering confidential information when assigning descriptions, tags, or friendly
names to your cloud resources through the Oracle Cloud Infrastructure Console,
API, or CLI.
Related Topics
• Zero Data Loss Recovery Appliance
• Manage Oracle Database Homes on Exadata Database Service on Cloud@Customer
Systems
Learn to manage Oracle Database homes on Exadata Database Service on
Cloud@Customer.
• Using the Console to Create a Backup Destination
To create a backup destination, be prepared to provide values for the backup destination
configuration.
• Manage Database Backup and Recovery on Oracle Exadata Database Service on
Cloud@Customer
Learn how to work with the backup and recovery facilities provided by Oracle Exadata
Database Service on Cloud@Customer.
5-135
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
– The appliance must be configured with a virtual private catalog (VPC) user,
which is used for taking the backups.
– The appliance must be configured with the unique database name of the
database being backed up, and a mapping to the VPC user.
– The appliance must be accessible from the Exadata Database Service on
Cloud@Customer system using the Oracle Net Services connection string,
which is provided by the Zero Data Loss Recovery Appliance administrator.
• For an NFS backup destination:
– Exadata Database Service on Cloud@Customer non-autonomous databases:
* You must mount the NFS server location to a local mount point directory
on each node in the VM cluster.
* The local mount point directory and the NFS server must be identical
across all nodes in the cluster.
* You must ensure that the NFS mount is maintained continuously on all of
the VM cluster nodes.
* The NFS-mounted file system must be readable and writable by the
oracle operating system user on all of the VM cluster nodes.
– Exadata Database Service on Cloud@Customer Autonomous Databases:
* To ensure that the Autonomous VM cluster can access the NFS server
over the Backup Network, enter valid Backup Network IP addresses while
configuring VM Cluster Network.
* The NFS-mounted file system must be readable and writable by the
oracle operating system user on all of the VM cluster nodes.
* If permissions are being controlled at the user level, then the uid:gid of the
oracle user for the Autonomous VM cluster is 1001:1001.
Using the Console for Backup Destinations for Exadata Database Service on
Cloud@Customer
Learn how to use the console to create, edit, move, and terminate a backup
destination for your infrastructure for Oracle Exadata Database Service on
Cloud@Customer.
• Using the Console to Create a Backup Destination
To create a backup destination, be prepared to provide values for the backup
destination configuration.
• Using the Console to Edit a Backup Destination
To edit a backup destination, be prepared to provide values for the backup
destination configuration.
• Using the Console to Move a Backup Destination to Another Compartment
To move a backup destination, be prepared to provide values for the backup
destination configuration.
• Using the Console to Delete a Backup Destination
To delete a backup destination, be prepared to provide values for the backup
destination configuration.
Using the Console to Create a Backup Destination
5-136
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
To create a backup destination, be prepared to provide values for the backup destination
configuration.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Choose the Region that contains your Exadata infrastructure.
3. Click Backup Destinations.
4. Click Create Backup Destination.
5. Provide the requested information in the Create Backup Destination page:
a. Choose a compartment.
From the list of available compartments, choose the compartment that you want to
contain the backup destination.
b. Name your backup destination.
Specify a user-friendly name that you can use to identify the backup destination. The
name doesn't need to be unique because an Oracle Cloud Identifier (OCID) uniquely
identifies the backup destination.
c. Choose either a Zero Data Loss Recovery Appliance or a network file system (NFS)
backup destination.
Note:
You can also set OCI Object Store as a backup destination. However, you
cannot set it from this screen. You can configure OCI Object Store as a
backup destination when creating a database. For more information, see
Backup Destination Type in Using the Console to Create a Database.
5-137
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Note:
You cannot edit a Backup Destination if there is already a database
attached to it.
• If you are editing a Zero Data Loss Recovery Appliance backup destination:
5-138
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
– Provide the Recovery Appliance connection string: Specify the Oracle Net
Services connection string that connects to the Recovery Appliance. This
information is typically provided by the Recovery Appliance administrator.
– Provide the Virtual Private Catalog (VPC) Users: Provide a VPC user name
for connecting to the Recovery Appliance. You can specify multiple VPC user
names in case you want to use the Recovery Appliance as a backup destination
for multiple databases. This information is typically provided by the Recovery
Appliance administrator.
• If you are editing an NFS backup destination:
– Self-mount for non-autonomous databases:
Provide the local NFS mount point path: Specify the local directory path on
each VM cluster node where the NFS server location is mounted. The local
directory path and the NFS server location must each be the same across all of
the VM cluster nodes.
– Auto-mount for Autonomous Databases:
Use this destination for Autonomous Databases:
* NFS server: Specify the IP address of the NFS server. Optionally, you can
specify up to four IP addresses.
* NFS export share: Specify the directory path where the exported file system
is mounted.
7. Click Save Changes.
Using the Console to Move a Backup Destination to Another Compartment
To move a backup destination, be prepared to provide values for the backup destination
configuration.
You can change the compartment that contains your backup destination by moving it.
When you move a backup destination, the compartment change does not affect other
associated resources. These other resources, such as the associated databases, remain in
their current compartment.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Choose the Region and Compartment that contains the backup destination that you
want to move.
3. Click Backup Destinations.
4. Click the name of the backup destination that you want to move.
The Backup Destination Details page displays information about the selected backup
destination.
5. Click Move Resource.
6. In the resulting dialog, choose the new compartment for the backup destination and click
Move Resource.
Using the Console to Delete a Backup Destination
To delete a backup destination, be prepared to provide values for the backup destination
configuration.
Before you can delete a backup destination, you must ensure that it is not associated with
any databases.
5-139
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
5-140
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
• UpdateBackupDestination
• ChangeBackupDestinationCompartment
• Database Service API
5-141
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Note:
The backup and recovery facilities described in this topic cater only for
database backup and recovery, which includes Oracle Database data files,
log files, control files, and the server parameter (SP) file. You are responsible
for backing up other files on your virtual machines. In particular, Oracle
strongly recommends that you back up the Transparent Data Encryption
(TDE) keystore (wallet). Without the TDE keystore, the Oracle Database
backups are effectively useless, because you cannot read the data contained
in the backup.
5-142
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Note:
If TAG based recovery fails with error ORA-01152, then use Recovery Manager
(RMAN) directly to complete the recovery.
If the server parameter file (SPFILE) recovery fails for local configuration using
dbaascli, then use Recovery Manager (RMAN) directly to complete the recovery.
Note:
Only the managed backups are synced to the Console. If you configure backups
directly in the backend, then they are not synced to the Console. This is an
expected behavior and Oracle has no plans to change this behavior.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Choose the Region and Compartment that contains the VM cluster that hosts the
database in which you are interested.
3. Click VM Clusters.
4. Click the name of the VM cluster that hosts the database in which you are interested.
5. In the Resources list of the VM Cluster Details page, click Databases.
6. Click the name of the database in which you are interested.
The Database Details page displays information about the selected database, which
includes a list of the available backups.
Editing Backup Settings with the Console
5-143
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
5-144
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Note:
If you select a backup destination (other than None), then you
cannot change it later.
5-145
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
– You can set the option to Enable automatic backups. Select this option
to enable automatic database backups. Deselect this option to suspend
automatic database backups.
9. Click Save Changes.
Related Topics
• Backup Destinations
• Customizing Real Time Redo Transport (RTRT) Behavior for Recovery Appliance
Backups
Restoring a Database with the Console
To restore a database to a point in time, to a system change number (SCN), or to the
latest backup, use the Exadata Database Service on Cloud@Customer Console.
Use the following procedure to restore a database:
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Choose the Region and Compartment that contains the VM cluster that hosts the
database that you want to restore.
3. Click VM Clusters.
4. Click the name of the VM cluster that hosts the database that you want to restore.
5. In the Resources list of the VM Cluster Details page, click Databases.
6. Click the name of the database that you want to restore.
The Database Details page displays information about the selected database.
7. Click Restore Database.
8. In the resulting dialog box, select one of the following options, and click Restore
Database:
• Restore to latest: The database is restored and recovered with zero, or least
possible, data loss.
• Restore to a timestamp: The database is restored and recovered to the
specified timestamp.
• Restore to SCN: The database is restored and recovered to the specified
Oracle Database System Change Number (SCN). The specified SCN must be
valid otherwise the operation fails.
Note:
Backup fails after a point in time restore to a timestamp or SCN on NFS
storage. Wait for 10 minutes or so before proceeding with the backup.
5-146
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
For information about using the API and signing requests, see "REST APIs" and "Security
Credentials". For information about SDKs, see "Software Development Kits and Command
Line Interface".
Use these API operations to manage database backup and recovery:
• GetBackup
• ListBackups
• RestoreDatabase
• UpdateDatabase - To enable and disable automatic backups.
For the complete list of APIs, see "Database Service API".
Related Topics
• REST APIs
• Security Credentials
• Software Development Kits and Command Line Interface
• GetBackup
• ListBackups
• RestoreDatabase
• UpdateDatabase
• Database Service API
5-147
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Returns the Backup configuration of the database in a file specified by the user. If the
backup is never configured, it returns the default template where the user can fill the
configuration parameters with their values and use it as input to --configure command
option.
5-148
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Using dbaascli database backup --configure, you can set the backup configuration
information for a database in the following cases:
1. User Managed Backup: Set complete backup configuration based on the destination.
2. Oracle Managed Backup: Set additional configuration parameters if a parameter is
compatible with Oracle Managed Backup.
Note that using dbaascli database backup --configure to set incompatible parameters
with Oracle Managed Backups can lead to backup/recovery issues. Currently, Oracle
does not validate whether a parameter is compatible or not. Until Oracle implements
validation, it is your responsibility to verify compatibility.
This asynchronous command generates a universally unique identifier (UUID), which you
can use to track the status.
Note:
When using Oracle Managed Backups, you may want to change some of the
backup configuration settings based on your application requirements. You can
use dbaascli to modify these parameters if they are tagged with Compatible
with console automatic backup.
Table 5-12 General Configuration Parameters (valid for all backup destinations
except Local Storage (FRA))
5-149
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Table 5-12 (Cont.) General Configuration Parameters (valid for all backup
destinations except Local Storage (FRA))
5-150
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Table 5-13 Configuration Parameters for Object Storage Service (OSS) Destination
Note:
Currently, Zero Data Loss Recovery Appliance (ZDLRA) destination is supported
only on Exadata Cloud@Customer.
Configuration Parameters for Zero Data Loss Recovery Appliance (ZDLRA) Destination
Table 5-14 Configuration Parameters for Zero Data Loss Recovery Appliance
(ZDLRA) Destination
5-151
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Table 5-14 (Cont.) Configuration Parameters for Zero Data Loss Recovery Appliance
(ZDLRA) Destination
For more information, see Customizing Real Time Redo Transport (RTRT) Behavior
for Recovery Appliance Backups.
5-152
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Note:
Currently, Network File System (NFS) destination is supported only on Exadata
Cloud@Customer.
Note:
Currently, Local Storage (FRA) destination is supported only on Exadata
Cloud@Customer.
Related Topics
• Customizing Real Time Redo Transport (RTRT) Behavior for Recovery Appliance
Backups
• dbaascli database backup
To configure Oracle Database with a backup storage destination, take database backups,
query backups, and delete a backup, use the dbaascli database backup command.
• dbaascli database recover
To recover a database, use the dbaascli database recover command.
• dbaascli pdb backup
To backup a pluggable database (PDB), query PDB backups, and delete a PDB backup,
use the dbaascli pdb backup command.
• dbaascli pdb recover
To recover a pluggable database (PDB), use the dbaascli pdb recover command.
5-153
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Before performing a backup, you must set up the backup configuration using dbaascli
database backup --configure command as a prerequisite. For more information, see
dbaascli database backup.
Related Topics
• dbaascli database backup
To configure Oracle Database with a backup storage destination, take database
backups, query backups, and delete a backup, use the dbaascli database
backup command.
You can also perform a backup of a specific PDB. This is useful if one or more PDBs
need to be backed up immediately or adhoc need basis, instead of backing up the
complete CDB which has its own schedule. For more information, see dbaascli pdb
backup.
Related Topics
• dbaascli pdb backup
To backup a pluggable database (PDB), query PDB backups, and delete a PDB
backup, use the dbaascli pdb backup command.
As the backup operation is being run, its status can be monitored by providing the job
ID that is displayed to the user when the backup command is executed. For more
information, see dbaascli database backup and dbaascli pdb backup.
Related Topics
• dbaascli database backup
To configure Oracle Database with a backup storage destination, take database
backups, query backups, and delete a backup, use the dbaascli database
backup command.
• dbaascli pdb backup
To backup a pluggable database (PDB), query PDB backups, and delete a PDB
backup, use the dbaascli pdb backup command.
To perform recovery of the database, there are various options depending on the type
of fault, availability of data, and its' backup and recovery requirement. For more
information, see dbaascli database recover.
• Recovering a PDB
• Fetching Recover Job Status
Related Topics
• dbaascli database recover
To recover a database, use the dbaascli database recover command.
Recovering a PDB
5-154
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
You can also recover a particular PDB instead of complete CDB whenever that can be
avoided. It reduces the impact of the outage as only the particular PDB is being recovered
while the rest of the CDB and PDBs are still available for business and applications. For more
information, see dbaascli pdb recover.
Related Topics
• dbaascli pdb recover
To recover a pluggable database (PDB), use the dbaascli pdb recover command.
Similar to backup, the recovery commands' status can be monitored by providing the job ID
that is displayed to the user when the recovery command is executed. To know the status of
recovery operation: For more information, see dbaascli database recover and dbaascli pdb
recover.
Related Topics
• dbaascli database recover
To recover a database, use the dbaascli database recover command.
• dbaascli pdb recover
To recover a pluggable database (PDB), use the dbaascli pdb recover command.
Note:
bkup_api will be deprecated in a future release. Use the dbaascli database
backup, dbaascli pdb backup, dbaascli database recover, and dbaascli pdb
recover commands to backup and recover container databases and pluggable
databases. For more information, see User Configured Backup.
5-155
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Related Topics
• User Configured Backup
It is the user's responsibility to configure and execute backup operations using
dbaascli according to their preferences.
WARNING:
In general, bkup_api configured backups, as described in this section,
should not be used in conjunction with console-enabled automatic backups,
other than the exceptions noted specifically below. If using parameters, other
than those noted as safe below, then do not enable console-based backups;
otherwise, conflicting conditions or over-writes of settings can occur, and
backups may not execute successfully.
To generate a configuration file with the current backup settings and use it to update
the settings:
1. Connect to a virtual machine as opc user.
For detailed instructions, see Connecting to a Virtual Machine with SSH.
2. Start a root user command shell:
sudo -s
3. Use the bkup_api get config command to generate a file containing the current
backup settings for the database deployment:
Where:
filename is an optional parameter used to specify a name for the file that is
generated
dbname is the database name for the database that you want to act on
4. Edit the parameter values in the generated file to change any settings you want to
customize in the backup configuration.
The following parameters can be modified to customize the backup configuration:
5-156
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Note:
Compatible with Console Automatic Backups=Yes indicates the parameter is
safe to change, even when using console-based automatic backups. If using
parameters with Compatible with Console Automatic Backups=No, then do
not enable backups through the console.
bkup_cfg_files Note: No
5-157
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
5-158
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
5-159
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Note:
Zero Data Loss Recovery Appliance (ZDLRA) parameters are only valid
for Exadara Cloud@Customer installations.
5-160
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Only the above parameters noted with *Compatible with Console Automatic Backups
= Yes are safe to alter in conjunction with console-based automatic backups. If any other
parameters are to be altered, then do not enable backups through the console.
5. Use the bkup_api set config command to update the backup settings using the file
containing your updated backup settings:
Where:
filename is used to specify the name of the file that contains the updated backup settings
5-161
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
dbname is the database name for the database that you are acting on
6. You can use the bkup_api configure_status command to check the status of the
configuration update:
/var/opt/oracle/bkup_api/bkup_api configure_status
exit
Note:
any changes you make by using the bkup_api command are not
reflected in the Oracle Database Exadata Cloud@Customer console.
Related Topics
• Disabling Automatic Backups to Facilitate Manual Backup and Recovery
Management
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
## OS Configuration Files
#
# Doc Spec
oscfg.spec
5-162
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
#
# Directories
/etc/rc.d
/home/oracle/bkup
#
# Single files
/home/oracle/.bashrc
/etc/crontab
/etc/sysctl.conf
/etc/passwd
/etc/group
/etc/oraInst.loc
/etc/oratab
/etc/fstab
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
5-163
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
/u02/app/oracle/admin/dbname/xdb_wallet
/u02/app/oracle/admin/dbname/db_wallet
# Note: tde_wallet must be backed up in a different location than
DATA bkup.
/u02/app/oracle/admin/dbname/tde_wallet
/u02/app/oracle/admin/dbname/cat_wallet
#/u01/app/oraInventory
#
# Single files
/var/opt/oracle/dbaas_acfs/dbname/opc/opcdbname.ora
/u02/app/oracle/product/dbversion/dbhome_n/dbs/opcdbname.ora
/u02/app/oracle/product/dbversion/dbhome_n/dbs/orapwinstancename
/u02/app/oracle/product/dbversion/dbhome_n/network/admin/
listener.ora
/u02/app/oracle/product/dbversion/dbhome_n/network/admin/sqlnet.ora
/u02/app/oracle/product/dbversion/dbhome_n/network/admin/
tnsnames.ora
/u02/app/oracle/product/dbversion/dbhome_n/rdbms/lib/env_rdbms.mk
/u02/app/oracle/product/dbversion/dbhome_n/rdbms/lib/ins_rdbms.mk
#
# Creg
/var/opt/oracle/creg/instancename.ini
#
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Note:
bkup_api will be deprecated in a future release. Use the dbaascli database
backup, dbaascli pdb backup, dbaascli database recover, and dbaascli
pdb recover commands to backup and recover container databases and
pluggable databases. For more information, see User Configured Backups
and Recovery.
Note:
Using this method for a manual backup is safe to use in conjunction with
automatic backups managed through the Console. Manual backups done
this way will appear in the console after some time due to synchronization.
5-164
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
# sudo -s
#
where dbname is the database name for the database that you want to back up.
• To create an on-demand backup of a specific PDB, use the following bkup_api
command:
• To create a long-term backup of the complete database that persists until you delete
it, use the following bkup_api command:
You can use this option to manually perform an RMAN level 0 (full) backup if the
scheduled weekly level 0 backup fails or following a major structural change in the
database, such as adding a new data file or tablespace. This option is only valid for
backup configurations that use cloud storage only.
• To create an on-demand backup that includes an image copy of the database data
files, use the following bkup_api command:
5-165
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
You can use this option to manually perform a full image backup to cloud
storage if the scheduled weekly full backup fails or following a major structural
change in the database, such as adding a new data file or tablespace. This
option is only valid for backup configurations that use cloud storage and local
Exadata storage.
4. After you start an on-demand backup, the backup process runs in the background.
To check the progress of the backup process, run the following bkup_api
command on the same compute node where the backup is running:
5. Exit the root-user command shell and disconnect from the compute node:
# exit
# exit
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Note:
If you execute these steps, then the automation will no longer purge/backup
the archive logs in the FRA for the database.
5-166
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
sudo -s
3. Use the bkup_api get config command to generate a file containing the current backup
settings for the database deployment:
Where:
• filename is an optional parameter used to specify a name for the file that is
generated
• dbname is the database name for the database that you want to act on
4. Edit the parameter values in the generated file to change the following parameters.
This will remove the backup crontab entries and disable all automatic backups. If the
values are set to yes, then set to no.
bkup_cron_entry=no
bkup_archlog_cron_entry=no
bkup_nfs=no
bkup_oss=no
bkup_local=no
5. Use the bkup_api set config command to update the backup settings using the file
containing your updated backup settings:
Where:
• filename is an optional parameter used to specify a name for the file that is
generated
• dbname is the database name for the database that you want to act on
The job to set the configuration will take several minutes to complete.
6. You can use the bkup_api configure_status command to check the status of the
configuration update:
Where:
• dbname is the database name for the database that you want to act on
The Configure backup status starts as running and then moves to finished when
complete.
5-167
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
7. Run the bkup_api get config command again and verify the settings listed above
are set to no.
Where:
• filename is an optional parameter used to specify a name for the file that is
generated
• dbname is the database name for the database that you want to act on
Note:
After making these changes, no backups, including archive log backups,
are made by the cloud automation. Ensure that manual RMAN backups
are in place to avoid filling the archive log location.
Note:
Changes made using the bkup_api command are not reflected in the
Oracle Exadata Database Service on Cloud@Customer console.
exit
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• Oracle Database Backup and Recovery User's Guide for Release 19
5-168
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Note:
• Enabling or disabling RTRT works only for Oracle Database version 12.2 and
higher.
• If you have enabled Data Guard association between databases, then after
enabling RTRT on the Primary database, you must manually copy the
password file from the Primary to the Standby database. To learn more about
copying the password file from the primary to the standby database, refer to
12c: Data Guard Physical Standby - Managing password files in a RAC
Physical Standby (Doc ID 1984091.1).
Related Topics
• dbaascli database backup
To configure Oracle Database with a backup storage destination, take database backups,
query backups, and delete a backup, use the dbaascli database backup command.
• 12c: Data Guard Physical Standby - Managing password files in a RAC Physical Standby
(Doc ID 1984091.1)
• About Real-Time Redo Transport
Note:
bkup_api will be deprecated in a future release. Use the dbaascli database
backup, dbaascli pdb backup, dbaascli database recover, and dbaascli pdb
recover commands to backup and recover container databases and pluggable
databases. For more information, see User Configured Backup.
RMAN is the backup tool included with the Oracle Database. For information about using
RMAN, see the Oracle Database Backup and Recovery User's Guide for Release 19. Using
RMAN to back up databases on Exadata Database Service on Cloud@Customer provides
the most flexibility in terms of backup options, but also the most complexity.
5-169
Chapter 5
Manage Database Backup and Recovery on Oracle Exadata Database Service on Cloud@Customer
Note:
While using RMAN for restoring databases backed up through any method
described herein is considered safe, RMAN should NEVER be used to set up
backups in conjunction with either console (and OCI API / CLI), nor in
conjunction with bkup_api. If you choose to orchestrate backups manually
leveraging RMAN, you should not use either console automated backups,
nor should you use bkup_api. You must first completely disable console
based automated backups. For more information, see Disabling Automatic
Backups to Facilitate Manual Backup and Recovery Management.
The bkup_api method offers a middle ground between RMAN and console automated
backups in terms of flexibility and simplicity. Use bkup_api if needed functionality is not
supported with console automated backups, but when you wish to avoid complexity of
using RMAN directly. In certain cases, bkup_api can be used to modify the console
automated backup configuration, but this is not generally the case. Generally,
bkup_api must be used instead of enabling backups in the console.
Note:
While recovering using RMAN is safe, you must not use RMAN to initiate
backups or edit backup setting in conjunction with either backup_api usage
or in conjunction with automated console backups. Doing so could result in
conflicting conditions or over-writes of settings, and backups may not
execute successfully.
Related Topics
• Oracle Database Backup and Recovery User's Guide for Release 19
5-170
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
5-171
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
For more information and examples for applying database quarterly patches on
Exadata Cloud@Customer refer to My Oracle Support note: How to Apply Database
Quarterly Patch on Exadata Cloud Service and Exadata Cloud at Customer Gen 2
(Doc ID 2701789.1).
For more guidance on achieving continuous service during patching operations, see
the Application Checklist for Continuous Service for MAA Solutions white paper.
• Patching and Updating VM Clusters and Database Homes
Learn how to perform patching operations on VM Cluster Grid Infrastructure (GI)
and Database Homes using the Console or API
• Updating Guest VM Operating System
Learn to update the operating system image on Exadata Cloud@Customer VM
cluster nodes in an automated manner from the OCI console and APIs.
• Upgrading Oracle Grid Infrastructure on an Exadata Cloud@Customer VM Cluster
Learn to upgrade Oracle Grid Infrastructure on an Exadata Cloud@Customer VM
cluster using the Oracle Cloud Infrastructure Console or API.
• Upgrading Oracle Databases
Learn to upgrade Oracle Database 19c (Long Term Release) using the Console
and the API.
Related Topics
• Patching and Updating an Exadata Database Service on Cloud@Customer
System Manually
• https://support.oracle.com/epmos/faces/DocContentDisplay?id=2701789.1
• Application Checklist for Continuous Service for MAA Solutions
5-172
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
patching updates the Oracle Database software shared by the databases in that home.
For more information on available patches, see My Oracle Support note https://
support.oracle.com/epmos/faces/DocContentDisplay?id=2333222.1.
Consider the following best practices:
• Because patching a system requires a reboot, plan to run the operations at a time when
they will have minimal impact on users.
• Oracle recommends that you back up your databases before you apply any patches. For
information about backing up the databases, see Managing Database Backup and
Recovery on Exadata Database Service on Cloud@Customer.
• Your Oracle Grid Infrastructure must be at the same or higher version than the database
version you want to patch to. This may require you to first patch a VM cluster before you
patch the Databases Homes within that system.
• To patch a database to a version other than the database version of the current home,
move the database to a Database Home running the target version. See Using the
Console to Move a Database to Another Home.
Related Topics
• Manage Database Backup and Recovery on Oracle Exadata Database Service on
Cloud@Customer
Learn how to work with the backup and recovery facilities provided by Oracle Exadata
Database Service on Cloud@Customer.
• Using the Console to Move a Database to Another Home
You can update the version of a VM cluster database by moving it to a Database Home
that is running the version of Oracle Database you are interested in.
Using the Console for Patching and Updating VM Cluster's GI and Database Homes
Learn how to use the console to view the history of patch operations on VM cluster and
Database Homes, apply patches, and monitor the status of patch operations.
Oracle recommends that you use the precheck action to ensure your VM cluster or Database
Home has met the requirements for the patch you want to apply.
• Using the Console to Perform a Grid Infrastructure Patch Operation on a VM Cluster
Learn to apply Grid Infrastructure patches on a VM cluster.
• Using the Console to Perform a Patch Operation on a Database Home
Learn to apply patches on a Database Home.
5-173
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
5-174
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
VM Clusters is selected by default.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of VM clusters, click the VM cluster where the Database Home is located.
4. Under Resources, click Database Homes.
5. In the list of Database Homes, click the Database Home on which you want to perform a
patch operation.
6. Under Database Software Version, click View Patches.
7. Review the scope:
• Database Home: Automatically set to the context from which you have launched this
page.
8. Review the list of available patches for the Database Home.
The Oracle Provided Database Software Images tab displays generally-available
Oracle Database software images that you can use to patch your database. Oracle
images that can be used for patching have the update Type of "Patch".
The Custom Database Software Images tab allows you to select a database software
image that you have created in advance. Use the Select a Compartment selector to
specify the compartment that contains the database software image.
9. Click the Actions icon (three dots) for the patch you are interested in, and then click one
of the following actions:
• Precheck: Check for any prerequisites to make sure that the patch can be
successfully applied. Oracle highly recommends that you run this operation before
you apply a patch. The Precheck does not cause any availability impact to the
cluster, everything remains operational.
• Apply: Applies the selected patch.
10. Confirm when prompted.
The patch list displays the status of the operation. While the precheck is running, the patch's
status shows Checking. While a patch is being applied, the patch's status shows Applying,
the status of the Database Home and the databases in it display as Updating, and lifecycle
operations on the VM cluster and its resources are temporarily unavailable. Patches are
applied to the Database Home in a rolling fashion, node by node, and each database in the
home is stopped and then restarted. This may result in temporary service disruption. If
patching completes successfully, the patch's status changes to Applied and the Database
Home's status changes to Available. You can view more details about an individual patch
operation by clicking Update History.
5-175
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
5-176
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
The database is moved in a rolling fashion. The database instance will be stopped, node by
node, in the current home and then restarted in the destination home. While the database is
being moved, the Database Home and Database statuses display as Updating. The
Database Home location, shown under Database Version, displays as Moving Database.
When the operation completes, Database Home is updated with the current home. Datapatch
is executed automatically, as part of the database move, to complete post-patch SQL actions
for all patches, including one-offs, on the new Database Home. If the database move
operation is unsuccessful, then the status of the database displays as Failed, and the
Database Home field provides information about the reason for the failure.
Using the API for Patching and Updating VM Cluster and Database Homes
Use various API features to help manage patching an Oracle Exadata Database Service on
Cloud@Customer system.
For information about using the API and signing requests, see "REST APIs" and "Security
Credentials". For information about SDKs, see "Software Development Kits and Command
Line Interface".
Use these API operations to manage patching VM clusters, Database Homes and
Databases.
VM cluster:
• UpdateVmCluster
Database Homes:
• CreateDbHome
• UpdateDbHome
• DeleteDbHome
Database:
• CreateDatabase
• UpdateDatabase
• DeleteDatabase
5-177
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
Use UpdateVMCluster to patch the Oracle Grid Infrastructure on the VM Cluster. Use
UpdateDbHome to patch the Database Software of the Database Home. Use
UpdateDatabase to move a database to a different Database Home, thereby updating
the database to the same version as the target Database Home.
For the complete list of APIs for the Database service, see "Database Service API".
Related Topics
• REST APIs
• Security Credentials
• Software Development Kits and Command Line Interface
• UpdateVmCluster
• CreateDbHome
• UpdateDbHome
• DeleteDbHome
• CreateDatabase
• UpdateDatabase
• DeleteDatabase
• Database Service API
5-178
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
Note:
If the precheck fails, the system displays a message in the Apply Exadata
OS Image Update dialog that the last precheck has failed. Oracle
recommends that you run the precheck again. Click the Actions icon (three
dots)at the end of the row listing the OS patch to view the dialog.
• Apply Exadata OS Image Update. This link displays the Apply Exadata Image
Update dialog that you use to apply the patch. The dialog shows the name of the
database system you are patching, the current version of the database, and the new
5-179
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
version of the database after the patch is applied. To start the process, click
Apply Exadata OS Image Update.
• Copy OCID. This copies the Oracle Cloud ID. This can be used when
troubleshooting a patch or to give to Support when contacting them.
Note:
While the patch is running:
– Run Precheck and Apply OS Image Update are not available.
When the patch has completed, these actions are available
again.
– If the Exadata infrastructure containing this VM cluster is
scheduled for maintenance that conflicts with the patching
operation, the patch fails and the system displays a message
explaining why. After the infrastructure maintenance is complete,
run the patch operation again.
Using the Console to Rollback or Retry Failed Guest VM Operating System Update
To update the guest VM operating system with the Console, be prepared to provide
values for the fields required.
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of cloud VM clusters, click the name of the cluster you want to patch to
display the cluster details.
If applying update has failed, then on the VM Cluster Details page, a banner with
the options Roll Back and Retry Apply is displayed.
Choose an appropriate option.
a. Click Retry Apply.
Apply Exadata OS Image Update dialog is displayed with the options Apply
Exadata Image Update and Run Precheck.
Choose an appropriate option.
(or)
b. Click Roll Back.
Confirm Rollback Operation dialog is displayed.
5-180
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
5-181
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of cloud VM clusters, click the name of the cluster you want to patch to
display the cluster details.
4. Under Version, click the View Updates link beside the Updates Available field.
5-182
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
5. Click View Updates to view the list of available patches and upgrades.
6. Click the Actions icon (three dots) at the end of the row listing the Oracle Grid
Infrastructure (GI) upgrade, then click Run Precheck.
7. In the Confirm dialog, confirm you want to upgrade to begin the precheck operation.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of cloud VM clusters, click the name of the cluster you want to patch to display
the cluster details.
4. Under Version, click the View Updates link beside the Updates Available field.
5. Click View Updates to view the list of available patches and upgrades.
6. Click the Actions icon (three dots) at the end of the row listing the Oracle Grid
Infrastructure (GI) upgrade, then click Upgrade Grid Infrastructure.
7. In the Upgrade Grid Infrastructure dialog, confirm you want to upgrade the GI by clicking
Upgrade Grid Infrastructure.
If you haven't run a precheck, you have the option of clicking Run Precheck in this dialog
to precheck your cloud VM cluster prior to the upgrade.
5-183
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
• GetVmClusterUpdate
• ListVmClusterUpdateHistoryEntries
• GetVmClusterUpdateHistoryEntry
• UpdateVmCluster
• Database Service API
5-184
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
• The Oracle Grid Infrastructure must be version 19c. If patches are available for your Grid
Infrastructure, Oracle recommends applying them prior to performing a database
upgrade.
• You must have an available Oracle Database Home that uses the two most recent
versions of Oracle Database 19c available in Oracle Cloud Infrastructure. See Using the
Console to Create Oracle Database Home on Exadata Cloud@Customer for information
on creating a Database Home. You can use Oracle-published software images or a
custom database software image based on your patching requirements to create
Database Homes.
• You must ensure that all pluggable databases in the container database that is being
upgraded can be opened. Pluggable databases that cannot be opened by the system
during the upgrade can cause an upgrade failure.
Your Oracle database must be configured with the following settings in order to upgrade:
• The database must be in archive log mode.
• The database must have flashback enabled.
See the Oracle Database documentation for your database's release version to learn more
about these settings.
Related Topics
• How to update the Exadata System Software (DomU) to 19 from 18 on the Exadata
Cloud Service in OCI (Doc ID 2521053.1)
• Using the Console to Create Oracle Database Home on Exadata Database Service on
Cloud@Customer
To create an Oracle Database home in an existing VM cluster with the Console, be
prepared to provide values for the fields required.
• Manage Oracle Database Software Images
Learn about Database Software Image resource type and how you can use it to create
Oracle Databases and Oracle Database Homes and to patch databases.
• Oracle Database Documentation
5-185
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
5-186
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
• Check that automatic backups are enabled for the database if you disabled them prior to
upgrading. See Customizing the Automatic Backup Configuration for more information.
• Edit the Oracle Database
COMPATIBLE
parameter to reflect the new Oracle Database software version. See What Is Oracle
Database Compatibility? for more information.
• If your database uses a database_name.env file, ensure that the variables in the file
have been updated to point to the 19c Database Home. These variables should be
automatically updated during the upgrade process.
• If you are upgrading a non-container database to Oracle Database version 19c, you can
convert the database to a pluggable database after converting. See How to Convert Non-
CDB to PDB (Doc ID 2288024.1) for instructions on converting your database to a
pluggable database.
• If your old Database Home is empty and will not be reused, you can remove it. See Using
the Console to Delete an Oracle Database Home for more information.
Related Topics
• Configuring and Customizing Backups with bkup_api
In addition to the console-based automated backup option, there is a command line
backup utility, bkup_api, which can allow for further customization. If configuring backups
using bkup_api instead of the console, then do not enable backups for your database in
the console.
• What Is Oracle Database Compatibility?
• How to Convert Non-CDB to PDB - Step by Step Example (Doc ID 2288024.1)
• Using the Console to Delete an Oracle Database Home
To delete an Oracle Database home with the Console, use this procedure.
Using the Console to Run Oracle Database Upgrade Precheck or Perform Upgrade
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of VM clusters, click the name of the VM cluster that contains the database you
want to upgrade.
5-187
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
4. In the list of databases on the VM Cluster Details page, click the name of the
database you want to upgrade to view the Database Details page.
5. Click Upgrade.
6. In the Upgrade Database dialog, select the following:
• Oracle Database version: The drop-down selector lists only Oracle Database
versions that are compatible with an upgrade from the current software version
the database is using. The target software version must be higher than the
database's current version.
• Target Database Home: Select a Database Home for your database. The list
of Database Homes is limited to those homes using the most recent versions
of Oracle Database 19c software. Moving the database to the new Database
Home results in the database being upgraded to the major release version and
patching level of the new Database Home.
7. Click one of the following:
• Run Precheck: This option starts an upgrade precheck to identify any issues
with your database that need mitigation before you perform an upgrade.
• Upgrade Database: This option starts upgrade operation. Oracle
recommends performing an upgrade only after you have performed a
successful precheck on the database.
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of VM clusters, click the name of the VM cluster that contains the
database with the failed upgrade.
4. Find the database that was unsuccessfully upgraded, and click its name to display
details about it.
5. The database must display a banner at the top of the details page that includes a
Rollback button and details about what issues caused the upgrade failure.
6. Click Rollback.
7. In the Confirm rollback dialog, confirm that you want to initiate a rollback to the
previous Oracle Database version.
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of VM clusters, click the name of the VM cluster that contains the
database you want to upgrade
5-188
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
4. In the list of databases on the VM Cluster Details page, click the name of the database
for which you want to view the upgrade history.
5. On the Database Details page, under Database Version, click the View link that is
displayed for databases that have been upgraded.
This link does not appear for databases that have not been updated.
The Updates History page is displayed. The table displayed on this page shows
precheck and upgrade operations performed on the database.
Note:
For more guidance on achieving continuous service during patching operations, see
the Application Checklist for Continuous Service for MAA Solutions white paper.
5-189
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
5-190
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
Updating the Operating System on All Virtual Machines of an Oracle Exadata Database Service
on Cloud@Customer System
To update the operating system on the Database Server Virtual Machines (VMs), use the
patchmgr tool.
Note:
Customers who do not have My Oracle Support patch download privilege may
obtain the Exadata patchmgr update utility and recent Exadata System Software
releases using the Exadata Cloud@Customer Gen 2 utility
exadata_updates.sh. For more information, see My Oracle Support Doc
2730739.1.
The patchmgr utility manages the entire update of one or more virtual machines remotely,
including the pre-restart, restart, and post-restart steps of an Oracle Exadata Database
Service on Cloud@Customer system.
You can run the utility either from one of your Oracle Exadata Database Service on
Cloud@Customer virtual machines, or from another server running Oracle Linux. The server
on which you run the utility is known as the driving system. You cannot use the driving
system to update itself. Therefore, if the driving system is one of the virtual machines in a VM
5-191
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
cluster that you are updating, then you must run the patchmgr utility more than once.
The following scenarios describe typical ways of performing the updates:
• Non-Exadata Driving System
The simplest way to run the update the system is to use a separate Oracle Linux
server to update all virtual machines in one operation.
• Exadata Virtual Machine Driving System
You can use one virtual machine to drive the updates for the rest of the virtual
machines in the VM cluster. Then, you can use one of the updated nodes to drive
the update on the original driving system. For example, consider updating a half
rack system with four virtual machines; node1, node2, node3, and node4. You could
first use node1 to drive the updates of node2, node3, and node4. Then, you could
use node2 to drive the update of node1.
The driving system requires root user SSH access to each virtual machine being
updated.
The following procedure is based on an example that assumes the following:
• The system has two virtual machines, node1 and node2.
• The target Exadata software version is 18.1.4.0.0.180125.3.
• Each node is used as the driving system to update the other node.
1. Gather the environment details.
a. Using SSH, connect to node1 as the opc user.
For detailed instructions, see Connecting to a Compute Node with SSH.
b. Start a root user command shell.
sudo su -
imageinfo -ver
For example:
d. Switch to the grid user, and identify all nodes in the cluster.
su - grid
olsnodes
For example:
olsnodes
node1
node2
5-192
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
ls /root/.ssh/id_rsa*
ls: cannot access /root/.ssh/id_rsa*: No such file or directory
ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
93:47:b0:83:75:f2:3e:e6:23:b3:0a:06:ed:00:20:a5 [email protected]
The key's randomart image is:
+--[ RSA 2048]----+
|o.. + . |
|o. o * |
|E . o o |
| . . = |
| o . S = |
| + = . |
| + o o |
| . . + . |
| ... |
+-----------------+
b. Distribute the public key to the target nodes, and verify this step. In the example, the
only target node is node2.
ls -al /tmp/id_rsa.node1.pub
-rw-r--r-- 1 opc opc 442 Feb 28 03:33 /tmp/id_rsa.node1.pub
date
Wed Feb 28 03:33:45 UTC 2018
c. On the target node (node2 in the example), add the root public key of node1 to the
root authorized_keys file.
d. Download patchmgr into /root/patch on the driving system (node1 in this example).
You can download the patchmgr bundle from Oracle Support by using My Oracle
Support Patch ID 21634633. Always obtain the latest available Exadata patchmgr
update utility to install any Exadata System Software release.
5-193
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
cd /root/patch/18.1.4.0.0.180125.3
unzip dbserver.patch.zip
Archive: p21634633_181400_Linux-x86-64.zip creating:
dbserver_patch_5.180228.2/
creating: dbserver_patch_5.180228.2/ibdiagtools/
inflating: dbserver_patch_5.180228.2/ibdiagtools/cable_check.pl
inflating: dbserver_patch_5.180228.2/ibdiagtools/setup-ssh
inflating: dbserver_patch_5.180228.2/ibdiagtools/VERSION_FILE
extracting: dbserver_patch_5.180228.2/ibdiagtools/xmonib.sh
inflating: dbserver_patch_5.180228.2/ibdiagtools/monitord
inflating: dbserver_patch_5.180228.2/ibdiagtools/checkbadlinks.pl
creating: dbserver_patch_5.180228.2/ibdiagtools/topologies/
inflating: dbserver_patch_5.180228.2/ibdiagtools/topologies/
VerifyTopologyUtility.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/topologies/
verifylib.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/topologies/
Node.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/topologies/
Rack.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/topologies/
Group.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/topologies/
Switch.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/topology-zfs
inflating: dbserver_patch_5.180228.2/ibdiagtools/dcli
creating: dbserver_patch_5.180228.2/ibdiagtools/netcheck/
inflating: dbserver_patch_5.180228.2/ibdiagtools/netcheck/
remoteScriptGenerator.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/netcheck/
CommonUtils.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/netcheck/
SolarisAdapter.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/netcheck/
LinuxAdapter.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/netcheck/
remoteLauncher.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/netcheck/
remoteConfig.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/netcheck/
spawnProc.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/netcheck/
runDiagnostics.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/netcheck/
OSAdapter.pm
inflating: dbserver_patch_5.180228.2/ibdiagtools/
SampleOutputs.txt
5-194
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
inflating: dbserver_patch_5.180228.2/ibdiagtools/infinicheck
inflating: dbserver_patch_5.180228.2/ibdiagtools/ibping_test
inflating: dbserver_patch_5.180228.2/ibdiagtools/tar_ibdiagtools
inflating: dbserver_patch_5.180228.2/ibdiagtools/verify-topology
inflating: dbserver_patch_5.180228.2/installfw_exadata_ssh
creating: dbserver_patch_5.180228.2/linux.db.rpms/
inflating: dbserver_patch_5.180228.2/md5sum_files.lst
inflating: dbserver_patch_5.180228.2/patchmgr
inflating: dbserver_patch_5.180228.2/xcp
inflating: dbserver_patch_5.180228.2/ExadataSendNotification.pm
inflating: dbserver_patch_5.180228.2/ExadataImageNotification.pl
inflating: dbserver_patch_5.180228.2/kernelupgrade_oldbios.sh
inflating: dbserver_patch_5.180228.2/cellboot_usb_pci_path
inflating: dbserver_patch_5.180228.2/exadata.img.env
inflating: dbserver_patch_5.180228.2/README.txt
inflating: dbserver_patch_5.180228.2/exadataLogger.pm
inflating: dbserver_patch_5.180228.2/patch_bug_26678971
inflating: dbserver_patch_5.180228.2/dcli
inflating: dbserver_patch_5.180228.2/patchReport.py
extracting: dbserver_patch_5.180228.2/dbnodeupdate.zip
creating: dbserver_patch_5.180228.2/plugins/
inflating: dbserver_patch_5.180228.2/plugins/010-check_17854520.sh
inflating: dbserver_patch_5.180228.2/plugins/020-check_22468216.sh
inflating: dbserver_patch_5.180228.2/plugins/040-check_22896791.sh
inflating: dbserver_patch_5.180228.2/plugins/000-check_dummy_bash
inflating: dbserver_patch_5.180228.2/plugins/050-check_22651315.sh
inflating: dbserver_patch_5.180228.2/plugins/005-check_22909764.sh
inflating: dbserver_patch_5.180228.2/plugins/000-check_dummy_perl
inflating: dbserver_patch_5.180228.2/plugins/030-check_24625612.sh
inflating: dbserver_patch_5.180228.2/patchmgr_functions
inflating: dbserver_patch_5.180228.2/exadata.img.hw
inflating: dbserver_patch_5.180228.2/libxcp.so.1
inflating: dbserver_patch_5.180228.2/imageLogger
inflating: dbserver_patch_5.180228.2/ExaXMLNode.pm
inflating: dbserver_patch_5.180228.2/fwverify
f. In the directory that contains the patchmgr utility, create the dbs_group file, which
contains the list of virtual machines to update. Include the nodes listed after running
the olsnodes command in step 1, except for the driving system. In this example,
dbs_group only contains node2.
cd /root/patch/18.1.4.0.0.180125.3/dbserver_patch_5.180228
cat dbs_group
node2
5-195
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
Note:
Run the precheck operation with the -nomodify_at_prereq option to
prevent any changes to the system that could impact the backup you
take in the next step. Otherwise, the backup might not be able to roll the
system back to its original state, should it be necessary.
********************************************************************
****************************************
NOTE patchmgr release: 5.180228 (always check MOS 1553103.1 for
the latest release of dbserver.patch.zip)
NOTE
WARNING Do not interrupt the patchmgr session.
WARNING Do not resize the screen. It may disturb the screen layout.
WARNING Do not reboot database nodes during update or rollback.
WARNING Do not open logfiles in write mode and do not try to alter
them.
********************************************************************
****************************************
2018-02-28 21:22:45 +0000 :Working: DO: Initiate precheck on
1 node(s)
2018-02-28 21:24:57 +0000 :Working: DO: Check free space and
verify SSH equivalence for the root user to node2
2018-02-28 21:26:15 +0000 :SUCCESS: DONE: Check free space
and verify SSH equivalence for the root user to node2
2018-02-28 21:26:47 +0000 :Working: DO: dbnodeupdate.sh
running a precheck on node(s).
2018-02-28 21:28:23 +0000 :SUCCESS: DONE: Initiate precheck
on node(s).
Note:
Ensure that you take the backup at this point, before any modifications
are made to the system.
5-196
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
**************************************************************************
**********************************
NOTE patchmgr release: 5.180228 (always check MOS 1553103.1 for the
latest release of dbserver.patch.zip)
NOTE
WARNING Do not interrupt the patchmgr session.
WARNING Do not resize the screen. It may disturb the screen layout.
WARNING Do not reboot database nodes during update or rollback.
WARNING Do not open logfiles in write mode and do not try to alter them.
**************************************************************************
**********************************
2018-02-28 21:29:00 +0000 :Working: DO: Initiate backup on 1
node(s).
2018-02-28 21:29:00 +0000 :Working: DO: Initiate backup on node(s)
2018-02-28 21:29:01 +0000 :Working: DO: Check free space and
verify SSH equivalence for the root user to node2
2018-02-28 21:30:18 +0000 :SUCCESS: DONE: Check free space and
verify SSH equivalence for the root user to node2
2018-02-28 21:30:51 +0000 :Working: DO: dbnodeupdate.sh running a
backup on node(s).
2018-02-28 21:35:50 +0000 :SUCCESS: DONE: Initiate backup on
node(s).
2018-02-28 21:35:50 +0000 :SUCCESS: DONE: Initiate backup on 1
node(s).
5. Remove all custom RPMs from the target virtual machines. Custom RPMs are reported in
precheck results. They include RPMs that were manually installed after the system was
provisioned.
• If you are updating the system from version 12.1.2.3.4.170111, and the precheck
results include krb5-workstation-1.10.3-57.el6.x86_64, then remove it. This item
is considered a custom RPM for this version.
• Do not remove exadata-sun-vm-computenode-exact or oracle-ofed-release-
guest. These two RPMs are handled automatically during the update process.
6. Perform the update. To ensure that the update process in not interrupted, use the
command nohup. For example:
**************************************************************************
**********************************
5-197
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
7. After the update operation completes, verify the version of the Exadata software
on the virtual machine that was updated.
imageinfo -ver
18.1.4.0.0.180125.3
5-198
Chapter 5
Patch and Update an Exadata Database Service on Cloud@Customer System
8. Repeat steps 2 through 7 of this procedure using the updated virtual machine as the
driving system to update the remaining virtual machine. In this example update, you
would now use node2 to update node1.
9. As root On each virtual machine, run the uptrack-install command to install the
available ksplice updates.
uptrack-install --all -y
uptrack-install --all -y
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• https://support.oracle.com/epmos/faces/DocumentDisplay?
cmd=show&type=NOT&id=2730739.1
• https://support.oracle.com/epmos/faces/DocumentDisplay?
cmd=show&type=NOT&id=1553103.1
• https://support.oracle.com/epmos/faces/ui/patch/PatchDetail.jspx?patchId=21634633
5-199
Chapter 5
Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
5-200
Chapter 5
Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
Related Topics
• Data Guard Concepts and Administration
• Oracle Document Portal
Prerequisites for Using Oracle Data Guard with Exadata Database Service
on Cloud@Customer
Review the list of prerequisites for using Data Guard with Exadata Database Service on
Cloud@Customer.
• Compute Nodes
A VM cluster Data Guard implementation requires two Exadata database compute
nodes, one containing the primary database and one containing the standby database.
• Password
For Data Guard operations to work, the SYS password and the TDE wallet password of
the primary and standby databases must all be the same.
Compute Nodes
A VM cluster Data Guard implementation requires two Exadata database compute nodes,
one containing the primary database and one containing the standby database.
When you enable Data Guard for an Exadata database compute node database, the Exadata
database compute node with the database to be used as the standby must already exist
before you enable Data Guard.
Password
For Data Guard operations to work, the SYS password and the TDE wallet password of the
primary and standby databases must all be the same.
If you change any one of these passwords, you must update the rest of the passwords to
match.
If you make any change to the TDE wallet (such as adding a master key for a new PDB or
changing the wallet password), you must copy the wallet from the primary to the standby so
that Data Guard can continue to operate. For Oracle Database versions earlier than 12.2, if
you change the SYS password on one of the peers, you need to manually sync the password
file between the DB systems.
5-201
Chapter 5
Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
• Switchover
A switchover reverses the primary and standby database roles.
• Failover
A failover transitions the standby database into the primary role after the existing
primary database fails or becomes unreachable.
• Reinstate
Reinstates a database into the standby role in a Data Guard association.
Switchover
A switchover reverses the primary and standby database roles.
Each database continues to participate in the Data Guard association in its new role. A
switchover ensures no data loss. You can use a switchover before you perform
planned maintenance on the primary database. Performing planned maintenance on a
Exadata database compute node with a Data Guard association is typically done by
switching the primary to the standby role, performing maintenance on the standby, and
then switching it back to the primary role.
Failover
A failover transitions the standby database into the primary role after the existing
primary database fails or becomes unreachable.
A failover might result in some data loss when you use Maximum Performance
protection mode.
Reinstate
Reinstates a database into the standby role in a Data Guard association.
You can use the reinstate command to return a failed database into service after
correcting the cause of failure.
Note:
You can't terminate a primary database that has a Data Guard association
with a peer (standby) database. Delete the standby database first.
Alternatively, you can switch over the primary database to the standby role,
and then terminate the former primary.
You can't terminate a VM cluster that includes Data Guard enabled
databases. You must first remove the Data Guard association by terminating
the standby database.
5-202
Chapter 5
Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
When you enable Data Guard, a separate Data Guard association is created for the primary
and the standby database.
• Using the Console to Enable Data Guard on an Exadata Database Service on
Cloud@Customer System
Learn to enable Data Guard association between databases.
• Using the Console To View and Edit Data Guard Associations
You can switch between Data Guard types based on the Oracle Database software
license type you have deployed.
• Using the Console To Perform a Database Switchover
You initiate a switchover operation by using the Data Guard association of the primary
database.
• Using the Console To Perform a Database Failover
You initiate a failover operation by using the Data Guard association of the standby
database.
• Using the Console To Reinstate a Database
After you fail over a primary database to its standby, the standby assumes the primary
role and the old primary is identified as a disabled standby.
• Using the Console To Terminate a Data Guard Association on an Exadata Database
Service on Cloud@Customer System
On a VM cluster, you remove a Data Guard association by terminating the standby
database.
Note:
When you enable Data Guard, replication of data happens only over the client
network.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
VM Clusters is selected by default.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of VM clusters, click the VM cluster that contains the database for which you
want to assume the primary role, and then click the name of that database.
4. Under Resources, click Data Guard Associations.
5. Click Enable Data Guard.
6. On the Enable Data Guard page, configure your Data Guard association.
• Data Guard association details:
– Select a Data Guard type, Active Data Guard or Data Guard, based on the
Oracle Database software license type you have deployed. If you have deployed
5-203
Chapter 5
Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
5-204
Chapter 5
Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
is selected by default. And, you will be presented with a list of Database Homes.
Select a Database Home from the list.
Note:
Although only Database homes of the same version and RU are listed,
the homes displayed may have different one-off patches than the
primary. Though acceptable to have different one-offs, best practice is
to have identical database homes between primary and standby.
– Create a new Database Home: If no Database Homes exist for the database
version you have selected, then this option is selected by default.
• Configure standby database:
– Provide a unique name for the database:
Note:
You cannot modify the db_name, db_unique_name, and SID prefix after
creating the database.
Optionally, specify a unique name for the database. This attribute defines the
value of the db_unique_name database parameter. The value is case insensitive.
The db_unique_name must contain only the permitted characters.
Review the following guidelines when selecting a database name:
* maximum of 30 characters
* can contain alphanumeric and underscore (_) characters
* begin with an alphabetic character
* unique across the fleet/tenancy
If a unique name is not entered, then the db_unique_name defaults to the
following format <db_name>_<3 char unique string>_<region-name>.
– Database password: Enter the database admin password of the primary
database in the Database password field. This same database admin password
will be used for the standby database.
The admin password and the TDE password must be the same. If they are not,
follow the instructions in Changing the Database Passwords to align them.
• (Optional) Select Show Advanced Options.
– Provide the Oracle SID prefix: Optionally, specify the Oracle SID prefix for the
database. The instance number is automatically appended to the SID prefix to
become the instance_name database parameter. If not provided, then the SID
prefix defaults to the first 12 characters of the db_unique_name.
Review the following guidelines when selecting a database name:
* maximum of 12 characters
* contain only alphanumeric characters
* begin with an alphabetic character
5-205
Chapter 5
Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
Note:
You cannot edit the Transport type. This field is updated
automatically based on the Protection mode you select.
5-206
Chapter 5
Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
5-207
Chapter 5
Use Oracle Data Guard with Exadata Database Service on Cloud@Customer
Set your ORACLE_UNQNAME environment variable to the value of the Database Unique
Name, and then run these commands:
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
VM Clusters is selected by default.
2. Choose your Compartment.
A list of VM Clusters is displayed for the chosen Compartment.
3. In the list of VM clusters, click the VM cluster that contains the primary database.
4. Click the name of the primary database.
5. Under Resources, click Data Guard Associations.
You will see the database you want to reinstate listed.
6. Click the Actions icon (three dots), and then click Reinstate.
7. In the Reinstate Database dialog box, enter the database admin password, and
then click OK.
This database should now be reinstated as the standby in the Data Guard association.
5-208
Chapter 5
Migrate to Exadata Database Service on Cloud@Customer
5-209
Chapter 5
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata Database Service on
Cloud@Customer Gen2 Infrastructure
Related Topics
• Migrating Databases to the Cloud
5-210
Chapter 5
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata Database Service on Cloud@Customer Gen2
Infrastructure
5-211
Chapter 5
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata Database Service on
Cloud@Customer Gen2 Infrastructure
• Configure network
– Provide network access path from the Exadata Cloud@Customer Gen1
servers and the Gen2 servers to the ZDM servers used for the upgrade.
– Provide network access and SSH access from the ZDM server to the
respective Exadata Cloud@Customer infrastructure.
– For any client access to the target databases, ensure that a network path is
available from the client host to the new Exadata Cloud@Customer Gen2
deployed databases.
• Software
– The upgrade will require minimum versions of the software stack so prior to
the upgrade, install the appropriate version of Oracle Grid Infrastructure on the
target Exadata Cloud@Customer Gen2 infrastructure.
– Oracle Database versions supported on Exadata Cloud@Customer Gen1 will
continue to be supported. On the target Gen2 infrastructure, install appropriate
versions of the Oracle Database software and the one-off patches that exist in
the source database.
– Complete all requirements for ZDM servers in terms of installation,
configuration, network access, and SSH access.
• Security
– Exadata Cloud@Customer Gen2 does not use Oracle Advanced Support
Gateway Security (OASG) so cannot request OASG logs.
5-212
Chapter 5
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata Database Service on Cloud@Customer Gen2
Infrastructure
• Ensure that automatic backup is not configured on the Gen2 target prior to migration.
Related Topics
• Preparing for Exadata Database Service on Cloud@Customer
Review OCI as well as the site, network and storage requirements to prepare and deploy
Exadata Database Service on Cloud@Customer in your data center.
• Prepare a Host for Zero Downtime Migration Software Installation
• Best Practices for Out-of-Place Cloud Upgrade to New Exadata Cloud@Customer Gen2
Infrastructure
For the purpose of the upgrade, the recommended tool to use is Oracle Zero Downtime
Migration (ZDM).
5-213
Chapter 5
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata Database Service on
Cloud@Customer Gen2 Infrastructure
TGT_DB_UNIQUE_NAME=z19tgt1_uniq2
MIGRATION_METHOD=ONLINE_PHYSICAL
DATA_TRANSFER_MEDIUM=DIRECT
PLATFORM_TYPE=EXACC
SRC_HTTP_PROXY_URL=
SRC_HTTP_PROXY_PORT=
SRC_CONFIG_LOCATION=
SRC_BASTION_HOST_IP=
SRC_BASTION_PORT=
SRC_BASTION_USER=
SRC_BASTION_IDENTITY_FILE=
SRC_HOST_IP=
SRC_TIMEZONE=
SRC_OSS_PROXY_HOST=
SRC_OSS_PROXY_PORT=
SRC_SSH_RETRY_TIMEOUT=
SRC_PDB_NAME=
SRC_DB_LISTENER_PORT=
TGT_HTTP_PROXY_URL=
TGT_HTTP_PROXY_PORT=
TGT_CONFIG_LOCATION=
TGT_BASTION_HOST_IP=
TGT_BASTION_PORT=
TGT_BASTION_USER=
TGT_BASTION_IDENTITY_FILE=
TGT_HOST_IP=
TGT_SSH_TUNNEL_PORT=
TGT_SSH_RETRY_TIMEOUT=
5-214
Chapter 5
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata Database Service on Cloud@Customer Gen2
Infrastructure
TGT_OSS_PROXY_HOST=
TGT_OSS_PROXY_PORT=
TGT_DATADG=
TGT_REDODG=
TGT_RECODG=
TGT_DATAACFS=
TGT_REDOACFS=
TGT_RECOACFS=
BACKUP_PATH=
HOST=
OPC_CONTAINER=
SRC_ZDLRA_WALLET_LOC=
TGT_ZDLRA_WALLET_LOC=
ZDLRA_CRED_ALIAS=
NONCDBTOPDB_CONVERSION=FALSE
NONCDBTOPDB_SWITCHOVER=TRUE
SKIP_FALLBACK=TRUE
TGT_RETAIN_DB_UNIQUE_NAME=
TGT_SKIP_DATAPATCH=FALSE
MAX_DATAPATCH_DURATION_MINS=
DATAPATCH_WITH_ONE_INSTANCE_RUNNING=
SHUTDOWN_SRC=
SKIP_SRC_SERVICE_RETENTION=
SRC_RMAN_CHANNELS=6
TGT_RMAN_CHANNELS=16
ZDM_LOG_OSS_PAR_URL=
ZDM_BACKUP_FULL_SRC_MONITORING_INTERVAL=10
ZDM_BACKUP_INCREMENTAL_SRC_MONITORING_INTERVAL=10
ZDM_BACKUP_DIFFERENTIAL_SRC_MONITORING_INTERVAL=10
ZDM_CLONE_TGT_MONITORING_INTERVAL=10
ZDM_OSS_RESTORE_TGT_MONITORING_INTERVAL=10
ZDM_OSS_RECOVER_TGT_MONITORING_INTERVAL=10
ZDM_BACKUP_RETENTION_WINDOW=
ZDM_BACKUP_TAG=
ZDM_USE_EXISTING_BACKUP=
ZDM_OPC_RETRY_WAIT_TIME=
ZDM_OPC_RETRY_COUNT=
ZDM_SRC_TNS_ADMIN=
ZDM_CURL_LOCATION=
ZDM_USE_EXISTING_UNDO_SIZE=
ZDM_SKIP_DG_CONFIG_CLEANUP=
ZDM_RMAN_COMPRESSION_ALGORITHM=LOW
ZDM_SRC_DB_RESTORE_SERVICE_NAME=
ZDM_RMAN_DIRECT_METHOD=ACTIVE_DUPLICATE
5-215
Chapter 5
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata Database Service on
Cloud@Customer Gen2 Infrastructure
TGT_DB_UNIQUE_NAME=z12tgt1s_uniq
MIGRATION_METHOD=ONLINE_PHYSICAL
DATA_TRANSFER_MEDIUM=DIRECT
PLATFORM_TYPE=EXACC
SRC_HTTP_PROXY_URL=
SRC_HTTP_PROXY_PORT=
SRC_CONFIG_LOCATION=
SRC_BASTION_HOST_IP=
SRC_BASTION_PORT=
SRC_BASTION_USER=
SRC_BASTION_IDENTITY_FILE=
SRC_HOST_IP=
SRC_TIMEZONE=
SRC_OSS_PROXY_HOST=
SRC_OSS_PROXY_PORT=
SRC_SSH_RETRY_TIMEOUT=
SRC_PDB_NAME=
SRC_DB_LISTENER_PORT=
TGT_HTTP_PROXY_URL=
TGT_HTTP_PROXY_PORT=
TGT_CONFIG_LOCATION=
TGT_BASTION_HOST_IP=
TGT_BASTION_PORT=
TGT_BASTION_USER=
5-216
Chapter 5
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata Database Service on Cloud@Customer Gen2
Infrastructure
TGT_BASTION_IDENTITY_FILE=
TGT_HOST_IP=
TGT_SSH_TUNNEL_PORT=
TGT_SSH_RETRY_TIMEOUT=
TGT_OSS_PROXY_HOST=
TGT_OSS_PROXY_PORT=
TGT_DATADG=
TGT_REDODG=
TGT_RECODG=
TGT_DATAACFS=
TGT_REDOACFS=
TGT_RECOACFS=
BACKUP_PATH=
HOST=
OPC_CONTAINER=
SRC_ZDLRA_WALLET_LOC=
TGT_ZDLRA_WALLET_LOC=
ZDLRA_CRED_ALIAS=
NONCDBTOPDB_CONVERSION=FALSE
NONCDBTOPDB_SWITCHOVER=TRUE
SKIP_FALLBACK=TRUE
TGT_RETAIN_DB_UNIQUE_NAME=
TGT_SKIP_DATAPATCH=FALSE
MAX_DATAPATCH_DURATION_MINS=
DATAPATCH_WITH_ONE_INSTANCE_RUNNING=
SHUTDOWN_SRC=
SKIP_SRC_SERVICE_RETENTION=
SRC_RMAN_CHANNELS=6
TGT_RMAN_CHANNELS=16
ZDM_LOG_OSS_PAR_URL=
ZDM_BACKUP_FULL_SRC_MONITORING_INTERVAL=10
ZDM_BACKUP_INCREMENTAL_SRC_MONITORING_INTERVAL=10
ZDM_BACKUP_DIFFERENTIAL_SRC_MONITORING_INTERVAL=10
ZDM_CLONE_TGT_MONITORING_INTERVAL=10
ZDM_OSS_RESTORE_TGT_MONITORING_INTERVAL=10
ZDM_OSS_RECOVER_TGT_MONITORING_INTERVAL=10
ZDM_BACKUP_RETENTION_WINDOW=
ZDM_BACKUP_TAG=
ZDM_USE_EXISTING_BACKUP=
ZDM_OPC_RETRY_WAIT_TIME=
ZDM_OPC_RETRY_COUNT=
ZDM_SRC_TNS_ADMIN=
ZDM_CURL_LOCATION=
ZDM_USE_EXISTING_UNDO_SIZE=
ZDM_SKIP_DG_CONFIG_CLEANUP=
ZDM_RMAN_COMPRESSION_ALGORITHM=LOW
ZDM_SRC_DB_RESTORE_SERVICE_NAME=
ZDM_RMAN_DIRECT_METHOD=
Related Topics
• Introduction to Zero Downtime Migration
• Preparing for Database Migration
• Migrating Your Database with Zero Downtime Migration
5-217
Chapter 5
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata Database Service on
Cloud@Customer Gen2 Infrastructure
Note:
The software stack will be upgraded to the latest versions at that point in time
when you perform Out-of-Place Cloud Upgrade to New Gen2 Hardware.
Patching: The infrastructure patching process and notification are different in Gen2.
For more information, see Maintaining an Exadata Cloud@Customer System.
Note:
Post-migration to Exadata Cloud@Customer Gen2, Oracle recommends
using supported backup methods for Exadata Cloud@Customer Gen2. It's
your responsibility to manually manage any backups to the Gen1 Oracle
Cloud At Customer (OCC) Object Storage Service (OSS), and Oracle does
not offer it through the OCI Console, API, or CLI.
5-218
Chapter 5
Overview of Exadata Cloud@Customer Gen1 to Out-of-Place Cloud Upgrade to Exadata Database Service on Cloud@Customer Gen2
Infrastructure
Related Topics
• Perform User Managed Maintenance Updates
• About Oracle Managed Exadata Cloud@Customer Infrastructure Maintenance Updates
Oracle performs patches and updates to all of the Oracle-managed system components
on Exadata Cloud@Customer.
Note:
It is not recommended to use either Gen1 Oracle Cloud At Customer OSS or
OCI Object Storage for this migration.
5-219
6
Autonomous Database on Exadata
Cloud@Customer
6-1
Chapter 6
What’s New in ADB-D on Exadata Cloud@Customer
6-2
Chapter 6
What’s New in ADB-D on Exadata Cloud@Customer
Related Topics
• Create an Autonomous Exadata VM Cluster
6-3
Chapter 6
What’s New in ADB-D on Exadata Cloud@Customer
Identify where the reclaimable OCPUs are located to reclaim them to create new
database resources or for scaling automation when a certain threshold is reached.
You can create multiple AVMCs on an Exadata Infrastructure resource. The OCPUs
that you allocate while provisioning the AVMC resource will be the Total OCPUs
available for its Autonomous Databases. When you create multiple AVMCs, each
AVMC can have its own value for total OCPUs.
At an AVMC or ACD level, the total number of OCPUs available for creating databases
is called Available OCPUs.
This feature enhancement provides better resource usage tracking:
• Reclaimable OCPUs:
When an Autonomous Database is terminated or scaled down, the number of
OCPUs allocated to it is not immediately returned to the available OCPUs at its
parent AVMC level for the overall deployment. They continue to be included in the
count of OCPUs available to its parent container database until that parent
container database is restarted. These OCPUs are called reclaimable OCPUs.
Reclaimable OCPUs at the parent AVMC level are the sum of reclaimable OCPUs
of all its ACDs. When an ACD is restarted, it returns all its reclaimable OCPUs to
the available OCPUs at its parent AVMC level.
• Failure free ADB Provisioning with Provisionable OCPUs:
Based on the resource utilization on each node; not all the values of the available
OCPUs can be used to provision or scale Autonomous Databases. For example,
suppose you have 20 OCPUs available at the AVMC level, not all the values from
1 to 20 OCPUs can be used to provision or scale Autonomous Databases
depending on the resource availability at the node level. The list of OCPU values
that can be used to provision or scale an Autonomous Database is called
Provisionable OCPUs.
On the console, when you try to provision or scale an Autonomous Database, the
OCPU count will be validated against the list of provisionable OCPUs, and if the
value is not provisionable, you will be provided with the two nearest provisionable
OCPU values. Alternatively, if you want to see the complete list of provisionable
OCPU values for an Autonomous Exadata VM Cluster, you can use the following
API:
GetAutonomousContainerDatabase returns a list of provisionable OCPU values
that can be used to create a new Autonomous Database in the given Autonomous
Container Database. See GetAutonomousContainerDatabase for more details.
GetAutonomousDatabase returns a list of provisionable OCPU values that can be
used for scaling a given Autonomous Database. See GetAutonomousDatabase for
more details.
Autonomous VM Clusters
As a Fleet Administrator, you will be able to identify:
• Total OCPUs: The number of CPU cores allocated to the VM Cluster.
• Exadata Storage (TB): The storage allocated to the VM Cluster in TBs.
• Total Autonomous Database Storage (TB): Total Autonomous Database
Storage storage allocated to the Autonomous VM Cluster.
• Available Autonomous Database Storage (TB): Storage available to create
Autonomous Databases in the Autonomous VM Cluster
6-4
Chapter 6
What’s New in ADB-D on Exadata Cloud@Customer
Note:
You cannot create an ACD if 2 OCPUs are not available in the VM Cluster or
Exadata Infrastructure.
Autonomous Database
As a Database Administrator, you will be able to identify the OCPU count that you can use to
provision or scale an ADB.
• OCPU: The number of OCPU cores to be made available to the database.
• Storage: The quantity of storage available to store data in the database, in terabytes.
• While provisioning an ADB, if you specify an OCPU count that the service cannot
provision in the existing ACD, then the service displays an error message and suggests 2
values in close proximity to the value that you have specified.
For example, assume that you are creating an ADB with 15 OCPUs on a Quarter Rack
Exadata Infrastructure that has 20 OCPUs available. However, there are only 10 OCPUs
available on each node. In this case, the service will not be able to provision the ADB
because 15 OCPUs is less than the split threshold of 16 OCPUs. Therefore, the nearest
possible values are 17 and 18.
• While scaling an ADB, if you specify an OCPU count that the service cannot use to scale
the ADB, then the service displays an error message and suggests 2 values in close
proximity to the value that you have specified.
6-5
Chapter 6
What’s New in ADB-D on Exadata Cloud@Customer
Table 6-1 REST API Endpoints to Track and Manage Resource Usage
Related Topics
• View a List of Autonomous Exadata VM Clusters
• View Details of an Autonomous Exadata VM Cluster
• Restart an Autonomous Container Database
• Create an Autonomous Data Guard Enabled Autonomous Container Database
Follow these steps to create an Autonomous Data Guard Enabled Autonomous
Container Database on an Oracle Exadata Cloud@Customer system.
• Create an Autonomous Data Guard Enabled Autonomous Database
• Scale the CPU Core Count or Storage of an Autonomous Database
• Clone an Autonomous Database
• Clone an Autonomous Database Backup
• GetAutonomousContainerDatabase
• GetAutonomousDatabase
6-6
Chapter 6
What’s New in ADB-D on Exadata Cloud@Customer
6-7
Chapter 6
What’s New in ADB-D on Exadata Cloud@Customer
6-8
Chapter 6
What’s New in ADB-D on Exadata Cloud@Customer
Related Topics
• Create an Autonomous Database
• Scale the CPU Core Count or Storage of an Autonomous Database
• Clone an Autonomous Database
Infrastructure Patching
• Services: Database
• Release Date: May 04, 2021
ADB-Dedicated maintenance involves patching Exadata Infrastructure(EI) Autonomous VM
Cluster, and Autonomous Container Database (ACD).
Related Topics
• Patching ADB on Exadata Cloud@Customer Infrastructure
6-9
Chapter 6
What’s New in ADB-D on Exadata Cloud@Customer
6-10
Chapter 6
What’s New in ADB-D on Exadata Cloud@Customer
Related Topics
• Access Control Lists (ACLs) for ADB-D on Exadata Cloud@Customer
• Create an Autonomous Database
• Manage Access Control List of an Autonomous Database
• Clone an Autonomous Database
6-11
Chapter 6
Introduction to ADB-D on Exadata Cloud@Customer
Resource Types
Each level of the architecture model corresponds to one of the following resources
types:
• Oracle Exadata Database Service on Cloud@Customer infrastructure:
Hardware rack that includes compute nodes and storage servers, tied together by
a high-speed, low-latency InfiniBand network and intelligent Exadata software.
Oracle Exadata Database Service on Cloud@Customer infrastructure is common
for both Autonomous and Non-Autonomous resources.
For a list of the hardware and Oracle Cloud resource characteristics of Oracle
Exadata Database Service on Cloud@Customer infrastructure resources that
support Autonomous Databases, see Available Exadata Infrastructure Hardware
Shapes.
– Only the Oracle Exadata Database Service on Cloud@Customer
Infrastructures deployed before Oracle announced support for Autonomous
Databases on Oracle Exadata Database Service on Cloud@Customer do not
support Autonomous resources listed below. Please contact your Oracle sales
representative to understand the infrastructure upgrades required for
supporting Oracle Autonomous Databases.
– You can create only one Autonomous VM cluster in an Exadata Infrastructure.
6-12
Chapter 6
Introduction to ADB-D on Exadata Cloud@Customer
Deployment Order
You must create the dedicated Exadata infrastructure resources in the following order:
1. Exadata Infrastructure. For more information, see Preparing for Exadata
Cloud@Customer and Provisioning Exadata Cloud@Customer System.
2. Autonomous Exadata VM cluster. For more information, see Managing Autonomous
Exadata VM Clusters.
3. Autonomous Container Database. For more information, see Managing Autonomous
Container Databases.
4. Autonomous Database. For more information, see Managing Autonomous Databases.
Related Topics
• Preparing for Exadata Database Service on Cloud@Customer
Review OCI as well as the site, network and storage requirements to prepare and deploy
Exadata Database Service on Cloud@Customer in your data center.
• Using the Console to Provision Exadata Database Service on Cloud@Customer
Infrastructure
Learn how to provision an Exadata Database Service on Cloud@Customer system.
• Managing Autonomous Exadata VM Clusters
An Autonomous Exadata VM Cluster is a set of symmetrical VMs across all Compute
nodes.
• Managing Autonomous Container Databases
Learn how you can create, view, move, change backup policies, manage maintenance
schedules, and perform other Oracle Autonomous Container Database management.
• Managing Autonomous Databases
An Autonomous Database resource is a user database. When you create an
Autonomous Database, you choose the Autonomous Container Database for it and you
specify "Data Warehouse" or "Transaction Processing" as its workload type to create an
Autonomous Data Warehouse database or an Autonomous Transaction Processing
database.
6-13
Chapter 6
Introduction to ADB-D on Exadata Cloud@Customer
User Roles
Your organization may choose to split the administration of the Oracle Autonomous
Database on Oracle Exadata Database Service on Cloud@Customer into the following
roles:
• Fleet Administrator. Fleet administrators create, monitor and manage
Autonomous Exadata Infrastructure and Autonomous Container Database
resources. They must also setup customer managed Backup Destinations, such
as Recovery Appliance and NFS to be used by Autonomous Databases. A fleet
administrator must have permissions for using the networking resources required
by the Oracle Exadata Database Service on Cloud@Customer infrastructure, and
permissions to manage the infrastructure and container database resources.
• Database Administrator. Database administrators create, monitor and manage
Autonomous Databases. They also create and manage users within the database.
Database administrators must have permissions for using container databases, for
managing autonomous databases and backups, and for using the related
networking resources. At the time of provisioning an Autonomous Database, the
administrator provides user credentials for the automatically created ADMIN
account, which provides administrative rights to the new database.
• Database User. Database users are the developers who write applications that
connect to and use an Autonomous Database to store and access the data.
Database users do not need Oracle Cloud Infrastructure accounts. They gain
network connectivity to and connection authorization information for the database
from the database administrator.
Note:
The limits listed in the following tables apply to all the Exadata Systems
supported by a dedicated Autonomous Database. Exceptions (if any) are
highlighted accordingly.
6-14
Chapter 6
Introduction to ADB-D on Exadata Cloud@Customer
Note:
It is possible to provision more Autonomous Databases than those recommended in
the Recommended Resource Limits table, especially with fractional OCPUs.
However, this implies compromising the Service Level Objectives (SLOs) to return
an application online following an unplanned outage or a planned maintenance
activity. To know the SLO details for dedicated Autonomous Database deployments,
see Availability Service Level Objectives (SLOs).
For more information, see Oracle Exadata Database Service on Exadata Cloud@Customer
X9M datasheet.
6-15
Chapter 6
Introduction to ADB-D on Exadata Cloud@Customer
Related Topics
• Availability Service Level Objectives (SLOs)
• Oracle Exadata Database Service on Exadata Cloud@Customer X9M
6-16
Chapter 6
Managing Autonomous Exadata VM Clusters
• Oracle Application Express (APEX), RESTful services, and SQL Developer Web are not
subject to ACLs. Choosing to enable an ACL disables these features automatically.
• Performance Hub is not subject to ACL rules.
• While creating a database, if setting ACL fails, then provisioning the database also fails.
• Updating ACL is allowed if the database is in Available and AvailableNeedsAttention
states.
• Restoring a database does not overwrite the existing ACLs.
• Cloning a database, full and metadata, will have the same access control settings as the
source database. You can make changes as necessary.
• All CDB operations are allowed during ACL update. However, ADB operations are not
allowed during ACL update.
Related Topics
• Manage Access Control List of an Autonomous Database
6-17
Chapter 6
Managing Autonomous Exadata VM Clusters
Note:
The minimum and maximum values for these parameters change in
relation to each other, for example, the OCPU count allocation will
impact the number of ACDs customers can create.
6-18
Chapter 6
Managing Autonomous Exadata VM Clusters
– OCPU count per node: Specify the OCPU count for each individual VM. The
minimum value is 5 OCPUs per VM.
– Database memory per OCPU (GB): The memory per OCPU allocated for the
Autonomous Databases in the Autonomous VM CLuster.
– Allocate Storage for Local Backups: Check this option to configure the
Exadata storage to enable local database backups.
– Autonomous Database storage for the Autonomous VM Cluster (TB): Data
storage allocated for Autonomous Database creation in the Autonomous VM
Cluster.
5. Configure automatic maintenance.
a. Click Edit Maintenance Preferences.
On the Edit Maintenance Preferences page do the following:
• No preference: The system assigns a date and start time for infrastructure
maintenance.
• Specify a schedule: Choose your preferred month, week, weekday, start time,
and lead time for infrastructure maintenance.
– Under Maintenance months, specify at least one month for each quarter
during which Exadata infrastructure maintenance will take place. You can
select more than one month per quarter. If you specify a long lead time for
advanced notification (for example, 4 weeks), you may wish to specify 2 or 3
months per quarter during which maintenance runs can occur. This will
ensure that your maintenance updates are applied in a timely manner after
accounting for your required lead time. Lead time is discussed in the
following steps.
– Optional. Under Week of the month, specify which week of the month
maintenance will take place. Weeks start on the 1st, 8th, 15th, and 22nd
days of the month, and have a duration of 7 days. Weeks start and end
based on calendar dates, not days of the week. Maintenance cannot be
scheduled for the fifth week of months that contain more than 28 days. If you
do not specify a week of the month, Oracle will run the maintenance update
in a week to minimize disruption.
– Optional. Under Day of the week, specify the day of the week on which the
maintenance will occur. If you do not specify a day of the week, Oracle will
run the maintenance update on a weekend day to minimize disruption.
– Optional. Under Start hour, specify the hour during which the maintenance
run will begin. If you do not specify a start hour, Oracle will pick the least
disruptive time to run the maintenance update.
– Under Lead Time, specify the minimum number of weeks ahead of the
maintenance event you would like to receive a notification message. Your
lead time ensures that a newly released maintenance update is scheduled to
account for your required minimum period of advanced notification.
b. Click Save Changes.
6. Choose the license type you wish to use.
Your choice affects metering for billing. You have the following options:
• Bring your own license: If you choose this option, make sure you have proper
entitlements to use for new service instances that you create.
6-19
Chapter 6
Managing Autonomous Exadata VM Clusters
• License included: With this choice, the cost of the cloud service includes a
license for the Database service.
7. The following Advanced Options are available:
• Time zone: The default time zone for the Exadata Infrastructure is UTC, but
you can specify a different time zone. The time zone options are those
supported in both the Java.util.TimeZone class and the Oracle Linux operating
system.
Note:
If you want to set a time zone other than UTC or the browser-
detected time zone, then select the Select another time zone
option, select a Region or contry, and then select the
corresponding Time zone.
If you do not see the region or country you want, then select
Miscellaneous, and then select an appropriate Time zone.
• Listener: VM Cluster Networks are created with the default ports (non-TLS:
1521 and TLS: 2484). You can select a non-default SCAN listener port for both
TLS and non-TLS connections within the permissible range of ports.
Note:
– Non-TLS port:
* Default: 1521
* Permissible range:1024 - 8999
* Exceptions:
* Agent port: 7070
* Admin port: 7879
* Connect to agent port: 7060
* Oracle notification service: 6100, 6200
– TLS port:
* Default: 2484
* Permissible range:1024 - 8999
* Exceptions:
6-20
Chapter 6
Managing Autonomous Exadata VM Clusters
6-21
Chapter 6
Managing Autonomous Exadata VM Clusters
d. In the list of Autonomous Exadata VM Clusters, click the display name of the
Autonomous Exadata VM Clusters you wish to view details. Or, click the action
menu (three dots), and then select View Details.
Autonomous Exadata VM Clusters Details page is displayed.
Autonomous VM Cluster Details page displays details that include total and
available OCPUs, Reclaimable OCPUs, total and available storage in TB, and
total and available ACDs.
6-22
Chapter 6
Managing Autonomous Exadata VM Clusters
8. Optional. Under Day of the week, specify the day of the week on which the maintenance
will occur.
If you do not specify a day of the week, Oracle will run the maintenance update on a
weekend day to minimize disruption.
9. Optional. Under Start hour, specify the hour during which the maintenance run will
begin. If you do not specify a start hour, Oracle will pick the least disruptive time to run
the maintenance update.
10. Under Lead Time, specify the minimum number of weeks ahead of the maintenance
event you would like to receive a notification message.
Your lead time ensures that a newly released maintenance update is scheduled to
account for your required minimum period of advanced notification.
11. Click Save Changes.
View or Edit the Time of the Next Scheduled Maintenance for Autonomous Exadata
VM Cluster
Learn how to view and edit the time of the next scheduled maintenance.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Click Autonomous Exadata VM Clusters.
3. In the list of Autonomous Exadata VM Clusters, find the Autonomous Exadata VM Cluster
you want to set the maintenance window for and click its highlighted name.
4. On the Autonomous Exadata VM Cluster details page, under Maintenance, click the
view link in the Next Maintenance field.
5. On the Maintenance page, scheduled maintenance events are listed.
6. Optional. To change the time of the next scheduled maintenance, click the Edit link in the
Scheduled Start Time field.
7. In the Edit Infrastructure Maintenance Scheduled Start Time page, enter a date and
time in the Scheduled Start time field.
The following restrictions apply:
• You can reschedule the infrastructure maintenance to a date no more than 180 days
from the prior infrastructure maintenance. If a new maintenance release is
announced prior to your rescheduled maintenance run, the newer release will be
applied on your specified date. You can reschedule your maintenance to take place
earlier than it is currently scheduled. You cannot reschedule the maintenance if the
current time is within 2 hours of the scheduled maintenance start time.
• Oracle reserves certain dates each quarter for internal maintenance operations, and
you cannot schedule your maintenance on these dates.
6-23
Chapter 6
Managing Autonomous Exadata VM Clusters
6-24
Chapter 6
Managing Encryption Keys on External Devices
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. In the list of Autonomous Exadata VM Clusters, click the display name of the Exadata VM
cluster you wish to administer.
3. Click Terminate.
4. Confirm that you wish to terminate your Autonomous Exadata VM Cluster in the
confirmation dialog.
5. Click Terminate VM Cluster.
6-25
Chapter 6
Managing Encryption Keys on External Devices
• Required IAM Policy for Managing OKV on Oracle Exadata Database Service on
Cloud@Customer
Review the identity access management (IAM) policy for managing OKV on Oracle
Exadata Database Service on Cloud@Customer Systems.
• Tagging Resources
You can apply tags to your resources to help you organize them according to your
business needs.
• Moving Resources to a Different Compartment
You can move vaults from one compartment to another.
• Setting Up Your Exadata Cloud@Customer to Work With Oracle Key Vault
• Managing Your Key Store
Note:
The Oracle Key Vault is a customer-provisioned and managed system and it
is not part of Oracle Cloud Infrastructure managed services.
Related Topics
• Oracle Key Vault
6-26
Chapter 6
Managing Encryption Keys on External Devices
Related Topics
• Oracle Key Vault
Tagging Resources
You can apply tags to your resources to help you organize them according to your business
needs.
You can apply tags at the time you create a resource, or you can update the resource later
with the desired tags. For general information about applying tags, see "Resource Tags".
Related Topics
• Resource Tags
6-27
Chapter 6
Managing Encryption Keys on External Devices
After you move a vault to a new compartment, inherent policies apply immediately and
affect access to the vault. Moving a vault doesn't affect access to any keys or secrets
that the vault contains. You can move a key or secret from one compartment to
another independently of moving the vault it's associated with. For more information,
see "Managing Compartments".
Related Topics
• Managing Compartments
6-28
Chapter 6
Managing Encryption Keys on External Devices
Step 1: Create a Vault in OCI Vault Service and Add a Secret to the Vault to Store
OKV REST Administrator Password
Your Exadata Cloud@Customer infrastructure communicates with OKV over REST each time
an Autonomous Container Database is provisioned to register the Autonomous Container
Database and request a wallet on OKV. Therefore, Exadata infrastructure needs access to
the REST admin credentials.
These credentials can be stored securely in the Oracle Vault Service in OCI as a Secret and
accessed by your Exadata Cloud@Customer infrastructure only when needed. These
credentials are not accessible by a human operator administering the Exadata infrastructure.
To store OKV administrator password in OCI Vault service, create a vault by following the
instructions outlined in "Managing Vaults" and create a Secret in that vault by following the
instructions outlined in "Managing Secrets".
Related Topics
• Managing Vaults
• Managing Secrets
Step 2: Create a Dynamic Group and a Policy Statement for Key Store to Access
Secret in OCI Vault
To grant your Key Store resources permission to access Secret in OCI Vault, you create an
IAM dynamic group that identifies these resources and then create an IAM policy that grants
this dynamic group access to the Secret you created in the OCI Vaults and Secrets.
When defining the dynamic group, you identify your Key Store resources by specifying the
OCID of the compartment containing your Key Store.
1. Copy the OCID of the compartment containing your Key Store resource.
You can find this OCID on the Compartment Details page of the compartment.
2. Create a dynamic group by following the instructions in "To create a dynamic group" in
Oracle Cloud Infrastructure Documentation. When following these instructions, enter a
matching rule of this format:
where <compartment-ocid> is the OCID of the compartment containing your Key Store
resource.
3. After creating the dynamic group, navigate to (or create) an IAM policy in a compartment
higher up in your compartment hierarchy than the compartment containing your vaults
and secrets. Then, add a policy statement of this format:
6-29
Chapter 6
Managing Encryption Keys on External Devices
where <dynamic-group> is the name of the dynamic group you created and
<vaults-and-secrets-compartment> is the name of the compartment in which
you created your vaults and secrets.
Related Topics
• To create a dynamic group
where <dynamic-group> is the name of the dynamic group you created and
<key-store-compartment> is the name of the compartment in which you created
your Key Store.
Step 4: Create a Policy Statement for Database Service to Use Secret from
OCI Vault Service
To grant the Autonomous Database service permission to use the secret in OCI Vault
to log in to the OKV REST interface, navigate to (or create) an IAM policy in a
compartment higher up in your compartment hierarchy than the compartment
containing your OCI Vaults and Secrets. Then, add a policy statement of this format:
6-30
Chapter 6
Managing Encryption Keys on External Devices
7. Ensure that you use the same "OKV REST Administrator" user credentials, for example,
"okv_rest_user", while provisioning Autonomous Database.
For more information, see Managing Vaults, Managing Keys, and Managing Secrets.
Related Topics
• Managing Vaults
• Managing Keys
• Managing Secrets
6-31
Chapter 6
Managing Encryption Keys on External Devices
6-32
Chapter 6
Managing Encryption Keys on External Devices
6. On the Edit Key Store page, make changes as needed, and then click Save Changes.
6-33
Chapter 6
Managing Autonomous Container Databases
For information about using the API and signing requests, see "REST APIs" and
"Security Credentials". For information about SDKs, see "Software Development Kits
and Command Line Interface".
The following table lists the REST API endpoints to manage key store.
Related Topics
• REST APIs
• Security Credentials
• Software Development Kits and Command Line Interface
6-34
Chapter 6
Managing Autonomous Container Databases
6-35
Chapter 6
Managing Autonomous Container Databases
For example:
EXEC dbms_ra.add_db(db_unique_name=>'ACDNAME',
protection_policy_name=>'BRONZE', reserved_space=>'1024G');
For more information about enrolling the protected database, see Enrolling the
Protected Database with Recovery Appliance (Command Line).
c. Grant access to this database to the Recovery Appliance user account.
EXEC dbms_ra.grant_db_access(db_unique_name=>'<DB_UNIQUE_NAME of
the database>', username=>'<Recovery Appliance user account>');
For example:
EXEC dbms_ra.grant_db_access(db_unique_name=>'ACDNAME',
username=>'RAVPC1');
6-36
Chapter 6
Managing Autonomous Container Databases
Note:
• Tags: Optionally, you can apply tags. If you have permissions to create a resource,
you also have permissions to apply free-form tags to that resource. To apply a
defined tag, you must have permissions to use the tag namespace. For more
information about tagging, see Resource Tags. If you are not sure if you should apply
tags, skip this option (you can apply tags later) or ask your administrator. Avoid
entering confidential information.
9. Click Create Autonomous Container Database.
Related Topics
• Creating Virtual Private Catalog Accounts
• Enrolling the Protected Database with Recovery Appliance (Command Line)
• Resource Tags
6-37
Chapter 6
Managing Autonomous Container Databases
3. Click the display name of the Autonomous Exadata VM Cluster that you interested
in.
In the Autonomous Exadata VM Clusters Details page, a list of Autonomous
Container Databases is displayed under Resources.
You can also filter out to view Autonomous Container Databases in a particular
compartment. Under List Scope, select a compartment from the Compartment
drop-down list.
Note:
OKV Wallet Name represents the name of the wallet in which keys for
this CDB are generated on the OKV.
6-38
Chapter 6
Managing Autonomous Container Databases
TDE Master Key leads to the new key being generated in OKV and assigned to this
database. You can view all of the keys in OKV.
Note:
You can rotate both Oracle-managed and customer-managed encryption keys.
1. Open the navigation menu. Under Oracle Database, click Exadata Cloud@Customer.
2. Click Autonomous Container Databases.
3. In the list of Autonomous Container Databases, click the display name of the database
you wish to view details.
4. On the Autonomous Container Database Details page, click Rotate Encryption Key.
5. On the Rotate Encryption Key dialog, click Rotate Encryption Key.
Note:
By default, database backups are retained for 30 days if you have chosen Object
Storage or NFS as a backup destination. You have the option of retaining backups
for 7, 15, 30, or 60 days. If you have chosen Local storage as a backup destination,
then by default, database backups are retained for a maximum of 7 days. If you
have chosen Recovery Appliance as a backup destination, then you cannot update
the backup retention policy.
The current backup retention policy for an Autonomous Container Database is
displayed on the Autonomous Container Database details page.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Click Autonomous Container Databases.
3. In the list of Autonomous Container Databases, click the display name of the container
database you are interested in.
4. On the Autonomous Container Database details page, under Backup, click the Edit link
in the Backup retention policy field.
5. Specify a backup retention period from the list of choices.
6. Click Update.
6-39
Chapter 6
Managing Autonomous Container Databases
Note:
You cannot restart an autonomous container database if a backup is in
progress on any of its autonomous databases.
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Click Autonomous Container Databases.
3. In the list of Autonomous Container Databases, click the display name of the
container database you are interested in.
Autonomous Container Database details page is displayed.
Autonomous Container Database details page displays details that include total
OCPU, available OCPU, reclaimable OCPU, and database memory per OCPU in
GB.
4. On the Autonomous Container Database details page, click Restart.
6-40
Chapter 6
Managing Autonomous Container Databases
5. In the confirmation dialog, type the name of the Autonomous Container Database.
6. Click Restart.
(or)
a. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
b. Click Autonomous Container Databases.
c. In the list of Autonomous Container Databases, click the Actions icon (three dots) for
the container database you are interested in, and then select Restart.
d. In the confirmation dialog, type the name of the Autonomous Container Database.
e. Click Restart.
Note:
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Click Autonomous Container Databases.
3. In the list of Autonomous Container Databases, click the display name of the container
database you wish to move.
4. Click Move Resource.
5. Select the new compartment.
6. Click Move Resource.
6-41
Chapter 6
Managing Autonomous Databases
Note:
You must terminate all Autonomous Databases within a container database
before you can terminate the container database itself.
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Click Autonomous Container Databases.
3. In the list of Autonomous Container Databases, click the display name of the
infrastructure resource you are interested in.
4. Click Terminate.
5. In the confirmation dialog, type the name of the Autonomous Container Database,
and then click Terminate Autonomous Container Database.
6-42
Chapter 6
Managing Autonomous Databases
6-43
Chapter 6
Managing Autonomous Databases
• Database Name: The database name must consist of letters and numbers
only, starting with a letter. The maximum length is 14 characters. Avoid
entering confidential information.
Workload Type
Select the desired workload type.
• Data Warehouse
• Transaction Processing
See About Autonomous Database for information about each workload type.
Autonomous Container Database: Select an Autonomous Container Database.
Compartment: Specify the compartment containing the Autonomous Container
Database you wish to use.
Configure the database
• OCPU Count: Specify the number of OCPU for your database. The total
number of cores available to all databases within the Autonomous Exadata
Infrastructure depends on the infrastructure shape and what is already
allocated to other Autonomous Databases.
Create Autonomous Databases with less than 1 OCPU count using fractional
units. Fractional OCPU supports up to 10 Autonomous Databases per core
with the smallest OCPU count being 0.1 and up to 0.9 fractional OCPU with an
increment of 0.1. Fractional OCPU is for less than one OCPU only. For OCPU
equal to or greater than one, the increment must be in integer.
– Default: 1
– Minimum: 0.1
– Maximum: Set by quota
– Increment between 0.1 and 0.9: 0.1
– Increment between 1 and maximum: 1
Auto scaling: Deselect Auto Scaling to disable auto scaling. By default auto
scaling is enabled to allow the system to automatically use up to three times
more CPU and IO resources to meet workload demand.
Fractional OCPU auto-scaling behaves the same way as integer OCPU auto-
scaling. However, there is a subtle difference between fractional OCPU auto-
scaling and integer OCPU auto-scaling behaviors. Fractional OCPU auto-
scaling will scale three times the base OCPU and then round it off to a whole
number.
For example, 0.1 OCPU can auto-scale up to 1 OCPU, 0.5 OCPU can auto-
scale up to 2 OCPU, 0.7 OCPU can auto-scale up to 3 OCPU, and so on.
• Storage (GB): Specify the storage you wish to make available to your
Autonomous Database, in GB. The available storage depends on the
infrastructure shape and what is already consumed by other Autonomous
Databases.
– Default: 1024 GB
– Minimum: 32 GB
– Increment: 1 GB
Administrator Credentials
6-44
Chapter 6
Managing Autonomous Databases
Set the password for the Autonomous Database Admin user by entering a password that
meets the following criteria. Use this password when accessing the Autonomous
Database service console and when using an SQL client tool.
• Contains from 12 to 30 characters
• Contains at least one lowercase letter
• Contains at least one uppercase letter
• Contains at least one number
• Does not contain the double quotation mark (")
• Does not contain the string "admin", regardless of casing
Configure network access You can optionally create an ACL during database
provisioning, or at any time thereafter.
• Select the Enable database level access control checkbox.
• Click Access Control Rule.
Note:
The database-level access control will be enabled without any IP addresses
in the access control list. Enabling an access control list with an empty list
of IP addresses makes the database inaccessible to all clients
• Specify the following types of addresses in your list by using the IP notation type
drop-down selector:
– IP Address allows you to specify one or more individual public IP addresses. Use
commas to separate your addresses in the input field.
– CIDR Block allows you to specify one or more ranges of public IP addresses
using CIDR notation. Use commas to separate your CIDR block entries in the
input field.
Advanced Options:
• Encryption Key: ADB inherits encryption settings from the parent ACD. If the parent
ACD is configured for customer-managed OKV-based encryption, then the child ADB
will also have a TDE Master Key generated and managed in the same OKV wallet
used to store ACD master keys. Additionally, any backups taken on the Autonomous
Database will have the OKV based key associated with it.
• Management: Choose a Character Set and National Character from the drop-down
list.
• Tags: Optionally, you can apply tags. If you have permission to create a resource,
you also have permission to apply free-form tags to that resource. To apply a defined
tag, you must have permission to use the tag namespace. For more information
about tagging, see Resource Tags. If you are not sure if you should apply tags, skip
this option (you can apply tags later) or ask your administrator. Avoid entering
confidential information.
5. Click Create Autonomous Database.
6-45
Chapter 6
Managing Autonomous Databases
Note:
The following naming restrictions apply to Autonomous Transaction
Processing and Autonomous Data Warehouse databases:
• Names associated with databases terminated within the last 60 days
cannot be used when creating a new database.
• A database name cannot be used concurrently for both an
Autonomous Data Warehouse and an Autonomous Transaction
Processing database.
Related Topics
• About Autonomous Database
• Resource Tags
Note:
Autonomous Data Guard enabled Automonous databases:
• You can only view ACLs for standby databases.
• You can reset ACL for both the primary and standby databases from
the primary database details page. You cannot configure ACL from
the standby database details page.
6-46
Chapter 6
Managing Autonomous Databases
• CIDR Block allows you to specify one or more ranges of public IP addresses using
CIDR notation. Use commas to separate your CIDR block entries in the input field.
Click + Access Control Rule to add additional access rules to your list.
To remove an access control rule, simply delete the entry from the list. Deleting all access
control rules from the ACL will render the database inaccessible because the allow list is
empty.
To disable the database-level access control configuration, clear the Enable database
level access control checkbox. Once ACL is disabled and the configuration is saved, all
the access control rules are removed from the ACL and no longer applicable.
6. Click Save Changes.
If the Lifecycle State is Available when you click Save, the Lifecycle State changes to
Updating until the ACL update is complete. The database is still up and accessible, there
is no downtime. When the update is complete the Lifecycle State returns to Available
and the network ACL rules from the access control list are in effect.
6-47
Chapter 6
Managing Autonomous Databases
leads to the new key being generated in OKV and assigned to this database. You can
view all of the keys in OKV.
Note:
You can rotate both Oracle-managed and customer-managed encryption
keys.
6-48
Chapter 6
Managing Autonomous Databases
6-49
Chapter 6
Managing Autonomous Databases
6-50
Chapter 6
Managing Autonomous Databases
5. Check Auto Scaling to enable the auto scaling feature, or uncheck Auto Scaling to
disable the feature.
6. Click Update.
Note:
• To move an autonomous database you must have the right to manage it in its
current compartment and in the compartment you are moving it to.
• As soon as you move an autonomous database to a different compartment, the
policies that govern the new compartment apply immediately and affect access
to the autonomous database. Therefore, both your and other Oracle Cloud
users' access to it may change, depending on the policies governing the user
account's access to resources. For example, a user may lose the ability to
manage the autonomous databae, given its new compartment.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Click Autonomous Databases.
3. In the list of Autonomous Databases, click the display name of the database you wish to
move.
4. From the More Actions drop-down list, select Move Resource.
5. Select the new compartment.
6. Click Move Resource.
6-51
Chapter 6
Managing Autonomous Databases
Note:
Stopping your database has the following consequences:
• On-going transactions are rolled back.
• You will not be able to connect to your database using database clients
or tools.
Note:
During the backup operation, your autonomous database remains available.
However, lifecycle management operations such as stopping it, scaling it, or
terminating it are disabled.
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Click Autonomous Databases.
3. In the list of Autonomous Databases, click the display name of the database you
wish to back up.
6-52
Chapter 6
Managing Autonomous Databases
Note:
Restoring an autonomous database puts the database in the unavailable state
during the restore operation. You cannot connect to a database in this state. The
only lifecycle management operation supported in the unavailable state is
terminate.
6-53
Chapter 6
Managing Autonomous Databases
6-54
Chapter 6
Managing Autonomous Databases
In the Clone Type section, select the type of clone you want to create. Choose either
Full Clone or Metadata Clone.
Clone Source: The clone source selection allows you to specify whether the clone is
created from a running database or from a database backup. Select one of the following
options:
• Clone from a database instance: Creates a clone of a running database as it exists
at the current moment.
• Clone from a backup: Creates a clone from a database backup. If you choose this
option, select one of the following options:
– Specify a timestamp: Creates a point-in-time clone. The timestamp has to be
between the first and latest backups of the database.
– Select from a list of backups: Creates a clone using all data from the specified
backup. To limit your list of backups to a specific date range, enter the starting
date in the From field and the ending date in the To field.
Provide basic information for the Autonomous Database.
• Choose a compartment: Your current compartment is the default selection but you
can select a different compartment in which to create the clone from the drop-down
list.
• Source database name: The name of the source database displays in the read-only
Source database name field.
• Display name: Enter a description or other information to identify the database
clone. You can change the display name any time and it does not have to be unique.
Avoid entering confidential information.
• Database name: Enter a database name for the clone that contains only letters and
numbers, begins with a letter. Avoid entering confidential information.
• Three additional fields are displayed if you opt to clone from a backup.
– Exadata Infrastructure: You can choose to create the database clone in the
same Exadata Infrastructure where the source database resides, or you can
choose a different compartment by clicking CHANGE COMPARTMENT and
choosing one from the drop-down list.
– Autonomous Exadata VM Cluster: You can choose to create the database
clone in the same Autonomous Exadata VM Cluster where the source database
resides, or you can choose a different compartment by clicking CHANGE
COMPARTMENT and choosing one from the drop-down list.
• Autonomous Container Database: You can choose to create the database clone in
the same compartment and container database as the source database, or you can
choose a different compartment by clicking CHANGE COMPARTMENT, and a
different container database by choosing one from the drop-down list.
Configure the database
• OCPU Count: Specify the number of OCPU for your database. The total number of
cores available to all databases within the Autonomous Exadata Infrastructure
depends on the infrastructure shape and what is already allocated to other
Autonomous Databases.
The selected OCPU count is validated against a list of provisionable OCPUs, and if
the database can not be scaled up to the chosen OCPU count, you will be provided
with the two nearest provisionable OCPU values.
6-55
Chapter 6
Managing Autonomous Databases
6-56
Chapter 6
Managing Autonomous Databases
Note: The database-level access control will be enabled without any IP addresses in
the access control list. Enabling an access control list with an empty list of IP
addresses makes the database inaccessible to all clients.
• Specify the following types of addresses in your list by using the IP notation type
drop-down selector:
– IP Address allows you to specify one or more individual public IP addresses. Use
commas to separate your addresses in the input field.
– CIDR Block allows you to specify one or more ranges of public IP addresses
using CIDR notation. Use commas to separate your CIDR block entries in the
input field.
Advanced Options:
• Encryption Key:
– Clone from a database instance: The source and the target ACD must be the
same Keystore type. When the source is OKV, the target must also be the same
OKV destination.
– Clone from a backup: The source and the target ACDs can be different
Keystore types. When the source is OKV, the target must also be the same OKV
destination.
• Management: Choose a Character Set and National Character from the drop-down
list.
• Tags: Optionally, you can apply tags. If you have permission to create a resource,
you also have permission to apply free-form tags to that resource. To apply a defined
tag, you must have permission to use the tag namespace. For more information
about tagging, see Resource Tags. If you are not sure if you should apply tags, skip
this option (you can apply tags later) or ask your administrator. Avoid entering
confidential information.
6. Click Create Autonomous Database Clone.
The Console displays the details page for the new clone of your database and the service
begins provisioning the Autonomous Database. Note the following:
• The new clone displays the Provisioning lifecycle state until the provisioning process
completes.
• The source database remains in the Available lifecycle state.
• Backups associated with the source database are not cloned for either the full-clone or
the metadata-clone option.
The Clone source is displayed in the General Information section of the cloned database
details page. Click the name to view details of the source database. Note that if the source
database is deleted, then this key/value pair is not displayed.
Related Topics
• GetAutonomousContainerDatabase
• Resource Tags
6-57
Chapter 6
Managing Autonomous Databases
You can use the cloning feature to create a point-in-time copy of your Autonomous
Database for purposes such as testing, development, or analytics. To clone only the
database schema of your source database, choose the metadata clone option.
Clone Types
The clone feature offers the following two types of Autonomous Database clones:
• The full-clone option creates a database that includes the metadata and data from
the source database.
• The metadata-clone option creates a database that includes only the metadata
from the source database.
Steps
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Click Autonomous Databases.
3. In the list of Autonomous Databases, click the display name of the database you
want to clone.
4. Under Resources, click Backups.
5. In the list of backups, find the backup that you want to clone, click the action icon
(three dots), and then click Create Clone.
6. On the Create Autonomous Database Clone page, provide the following
information:
In the Clone Type section, select Full Clone.
Clone Source: The clone source section displays the source backup details.
Provide basic information for the Autonomous Database.
• Choose a compartment: Your current compartment is the default selection
but you can select a different compartment in which to create the clone from
the drop-down list.
• Source database name: The name of the source database displays in the
read-only Source database name field.
• Display name: Enter a description or other information to identify the
database clone. You can change the display name any time and it does not
have to be unique. Avoid entering confidential information.
• Database name: Enter a database name for the clone that contains only
letters and numbers, begins with a letter. Avoid entering confidential
information.
• Exadata Infrastructure: You can choose to create the database clone in the
same Exadata Infrastructure where the source database resides, or you can
choose a different compartment by clicking CHANGE COMPARTMENT and
choosing one from the drop-down list.
• Autonomous Exadata VM Cluster: You can choose to create the database
clone in the same Autonomous Exadata VM Cluster where the source
database resides, or you can choose a different compartment by clicking
CHANGE COMPARTMENT and choosing one from the drop-down list.
• Autonomous Container Database: You can choose to create the database
clone in the same compartment and container database as the source
6-58
Chapter 6
Managing Autonomous Databases
Note:
When the target Autonomous Exadata VM Cluster is the same as the
source, then the database name cannot be the same as the source
database name.
Note:
The time taken to clone an ADB depends on the OCPU Count and the
network bandwidth between the Backup Destination and the target ACD.
Specify the number of OCPU for your database. The total number of cores available
to all databases within the Autonomous Exadata Infrastructure depends on the
infrastructure shape and what is already allocated to other Autonomous Databases.
The selected OCPU count is validated against a list of provisionable OCPUs, and if
the database can not be scaled up to the chosen OCPU count, you will be provided
with the two nearest provisionable OCPU values.
You can use the GetAutonomousContainerDatabase API to get a complete list of
provisionable OCPU values.
The default is 1. However, you can assign a fractional OCPU value from 0.1 to 0.9 (in
increments of 0.1) to databases that do not need a full OCPU. For databases that
need 1 or more OCPU cores, you must specify the number of assigned OCPUs as an
integer. For example, you cannot assign 3.5 OCPU to a database. The next available
number of OCPU above 3 is 4.
– Default: 2
– Minimum: 2
– Maximum: Set by quota
• Storage (GB): Specify the amount of storage, in GB, that you want to make available
to your cloned Autonomous Database, and it depends on the storage available to
use.
– Default/Minimum: Allocated storage of the source database
– Increment: 1 GB
• Auto scaling: Enabling autoscaling allows the system to automatically use up to
three times more CPU and I/O resources to meet workload demand.
Create administrator credentials
Set the password for the Autonomous Database administrator user by entering a
password that meets the following criteria.
6-59
Chapter 6
Managing Autonomous Databases
• Password cannot be one of the three most recently used passwords of the
source database
• Between 12 and 30 characters long
• Contains at least one lowercase letter
• Contains at least one uppercase letter
• Contains at least one number
• Does not contain the double quotation mark (")
• Does not contain the string "admin", regardless of casing
Use this password when accessing the service console and when using a SQL
client tool.
Configure Network Access
You can change the access control list to enable or disable database-level access
control or add or modify entries to the access control list.
• Click Modify Access Control.
• Select the Enable database level access control check box.
• Click Access Control Rule.
Note: The database-level access control will be enabled without any IP
addresses in the access control list. Enabling an access control list with an
empty list of IP addresses makes the database inaccessible to all clients.
• Specify the following types of addresses in your list by using the IP notation
type drop-down selector:
– IP Address allows you to specify one or more individual public IP
addresses. Use commas to separate your addresses in the input field.
– CIDR Block allows you to specify one or more ranges of public IP
addresses using CIDR notation. Use commas to separate your CIDR
block entries in the input field.
Advanced Options:
• Encryption Key:
– Clone from a database instance: The source and the target ACD must
be the same Keystore type. When the source is OKV, the target must also
be the same OKV destination.
– Clone from a backup: The source and the target ACDs can be different
Keystore types. When the source is OKV, the target must also be the
same OKV destination.
• Management: Choose a Character Set and National Character from the
drop-down list.
• Tags: Optionally, you can apply tags. If you have permission to create a
resource, you also have permission to apply free-form tags to that resource.
To apply a defined tag, you must have permission to use the tag namespace.
For more information about tagging, see Resource Tags. If you are not sure if
you should apply tags, skip this option (you can apply tags later) or ask your
administrator. Avoid entering confidential information.
7. Click Create Autonomous Database Clone.
6-60
Chapter 6
Managing Autonomous Databases
The Console displays the details page for the new clone of your database and the service
begins provisioning the Autonomous Database. Note the following:
• The new clone displays the Provisioning lifecycle state until the provisioning process
completes.
• The source database remains in the Available lifecycle state.
Related Topics
• GetAutonomousContainerDatabase
• Resource Tags
6-61
Chapter 6
Managing Autonomous Databases
6-62
Chapter 6
Managing Autonomous Databases
6-63
Chapter 6
Managing Autonomous Databases
about tagging, see Resource Tags. If you are not sure if you should apply
tags, skip this option (you can apply tags later) or ask your administrator.
Avoid entering confidential information.
8. Click Create Autonomous Database Clone.
The Console displays the details page for the new clone of your database and the
service begins provisioning the Autonomous Database. Note the following:
• The new clone displays the Provisioning lifecycle state until the provisioning
process completes.
• The source database remains in the Available lifecycle state.
• Backups associated with the source database are not cloned for either the full-
clone or the metadata-clone option.
The Clone source is displayed in the General Information section of the cloned
database details page. Click the name to view details of the source database. Note
that if the source database is deleted, then this key/value pair is not displayed.
Related Topics
• Resource Tags
6-64
Chapter 6
Managing Autonomous Databases
8. On the Create Autonomous Database Clone page, provide the following information:
In the Clone Type section, select Full Clone.
Clone Source: The clone source section displays the source backup details.
Provide basic information for the Autonomous Database.
• Choose a compartment: Your current compartment is the default selection but you
can select a different compartment in which to create the clone from the drop-down
list.
• Source database name: The name of the source database displays in the read-only
Source database name field.
• Display name: Enter a description or other information to identify the database
clone. You can change the display name any time and it does not have to be unique.
Avoid entering confidential information.
• Database name: Enter a database name for the clone that contains only letters and
numbers, begins with a letter. Avoid entering confidential information.
• Exadata Infrastructure: You can choose to create the database clone in the same
Exadata Infrastructure where the source database resides, or you can choose a
different compartment by clicking CHANGE COMPARTMENT and choosing one from
the drop-down list.
• Autonomous Exadata VM Cluster: You can choose to create the database clone in
the same Autonomous Exadata VM Cluster where the source database resides, or
you can choose a different compartment by clicking CHANGE COMPARTMENT and
choosing one from the drop-down list.
• Autonomous Container Database: You can choose to create the database clone in
the same compartment and container database as the source database, or you can
choose a different compartment by clicking CHANGE COMPARTMENT, and a
different container database by choosing one from the drop-down list.
Note:
When the target Autonomous Exadata VM Cluster is the same as the
source, then the database name cannot be the same as the source
database name.
Note:
The time taken to clone an ADB depends on the OCPU Count and the
network bandwidth between the Backup Destination and the target ACD.
Specify the number of OCPU for your database. The total number of cores available
to all databases within the Autonomous Exadata Infrastructure depends on the
infrastructure shape and what is already allocated to other Autonomous Databases.
6-65
Chapter 6
Managing Autonomous Databases
The default is 1. However, you can assign a fractional OCPU value from 0.1 to
0.9 (in increments of 0.1) to databases that do not need a full OCPU. For
databases that need 1 or more OCPU cores, you must specify the number of
assigned OCPUs as an integer. For example, you cannot assign 3.5 OCPU to
a database. The next available number of OCPU above 3 is 4.
– Default: 2
– Minimum: 2
– Maximum: Set by quota
• Storage (GB): Specify the amount of storage, in GB, that you want to make
available to your cloned Autonomous Database, and it depends on the storage
available to use.
– Default/Minimum: Allocated storage of the source database
– Increment: 1 GB
• Auto scaling: Enabling autoscaling allows the system to automatically use up
to three times more CPU and I/O resources to meet workload demand.
Create administrator credentials
Set the password for the Autonomous Database administrator user by entering a
password that meets the following criteria.
• Password cannot be one of the three most recently used passwords of the
source database
• Between 12 and 30 characters long
• Contains at least one lowercase letter
• Contains at least one uppercase letter
• Contains at least one number
• Does not contain the double quotation mark (")
• Does not contain the string "admin", regardless of casing
Use this password when accessing the service console and when using a SQL
client tool.
Configure Network Access
You can change the access control list to enable or disable database-level access
control or add or modify entries to the access control list.
• Click Modify Access Control.
• Select the Enable database level access control check box.
• Click Access Control Rule.
Note: The database-level access control will be enabled without any IP
addresses in the access control list. Enabling an access control list with an
empty list of IP addresses makes the database inaccessible to all clients.
• Specify the following types of addresses in your list by using the IP notation
type drop-down selector:
– IP Address allows you to specify one or more individual public IP
addresses. Use commas to separate your addresses in the input field.
6-66
Chapter 6
Managing Autonomous Databases
– CIDR Block allows you to specify one or more ranges of public IP addresses
using CIDR notation. Use commas to separate your CIDR block entries in the
input field.
Advanced Options:
• Encryption Key:
– Clone from a database instance: The source and the target ACD must be the
same Keystore type. When the source is OKV, the target must also be the same
OKV destination.
– Clone from a backup: The source and the target ACDs can be different
Keystore types. When the source is OKV, the target must also be the same OKV
destination.
• Management: Choose a Character Set and National Character from the drop-down
list.
• Tags: Optionally, you can apply tags. If you have permission to create a resource,
you also have permission to apply free-form tags to that resource. To apply a defined
tag, you must have permission to use the tag namespace. For more information
about tagging, see Resource Tags. If you are not sure if you should apply tags, skip
this option (you can apply tags later) or ask your administrator. Avoid entering
confidential information.
9. Click Create Autonomous Database Clone.
The Console displays the details page for the new clone of your database and the service
begins provisioning the Autonomous Database. Note the following:
• The new clone displays the Provisioning lifecycle state until the provisioning process
completes.
• The source database remains in the Available lifecycle state.
Related Topics
• Resource Tags
WARNING:
Terminating an Autonomous Database permanently deletes it. The database data
will be lost when the system is terminated. However, automatic backups are not
deleted if you have chosen Recovery Appliance or NFS as a backup destination.
You can delete automatic backups directly from the Recovery Appliance or NFS.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Click Autonomous Databases.
3. In the list of Autonomous Databases, click the display name of the database you wish to
terminate.
6-67
Chapter 6
Managing Autonomous Databases
6-68
Chapter 6
Managing Autonomous Databases
6-69
Chapter 6
Connecting to Autonomous Databases
6-70
Chapter 6
Connecting to Autonomous Databases
• JDBC Thin Driver, also for Java applications, is a pure Java driver. Oracle SQL
Developer supports JDBC Thin Driver connections.
Third-party products and custom applications can use any of these connection types.
Oracle Autonomous Database provides several pairs of database services to use when
connecting to autonomous databases. In each pair, one of the pair provides a secure TCP
(TCPS) connection using the TLS protocol, and the other provides a TCP connection. In all
other respects, the two members of a pair are the same. To ensure security of data in transit,
Oracle strongly recommends that you use a secure connection, even if the database is only
available through a private network. If you are familiar with using an Oracle Database within
your own data center, you may not have previously used these secure connections.
To provide the secure TCPS connection, certification authentication uses an encrypted key
stored in a wallet on both the client (where the application is running) and the server (where
the autonomous database is running). The key on the client must match the key on the server
to make a connection. A wallet contains a collection of files, including the key and other
information needed to connect to your database . All communications between the client and
the server are encrypted.
• Download the Wallet for an Autonomous Database
• Get the APEX and SQL Developer Web URLs for an Autonomous Database
Note:
This password protects the downloaded Client Credentials wallet. This wallet is
not the same as the Transparent Data Encryption (TDE) wallet for the
database; therefore, use a different password to protect the Client Credentials
wallet.
6-71
Chapter 6
Patching ADB on Exadata Cloud@Customer Infrastructure
Note:
Wallet files, along with the Database user ID and password, provide access
to data in your autonomous database. Store wallet files in a secure location.
Share wallet files only with authorized users. If wallet files are transmitted in
a way that might be accessed by unauthorized users (for example, over
public email), transmit the wallet password separately and securely.
Get the APEX and SQL Developer Web URLs for an Autonomous
Database
Follow these steps to get the URLs to use to connect to APEX (Oracle Application
Express) and Oracle SQL Developer Web in an autonomous database on an Oracle
Exadata Database Service on Cloud@Customer system.
1. Open the navigation menu. Under Oracle Database, click Exadata Database
Service on Cloud@Customer.
2. Click Autonomous Databases.
3. In the list of Autonomous Databases, click the display name of the database
whose APEX and SQL URLs you wish to get.
4. Click DB Connections.
5. Select the Application Connection option.
6. Application URLs are displayed in plain text in the Application URL field. Copy
the URL string using the Copy link.
Paste the URL into a browser running on a system with network access to your
autonomous database.
6-72
Chapter 6
Patching ADB on Exadata Cloud@Customer Infrastructure
Note:
Oracle recommends that you set a maintenance window for at least Exadata
Infrastructure resources. Doing so will prevent maintenance operations from
occurring at times that would be disruptive to regular database operations.
You can set the maintenance window for an Exadata Infrastructure and Autonomous
Container Database resources when you create them or you can set or change it later. Once
a maintenance activity is scheduled based on the maintenance window you set, you can
manage the actual timing of the activity, even to the point of changing the patch version,
applying the patch immediately, or skipping the activity.
Related Topics
• Using the Console to Create Oracle Exadata Database Service on Cloud@Customer
Infrastructure
To create your Oracle Exadata Database Service on Cloud@Customer infrastructure, be
prepared to provide values for the fields required for configuring the infrastructure.
6-73
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
6-74
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Note:
Replication of data happens only over the client network.
6-75
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Note:
If the selected Autonomous Exadata VM Cluster does not have 2
available OCPUs per node, which is the minimum requirement for
creating an Autonomous Container Database, then this field is greyed
out. Select an Autonomous Exadata VM Cluster that has enough
resources to create an autonomous container database.
6-76
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Note:
If the selected Autonomous Exadata VM Cluster does not have 2
available OCPUs per node, which is the minimum requirement for
creating an Autonomous Container Database, then this field is greyed
out. Select an Autonomous Exadata VM Cluster that has enough
resources to create an Autonomous Container Database.
• Data Protection Mode: Specify the protection mode used for this Data Guard
association.
– Maximum Performance: Provides the highest level of data protection that is
possible without compromising the availability of a primary database.
– Maximum Availability: Provides the highest level of data protection that is
possible without affecting the performance of a primary database. This is the
default protection mode.
See Oracle Data Guard Concepts and Administration for more information about
Oracle Data Guard Protection Modes.
7. Optionally, you can configure an automatic maintenance schedule.
a. Click Modify Schedule.
b. Optionally, you can change the maintenance patch type. Select either Release
Update (RU) or Release Update Revision (RUR).
Note:
You can set maintenance type only for primary.
Release Update (RU): Autonomous Database installs only the most current release
update.
Release Update Revision (RUR): Autonomous Database installs the release update
plus additional fixes.
For more information, see Management Operations.
c. To configure the maintenance schedule, select Specify a schedule.
Choose your preferred month, week, weekday, and start time for autonomous
container database maintenance.
• Under Week of the month, specify which week of the month maintenance will
take place. Weeks start on the 1st, 8th, 15th, and 22nd days of the month, and
have a duration of 7 days. Weeks start and end based on calendar dates, not
days of the week. Maintenance cannot be scheduled for the fifth week of months
that contain more than 28 days.
• Under Day of the week, specify the day of the week on which the maintenance
will occur.
• Under Start hour, specify the hour during which the maintenance run will begin.
d. Click Save Changes.
8. Select a Backup Destination Type:
6-77
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Note:
• Tags: Optionally, you can apply tags. If you have permission to create a
resource, you also have permission to apply free-form tags to that resource.
To apply a defined tag, you must have permission to use the tag namespace.
For more information about tagging, see Resource Tags. If you are not sure if
you should apply tags, skip this option (you can apply tags later) or ask your
administrator. Avoid entering confidential information.
10. Click Create Autonomous Container Database.
6-78
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Related Topics
• Oracle Data Guard Protection Modes
• Management Operations
• Resource Tags
Note:
You can rotate both Oracle-managed and customer-managed encryption keys.
1. Open the navigation menu. Under Oracle Database, click Exadata Cloud@Customer.
2. Click Autonomous Container Databases.
3. In the list of Autonomous Container Databases, click the display name of the primary or
standby database you wish to view details.
4. On the Autonomous Container Database Details page, click Rotate Encryption Key.
5. On the Rotate Encryption Key dialog, click Rotate Encryption Key.
6-79
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Note:
After the service resolves the issues with the former primary Autonomous Container
Database, you can perform a manual switchover to return both databases to their
initial roles.
Once you provision the standby database, you can perform various management
tasks related to the standby database, including:
• Manually switching over a primary database to a standby database
6-80
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Note:
After successful completion of failover, the standby ACDs role will change
to primary and the primay's role will become disabled-standby.
6-81
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
6-82
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
3. In the list of Autonomous Container Databases, click the display name of the
infrastructure resource you are interested in.
4. In the Autonomous Container Database Details page, select Terminate from the More
Actions drop-down list.
5. Click Terminate.
6. In the confirmation dialog, type the name of the Autonomous Container Database, and
then click Terminate Autonomous Container Database.
6-83
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Related Topics
• REST APIs
• Security Credentials
• Software Development Kits and Command Line Interface
6-84
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
6-85
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
6-86
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
(Default) Same as primary database: Leave as is if you want the same access control
list for the secondary database.
Define standby database access control: Initialized with the same details as primary.
Add or modify entries, as applicable.
Advanced Options
Tags: Optionally, you can apply tags. If you have permission to create a resource, then
you also have permission to apply free-form tags to that resource. To apply a defined tag,
you must have permission to use the tag namespace. For more information about
tagging, see Resource Tags. If you are not sure if you should apply tags, skip this option
(you can apply tags later) or ask your administrator. Avoid entering confidential
information.
Encryption Key: ADB inherits encryption settings from the parent ACD. If the parent
ACD is configured for customer-managed OKV-based encryption, then the child ADB will
also have TDE Master Key generated and managed in the same OKV wallet used to
store ACD master keys. Additionally, any backups taken on the Autonomous Database
will have the OKV-based key associated with it.
5. Click Create Autonomous Database.
Note:
The following naming restrictions apply to Autonomous Transaction Processing
and Autonomous Data Warehouse databases:
• Names associated with databases terminated within the last 60 days
cannot be used when creating a new database.
• A database name cannot be used concurrently for both an Autonomous
Data Warehouse and an Autonomous Transaction Processing database.
Related Topics
• About Autonomous Database
• GetAutonomousContainerDatabase
• Resource Tags
6-87
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Note:
You can rotate both Oracle-managed and customer-managed encryption
keys.
6-88
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Note:
The standby database will have No preference by default. Standby
Maintenance depends on the primary maintenance schedule.
5. Optionally, you can change the maintenance patch type. To edit this setting, select either
Release Update (RU) or Release Update Revision (RUR).
Release Update (RU): Autonomous Database installs only the most current release
update.
Release Update Revision (RUR): Autonomous Database installs the release update plus
additional fixes.
Note:
Standby will be always patched before primary and the default gap between
standby and primary is 7 days. You have have an option to change the default
gap to anytime between 1 - 7 days.
6. To configure the maintenance schedule, select Specify a schedule in the Configure the
automatic maintenance schedule section. Choose your preferred month, week, weekday,
and start time for container database maintenance.
• Under Maintenance months, specify at least one month for each maintenance quarter
during which you want Autonomous Exadata Infrastructure maintenance to occur.
Note:
Maintenance quarters begin in February, May, August, and November, with
the first maintenance quarter of the year beginning in February.
• Under Week of the month, specify which week of the month maintenance will take
place. Weeks start on the 1st, 8th, 15th, and 22nd days of the month, and have a
duration of 7 days. Weeks start and end based on calendar dates, not days of the
week. Maintenance cannot be scheduled for the fifth week of months that contain
more than 28 days.
• Under Day of the week, specify the day of the week on which the maintenance will
occur.
• Under Start hour, specify the hour during which the maintenance run will begin.
• Choose the buffer period between primary and standby maintenance execution.
Buffer period is the number of days before which the standby Autonomous Container
6-89
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
6-90
Chapter 6
Using Autonomous Data Guard with Autonomous Database on Exadata Cloud@Customer
Note:
Patching primary immediately will result in standby being patched first, if standby is
not already patched.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Click Autonomous Databases.
3. In the list of Autonomous Container Databases, click the display name of the
Autonomous Container Database that you want to patch.
4. On the Autonomous Container Database Details page, in the Maintenance section, click
the View link in the Next Maintenance field to display the Maintenance page for the
Autonomous Container Database that you want to patch.
5. In the Autonomous Container Database section, click Patch Now in the Scheduled
Start Time field to display the Run Maintenance dialog.
6. Click Patch Now to start the patching operation.
Note:
Skipping primary will skip standby also. If standby is patched, then skipping on
primary is not allowed.
1. Open the navigation menu. Under Oracle Database, click Exadata Database Service
on Cloud@Customer.
2. Click Autonomous Databases.
3. In the list of Autonomous Container Databases, click the display name of the container
database that you want to manage.
4. On the Autonomous Container Database details page, in the Maintenance section, click
the View link in the Next Maintenance field.
5. On the Maintenance page, any container database maintenance events planned for the
next 15 days will appear in the list of maintenance events.
To skip scheduled maintenance for a container database, click Skip.
6-91
Chapter 6
Using Performance Hub to Analyze Database Performance
Note:
You cannot skip scheduled maintenance more than twice, consecutively.
To reschedule maintenance, click Edit and enter a start time for the
update in the Edit Maintenance dialog. Ensure that your specified
container database maintenance window is later in the quarter than your
scheduled Exadata infrastructure maintenance.
Note:
Performance Hub supports only Autonomous Databases.
6-92
Chapter 6
Using Performance Hub to Analyze Database Performance
• Which specific modules may be causing a load on the system, and where most of
database time is being spent on this module.
• Which SQL statements are the key contributors to changes in database performance,
and which executions are causing them.
• Which user sessions are causing performance bottlenecks.
• Which sessions are currently blocking and if there are outstanding requests for a lock.
The time range field (#1 in the above illustration) shows database activity in chart form for the
specified Time Range period. The time range is the amount of time being monitored.
Use the Quick Select selector to set the time range. The menu includes five time choices,
Last Hour, Last 8 Hours, Last 24 Hours, Last Week, and Custom. The default time range is
Last Hour. To specify a custom time range, you can also click the Time Range field. This
opens the Custom Time Range dialog, allowing you to specify a custom range.
The Activity graph displays the average number of active sessions broken down by CPU,
User I/O, and Wait. Maximum threads are shown as a red line above the time field.
The sliding box (circled at right in the above illustration) on the time range chart is known as
the time slider. The time slider selects a section of the time range (#2 in the above illustration)
shown in the time range field. It shows the time being analyzed. In the illustration, the arrows
inside the time slider point to the vertical 'handle' elements on the left and right boundaries of
the slider box. The time slider works as follows:
• To change the start and end time of the analysis while keeping the same amount of time
between them, left click anywhere inside the box. Then slide the box left or right along the
time range without changing its size. The selected times are displayed below the time
graph.
• To increase or decrease the length of time being analyzed, left click either one of the
handles and drag it left or right to expand or contract the box.
• To refresh the data in Performance Hub according to the time range chosen, click
Refresh (upper right corner of the window).
6-93
Chapter 6
Using Performance Hub to Analyze Database Performance
Note:
The time slider provides an extra display feature in the Workload tab. See
the description in the Workload section of this page.
Use the Quick Select menu to set the time duration. The menu includes the
following five time choices: Last Hour, Last 8 Hours, Last 24 Hours, Last
Week, and Custom. The default Time Range is Last Hour. The time slider
selects the time period of the data displayed in Performance Hub. The time
slider has a different default time period based on the selected Time Range.
6-94
Chapter 6
Using Performance Hub to Analyze Database Performance
6-95
Chapter 6
Using Performance Hub to Analyze Database Performance
• The database name is displayed at the top of the Performance Hub page.
• The time period for which information is available on the Performance Hub is
displayed in the Time Range field. The selected time period is indicated on
the time slider graph by the adjustable time slider box.
The ASH Analytics tab is displayed with the top activity for a selected dimension
in the selected time period.
2. Use the Quick Select selector to set the exact time period for which data is
displayed in the ASH Analytics tables and graphs.
By default, the last hour is selected. The time range is the total amount of time
available for analysis.
3. Use the box on the time slider to further narrow down the time period for which
performance data is displayed on the ASH Analytics tab.
4. Select a dimension in the Average Active Sessions drop-down list to display
ASH analytics by that dimension.
When the Consumer Group dimension is selected, the data is categorized by
default to the High, Medium, or Low service name that is associated with the
Autonomous Database.
Optionally, you can:
• Click the Maximum Threads check box to view the number of Max CPU
Threads. The red line on the chart shows this limit.
• Click the Total Activity check box to view a black border that denotes total
activity of all the components of the selected dimension on the chart. This
option is selected by default when you use the filtering capabilities to only view
the data for a particular component within a dimension. For information on
filtering Average Active Sessions data, see Filter Average Active Sessions
Data.
5. For the dimension selected in the Average Active Sessions drop-down list, you
can further drill down into session details by selecting dimensions in the two
sections at the bottom of the ASH Analytics tab.
By default, the following dimensions are selected:
• SQL ID by Consumer Group, which displays the SQL statements with the top
average active sessions activity for consumer groups for the selected time
period. You can right-click the bar charts to sort the SQL statements in
ascending or descending order or click the SQL ID to go the SQL Details
page.
• User Session by Consumer Group, which displays the user sessions with the
top average active sessions activity for consumer groups for the selected time
period. You can right-click the bar charts to sort the user sessions in
ascending or descending order or click the user session to go to the User
Session page.
6-96
Chapter 6
Using Performance Hub to Analyze Database Performance
• The database name is displayed at the top of the Performance Hub page.
• The time period for which information is available on the Performance Hub is
displayed in the Time Range field. The selected time period is indicated on the time
slider graph by the adjustable time slider box.
The ASH Analytics tab is displayed with the top activity for a selected dimension in the
selected time period.
2. Use the Quick Select selector to set the exact time period for which data is displayed in
the ASH Analytics tables and graphs.
By default, the last hour is selected. The time range is the total amount of time available
for analysis.
3. Use the adjustable time slider box to further narrow down the time period for which
performance data is displayed on the ASH Analytics tab.
4. In the ASH Analytics tab, select a dimension in the Average Active Sessions by drop-
down list.
By default, Consumer Group is selected.
The chart is displayed. Each color in the chart denotes a component of the selected
dimension.For example, the Consumer Group dimension has High, Medium, and Low,
which are predefined service names assigned to your Autonomous Database to provide
different levels of concurrency and performance.
5. Click a component in the legend.
The selected component is displayed in the Applied Filters field and the chart is updated
to only display data pertaining to that component. The total activity, which includes all the
components of the dimension, is defined by a black outline and is displayed by default
when you filter data.
6-97
Chapter 6
Using Performance Hub to Analyze Database Performance
Note:
If you see an error message that says the server failed to get
performance details for the selected session at the selected time, try the
selection again. If the same error message is displayed, try a different
time selection. If that fails, contact Oracle Support.
6-98
Chapter 6
Using Performance Hub to Analyze Database Performance
• Killing a Session
• Displaying Lock Details
• Displaying Wait Event Information
• Displaying Session Details
• Displaying SQL Details
The minimum wait time works like a filter for the Blocking Sessions information. It sets the
minimum time that a session must wait before it is displayed in the tab. For example, if the
minimum wait time is set to three seconds, and a session has waited only two seconds, it is
not displayed in the table. But if you change the minimum wait time to one second, the
session that waited only two seconds is added to the display.
Note:
The minimum wait time default setting is three seconds.
Killing a Session
1. Click the check box at the left of the session User Name to select a session.
The Kill Session button is enabled.
2. Click Kill Session.
The Kill Session confirmation dialog box is displayed.
3. Click Kill Session to end the session.
1. In the session Lock column, click the name of the lock type (Lock or Exclusive Lock) for
the session.
The Wait Event Details message box is displayed.
2. Note the information in the table and use as needed to determine any action to take.
1. In the session Wait Event column, click the name of the wait event for the selected
session.
The Session Lock Information table is displayed.
2. Note the information in the message box and use as needed to determine any action to
take.
6-99
Chapter 6
Using Performance Hub to Analyze Database Performance
1. In the session User Session column, click the session identifier for the
session.The Performance Hub Session Details page is displayed.
2. Optionally, move the time slider to display a specific time range of the session.
3. Use the Session Details page to explore additional details about the session.
1. In the session SQL ID column, click the SQL ID associated with the session.
The Performance Hub SQL Details page is displayed.
2. Optionally, move the time slider to display a specific time range of the session.
3. Select one or more of the following tabs, note the information in them, and take
any action needed.
• Summary. This tab displays the SQL Overview and Source details.
• ASH Analytics. This tab displays the SQL average active sessions.
• Execution Statistics. This tab displays the SQL plans and plan details.
• SQL Monitoring. This tab displays information about monitored SQL
executions.
• SQL Text. This tab displays the SQL.
6-100
7
Reference Guides for Exadata Database
Service on Cloud@Customer
7-1
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
To get command-specific help, run dbaascli command --help. For example, dbaascli
database create --help.
7-2
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
sudo -s
exit
For more details on advanced supported options, see dbaascli cswlib showImages.
Example 7-1 dbaascli cswlib showImages
2.IMAGE_TAG=19.8.0.0.0-NC
VERSION=19.8.0.0.0
DESCRIPTION=19c JUL 2020 Non CDB Image
IMAGE_ALIASES=19000-NC19800,19000-NCJUL2020
3.IMAGE_TAG=19.9.0.0.0
VERSION=19.9.0.0.0
DESCRIPTION=19c OCT 2020 DB Image
IMAGE_ALIASES=19000-19900,19000-OCT2020
4.IMAGE_TAG=19.9.0.0.0-NC
VERSION=19.9.0.0.0
7-3
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Note:
You can specify the target version in dbaascli dbhome create command as
--version value from the dbaascli cswlib showImages command output.
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli cswlib showImages
To view the list of available Database and Grid Infrastructure images, use the
dbaascli cswlib showImages command.
Note:
You can create an Oracle Database home with a specified Oracle home
name. If you do not specify, then this is computed automatically
(recommended).
sudo -s
Where:
• --version specifies the Oracle Database version
• --imageTag specifies the Image Tag of the image to be used
For example:
7-4
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Note:
Specifying imageTag is optional. To view the Image Tags, refer to command
dbaascli cswlib showImages. Image Tags are typically same as the version of
the database. However, it is kept as a provision for cases where multiple
images may need to be released for the same version - each catering to a
specific customer requirement.
exit
For more details on advanced supported options, see dbaascli dbhome create.
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli dbhome create
To create an Oracle Database home of desired version, use the dbaascli dbhome
create command.
Note:
Databases created on a subset of nodes will not be displayed in the OCI
console.
• Create Oracle Database version 12.1.0.2 or higher with the release update JAN 2021 or
higher. For databases with lower versions, it is recommended to use the OCI Console
based API.
1. Connect to the virtual machine as the opc user.
For detailed instructions, see Connecting to a Virtual Machine with SSH.
2. Start a root user command shell:
sudo -s
7-5
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Where:
• --dbName specifies the name of the database
• --oracleHome specifies Oracle home location
To create a CDB, run the following command:
exit
For more details on advanced supported options, see dbaascli database create.
7-6
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
sudo -s
Where:
• --dbName specifies the name of the database
• --oracleHome specifies the Oracle home location
4. Exit the root user command shell:
exit
For more details on advanced supported options, see dbaascli database create.
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli database create
To create Oracle Database, use the dbaascli database create command. When
prompted, enter the sys and tde passwords.
Note:
• While using the --resume or --revert command options, ensure that you use
the same command from the same node that was used for actual create
operation flow.
• You can resume database creation only if there is a failure in the post database
creation step.
7-7
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli database create
To create Oracle Database, use the dbaascli database create command. When
prompted, enter the sys and tde passwords.
Note:
if you are enabling Data Guard for a database, then the SYS password and
the TDE wallet password of the primary and standby databases must all be
the same.
Note:
Using the dbaascli to change the SYS password will ensure the backup/
restore automation can parallelize channels across all nodes in the cluster.
7-8
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
2. Copy the blob file created to all the standby databases and update the file ownership to
oracle user.
3. Run the following command on all the standby databases:
Note:
You can create custom database software images for your Exadata Database
Service on Cloud@Customer instances using the Console or API. These images
are stored in Object Storage, and can be used to provision a Database Home in
your Exadata instance. See Oracle Database Software Images more information.
You can control the version of Oracle binaries that is installed when you provision a new
database on an Exadata Database Service on Cloud@Customer instance by maintaining the
software images on the system. Oracle provides a library of cloud software images that you
can view and download onto your instance by using the dbaascli utility.
• Listing Available Software Images and Versions for Database and Grid Infrastructure
To produce a list of available supported versions for patching, use the dbaascli cswlib
showImages command.
• To download a software image
You can download available software images onto your Exadata Database Service on
Cloud@Customer instance by using the cswlib download subcommand of the dbaascli
utility.
Listing Available Software Images and Versions for Database and Grid Infrastructure
To produce a list of available supported versions for patching, use the dbaascli cswlib
showImages command.
7-9
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
sudo -s
exit
############
List of Available Database Images
#############
17.IMAGE_TAG=18.17.0.0.0
VERSION=18.17.0.0.0
DESCRIPTION=18c JAN 2022 DB Image
18.IMAGE_TAG=19.10.0.0.0
VERSION=19.10.0.0.0
DESCRIPTION=19c JAN 2021 DB Image
19.IMAGE_TAG=19.11.0.0.0
VERSION=19.11.0.0.0
DESCRIPTION=19c APR 2021 DB Image
20.IMAGE_TAG=19.12.0.0.0
VERSION=19.12.0.0.0
DESCRIPTION=19c JUL 2021 DB Image
21.IMAGE_TAG=19.13.0.0.0
7-10
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
VERSION=19.13.0.0.0
DESCRIPTION=19c OCT 2021 DB Image
Images can be downloaded using their image tags. For details, see help using
'dbaascli cswlib download --help'.
dbaascli execution completed
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli cswlib showImages
To view the list of available Database and Grid Infrastructure images, use the dbaascli
cswlib showImages command.
$ sudo -s
#
The command displays the location of software images that are downloaded to your
Exadata Database Service on Cloud@Customer environment.
The optional parameters are:
• version: specifies an Oracle Database software version. For example, 19.14.0.0.0.
• imageTag: specifies the image tag of the image.
4. Exit the root-user command shell:
# exit
$
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
7-11
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
This will patch all databases running in the specified home, and the databases will
remain in the home after the patching is complete. The following apply to using the
dbHome patch command for in-place patching operations:
• You can patch all of your database nodes or a subset of nodes.
• Multi-node patching takes place in a rolling fashion.
• Optionally, you can perform a software-only patch operation. Then, when you are
ready, you can run datapatch to perform post-patch SQL actions.
7-12
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
sudo -s
Where:
• --oracleHome identifies the path of the Oracle home to be patched.
• --targetVersion specifies the target Oracle Database version to use for patching,
specified as five numeric segments separated by periods (e.g. 19.12.0.0.0).
For example:
exit
For more details on advanced supported options, see dbaascli dbHome patch.
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli dbHome patch
To patch Oracle home from one patch level to another, use the dbaascli dbHome patch
command.
After the database move operation is complete, the database runs using the Oracle Database
software version of the target Oracle Home.
To patch a database by moving it to a different Oracle Home:
1. Connect to the virtual machine as the opc user.
For detailed instructions, see Connecting to a Virtual Machine with SSH.
7-13
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
sudo -s
Where:
• --oracleHome identifies the path of the target Oracle home that uses the
desired Oracle Database software version. Note that the target Oracle home
must exist in your system prior to using the database move command.
• --dbname specifies the name of the database that is being moved.
For example:
exit
For more details on advanced supported options, see dbaascli database move.
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli database move
To perform out-of-place patching, use the dbaascli database move command.
sudo -s
Where --targetVersion identifies target software version that the Oracle Grid
Infrastructure will be patched to.
7-14
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
For example:
exit
For more details on advanced supported options, see dbaascli grid patch.
Once the patched software image creation is completed, the image can then be used for
performing the patching operation.
2. Perform the patching operation.
Listing Available Software Images and Versions for Database and Grid Infrastructure
To produce a list of available supported versions for patching, use the dbaascli cswlib
showImages command.
7-15
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
sudo -s
exit
############
List of Available Database Images
#############
17.IMAGE_TAG=18.17.0.0.0
VERSION=18.17.0.0.0
DESCRIPTION=18c JAN 2022 DB Image
18.IMAGE_TAG=19.10.0.0.0
VERSION=19.10.0.0.0
DESCRIPTION=19c JAN 2021 DB Image
19.IMAGE_TAG=19.11.0.0.0
VERSION=19.11.0.0.0
DESCRIPTION=19c APR 2021 DB Image
20.IMAGE_TAG=19.12.0.0.0
VERSION=19.12.0.0.0
DESCRIPTION=19c JUL 2021 DB Image
21.IMAGE_TAG=19.13.0.0.0
VERSION=19.13.0.0.0
7-16
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Images can be downloaded using their image tags. For details, see help using
'dbaascli cswlib download --help'.
dbaascli execution completed
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli cswlib showImages
To view the list of available Database and Grid Infrastructure images, use the dbaascli
cswlib showImages command.
sudo -s
Where:
• --oracleHome identifies the path of the Oracle home to be prechecked.
7-17
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
exit
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli dbHome patch
To patch Oracle home from one patch level to another, use the dbaascli dbHome
patch command.
sudo -s
Where:
• --oracleHome identifies the path of the target Oracle Home that uses the
desired Oracle Database software version. Note that the target Oracle Home
must exist in your system prior to using the database move command.
• --dbname specifies the name of the database that is being moved
4. Exit the root user command shell:
exit
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli database move
To perform out-of-place patching, use the dbaascli database move command.
7-18
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
sudo -s
Where --targetVersion identifies target software version that the Oracle Grid
Infrastructure will be patched to, specified as five numeric segments separated by
periods, for example, 19.12.0.0.0
4. Exit the root user command shell:
exit
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli grid patch
To patch Oracle Grid Infrastructure to the specified minor version, use the dbaascli grid
patch command.
7-19
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
sudo -s
exit
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli dbHome patch
To patch Oracle home from one patch level to another, use the dbaascli dbHome
patch command.
• dbaascli grid patch
To patch Oracle Grid Infrastructure to the specified minor version, use the
dbaascli grid patch command.
sudo -s
3. Run the original patching command to roll back (revert) a patching operation:
For example:
7-20
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Note:
• Resume and Rollback operations are supported for Oracle Home patching,
Oracle Grid Infrastructure patching, and database move operations.
• When resuming or rolling back a patching operation, you must run the
resume or rollback command from the same node that was used to run the
original patching command, and you must run the original command with
the addition of the --resume or --rollback flag.
exit
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli dbHome patch
To patch Oracle home from one patch level to another, use the dbaascli dbHome patch
command.
• dbaascli grid patch
To patch Oracle Grid Infrastructure to the specified minor version, use the dbaascli grid
patch command.
The cloud tooling is automatically updated by Oracle when new releases are made available.
If needed, you can follow the steps below to ensure you have the latest version of the cloud-
specific tooling on all of the virtual machines in the VM cluster.
Note:
You can update the cloud-specific tooling by downloading and applying a software
package containing the updated tools.
sudo -s
7-21
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
3. To update to the latest available cloud tooling release, run the following command:
The command takes care of updating the cloud tooling release on all the nodes of
the cluster.
For more details and other available options, refer to dbaascli admin
updateStack --help.
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
• dbaascli admin updateStack
To install or update a dbaastools RPM, use the dbaascli admin updateStack
command.
Release Notes
Review the changes made in various releases of dbaascli.
7-22
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
7-23
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
7-24
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
images. For details, see createAsCDB option in dbaascli database create –help.
• Non-CDB Database Creation:
– Enhanced database creation workflow to create a non-CDB database using standard
database software image. For details, see createAsCDB option in dbaascli database
create –help.
• Database Home Patching:
– New optimized workflow
• Grid Infrastructure Upgrade:
– New optimized workflow
• Pluggable Database (PDB) Operations:
– Deletion of PDB in Data Guard environments requires explicit acknowledgment to
indicate that operations necessary on standby site are completed, by passing of
additional argument –allStandByPrepared. For details, see dbaascli pdb delete
--help.
• Provided rolling capability for database bounce operation. For details, see dbaascli
database bounce –help.
• Various bug fixes and stability improvements
7-25
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Release 21.4.1.1.0
• Enabled encryption of the system level tablespaces (SYSTEM, SYSAUX, UNDO, and
TEMP) for databases that will get created with this version of dbaastools onwards.
This feature is enabled for Oracle Database version 19.6.0.0.0 and above.
• Grid Patching:
– Prerequisite condition added to check for following file ownership to be owned
by grid user.
* <gi_home>/suptools/tfa/release/tfa_home/jlib/jdev-rt.jar
* <gi_home>/suptools/tfa/release/tfa_home/jlib/jewt4.jar
• Database Patching:
– Simultaneous database move operation is disallowed by default. A new option
–allowParallelDBMove is introduced that can be used to override the default
behavior for Oracle Database releases 12.2 and above.
– Fixed issues related to move of standby databases being in MOUNT mode.
• Database Backup and Recovery:
– Added new command-line options for database backup. For more details, refer
to dbaascli database backup command reference.
– Added new command-line options for database recovery. For more details,
refer to dbaascli database recover command reference.
– bkup_api usage for backup and recovery operations will be deprecated in
future.
– To align with the Oracle recommended practice of using SYSBACKUP
administrative privilege for Backup and Recovery operations, cloud automation
7-26
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Release 21.3.1.2.0
• Improved the timing of dbaascli operations with enhanced Control Plane metadata
synchronization logic.
• Enhanced dbaascli logs to have millisecond-level information along with the associated
thread.
• Introduced more prerequisite checks in database home patching and database move
operations to catch potential failures scenarios with suggestions to corrective action.
• Database patching operations now retain the state of the databases to be same as it was
prior to patching. For pluggable databases, pdb saved state is honored.
• Various bug fixes and stability improvements.
Release 21.3.1.1.0
• Added support to unlock PDB Admin user account as part of PDB creation, localClone,
or remoteClone operation. For details, see option --lockPDBAdminAccount in dbaascli
pdb create --help.
• Fixed an issue that updates the database resource registered with Oracle Grid
Infrastructure in existing environments with the correct value of database name.
• Enhanced PDB lifecycle operations.
• Various bug fixes and stability improvements.
Release 21.3.1.0.1
• Support for the following dbaascli commands to be run as oracle user.
– dbaascli pdb bounce
– dbaascli pdb close
7-27
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Release 21.2.1.x.x
• Redesigned Oracle Grid Infrastructure patching operation and added ability to
resume from failed point, patch on subset of nodes, instance draining, and other
enhancements. For details, see dbaascli grid patch --help. Also refer to the
Patching Oracle Grid Infrastructure and Oracle Database Using dbaascli section.
• Deprecated the support for exadbcpatchmulti / dbaascli patch for patching
operations. dbaascli dbhome patch and dbaascli grid patch commands are
provided for patching operation for database homes and Oracle Grid
7-28
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Infrastructure. Refer to the Patching Oracle Grid Infrastructure and Oracle Database
Using dbaascli section for details. Also see, dbaascli Command Reference section.
• Deprecated the support for dbaascli tools patch command to bring consistency in the
command conventions. The new command is dbaascli admin updateStack.
• Redesigned PDB management APIs for create, local clone, and remote clone operations.
For details, see dbaascli pdb --help.
• Redesigned database delete API. For details, see dbaascli database delete --help.
• Revamped dbhome creation (support for custom software image, scale-out operation).
For details, see dbaascli dbhome create --help.
• Support for database creation on subset of cluster nodes. For details, see dbaascli
database create --help.
• Ability to run dbaascli in disconnected mode for long running operations. Executing
dbaascli command with --waitForCompletion false gets you a job ID that can be
queried later to get the status of the operation, using dbaascli job getStatus –jobid
job_id. This is useful for long running operations where users may want to get the
control back immediately after command execution. In this release, this option is
available only for dbaascli database create command. More commands will be added
in subsequent releases to have this support. The help output for those commands will
reflect the support of --waitForCompletion option.
• Enhanced dbhome patching experience with introduction of multiple options like
skipPDBs, continueWithDowntime, and so on. For details, see dbaascli dbhome patch
--help.
• Support for better diagnostic collection. For details, see dbaascli diag collect --help.
• Minor improvements in the area of database upgrade automation.
• Various bug fixes and stability improvements.
7-29
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
7-30
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
7-31
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
7-32
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
7-33
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisites
Run the command as the root user.
Syntax
Where:
• --resume resumes the previous execution
• --prechecksOnly runs only the prechecks for this operation
• --nodes specifies a comma-delimited list of nodes to install the RPM on. If you do
not pass this argument, then the RPM will be installed on all of the cluster nodes
• --force forces the installation of a lower RPM version
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisites
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
7-34
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Displays various command execution states as it progresses from scheduled, running, and
finally to success or failure.
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisites
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Exadata Database Service on Cloud@Customer is considered to be in a Disconnected
mode when there is a loss of connectivity with the DBaaS control plane running on Oracle
Cloud Infrastructure (OCI).
Where:
• --coreCount specifies the number of CPUs that you want to scale up or down per VM in
a cluster
• --message optionally, you can include a message for your reference
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
7-35
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --imageTag specifies Oracle home image tag
Example 7-5 dbaascli cswlib deletelocal
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisites
Run the command as the root user.
Syntax
Where:
• --version specifies an Oracle home image version
• --imageTag specifies the image tag of the image
7-36
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Syntax
Where:
• --product identifies Oracle home product type. Valid values: database or grid.
Example 7-8 dbaascli cswlib listlocal
7-37
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Syntax
Where:
• --product identifies Oracle home product type. Valid values: database or grid.
Example 7-9 dbaascli cswlib showImages
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
• Run the command as the root user.
Syntax
Where:
• --dbname specifies Oracle Database name
• --node specifies the node name for the database instance
– --newNodeSID specifies SID for the instance to add in the new node
7-38
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
• Run the command as the root user.
Syntax
Where:
--dbname: Oracle Database name.
--list | --start | --delete | --status | --getBackupReport | --configure | --
getConfig
--list: Returns database backup information.
[--json: Specify the file name for JSON output.]
--start: Begins database backup.
[--level0 | --level1 | --archival]
[--level0: Creates a Level-0 (full) backup. ]
[--level1: Creates a Level-1 (incremental) backup. ]
[--archival: Creates an Archival full backup. ]
--tag: Specify backup tag.
--delete: Deletes Archival backup.
--backupTag <value>
--status
--uuid <value>
--getBackupReport: Returns backup report.
--tag: Specify backup tag.
--json: Specify the file name for JSON output.
--configure: Configures database for backup.
--configFile | --enableRTRT | --disableRTRT
7-39
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Note:
enableRTRT and disableRTRT are applicable only for ZDLRA backup
destination on Exadata Database Service on Cloud@Customer.
• To set backup configuration for a database myTestDB by modifying the config file
with configuration details:
Prerequisites
Run the command as the oracle user.
Syntax
7-40
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Where:
• --dbname specifies the name of the database
• --rolling specifies true or false to bounce the database in a rolling manner. Default
value is false.
The command performs a database shutdown in immediate mode. The database is then
restarted and opened. In Oracle Database 12c or later, all of the PDBs are also opened.
Example 7-11 dbaascli database bounce
Prerequisites
Run the command as the root or oracle user.
Syntax
Where:
• --dbname specifies the name of the Oracle Database that you want to act on
• --user specifies the user name whose password change is required
• --prepareStandbyBlob specifies true to generate a blob file containing the artifacts
needed to change the password in a Data Guard environment. Valid values: true|false
• --blobLocation specifies the custom path where blob file will be generated
• --standbyBlobFromPrimary specifies the standby blob file, which is prepared from the
primary database
• --resume specifies to resume the previous execution
– --sessionID specifies to resume a specific session ID
7-41
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --dbname specifies the name of Oracle Database
• --cdbName specifies the name of the target CDB in which the PDB will be created.
If the CDB does not exist, then it will be created in the same Oracle home as the
source non-CDB
• --executePrereqs specifies to run only the pre-conversion checks
• --copyDatafiles specifies to create a new copy of the data files instead of using
the ones from the source database
• --backupPrepared flag to acknowledge that a proper database backup is in place
for the non-CDB prior to performing the conversion to PDB
• --targetPDBName specifies the name of the PDB that will be created as part of the
operation
• --waitForCompletion specifies false to run the operation in the background.
Valid values: true|false
• --resume specifies to resume the previous execution
– --sessionID specifies to resume a specific session ID
To run a full conversion with a copy of the data files from the non-CDB:
7-42
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Use this command to create Oracle Database version 12.1.0.2 or higher with the release
update JAN 2021 or higher. For databases with lower versions, it is recommended to use the
OCI Console based API.
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbname specifies the name of the database
• --oracleHome specifies the location of the Oracle home
• --oracleHomeName specifies the name of the Oracle home
• --dbSID specifies the SID of the database
• --dbNCharset specifies database national character set
• --tdeConfigMethod specifies TDE configuration method. Valid values: FILE, KMS
7-43
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
• --kmsKeyOCID specifies KMS key OCID to use for TDE. This is applicable only if
KMS is selected for TDE
• --nodeList specifies a comma-delimited list of nodes for the database
• --executePrereqs specifies yes to run only the prereqs for this operation. Valid
values: yes or no
• --skipPrereqs specifies yes to skip the prereqs for this operation. Valid values:
yes or no
• --dbLanguage specifies the database language
• --dbTerritory specifies the database territory
• --fraDestination specifies ASM disk group name to use for database Fast
Recovery Area
• --fraSizeInMB specifies the Fast Recovery Area size value in megabyte unit
• --resume resumes the previous execution
• --dbUniqueName specifies database unique name
• --revert rolls back the previous run
• --dbCharset specifies database character set
• --honorNodeNumberForInstance specifies true or false to indicate instance
name to be suffixed with the cluster node numbers. Default value: true
• --waitForCompletion specifies false to run the operation in the background.
Valid values: true or false
• --sgaSizeInMB specifies the sga_target value in megabyte unit
• --pdbName specifies the name of the PDB
• --pdbAdminUserName specifies the PDB admin user name
• --datafileDestination specifies the ASM disk group name to use for database
datafiles
• --pgaSizeInMB specifies the pga_aggregate_target value in megabyte unit
• --createAsCDB specifies true or false to create the database as CDB or non-
CDB
Example 7-14 dbaascli database create
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
7-44
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbname specifies the name of the database.
• --deleteArchiveLogs specifies true or false to indicate deletion of database archive
logs.
• --deleteBackups specifies true or false to indicate deletion of database backups.
• --precheckOnly specifies yes to run only the prechecks for this operation. Valid values:
yes or no.
• --waitForCompletion specifies false to run the operation in the background. Valid
values: true or false.
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
• Run the command as the root user.
7-45
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --dbname specifies Oracle Database name
• --node specifies the node name for database instance
• --continueOnUnreachableNode specifies to perform the operation even if the node
is unreachable
Example 7-16 database deleteinstance
7-46
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
• Run the command as the root user.
Syntax
Where:
• --dbName specifies Oracle Database name
• --sourceDBConnectionString specifies source database connection string in the format
of <scan_name>:<scan_port>/<database_service_name>
• --oracleHome specifies Oracle home location
• --oracleHomeName specifies Oracle home name
• --dbSID specifies database SID
• --dbUniqueName specifies database unique name
• --sgaSizeInMB specifies sga_target value in mega byte unit
• --pgaSizeInMB specifies pga_aggregate_target value in mega byte unit
• --datafileDestination specifies ASM disk group name to use for database datafiles
• --fraDestination specifies ASM disk group name to use for database fast recovery
area
• --fraSizeInMB specifies fast recovery area size value in mega byte unit
7-47
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --dbname specifies the name of the container database
7-48
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
Run the command as the root user.
Syntax
Where:
• --dbname specifies the name of the database.
• --setParameters specifies a comma-delimited list of parameters to modify with new
values. For example: parameter1=valueA,parameter2=valueB, and so on
• --resetParameters specifies a comma-delimited list of parameters to be reset to their
corresponding default values. For example, parameter1=valueA,parameter2=valueB, and
so on
• --responseFile specifies the absolute location of the response JSON file to modify the
database parameters
• --backupPrepared acknowledges that a proper database backup is in place prior to
modifying critical or sensitive parameters.
• --instance specifies the name of the instance on which the parameters will be
processed. If not specified, then the operation will be performed at the database level.
• --allowBounce grants permission to bounce the database in order to reflect the changes
on applicable static parameters.
Example 7-19 dbaascli database modifyParameters
Prerequisites
• Before performing a move operation, ensure that all of the database instances associated
with the database are up and running.
• Run the command as the root user.
7-49
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• database move moves the database from one home to another home
• --oracleHome specifies Oracle home path
• --oracleHomeName specifies the name of Oracle home
• --dbname specifies the name of the database
• --resume resumes the previous run
– --sessionID specifies to resume a specific session ID
• --skipPdbs skips running the datapatch on a specified comma-delimited list of
PDBs. For example: pdb1,pdb2...
• --continueWithDbDowntime continues patching with database downtime. This
option can be used in environments wherein there is only one active instance up
and the patching operation can be continued even with a downtime.
• --allowParallelDBMove allows database move in parallel.
• --rollback rolls back the patches applied
• --skipDatapatch skips datapatch execution on the databases
• --skipClosedPDBs skips running datapatch on closed PDBs
• --executePrereqs runs prereqs
Example 7-20 dbaascli database move
Prerequisite
• Run the command as the root user.
7-50
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
• Database must have been configured with backup storage destination details where
backups are stored.
Syntax
Where:
--dbname: Oracle Database name.
--start | --status
--start: Begins database recovery.
--untilTime | --untilSCN | --latest | --tag
--untilTime: Recovers database until time. Input format: DD-MON-YYYY
HH24:MI:SS.
--untilSCN: Recovers database until SCN.
--latest: Recovers database to last known state.
--tag: Recovers database to archival tag.
--status
--uuid <value>
Prerequisites
• Before performing a runDatapatch operation, ensure that all of the database instances
associated with the database are up and running.
• Run the command as the root user.
7-51
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --dbname specifies the name of the database
• --resume resumes the previous run
– --sessionID specifies to resume a specific session ID
• --skipPdbs skips running the datapatch on a specified comma-delimited list of
PDBs. For example: pdb1,pdb2...
• --pdbs runs the datapatch only on a specified comma-delimited list of PDBs. For
example: pdb1,pdb2...
• --executePrereqs runs prerequisite checks
• --patchList applies or rolls back the specified comma-delimited list of patches.
For example: patch1,patch2...
• --skipClosedPdbs skips running the datapatch on closed PDBs
• --rollback rolls back the patches applied
Prerequisites
Run the command as the root user.
Syntax
Where:
• --dbname specifies the name of the database
• --mode specifies mount or nomount to start database in the corresponding mode
7-52
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
The command starts and opens the database. In Oracle Database 12c or later, all of the
PDBs are also opened.
Example 7-22 dbaascli database start
Prerequisites
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbname specifies the name of the database that you want to stop
• --mode specifies the mode of the database. Valid values: abort, immediate, normal,
transactional
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
7-53
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --dbname (mandatory) specifies the name of the database.
• --targetHome specifies the target Oracle home location
• --targetHomeName specifies the name of the target Oracle Database home
• --standBy use this option to upgrade standby databases in Data Guard
configurations
• --allStandbyPrepared required for Data Guard configured primary databases.
Flags to acknowledge that all the required operations are performed on the
standby databases prior to upgrading primary database
• --removeGRP automatically removes the Guaranteed Restore Point (GRP) backup
only if the database upgrade was successful
• --increaseCompatibleParameter automatically increases the compatible
parameter as part of the database upgrade. The parameter will get increased only
if the database upgrade was successful
• --executePrereqs runs only the preupgrade checks
• --postUpgrade use this option if postupgrade fails and needs to rerun the
postupgrade steps
• --revert reverts an Oracle Database to its original Oracle home
• --upgradeOptions use this option to pass DBUA-specific arguments to perform
the Oracle Database upgrade. Refer to the corresponding Oracle documentation
for the supported arguments and options.
Example 7-24 dbaascli database upgrade pre-upgrade requisite checks
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
7-54
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --dbname specifies the Oracle Database name
• --blobLocation specifies the custom directory location where the standby blob file will
be generated in a Data Guard environment
Syntax
Where:
• --attributes contains the Data Guard automation attributes that are to be modified.
Accepts comma-delimited values in the format <attribute=value>. Attributes must be
predefined in the Data Guard configuration file.
Prerequisite
Run the command as the root user.
Syntax
Where:
7-55
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
Run the command as the root user.
Syntax
Where:
• --oracleHome specifies the location of the Oracle home
• --oracleHomeName specifies the name of the Oracle home
• --resume resumes the previous execution
– --sessionID specifies to resume a specific session ID
Syntax
7-56
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Where:
• --oracleHomeName specifies user-defined Oracle home name
• --oracleHome specifies the location (path) of Oracle home
Prerequisite
Run the command as the root user.
Syntax
Where:
• --oracleHomeName specifies user-defined Oracle home name
• --oracleHome specifies the location of Oracle home
Prerequisite
Run the command as the root user.
Syntax
7-57
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
[--nodes]
[--executePrereqs]
[--skipDatapatch]
[--imageFilePath]
[--skipPDBs]
[--skipClosedPDBs]
[--rollback]
Where:
• --oracleHome specifies the path of Oracle home
• --oracleHomeName specifies the name of Oracle home
• --targetVersion specifies the target version of Oracle Home specified as five
numeric segments separated by periods, for example, 19.12.0.0.0.
• --resume resumes the previous run
– --sessionID specifies to resume a specific session ID
• --continueWithDbDowntime continues patching with database downtime. This
option can be used in environments wherein there is only one active instance up
and the patching operation can be continued even with a downtime.
• --skipUnreachableNodes skips operation on unreachable nodes
• --nodes specifies a comma-delimited list of nodes if patching has to be performed
on a subset of nodes
• --executePrereqs runs prereqs
• --skipDatapatch skips running datapatch on the databases
• --imageFilePath specifies the absolute path of the image file to be used
• --skipPDBs skips running the datapatch on a specified comma-delimited list of
PDBs. For example: cdb1:pdb1,cdb2:pdb2, and so on
• --skipClosedPdbs skips running datapatch on closed PDBs
• --rollback rolls back patched Oracle home.
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
7-58
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --destLocation specifies the directory location on domU to collect logs.
Default: /var/opt/oracle/dbaas_acfs
• --nodes specifies a comma-delimited list of nodes to collect logs
• --components specifies a list of components for log collection. Valid values: db, gi, os,
dbaastools, all
• --objectStoreBucketURI specifies OSS PAR URL to upload log collections
• --startTime specifies the start time for log collection. Valid date and time format: YYYY-
MM-DDTHH24:MM:SS
• --dbNames specifies the database name for which to collect logs. You can specify only
one database name.
• --endTime specifies the end time for log collection. Valid date and time format: YYYY-MM-
DDTHH24:MM:SS
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
7-59
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Where:
• --destLocation specifies the directory location on domU to collect logs.
Default: /var/opt/oracle/dbaas_acfs
• --nodes specifies a comma-delimited list of nodes to collect logs
• --objectStoreBucketURI specifies OSS PAR URL to upload log collection
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the root user.
Syntax
Note:
By default, TCPS is enabled for databases on Oracle Exadata Database
Service on Dedicated Infrastructure systems.
Note:
TCPS is not enabled for databases on Exadata Database Service on
Cloud@Customer systems. To enable TCPS for a given database, update
the database specific sqlnet.ora file with WALLET_LOCATION =
(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/var/opt/oracle/
dbaas_acfs/grid/tcps_wallets))) on all database nodes and then bounce
the database. This will enable TCPS usage for the database. However,
enabling TCPS will cause ZDLRA connection to fail. On Exadata Database
Service on Cloud@Customer systems, you can enable either ZDLRA or
TCPS configuration. Enabling both ZDLRA and TCPS simultaneously will not
work.
7-60
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Where:
• --pkcs12WalletFilePath specifies the absolute path of the certificate file, which is in the
pkcs12 wallet format
• --caCertChain concatenated list of certs, containing intermediate CA's and root CA certs
• --precheckOnly specifies yes to run only the prechecks for this operation. Valid values:
yes or no.
• --serverCert specifies the path of PEM certificate to use or rotate for TCPS
configuration.
• --privateKey specifies the path of the private key file of the certificate.
• --certType type of the cert to be added to the Grid Infrastructure wallet. Accepted values
are: SELF_SIGNED_CERT, CA_SIGNED_CERT, or PKCS12_CERT. Default: SELF_SIGNED_CERT
• --privateKeyPasswordProtected specifies if the private key is password protected or
not. Valid values: true or false. Default: true.
Prerequisites
Run the command as the root user.
Syntax
7-61
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Where:
• --targetVersion specifies the target version of Oracle Home specified as five
numeric segments separated by periods (e.g. 19.12.0.0.0)
• --containerURL specifies custom URL for fetching Grid Infrastructure image
• --executePrereqs runs prereqs
• --nodeList specifies a comma-delimited list of nodes if patching has to be
performed on a subset of nodes
• --rollback specifies to roll back patched Oracle home
• --resume resumes the previous run
– --sessionID specifies to resume a specific session ID
• --continueWithDbDowntime continues patching with database downtime. This
option can be used in environments wherein there is only 1 active instance up and
the patching operation can be continued even with a downtime.
• --createImage creates an image from a copy of the active Grid home, patched to
the specified target version
– --createImageDir specifies fully qualified path of the directory where the
image is to be created
• --imageFile specifies fully qualified path of the image to be used
• --waitForCompletion specifies false to run the operation in background. Valid
values: true|false
Example 7-31 dbaascli grid patch
Prerequisite
Run the command as the root user.
Syntax
Where:
• --pkcs12WalletFilePath specifies the absolute path of the certificate file, which is
in the pkcs12 wallet format
7-62
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
• --caCertChain concatenated list of certs, containing intermediate CA's and root CA certs
• --precheckOnly specifies yes to run only the prechecks for this operation. Valid values:
yes or no.
• --serverCert specifies the path of PEM certificate to use or rotate for TCPS
configuration.
• --privateKey specifies the path of the private key file of the certificate.
• --certType type of the cert to be added to the Grid Infrastructure wallet. Accepted values
are: SELF_SIGNED_CERT, CA_SIGNED_CERT, or PKCS12_CERT. Default: SELF_SIGNED_CERT
• --privateKeyPasswordProtected specifies if the private key is password protected or
not. Valid values: true or false. Default: true.
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --version specifies the target version
• --resume resumes the previous run
• --executePrereqs runs prereqs for Grid Infrastrucure upgrade
7-63
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
• --containerUrl specifies the custom URL for fetching Grid Infrastrucure image
• --softwareOnly installs only the Grid Infrastructure software
• --targetHome specifies the path of existing target Grid home
• --revert reverts failed run
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --jodID specifies the job ID
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
7-64
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Note:
dbaascli patch db prereq and dbaascli patch db apply commands have been
deprecated in dbaascli release 21.2.1.2.0, and replaced with dbaascli grid
patch, dbaascli dbhome patch, and dbaascli database move commands.
For more information, see:
• dbaascli grid patch
• dbaascli dbhome patch
• dbaascli database move
• Patching Oracle Grid Infrastructure and Oracle Databases Using dbaascli
Related Topics
• dbaascli grid patch
To patch Oracle Grid Infrastructure to the specified minor version, use the dbaascli grid
patch command.
• dbaascli dbHome patch
To patch Oracle home from one patch level to another, use the dbaascli dbHome patch
command.
• dbaascli database move
To perform out-of-place patching, use the dbaascli database move command.
• Patching Oracle Grid Infrastructure and Oracle Databases Using dbaascli
Learn to use the dbaascli utility to perform patching operations for Oracle Grid
Infrastructure and Oracle Database on an Exadata Cloud@Customer system.
Note:
dbaascli patch db prereq and dbaascli patch db apply commands have been
deprecated in dbaascli release 21.2.1.2.0, and replaced with dbaascli grid
patch, dbaascli dbhome patch, and dbaascli database move commands.
For more information, see:
• dbaascli grid patch
• dbaascli dbhome patch
• dbaascli database move
• Patching Oracle Grid Infrastructure and Oracle Databases Using dbaascli
7-65
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Related Topics
• dbaascli grid patch
To patch Oracle Grid Infrastructure to the specified minor version, use the
dbaascli grid patch command.
• dbaascli dbHome patch
To patch Oracle home from one patch level to another, use the dbaascli dbHome
patch command.
• dbaascli database move
To perform out-of-place patching, use the dbaascli database move command.
• Patching Oracle Grid Infrastructure and Oracle Databases Using dbaascli
Learn to use the dbaascli utility to perform patching operations for Oracle Grid
Infrastructure and Oracle Database on an Exadata Cloud@Customer system.
Prerequisite
• Run the command as the root user.
• To use the utility, you must connect to an Exadata Cloud@Customer virtual
machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
--pdbName: PDB name.
--dbname: Oracle Database name.
--start | --delete | --status | --getBackupReport | --list
--start: Begins PDB backup.
[--level1 | --archival]
[--level1: Creates a Level-1 (incremental) backup.]
[--archival: Creates an archival full backup.]
--tag: Specify backup tag.
--delete: Deletes archival backup.
--backupTag: Specify backup tag to delete.
7-66
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
--status
--uuid <value>
--getBackupReport: Returns backup report.
--json: Specify the file name for JSON output.
--tag: Specify backup tag.
--list: Returns PDB backup information.
[--json: Specify the file name for JSON output.]
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the oracle user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbname specifies the name of the container database that hosts the PDB
• --pdbName specifies the name of the PDB
• --pdbUID specifies the identifier of the PDB
• --openMode specifies the target OPEN MODE of PDB
7-67
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Optional:
• --openMode READ_WRITE
• --openMode READ_ONLY
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the oracle user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbname specifies the name of the container database that hosts the PDB.
• --pdbname specifies the name of the PDB that you want to close.
• --pdbUID specifies the identifier of the PDB
Upon successful completion of running this command, the PDB is closed on all of the
container database instances.
Example 7-37 dbaascli pdb close
dbaascli pdb close --dbname cdb name --pdbName pdb name associated
with the CDB
dbaascli pdb close --dbname cdb name --pdbUID con_uid of that pdb
7-68
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the oracle user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbname specifies the name of the container database that hosts the PDB
• --pdbname specifies the name of the PDB for which you want to display connect string
information
• --pdbUID specifies the identifier of the PDB
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the oracle user.
Syntax
7-69
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Where:
• --pdbName specifies the name of the new PDB that you want to create
• --dbName specifies the name of the container database that hosts the new PDB
• --maxCPU optionally specifies the maximum number of CPUs that are available to
the PDB. Setting this option is effectively the same as setting the CPU_COUNT
parameter in the PDB
• --maxSize optionally specifies the maximum total size of data files and temporary
files for tablespaces belonging to the PDB. Setting this option is effectively the
same as setting the MAXSIZE PDB storage clause in the CREATE PLUGGABLE
DATABASE SQL command. You can impose a limit by specifying an integer followed
by a size unit (K, M, G, or T), or you can specify UNLIMITED to explicitly enforce no
limit
• --pdbAdminUserName specifies the new PDB admin user name
• --lockPDBAdminAccount specifies true or false to lock the PDB admin user
account. Default value is true.
• --resume resumes the previous run
– --sessionID specifies to resume a specific session ID
• --executePrereqs specifies yes to run only the prereqs for this operation. Valid
values: yes or no
• --waitForCompletion specifies false to run the operation in the background.
Valid values: true or false
• --standbyBlobFromPrimary specifies the location of the standby blob file, which is
prepared from the primary database. This is required only for standby database
PDB operations.
During the PDB creation process, you are prompted to specify the administration
password for the new PDB.
Example 7-39 dbaascli pdb create
To create a PDB from seed in a standard database in a non-Data Guard environment:
7-70
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
Run the command as the oracle user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbName specifies the name of the container database that hosts the PDB
• --pdbname specifies the name of the PDB that you want to delete
• --pdbUID specifies the name of the PDB that you want to delete
• --executePrereqs specifies yes to run only the prereqs for this operation. Valid values:
yes or no
• --waitForCompletion specifies false to run the operation in the background. Valid
values: true or false
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the oracle user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbname specifies the name of the container database that hosts the PDB
7-71
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
• --pdbname specifies the name of the PDB that you want to delete
• --pdbUID specifies the identifier of the PDB
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the oracle user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbname specifies the name of the container database that hosts the PDB
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
7-72
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
Run the command as the oracle user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbName specifies the name of the database
• --pdbName specifies the name of the new PDB that you want to clone
• --resume resumes the previous run
• --maxCPU specifies the maximum number of CPUs to be allocated for the PDB
• --waitForCompletion specifies false to run the operation in the background. Valid
values: true or false
• --primaryDBWalletTar specifies the primary database wallet tar file. This is required
only for standby database PDB operations
• --maxSize specifies the maximum storage size in GB for the new PDB
• --targetPDBName specifies the name for the target PDB (new cloned PDB)
• --executePrereqs specifies yes to run only the prereqs for this operation. Valid values:
yes or no
• --powerLimit specifies the degree of parallelism to be used for the clone operation. Valid
value is between 1 and 128
The newly cloned PDB inherits administration passwords from the source PDB.
Example 7-42 dbaascli pdb localClone
7-73
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Syntax
Where:
• --dbname specifies the name of the container database that hosts the PDB.
• --pdbName specifies the name of the PDB that you want to open
• --pdbUID specifies the identifier of the PDB
• --openMode specifies the target OPEN MODE of PDB
Upon successful completion, the PDB is opened on all of the container database
instances.
Example 7-43 dbaascli pdb open
dbaascli pdb open --dbname cdb name --pdbName pdb name associated with
the CDB
dbaascli pdb open --dbname cdb name --pdbUID con_uid of that pdb
Prerequisite
• Run the command as the root user.
• Database must be configured with backup storage destination details where
backups are stored.
Syntax
7-74
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
--untilTime <value>
| --untilSCN <value>
| --latest
| --tag <value>
}
| --status --uuid <value>
}
Where:
--pdbName: PDB name.
--dbname: Oracle Database name.
--start | --status
--start
--untilTime | --untilSCN | --latest | --tag
--untilTime: Recovers PDB until time. Input format: DD-MON-YYYY HH24:MI:SS.
--untilSCN: Recovers PDB until SCN.
--latest: Recovers PDB to last known state.
--tag: Recovers PDB to archival tag.
--status
--uuid <value>
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the oracle user. When prompted, you must supply the SYS user
password for the source database.
Syntax
7-75
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
[--powerLimit <value>]
[--waitForCompletion <value>]
[--sourcePDBReadOnlyServices <value>]
[--primaryDBWalletTar <value>]
[--executePrereqs <value>]
[--maxCpu <value>]
[--sourcePDBServices <value>]
[--targetPDBName <value>]
[--maxSize <value>]
Where:
• --dbName specifies the target database name
• --sourceDBConnectionString specifies the source database connection string in
the format <scan_name>:<scan_port>/<database_service_name>
• --pdbName specifies the source PDB name to relocate
• --resume specifies to resume the previous execution
– --sessionID specifies to resume a specific session ID
• --powerLimit specifies the degree of parallelism to be used for the relocate
operation
• --waitForCompletion specifies false to run the operation in the background. Valid
values: true|false
• --sourcePDBReadOnlyServices specifies a comma-delimited list of source PDB
read-only services
• --primaryDBWalletTar specifies the primary database wallet tar file. This is
required only for standby database PDB operations
• --executePrereqs specifies yes to run only the prereqs for this operation. Valid
values: yes|no
• --maxCpu specifies the maximum number of CPUs to be allocated for the PDB
• --sourcePDBServices specifies a list of comma-delimited source PDB services
• --targetPDBName specifies a name for the target PDB (new relocated PDB)
• --maxSize specifies the maximum storage size in GB for the new PDB
7-76
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --pdbName specifies the name of the source PDB that you want to clone
• --dbname specifies the name (DB_NAME) of the CDB that hosts the newly cloned PDB
• --sourceDBConnectionString specifies the source database connection string in the
format scan_name:scan_port/database_service_name
• --targetPDBName specifies the name for the target PDB (new cloned PDB)
• --powerLimit specifies the degree of parallelism to be used for the clone operation. Valid
value is between 1 and 128
• --maxCPU specifies the maximum number of CPUs to be allocated for the PDB
• --maxSize specifies the maximum storage size in GB for the new PDB
• --resume resumes the previous run
– --sessionID specifies to resume a specific session ID
• --executePrereqs specifies yes to run only the prereqs for this operation. Valid values:
yes or no
• --waitForCompletion specifies false to run the operation in the background. Valid
values: true or false
• --sourcePDBExportedTDEKeyFile specifies the source PDB exported key file. This
variable is applicable to only 12.1 database.
• --blobLocation specifies the custom path where the standby blob file will be generated
in a Data Guard environment
7-77
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Note:
The parameters --blobLocation and --standbyBlobFromPrimary are
mutually exclusive.
7-78
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
Run the command as the root or oracle user.
Syntax
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --secondaryKmsKeyOCID specifies the secondary KMS key to add to the existing HSM
(KMS) configuration
• --dbname specifies the name of the database
• --precheckOnly specifies yes to run only the prechecks for this operation. Valid values:
yes or no
7-79
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
frankfurt-1.bjqnwclvaafak.abtheljsgfxa2xe5prvlzdxtygoiqpm2pu2afgta54krx
wllk5uxainvvxza
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the root user.
Syntax
Where:
• --dbname specifies the name of the database
• --pdbName specifies the name of the PDB for which the TDE Keystore needs to be
changed
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
7-80
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Where:
• --dbrestart specifies the database restart option. Valid values are: rolling or full.
Default value: rolling
If you do not pass the dbrestart argument, then the database restarts in a rolling
manner.
• --dbname specifies the name of the Oracle Database.
• --precheckOnly runs only the precheck for this operation. Valid values are: yes or no
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --pdbName specifies the name of the PDB to encrypt all the tablespaces.
• --dbname specifies the name of the Oracle Database.
• --precheckOnly runs only the precheck for this operation. Valid values: yes or no
• --useSysdbaCredential uses SYSDBA credentials for this operation if passed value is
true. Valid values: true or false
7-81
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the root user.
Syntax
Where:
• --kmsKeyOCID specifies the KMS key OCID to use for TDE. This is applicable only
if KMS is selected for TDE
• --dbname specifies the name of the database
• --skipPatchCheck skips validation check for required patches if the value passed
for this argument is true. Valid values: true or false
• --executePrereqs specifies yes to run only the prechecks for this operation. Valid
values: yes or no
• --primarySuc specify this property in the standby database of the Data Guard
environment once the command is successfully run on the primary database
• --resume specifies to resume the previous run
7-82
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --dbname specifies the name of the database
• --infoFile specifies the file path where the list of OCIDs will be saved. The output is in
JSON format
Example 7-52 dbaascli tde getHsmKeys
7-83
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --kmsKeyVersionOCID specifies the KMS key version OCID to set
• --dbname specifies the name of the database
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
7-84
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --dbname specifies the name of the database
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
Syntax
Where:
• --dbname specifies the name of the database
• --primaryDBWalletTar specifies the primary database wallet tar file. This is required
only for standby database hsmToFile conversion
• --skipPatchCheck skips validation check for required patches if the value passed for this
argument is true. Valid values: true or false
• --executePrereqs specifies yes to run only the prechecks for this operation. Valid values:
yes or no
• --primarySuc specify this property in the standby database of the Data Guard
environment once the command is successfully run on the primary database
• --resume resumes the previous run
– --sessionID specifies to resume a specific session ID
7-85
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --file specifies the file path to save the results
• --dbname specifies the name of the database
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
7-86
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Prerequisite
Run the command as the root user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
Syntax
Where:
• --force if not specified, you will be prompted while deleting all of the existing HSM
(KMS) keys
• --secondaryKmsKeyOCID specifies the secondary KMS key to add to the existing HSM
(KMS) configuration
• --dbname specifies the name of the database
• --precheckOnly specifies yes to run only the prechecks for this operation. Valid values:
yes or no
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
7-87
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --kmsKeyVersionOCID specifies the KMS key version OCID to set.
• --dbname specifies the name of the database.
• --pdbName name of the PDB to use the key version OCID.
• --masterKeyID specifies the master key ID of the given key version OCID. This is
applicable to the Data Guard environment.
• --standbySuc specify this property in the primary database of the Data Guard
environment once the command is successfully run on the standby database
• --executePrereqs specifies yes to run only the prechecks for this operation. Valid
values: yes or no
• --waitForCompletion specify false to run the operation in background. Valid
values: true|false
7-88
Chapter 7
Using the dbaascli Utility with Exadata Database Service on Cloud@Customer
Syntax
Where:
• --primaryKmsKeyOCID specifies the primary KMS key to set
• --dbname specifies the name of the database
• --standbySuc specify this property in the primary database of the Data Guard
environment once the command is successfully run on the standby database
• --precheckOnly specifies yes to run only the prechecks for this operation. Valid values:
yes or no
• --bounceDatabase specify this flag to do rolling database bounce for this operation
Prerequisite
Run the command as the oracle user.
To use the utility, you must connect to an Exadata Cloud@Customer virtual machine.
See, Connecting to a Virtual Machine with SSH.
7-89
Chapter 7
Monitoring and Managing Exadata Storage Servers with ExaCLI
Syntax
Where:
• --dbname specifies the name of the database that you want to check.
Output from the command includes the type of keystore, and the status of the
keystore.
Example 7-60 dbaascli tde status
Related Topics
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
7-90
Chapter 7
Monitoring and Managing Exadata Storage Servers with ExaCLI
The password for cloud_user_clustername is initially set to a random value, which you can
view by running the following command as the opc user on any cluster node:
/opt/exacloud/get_cs_data.py
ExaCLI Command
Use ExaCLI (exacli) to configure cell, database node configuration, and objects in the
remote node environment, and to monitor your Exadata Database Service on
Cloud@Customer services and objects.
Purpose
ExaCLI (exacli) enables you configure your Exadata Database Service on Cloud@Customer
system, and to obtain real-time information about your Exadata Cloud Service. To obtain
information about the services and options on your system, run ExaCLI using the monitoring
command parameter that you require.
To obtain a list of the system monitoring parameters you can use with ExaCLI, run the LIST
parameter.
Syntax
exacli -c [username@]remotehost[:port]
[-l username]
[--xml]
[--cookie-jar filename]
[-e {command | 'command; command' | @batchfile}]
Options
Option Description
-c [username@]remotehost or --connect Specifies the remote node to which you want to
[username@]remotehost[:port] connect. ExaCLI prompts for the user name if not
specified.
-l username or --login-name username Specifies the user name to log into the remote
node. The preconfigured user is
cloud_user_clustername.
7-91
Chapter 7
Monitoring and Managing Exadata Storage Servers with ExaCLI
Option Description
--xml Displays the output in XML format.
--cookie-jar [filename] Specifies the filename of the cookie jar to use. If
you do not specify a filename, then the cookie is
stored in a default cookie jar located at
HOME/.exacli/cookiejar, where HOME is the
home directory of the operating system user
running the exacli command.
The presence of a valid cookie allows the ExaCLI
user to run commands without requiring the user
to log in during subsequent ExaCLI sessions.
-e command or -e 'command[; command]' or - Specifies either the ExaCLI commands to run, or a
e @batchFile batch file. After running the commands, ExaCLI
quits.
If you are specifying multiple commands to run,
then enclose the commands in single quotes to
prevent the shell from interpreting the semicolon.
To start an interactive ExaCLI session, omit this
command.
--cert-proxy proxy[:port] Specifies the proxy server that you want to use
when downloading certificates. If port is omitted,
then port 80 is used by default.
-n or --no-prompt Suppresses prompting for user input.
Command Parameters
To obtain information about objects and services on your system, use these ExaCLI
command parameters.
7-92
Chapter 7
Monitoring and Managing Exadata Storage Servers with ExaCLI
select object_name,
data_object_id from user_objects
where object_name = 'BIG_CENSUS';
OBJECT_NAME
DATA_OBJECT_ID
----------------------------------
------
BIG_CENSUS 29152
7-93
Chapter 7
Monitoring and Managing Exadata Storage Servers with ExaCLI
7-94
Chapter 7
Monitoring and Managing Exadata Storage Servers with ExaCLI
7-95
Chapter 7
Monitoring and Managing Exadata Storage Servers with ExaCLI
Usage Notes
• Notes for the --cookie-jar option:
– The user name and password are sent to the remote node for authentication.
On successful authentication, the remote node issues a cookie (the login
credentials) that is stored in the specified filename on the database node. If
filename is not specified, the cookie is stored in a default cookie jar located at
HOME/.exacli/cookiejar, where HOME is the home directory of the operating
system user running the ExaCLI command. For the opc user, the home is /
home/opc.
– The operating system user running the ExaCLI command is the owner of the
cookie jar file.
– A cookie jar can contain multiple cookies from multiple users on multiple
nodes in parallel sessions.
– Cookies are invalidated after 24 hours.
– If the cookie is not found or is no longer valid, ExaCLI prompts for the
password. The new cookie is stored in the cookie jar identified by filename, or
the default cookie jar if filename is not specified.
– Even without the --cookie-jar option, ExaCLI still checks for cookies from
the default cookie jar. However, if the cookie does not exist or is no longer
valid, the new cookie will not be stored in the default cookie jar if the --
cookie-jar option is not specified.
• Notes for the -e option:
– ExaCLI exits after running the commands.
7-96
Chapter 7
Monitoring and Managing Exadata Storage Servers with ExaCLI
Examples
Example 7-61 Starting an Interactive ExaCLI Session on a Storage Server
This example shows the user on an Exadata compute node issuing the command to log in to
ExaCLI start an interactive ExaCLI session on a storage server:
See "Finding the IP addresses of storage cells using the cellip.ora file" for information about
how to determine your storage server IP address.
After you are logged in, run additional commands as follows:
Related Topics
• Connecting to a Storage Server with ExaCLI
To use ExaCLI on storage servers, you will need to know your target storage server's IP
address.
7-97
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
The following example illustrates how to do so on the UNIX command line for a quarter
rack system. (Note that a quarter rack has three storage cells, and each cell has two
connections, so a total of six IP addresses are shown.)
cat /etc/oracle/cell/
network-config/cellip.oracle
cell="192.168.136.5;cell="192.168.136.6"
cell="192.168.136.7;cell="192.168.136.8"
cell="192.168.136.9;cell="192.168.136.10"
If you are connecting to a storage cell for the first time using ExaCLI, you may be
prompted to accept an SSL certificate. The ExaCLI output in this case will look like the
following:
Accept the self-signed Oracle certificate by pressing "y" to continue using ExaCLI.
7-98
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-99
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.createexadatainfrastructure.begin",
"source": "databaseservice",
"eventTypeVersion": "version",
"eventTime": "2019-08-29T21:16:04Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
7-100
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"resourceName": "my_exadata_infra",
"resourceId": "ExadataInfra-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
"lifecycleDetails": "detail message",
"shape": "ExadataCC.Base3.48",
"timeZone": "US/Pacific",
"displayName": "testDisplayName"
}
}
}
{
"eventType" :
"com.oraclecloud.databaseservice.exadatainfrastructureconnectstatus",
"cloudEventsVersion" : "0.1",
"eventTypeVersion" : "2.0",
"source" : "DatabaseService",
"eventTime" : "2020-06-02T06:07:40.141Z",
"contentType" : "application/json",
"data" : {
"compartmentId" :
"ocid1.compartment.oc1..aaaaaaaayrygl4guhplo5rtiumx3eh4mk7grrkrqspzaltmvbxecn
bvhkrga",
"compartmentName" : "DBaaSInteg20160918ExaccTest",
"resourceName" : "MVM_HR",
"resourceId" : "ocid1.exadatainfrastructure.oc1.ap-
hyderabad-1.abuhsljrp2vzzenmqmctqciwro6euhhsmlrewiiemiktov5xyfsu5hiufjsq",
"availabilityDomain" : "",
"additionalDetails" : {
"timeCreated" : "2020-05-28T00:23:18Z",
"timeUpdated" : "2020-06-02T06:07:40Z",
"lifecycleState" : "DISCONNECTED",
"lifecycleDetails" : "Exadata Infrastructure is not reachable. Please
lodge a Service Request (SR) with Oracle Support and provide Infrastructure-
id: ocid1.exadatainfrastructure.oc1.ap-
hyderabad-1.abuhsljrp2vzzenmqmctqciwro6euhhsmlrewiiemiktov5xyfsu5hiufjsq.",
"shape" : "ExadataCC.Half3.200",
"timeZone" : "UTC"
},
"definedTags" : {
"Oracle-Tags" : {
"CreatedBy" : "[email protected]",
"CreatedOn" : "2020-05-28T00:23:18.291Z"
}
}
7-101
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
},
"eventID" : "cde92d45-a06b-4b69-a125-6005dd8c2f0c",
"extensions" : {
"compartmentId" :
"ocid1.compartment.oc1..aaaaaaaayrygl4guhplo5rtiumx3eh4mk7grrkrqspzaltm
vbxecnbvhkrga"
}
}
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.createvmclusternetwork.begin",
"source": "databaseservice",
"eventTypeVersion": "version",
"eventTime": "2019-08-29T21:16:04Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
7-102
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_vmcluster_network",
"resourceId": "VmClusterNetwork-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExadataInfra-unique_ID",
"displayName": "testDisplayName"
}
}
}
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
7-103
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"com.oraclecloud.databaseservice.createvmclusternetwork.begin",
"source": "databaseservice",
"eventTypeVersion": "version",
"eventTime": "2019-08-29T21:16:04Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_vmcluster_network",
"resourceId": "VmClusterNetwork-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExadataInfra-unique_ID",
"displayName": "testDisplayName"
}
}
}
{
"cloudEventsVersion": "0.1",
"eventId": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType": "com.oraclecloud.databaseservice.createvmcluster.begin",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "Vmcluster-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-09-03T12:00:00.000Z",
"timeUpdated": "2019-09-03T12:30:00.000Z",
7-104
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExatraInfra-unique_ID",
"vmClusterNetworkId": "VmCluster-unique_ID",
"cpuCoreCount": 2,
"dataStorageSizeInTBs": 4,
"dbVersion": "19.0.0.0",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"giVersion": "19.0.0.0",
"dbNodeIds": "[ocid1.dbnode.1, ocid1.dbnode.2,...]",
"timeZone": "US/Pacific"
}
}
}
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType": "com.oraclecloud.databaseservice.createbackupdestination",
"source": "databaseservice",
"eventTypeVersion": "version",
"eventTime": "2019-08-29T21:16:04Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_backupdestination",
"resourceId": "BackupDestination-unique_ID",
"availabilityDomain": "all",
7-105
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"freeFormTags": {},
"definedTags": {}
}
}
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType": "com.oraclecloud.databaseservice.dbnodeaction.begin",
"source": "databaseservice",
"eventTypeVersion": "version",
"eventTime": "2019-06-27T21:16:04Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_dbnode",
"resourceId": "DbNode-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-26T12:00:00.000Z",
"timeUpdated": "2019-08-26T12:30:00.000Z",
"dbSystemId": "ocid1.dbsystem.oc1.phx.unique_ID",
"lifecycleDetails": "detail message",
"vmClusterId": "VmCluster-unique_ID",
"dbHostId": "dbHost-unique_ID",
"nodeNumber": 2,
"powerAction": "HardReset",
"hostName": "testHostName"
}
7-106
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
}
}
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType": "com.oraclecloud.databaseservice.createdbhome.begin",
"source": "databaseservice",
"eventTypeVersion": "version",
"eventTime": "2019-08-29T21:16:04Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_dbhome",
"resourceId": "DbHome-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
7-107
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType": "com.oraclecloud.databaseservice.restoredatabase.begin",
"source": "databaseservice",
"eventTypeVersion": "version",
"eventTime": "2019-06-27T21:16:04Z",
"contentType": "application/json",
"extensions": {
7-108
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "Database-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-26T12:00:00.000Z",
"timeUpdated": "2019-08-26T12:30:00.000Z",
"dbSystemId": "dbSystem-unique_ID",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"vmClusterId": "VmCluster-unique_ID",
"backupType": "FULL",
"dbHomeId": "dbHome-unique_ID",
"dbVersion": "19.0.0.0",
"databaseEdition": "ENTERPRISE_EDITION_EXTREME",
"autoBackupsEnabled": "true",
"recoveryWindow": 30,
"backupDestinationId": "backupDestination-unique_ID",
"backupDestinationType": "OBJECT_STORAGE",
"backupDestinationName": "my_backup_destination_name",
"exadataInfrastructureId": "ExadataInfrastructure-unique_ID",
"dbUniqueName": "akv_tgh_unqna"
}
}
}
7-109
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"cloudEventsVersion": "0.1",
"eventId": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.patchvmcluster.begin",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "Vmcluster-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-09-03T12:00:00.000Z",
"timeUpdated": "2019-09-03T12:30:00.000Z",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExatraInfra-unique_ID",
"vmClusterNetworkId": "VmCluster-unique_ID",
"cpuCoreCount": 2,
"dataStorageSizeInTBs": 4,
"dbVersion": "19.0.0.0",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"giVersion": "19.0.0.0",
"dbNodeIds": "[ocid1.dbnode.1, ocid1.dbnode.2,...]",
"timeZone": "US/Pacific"
}
}
}
7-110
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"cloudEventsVersion": "0.1",
"eventId": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType": "com.oraclecloud.databaseservice.patchdbhome.begin",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-08-29T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_dbhome",
"resourceId": "DbHome-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
"lifecycleDetails": "detail message",
"dbSystemId": "DbSystem-unique_ID",
"dbVersion": "19.0.0.0",
"recordVersion": 4,
"displayName": "testDisplayName"
}
}
}
{
"cloudEventsVersion": "0.1",
"eventId": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType": "com.oraclecloud.databaseservice.movedatabase.begin",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "Database-unique_ID",
"availabilityDomain": "all",
7-111
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-26T12:00:00.000Z",
"timeUpdated": "2019-08-26T12:30:00.000Z",
"dbSystemId": "ocid1.dbsystem.oc1.phx.unique_ID",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"vmClusterId": "VmCluster-unique_ID",
"dbSystemId": "dbSystem-unique_ID",
"backupType": "FULL",
"dbHomeId": "dbHome-unique_ID",
"dbVersion": "19.0.0.0",
"databaseEdition": "ENTERPRISE_EDITION_EXTREME",
"autoBackupsEnabled": "true",
"recoveryWindow": 30,
"backupDestinationId": "backupDestination-unique_ID",
"backupDestinationType": "OBJECT_STORAGE",
"backupDestinationName": "my_backup_destination_name",
"exadataInfrastructureId": "ExadataInfrastructure-unique-ID",
"dbUniqueName": "akv_tgh_unqna"
}
}
}
7-112
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.changeautonomousvmclustercompartment",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-06-27T21:16:04Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "AutonomousVmCluster-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-09-03T12:00:00.000Z",
"timeUpdated": "2019-09-03T12:30:00.000Z",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExatraInfra-unique_ID",
"vmClusterNetworkId": "VmClusterNetwork-unique_ID",
"cpuCoreCount": "2",
"availableCpus": "1",
"dataStorageSizeInTBs": "4",
"availableDataStorageSizeInTBs": "1",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"timeZone": "US/Pacific"
}
}
}
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.createautonomousvmcluster.begin",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-06-27T21:16:04Z",
"contentType": "application/json",
"extensions": {
7-113
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "AutonomousVmCluster-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-09-03T12:00:00.000Z",
"timeUpdated": "2019-09-03T12:30:00.000Z",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExatraInfra-unique_ID",
"vmClusterNetworkId": "VmClusterNetwork-unique_ID",
"cpuCoreCount": "2",
"availableCpus": "1",
"dataStorageSizeInTBs": "4",
"availableDataStorageSizeInTBs": "1",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"timeZone": "US/Pacific"
}
}
}
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.deleteautonomousvmcluster.begin",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-06-27T21:16:04Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "AutonomousVmCluster-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
7-114
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"timeCreated": "2019-09-03T12:00:00.000Z",
"timeUpdated": "2019-09-03T12:30:00.000Z",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExatraInfra-unique_ID",
"vmClusterNetworkId": "VmClusterNetwork-unique_ID",
"cpuCoreCount": "2",
"availableCpus": "1",
"dataStorageSizeInTBs": "4",
"availableDataStorageSizeInTBs": "1",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"timeZone": "US/Pacific"
}
}
}
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.updateautonomousvmcluster.begin",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-06-27T21:16:04Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "AutonomousVmCluster-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-09-03T12:00:00.000Z",
"timeUpdated": "2019-09-03T12:30:00.000Z",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExatraInfra-unique_ID",
"vmClusterNetworkId": "VmClusterNetwork-unique_ID",
"cpuCoreCount": "2",
"availableCpus": "1",
"dataStorageSizeInTBs": "4",
"availableDataStorageSizeInTBs": "1",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"timeZone": "US/Pacific"
}
7-115
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
}
}
7-116
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{lifecycleState=AVAILABLE,
autonomousVmClusterId=ocid1.autonomousvmcluster.oc1.sea.abzwkljrevsjcfuskw7mg
i6ulzfg2epjjxhbnhwj63q7q3kzvuwg3djqnd2a,
displayName=CDB2-NFS,
dbName=wqxtzzfn,
dbUniqueName=wqxtzzfn_sea1td,
freeTags={},
autonomousContainerDatabaseId=ocid1.autonomouscontainerdatabase.oc1.sea.abzwk
ljrxkuruqe3qzgw432adr5ug7ridmwi4ifvjlsahcdqdhbhzbf543xa,
compartmentId=ocid1.compartment.region1..aaaaaaaass5x4witduxzgrs7qmzqk3m5kmog
uve7urwploqef6763w3o42ta,
timeUpdated=2020-06-15 21:52:24.085,
tenantId=ocid1.tenancy.region1..aaaaaaaagyw5okosjg54csr3u5qgaxvtjufz55537h44m
jy2umiqur4z5w3a,
timeCreated=2020-06-15 19:08:03.797,
id=ocid1.autonomouscontainerdatabase.oc1.sea.abzwkljrxkuruqe3qzgw432adr5ug7ri
dmwi4ifvjlsahcdqdhbhzbf543xa,
definedTags={}}
7-117
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-118
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"eventId": "022a63a4-ff77-11e9-a0af-f45c89b1cb17",
"eventTime": "2019-11-05T02:50:21.000Z",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_id"
},
"eventType":
"com.oraclecloud.databaseservice.createdataguardassociation.begin",
"eventTypeVersion": "2.0",
"cloudEventsVersion": "0.1",
"source": "databaseservice",
"contentType": "application/json",
"definedTags": {},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_id",
"compartmentName": "example_name",
"resourceName": "my_container_database",
"resourceId": "ocid1.dataguard.oc1.phx.unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dataguard.oc1.phx.unique_id",
"timeCreated": "2019-06-27T21:15:59.000Z",
"timeUpdated": "2019-06-27T21:16:04.389Z",
"lifecycleState": "ACTIVE",
"lifecycleMessage": "",
"dbSystemId": "ocid1.vmcluster.oc1.phx.unique_id",
"DatabaseId": "ocid1.database.oc1.phx.unique_id",
"DbHomeId": "ocid1.dbhome.oc1.phx.unique_id",
"DGConfigId": "022a67c8-ff77-11e9-af6e-f45c89b1cb17",
"DGConfigState": "SUCCESS",
"LastSyncedTime": "2019-06-27T21:16:04.389Z",
"ApplyLag": "2 hours",
7-119
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"SyncState": "SYNCED",
"dcsDgUpdateTimestamp": "2019-06-27T21:16:04.389Z",
"lastUpdatedIdentifier": "022a6912-ff77-11e9-9e77-
f45c89b1cb17",
"displayName": "Data Guard Association - Create Begin",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"workloadType": "Transaction Processing"
}
}
}
{
"eventId": "022aa7cc-ff77-11e9-90cd-f45c89b1cb17",
"eventTime": "2019-11-05T02:50:21.000Z",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_id"
},
"eventType":
"com.oraclecloud.databaseservice.createdataguardassociation.end",
"eventTypeVersion": "2.0",
"cloudEventsVersion": "0.1",
"source": "databaseservice",
"contentType": "application/json",
"definedTags": {},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_id",
"compartmentName": "example_name",
"resourceName": "my_container_database",
"resourceId": "ocid1.dataguard.oc1.phx.unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dataguard.oc1.phx.unique_id",
"timeCreated": "2019-06-27T21:15:59.000Z",
"timeUpdated": "2019-06-27T21:16:04.389Z",
"lifecycleState": "ACTIVE",
"lifecycleMessage": "",
"dbSystemId": "ocid1.vmcluster.oc1.phx.unique_id",
"DatabaseId": "ocid1.database.oc1.phx.unique_id",
"DbHomeId": "ocid1.dbhome.oc1.phx.unique_id",
"DGConfigId": "022aab34-ff77-11e9-b89c-f45c89b1cb17",
"DGConfigState": "SUCCESS",
"LastSyncedTime": "2019-06-27T21:16:04.389Z",
"ApplyLag": "2 hours",
"SyncState": "SYNCED",
"dcsDgUpdateTimestamp": "2019-06-27T21:16:04.389Z",
"lastUpdatedIdentifier": "022aac10-ff77-11e9-8041-
f45c89b1cb17",
"displayName": "Data Guard Association - Create End",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"workloadType": "Transaction Processing"
7-120
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
}
}
}
{
"cloudEventsVersion": "0.1",
"eventID": "<unique_ID>",
"eventType":
"com.oraclecloud.DatabaseService.CreateAutonomousDataGuardAssociation.begin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "<unique_ID>",
"eventName"="CreateAutonomousDataGuardAssociation"
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
"compartmentName": "example_name",
"resourceVersion":null,
"resourceName": "my_container_database",
"resourceId": "<unique_ID>",
"availabilityDomain": "all",
7-121
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"tagSlug": "<slug_ID>",
"definedTags": {},
"additionalDetails": {
"lifecycleState": "PROVISIONING",
"DGConfigId"="91f298da-b890-42ce-935b-9b841e908756",
"ApplyLag"=null,
"LastRoleChangeTime"=null,
"TransportLag"=null,
"autonomousContainerDatabaseId"="ocid1.autonomouscontainerdatabase.oc1.
sea.<unique_ID>",
"DGConfigState"=null,
"lifeCycleMessage"=null,
"lastUpdatedIdentifier"=null,
"SyncState"=null,
"autonomousExadataInfrastructureId"="ocid1.autonomousvmcluster.oc1.sea.
<unique_ID>",
"timeUpdated"="2020-10-18 23:02:34.864",
"timeCreated"="2020-10-18 23:02:34.864",
"dbHomeId"="ocid1.autonomouspodhome.oc1.sea.<unique_ID>",
"LastSyncedTime"=null,
"dcsDgUpdateTimestamp"=null,
}
}
}
This is a reference event for Autonomous Data Guard Association - Switchover Begin:
{
"cloudEventsVersion": "0.1",
"eventID": "<unique_ID>",
"eventType":
"com.oraclecloud.DatabaseService.CreateAutonomousDataGuardAssociation.b
egin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "<unique_ID>",
"eventName"="SwitchoverAutonomousDataguardAssociation"
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
"compartmentName": "example_name",
"resourceVersion":null,
"resourceName": "my_container_database",
"resourceId": "ocid1.autonomousdgassociation.oc1.sea.<unique_ID>",
"availabilityDomain": "all",
"tagSlug": "<slug_ID>",
"definedTags": {},
"stateChange": {
"previous"=null,
"current: {
"lifecycleState"="ROLE_CHANGE_IN_PROGRESS
7-122
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
}
}
"additionalDetails": {
"lifecycleState": "ROLE_CHANGE_IN_PROGRESS",
"DGConfigId"="<unique_ID>",
"ApplyLag"="0 seconds computed 2 seconds ago",
"LastRoleChangeTime"=null,
"TransportLag"="0 seconds computed 2 seconds ago",
"autonomousContainerDatabaseId"="ocid1.autonomouscontainerdatabase.oc1.sea.<u
nique_ID>",
"DGConfigState"="SUCCESS",
"lifeCycleMessage"=null,
"lastUpdatedIdentifier"=null,
"SyncState"="SYNCED",
"autonomousExadataInfrastructureId"="ocid1.autonomousvmcluster.oc1.sea.<uniqu
e_ID>",
"timeUpdated"="2020-10-18 23:02:34.864",
"timeCreated"="2020-10-18 23:02:34.864",
"dbHomeId"="ocid1.autonomouspodhome.oc1.sea.<unique_ID>",
"LastSyncedTime"=null,
"dcsDgUpdateTimestamp"=null,
}
}
}
This is a reference event for Autonomous Data Guard Association - Failover Begin:
{
"cloudEventsVersion": "0.1",
"eventID": "<unique_ID>",
"eventType":
"com.oraclecloud.DatabaseService.CreateAutonomousDataGuardAssociation.begin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "<unique_ID>",
"eventName"="FailoverAutonomousDataguardAssociation"
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
"compartmentName": "example_name",
"resourceVersion":null,
"resourceName": "my_container_database",
"resourceId": "ocid1.autonomousdgassociation.oc1.sea.<unique_ID>",
"availabilityDomain": "all",
"tagSlug": "<slug_ID>",
"definedTags": {},
"stateChange": {
"previous"=null,
"current: {
"lifecycleState"="ROLE_CHANGE_IN_PROGRESS
}
7-123
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
}
"additionalDetails": {
"lifecycleState": "ROLE_CHANGE_IN_PROGRESS",
"DGConfigId"="<unique_ID>",
"ApplyLag"="0 seconds computed 2 seconds ago",
"LastRoleChangeTime"=null,
"TransportLag"="0 seconds computed 2 seconds ago",
"autonomousContainerDatabaseId"="ocid1.autonomouscontainerdatabase.oc1.
sea.<unique_ID>",
"DGConfigState"="SUCCESS",
"lifeCycleMessage"=null,
"lastUpdatedIdentifier"=null,
"SyncState"="SYNCED",
"autonomousExadataInfrastructureId"="ocid1.autonomousvmcluster.oc1.sea.
<unique_ID>",
"timeUpdated"="2020-10-18 23:02:34.864",
"timeCreated"="2020-10-18 23:02:34.864",
"dbHomeId"="ocid1.autonomouspodhome.oc1.sea.<unique_ID>",
"LastSyncedTime"=null,
"dcsDgUpdateTimestamp"=null,
}
}
}
This is a reference event for Autonomous Data Guard Association - Reinstate Begin:
{
"cloudEventsVersion": "0.1",
"eventID": "<unique_ID>",
"eventType":
"com.oraclecloud.DatabaseService.CreateAutonomousDataGuardAssociation.b
egin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "<unique_ID>",
"eventName"="ReinstateAutonomousDataGuardAssociation"
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
"compartmentName": "example_name",
"resourceVersion":null,
"resourceName": "my_container_database",
"resourceId": "ocid1.autonomousdgassociation.oc1.sea.<unique_ID>",
"availabilityDomain": "all",
"tagSlug": "<slug_ID>",
"definedTags": {},
"stateChange": {
"previous"=null,
"current: {
"lifecycleState"="ROLE_CHANGE_IN_PROGRESS
}
7-124
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
}
"additionalDetails": {
"lifecycleState": "ROLE_CHANGE_IN_PROGRESS",
"DGConfigId"="<unique_ID>",
"ApplyLag"="0 seconds computed 2 seconds ago",
"LastRoleChangeTime"=null,
"TransportLag"="0 seconds computed 2 seconds ago",
"autonomousContainerDatabaseId"="ocid1.autonomouscontainerdatabase.oc1.sea.<u
nique_ID>",
"DGConfigState"="SUCCESS",
"lifeCycleMessage"=null,
"lastUpdatedIdentifier"=null,
"SyncState"="SYNCED",
"autonomousExadataInfrastructureId"="ocid1.autonomousvmcluster.oc1.sea.<uniqu
e_ID>",
"timeUpdated"="2020-10-18 23:02:34.864",
"timeCreated"="2020-10-18 23:02:34.864",
"dbHomeId"="ocid1.autonomouspodhome.oc1.sea.<unique_ID>",
"LastSyncedTime"=null,
"dcsDgUpdateTimestamp"=null,
}
}
}
7-125
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType": "com.oraclecloud.databaseservice.createkeystore",
"source": "databaseservice",
"eventTypeVersion": "version",
"eventTime": "2020-10-27T21:16:04Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_keystore",
"resourceId": "KeyStore-unique_ID",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"timeUpdated"="2020-10-27 21:16:34.864",
"timeCreated"="2020-10-27 21:16:34.864",
"keyStoreType": "all",
"connectionIps": "ip1,ip2",
"adminUsername": "username",
}
}
}
7-126
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-127
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-128
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-129
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-130
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenancevm.begin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceVM",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeStarted": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
7-131
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenancevm.end",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceVM",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeEnded": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance
Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenanceschedule
d",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
7-132
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceScheduled",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenancereminder",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceReminder",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
7-133
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenance.begin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenance",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeStarted": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance
Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenance.end",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenance",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
7-134
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeEnded": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
}
}
This is a reference event for Exadata Infrastructure - Maintenance Custom action time Begin:
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinframtncustomactiontime.begin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfraMtnCustomActionTime",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeStarted": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detail message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
}
}
7-135
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
This is a reference event for Exadata Infrastructure - Maintenance Custom action time
End:
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinframtncustomactiontime.end",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfraMtnCustomActionTime",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeStarted": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance
Notifications",
"message": "detail message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b98",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenanceibswitch
.begin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceIBSwitch",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
7-136
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeStarted": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detail message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
}
}
This is a reference event for Exadata Infrastructure - maintenance Network Switches End:
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b98",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenanceibswitch.end",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceIBSwitch",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeStarted": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detail message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
}
}
7-137
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b55",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenancestorages
ervers.begin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceStorageServers",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeStarted": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance
Notifications",
"message": "detail message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b55",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenancestorages
ervers.end",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceStorageServers",
7-138
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeStarted": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detail message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenancereminder",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceReminder",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
"maintenanceSubType": "QUARTERLY"
7-139
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenancereminder
",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceReminder",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance
Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
"maintenanceSubType": "SECURITY_MONTHLY"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenance.begin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
7-140
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenance",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeStarted": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
"maintenanceSubType": "QUARTERLY"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenance.begin",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenance",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeStarted": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
7-141
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"displayName": "testDisplayName"
"maintenanceSubType": "SECURITY_MONTHLY"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenance.end",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenance",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeEnded": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance
Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
"maintenanceSubType": "QUARTERLY"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenance.end",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
7-142
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenance",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"timeEnded": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
"maintenanceSubType": "SECURITY_MONTHLY"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenancescheduled",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceScheduled",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance Notifications",
"message": "detailed message",
7-143
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
"maintenanceSubType": "QUARTERLY"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "b28fcda6-3d7b-4044-aa8e-7c21cde84b44",
"eventType":
"com.oraclecloud.databaseservice.exaccinfrastructuremaintenanceschedule
d",
"source": "databaseservice",
"eventTypeVersion": "2.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "4976b940-2c2d-4380-a669-1d70d071b187",
"eventName": "ExaccInfrastructureMaintenanceScheduled",
"compartmentId": "ocid1.compartment.oc1.......unique_id",
"compartmentName": "example_compartment",
"resourceName": "my_exacc_infrastructure",
"resourceId": "ocid1.exadatainfrastructure.oc1.....unique_id",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.dbmaintenancerun.oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeScheduled": "2019-08-29T12:30:00.000Z",
"description": "ExaCC Infrastructure Maintenance
Notifications",
"message": "detailed message",
"shape": "ExadataCC.Base3.48",
"displayName": "testDisplayName"
"maintenanceSubType": "SECURITY_MONTHLY"
}
}
}
7-144
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.addstoragecapacityexadatainfrastructure.begi
n",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-08-29T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_exadata_infra",
"resourceId": "ExadataInfra-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
"lifecycleDetails": "detail message",
"shape": "ExadataCC.X8",
"timeZone": "US/Pacific",
"displayName": "testDisplayName"
}
}
}
This is a reference event for Exadata Infrastructure - Add Storage Capacity End:
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
7-145
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"com.oraclecloud.databaseservice.addstoragecapacityexadatainfrastructur
e.end",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-08-29T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_exadata_infra",
"resourceId": "ExadataInfra-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
"lifecycleDetails": "detail message",
"shape": "ExadataCC.X8",
"timeZone": "US/Pacific",
"displayName": "testDisplayName"
}
}
}
7-146
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"eventType":
"com.oraclecloud.DatabaseService.CreateDatabaseSoftwareImage.begin",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "DatabaseService",
"eventId": "6dcad2c5-de0a-4e46-9a18-25c66f292dcf",
"eventTime": "2021-06-18T04:04:35.451Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "csid68e598ea4474b18860cdd476af4a/
b46a0a70da064d57a149c3c49b7cc588/FB22262C016611EFC401A9292187861D",
"eventName": "CreateDatabaseSoftwareImage",
"compartmentId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqinczgm2z5d
64cnl5q",
"compartmentName": "sic-dbaas",
"resourceName": "DBImage_19c",
"resourceId":
"ocid1.databasesoftwareimage.oc1.sea.abzwkljsbpu3kxb54loym5sgkn2z4briz4xbokho
uxywkir764ht4txx4nya",
"availabilityDomain": "AD2",
"freeformTags": null,
"definedTags": null,
"identity": {
"principalName": "xxxx",
"principalId":
"ocid1.user.region1..aaaaaaaaedlsln4welqy3upwitxqrss3fnu6potqmds4xo3xld5sqyzw
bveq",
"authType": "natv",
"callerName": null,
"callerId": null,
7-147
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"tenantId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqincz
gm2z5d64cnl5q",
"ipAddress": "160.34.124.111",
"credentials": ""
},
"request": {
"id": "csid68e598ea4474b18860cdd476af4a/
b46a0a70da064d57a149c3c49b7cc588/FB22262C016611EFC401A9292187861D",
"path": "/20160918/databaseSoftwareImages",
"action": "POST",
"parameters": {},
"headers": {}
},
"response": {
"status": "200",
"responseTime": "2021-06-18T04:04:36.457Z",
"headers": {},
"payload": null,
"message": "CreateDatabaseSoftwareImage succeeded"
},
"stateChange": {
"previous": null,
"current": {
"displayName": "DBImage_19c",
"lifecycleState": "PROVISIONING"
}
},
"additionalDetails": {
"dbVersion": "19.0.0.0",
"displayName": "DBImage_19c",
"lifecycleState": "PROVISIONING",
"timeCreated": "2021-06-18T04:04:35.739Z"
}
}
}
{
"eventType":
"com.oraclecloud.DatabaseService.CreateDatabaseSoftwareImage.end",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "DatabaseService",
"eventId": "7bf14762-1ec7-4230-99d0-6323c5e8b3cb",
"eventTime": "2021-06-18T04:26:24.119Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "csid68e598ea4474b18860cdd476af4a/
b46a0a70da064d57a149c3c49b7cc588/FB22262C016611EFC401A9292187861D",
"eventName": "CreateDatabaseSoftwareImage",
"compartmentId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqincz
7-148
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
gm2z5d64cnl5q",
"compartmentName": "sic-dbaas",
"resourceName": "DBImage_19c",
"resourceId":
"ocid1.databasesoftwareimage.oc1.sea.abzwkljsbpu3kxb54loym5sgkn2z4briz4xbokho
uxywkir764ht4txx4nya",
"availabilityDomain": null,
"freeformTags": null,
"definedTags": null,
"identity": {
"principalName": null,
"principalId": null,
"authType": null,
"callerName": null,
"callerId": null,
"tenantId": null,
"ipAddress": null,
"credentials": null,
"userAgent": null,
"consoleSessionId": null
},
"request": {
"id": "d2030b31-16aa-4e71-9b06-dabc7545ad65",
"path": null,
"action": null,
"parameters": null,
"headers": null
},
"response": {
"status": null,
"responseTime": "2021-06-18T04:26:24.119Z",
"headers": null,
"payload": null,
"message": "CreateDatabaseSoftwareImage"
},
"stateChange": {
"previous": null,
"current": {
"displayName": "DBImage_19c",
"lifecycleState": "AVAILABLE"
}
},
"additionalDetails": {
"dbVersion": "19.0.0.0",
"displayName": "DBImage_19c",
"lifecycleState": "AVAILABLE",
"timeCreated": "2021-06-18T04:04:35.739Z"
}
}
}
7-149
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"eventType":
"com.oraclecloud.DatabaseService.DeleteDatabaseSoftwareImage.begin",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "DatabaseService",
"eventId": "b789f327-ad93-45e1-a739-45fdb97c24d2",
"eventTime": "2021-06-25T05:06:25.316Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "csidd793a61a40689138814477fa5c6e/
ffe9b65c8dcf425c9b30ae1a30ae5687/B7CA65C1DDBEDB55052051EF1113DB73",
"eventName": "DeleteDatabaseSoftwareImage",
"compartmentId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqincz
gm2z5d64cnl5q",
"compartmentName": "sic-dbaas",
"resourceName": "DBImage_202106152041",
"resourceId":
"ocid1.databasesoftwareimage.oc1.sea.abzwkljrzqt4tr326jtdmyudcziz6h5uhc
e36jbndxojgeg5kpwjcipxelga",
"availabilityDomain": "AD2",
"freeformTags": null,
"definedTags": null,
"identity": {
"principalName": "xxx",
"principalId":
"ocid1.user.region1..aaaaaaaaedlsln4welqy3upwitxqrss3fnu6potqmds4xo3xld
5sqyzwbveq",
"authType": "natv",
"callerName": null,
"callerId": null,
"tenantId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqincz
gm2z5d64cnl5q",
"ipAddress": "160.34.124.245",
"credentials": ""
},
"request": {
"id": "csidd793a61a40689138814477fa5c6e/
ffe9b65c8dcf425c9b30ae1a30ae5687/B7CA65C1DDBEDB55052051EF1113DB73",
"path": "/20160918/databaseSoftwareImages/
ocid1.databasesoftwareimage.oc1.sea.abzwkljrzqt4tr326jtdmyudcziz6h5uhce
36jbndxojgeg5kpwjcipxelga",
"action": "DELETE",
"parameters": {},
"headers": {}
},
"response": {
"status": "204",
"responseTime": "2021-06-25T05:06:26.074Z",
"headers": {},
"payload": null,
7-150
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"eventType":
"com.oraclecloud.DatabaseService.DeleteDatabaseSoftwareImage.end",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "DatabaseService",
"eventId": "6a1a808f-f5dd-4fb5-9d77-3bad38591998",
"eventTime": "2021-06-25T05:07:21.454Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "csidd793a61a40689138814477fa5c6e/
ffe9b65c8dcf425c9b30ae1a30ae5687/B7CA65C1DDBEDB55052051EF1113DB73",
"eventName": "DeleteDatabaseSoftwareImage",
"compartmentId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqinczgm2z5d
64cnl5q",
"compartmentName": "sic-dbaas",
"resourceName": "DBImage_202106152041",
"resourceId":
"ocid1.databasesoftwareimage.oc1.sea.abzwkljrzqt4tr326jtdmyudcziz6h5uhce36jbn
dxojgeg5kpwjcipxelga",
"availabilityDomain": null,
"freeformTags": null,
"definedTags": null,
"identity": {
"principalName": null,
"principalId": null,
"authType": null,
"callerName": null,
"callerId": null,
"tenantId": null,
"ipAddress": null,
"credentials": null,
"userAgent": null,
7-151
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"consoleSessionId": null
},
"request": {
"id": "676465d5-e066-43e4-bb21-77dc468ce1f9",
"path": null,
"action": null,
"parameters": null,
"headers": null
},
"response": {
"status": null,
"responseTime": "2021-06-25T05:07:21.454Z",
"headers": null,
"payload": null,
"message": "DeleteDatabaseSoftwareImage"
},
"stateChange": {
"previous": null,
"current": {
"displayName": "DBImage_202106152041",
"lifecycleState": "TERMINATED"
}
},
"additionalDetails": {
"dbVersion": "19.0.0.0",
"displayName": "DBImage_202106152041",
"lifecycleState": "TERMINATED",
"timeCreated": "2021-06-15T15:11:53.672Z"
}
}
}
{
"eventType":
"com.oraclecloud.DatabaseService.ListDatabaseSoftwareImages",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "DatabaseService",
"eventId": "762072e3-52a0-437c-9956-334aad767db8",
"eventTime": "2021-06-24T05:39:41.344Z",
"contentType": "application/json",
"data": {
"eventGroupingId": null,
"eventName": "ListDatabaseSoftwareImages",
"compartmentId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqincz
gm2z5d64cnl5q",
"compartmentName": "sic-dbaas",
"resourceName": "",
"resourceId": null,
"availabilityDomain": "AD2",
"freeformTags": null,
7-152
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"definedTags": null,
"identity": {
"principalName": "xxx",
"principalId":
"ocid1.user.region1..aaaaaaaaedlsln4welqy3upwitxqrss3fnu6potqmds4xo3xld5sqyzw
bveq",
"authType": "natv",
"callerName": null,
"callerId": null,
"tenantId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqinczgm2z5d
64cnl5q",
"ipAddress": "160.34.125.213",
"credentials": "",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)
AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.77 Safari/537.36",
"consoleSessionId": "csidc25d57894f49986ae07157ab5e03"
},
"request": {
"id": "csidc25d57894f49986ae07157ab5e03/
dc74ad5a75d7494bb35408a33a99c0ad/084F718D53FBC66D46B573CF8D5D1A5A",
"path": "/20160918/databaseSoftwareImages",
"action": "GET",
"parameters": {},
"headers": {}
},
"response": {
"status": "200",
"responseTime": "2021-06-24T05:39:41.998Z",
"headers": {},
"payload": null,
"message": "ListDatabaseSoftwareImages succeeded"
},
"stateChange": {
"previous": null,
"current": null
},
"additionalDetails": null
}
}
{
"eventType": "com.oraclecloud.DatabaseService.GetDatabaseSoftwareImage",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "DatabaseService",
"eventId": "179471f3-c628-4e55-98d0-959b0913b327",
"eventTime": "2021-06-24T04:11:10.738Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "csid31b4236f4f1ebc4ee66169d17b0a/
1f2e5dbf57ca40c886b111616b02c33f/CA5B5AD4C8678E2C428DA9AF0C62A082",
7-153
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"eventName": "GetDatabaseSoftwareImage",
"compartmentId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqincz
gm2z5d64cnl5q",
"compartmentName": "sic-dbaas",
"resourceName": "DBImage_19c",
"resourceId":
"ocid1.databasesoftwareimage.oc1.sea.abzwkljsbpu3kxb54loym5sgkn2z4briz4
xbokhouxywkir764ht4txx4nya",
"availabilityDomain": "AD2",
"freeformTags": null,
"definedTags": null,
"identity": {
"principalName": "xxx",
"principalId":
"ocid1.user.region1..aaaaaaaalkib75hbawg6xh6rlys5ztumfx3cxf2ktwbon5ryv6
xjev7oectq",
"authType": "natv",
"callerName": null,
"callerId": null,
"tenantId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqincz
gm2z5d64cnl5q",
"ipAddress": "192.188.170.109",
"credentials": "",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)
AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.106 Safari/
537.36",
"consoleSessionId": "csid31b4236f4f1ebc4ee66169d17b0a"
},
"request": {
"id": "csid31b4236f4f1ebc4ee66169d17b0a/
1f2e5dbf57ca40c886b111616b02c33f/CA5B5AD4C8678E2C428DA9AF0C62A082",
"path": "/20160918/databaseSoftwareImages/
ocid1.databasesoftwareimage.oc1.sea.abzwkljsbpu3kxb54loym5sgkn2z4briz4x
bokhouxywkir764ht4txx4nya",
"action": "GET",
"parameters": {},
"headers": {}
},
"response": {
"status": "200",
"responseTime": "2021-06-24T04:11:10.966Z",
"headers": {},
"payload": null,
"message": "GetDatabaseSoftwareImage succeeded"
},
"stateChange": {
"previous": null,
"current": {
"displayName": "DBImage_19c",
"lifecycleState": "AVAILABLE"
}
},
"additionalDetails": {
7-154
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"dbVersion": "19.0.0.0",
"displayName": "DBImage_19c",
"lifecycleState": "AVAILABLE",
"timeCreated": "2020-09-24T18:06:00.395Z"
}
}
}
eventType": "com.oraclecloud.DatabaseService.MoveDatabase.begin"
"eventName": "MoveDatabase"
{
"eventType": "com.oraclecloud.DatabaseService.MoveDatabase.begin",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "DatabaseService",
"eventId": "c78fb931-adda-4813-ab75-b9cc51b96847",
"eventTime": "2021-07-15T11:03:52.582Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "csidff49902144a1a3c98bd4e5f49c1c/
37d3a7113f1e462fbd5a741dc5d52ef7/57472323A2FFABC31623FB7660F519AB",
"eventName": "MoveDatabase",
"compartmentId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqinczgm2z5d
64cnl5q",
"compartmentName": "sic-dbaas",
"resourceName": "DB211507",
"resourceId":
"ocid1.database.oc1.sea.abzwkljs5xinda6nughtf5tzapxhcq7at54bpsmdricyq4o4trsr3
pyiqhpq",
"availabilityDomain": "",
"freeformTags": {},
7-155
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"definedTags": {
"Operators": {
"Created_By": "[email protected]",
"Created_Time": "2021-07-15T11:01:24.085Z"
}
},
"identity": {
"principalName": null,
"principalId": null,
"authType": null,
"callerName": null,
"callerId": null,
"tenantId": null,
"ipAddress": null,
"credentials": null,
"userAgent": null,
"consoleSessionId": null
},
"request": {
"id": "8f7b5283-4896-4ce0-aefa-a4156971e07b",
"path": null,
"action": null,
"parameters": null,
"headers": null
},
"response": {
"status": null,
"responseTime": null,
"headers": null,
"payload": null,
"message": "MoveDatabase"
},
"stateChange": {
"previous": null,
"current": {
"definedTags": {
"Operators": {
"Created_By": "[email protected]",
"Created_Time": "2021-07-15T11:01:24.085Z"
}
},
"displayName": "DB211507",
"freeTags": {},
"lifecycleState": "UPGRADING"
}
},
"additionalDetails": {
"databaseEdition": "ENTERPRISE_EDITION_EXTREME",
"databaseId":
"ocid1.database.oc1.sea.abzwkljs5xinda6nughtf5tzapxhcq7at54bpsmdricyq4o
4trsr3pyiqhpq",
"dbHomeId":
"ocid1.dbhome.oc1.sea.abzwkljskjhqcc4bkzuai6kybx3hp3jznvxcgwlghqjnklpch
rktcynwnloq",
"dbUniqueName": "Audit_check",
7-156
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"dbVersion": "18.14.0.0",
"exadataInfrastructureId":
"ocid1.exadatainfrastructure.oc1.sea.abzwkljsqtwpumvorlttjuxcx6qtkxhuasvmyu4q
y3bng74sqolpwjunsrqa",
"lifecycleState": "UPGRADING",
"timeCreated": "2021-07-15T11:01:24Z",
"timeUpdated": "2021-07-15T11:02:34Z",
"vmClusterId":
"ocid1.vmcluster.oc1.sea.abzwkljsghfg7e3q3xh3gzqqxijt72fepczowmk35t554wxbpew7
txnooprq"
}
}
}
eventType": "com.oraclecloud.DatabaseService.MoveDatabase.end"
"eventName": "MoveDatabase"
{
"eventType": "com.oraclecloud.DatabaseService.MoveDatabase.end",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "DatabaseService",
"eventId": "97429610-9b8f-4da7-8f99-2f7cd5455c24",
"eventTime": "2021-07-15T11:03:56.359Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "csidff49902144a1a3c98bd4e5f49c1c/
37d3a7113f1e462fbd5a741dc5d52ef7/57472323A2FFABC31623FB7660F519AB",
"eventName": "MoveDatabase",
"compartmentId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqinczgm2z5d
64cnl5q",
"compartmentName": "sic-dbaas",
"resourceName": "DB211507",
"resourceId":
"ocid1.database.oc1.sea.abzwkljs5xinda6nughtf5tzapxhcq7at54bpsmdricyq4o4trsr3
pyiqhpq",
"availabilityDomain": "",
"freeformTags": {},
"definedTags": {
"Operators": {
"Created_By": "[email protected]",
"Created_Time": "2021-07-15T11:01:24.085Z"
}
},
"identity": {
"principalName": null,
"principalId": null,
"authType": null,
"callerName": null,
"callerId": null,
"tenantId": null,
7-157
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"ipAddress": null,
"credentials": null,
"userAgent": null,
"consoleSessionId": null
},
"request": {
"id": "8f7b5283-4896-4ce0-aefa-a4156971e07b",
"path": null,
"action": null,
"parameters": null,
"headers": null
},
"response": {
"status": null,
"responseTime": null,
"headers": null,
"payload": null,
"message": "MoveDatabase"
},
"stateChange": {
"previous": null,
"current": {
"definedTags": {
"Operators": {
"Created_By": "[email protected]",
"Created_Time": "2021-07-15T11:01:24.085Z"
}
},
"displayName": "DB211507",
"freeTags": {},
"lifecycleState": "AVAILABLE"
}
},
"additionalDetails": {
"databaseEdition": "ENTERPRISE_EDITION_EXTREME",
"databaseId":
"ocid1.database.oc1.sea.abzwkljs5xinda6nughtf5tzapxhcq7at54bpsmdricyq4o
4trsr3pyiqhpq",
"dbHomeId":
"ocid1.dbhome.oc1.sea.abzwkljs7obwmwq2kgkjgeko4voudfcd5chu6iuonnew7uuxc
ulsvdralzda",
"dbUniqueName": "Audit_check",
"dbVersion": "19.10.0.0",
"exadataInfrastructureId":
"ocid1.exadatainfrastructure.oc1.sea.abzwkljsqtwpumvorlttjuxcx6qtkxhuas
vmyu4qy3bng74sqolpwjunsrqa",
"lifecycleState": "AVAILABLE",
"timeCreated": "2021-07-15T11:01:24Z",
"timeUpdated": "2021-07-15T11:03:56Z",
"vmClusterId":
"ocid1.vmcluster.oc1.sea.abzwkljsghfg7e3q3xh3gzqqxijt72fepczowmk35t554w
xbpew7txnooprq"
}
}
}
7-158
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"eventType": "com.oraclecloud.DatabaseService.UpgradeDatabase.begin",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "DatabaseService",
"eventId": "96c66a03-fa53-4008-b86c-619b9f44ef31",
"eventTime": "2021-07-15T11:02:33.948Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "csidff49902144a1a3c98bd4e5f49c1c/
37d3a7113f1e462fbd5a741dc5d52ef7/57472323A2FFABC31623FB7660F519AB",
"eventName": "UpgradeDatabase",
"compartmentId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqinczgm2z5d
64cnl5q",
"compartmentName": "sic-dbaas",
"resourceName": "DB211507",
"resourceId":
"ocid1.database.oc1.sea.abzwkljs5xinda6nughtf5tzapxhcq7at54bpsmdricyq4o4trsr3
pyiqhpq",
"availabilityDomain": "",
"freeformTags": {},
"definedTags": {
"Operators": {
"Created_By": "[email protected]",
"Created_Time": "2021-07-15T11:01:24.085Z"
}
},
"identity": {
"principalName": "[email protected]",
"principalId":
"ocid1.user.region1..aaaaaaaac5dskxmhmemrbyhaeabru4kgpituqmvgxjcm5y22mlxre26o
m4zq",
"authType": "natv",
"callerName": null,
"callerId": null,
"tenantId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqinczgm2z5d
64cnl5q",
"ipAddress": "160.34.92.141",
"credentials":
"ST$eyJraWQiOiJhc3dfcmVnaW9uMV8yMDIxLTA1LTE0IiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOi
JvY2lkMS51c2VyLnJlZ2lvbjEuLmFhYWFhYWFhYzVkc2t4bWhtZW1yYnloYWVhYnJ1NGtncGl0dXF
tdmd4amNtNXkyMm1seHJlMjZvbTR6cSIsIm1mYV92ZXJpZmllZCI6ImZhbHNlIiwiaXNzIjoiYXV0
aFNlcnZpY2Uub3JhY2xlLmNvbSIsInB0eXBlIjoidXNlciIsInNlc3NfZXhwIjoiRnJpLCAxNiBKd
WwgMjAyMSAxMDo1OToxNyBVVEMiLCJhdWQiOiJvY2kiLCJwc3R5cGUiOiJuYXR2IiwidHR5cGUiOi
Jsb2dpbiIsImV4cCI6MTYyNjM1MDM1OSwiaWF0IjoxNjI2MzQ2NzU5LCJqdGkiOiJhNWE2YmRhNC0
2OGJkLTQ0ZjktODFlNS0yZGRiZGMyZWU4MTQiLCJ0ZW5hbnQiOiJvY2lkMS50ZW5hbmN5LnJlZ2lv
bjEuLmFhYWFhYWFhZTM0Z3diZXozZGJvN3VydGNmNDYyd2ozbW5tYW5iYmE1eHFpbmN6Z20yejVkN
jRjbmw1cSIsImp3ayI6IntcImtpZFwiOlwicHVia2V5LWU5Y2RmMWY4LTJjNTEtNGEyNi1hZjkyLT
7-159
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
NlZjlkNTlhNWEzN1wiLFwiblwiOlwicjE1azFxR0s1MXJaVUZzLVdFNDFrU2ZLRWozanlnd
lZ2bG9pZVM5Y3RLODJ4QmxZT1F3SkZwX19HUXVGTFktWk45MVZabXdSQkpFeHJYbE1hNHV6
aE5VS1BNQ3M5OG9XTENpQmo2UlVMekFLZHVtbHZlbHEwTUcwVmtMMjVXb1hONzU2N19wUUx
3NDc0T2w2VzNJUl9Jd2tBVy1QZnF5QzdpY1NOekI2UXh2aGlVMXRpTUFUZ09RUjQ1Ty1md3
NnVnl5WW14eVNCbm1sN1BDUEtoaGpBLTlFOFozeV94cnlPWFBuYjl1QlFrczZOblgzX08yR
kZ1UGxualN5QXdlSEZLSzd6MUJNVVdONUMtLV9Uemw5T0VaOENMeGdKNkpzeUUtRUVMeEZE
UkZ0MlVHZGNubUVBY2hNQ1gxNEtnWEFELVk5a2dkVS1HczNaUU1VTW5pYmFRXCIsXCJlXCI
6XCJBUUFCXCIsXCJrdHlcIjpcIlJTQVwiLFwiYWxnXCI6XCJSUzI1NlwiLFwidXNlXCI6bn
VsbH0ifQ.GGPB9TMU_CkqOfLNCgO2J6-
QwvHEEaY6jky5T92PBoPOBUkXb_ruNOe6C8RwQhs2pmIsIBybTP7Ueene4cJ9nNKzsoTzNA
UrSp9714Be2noQgqJL-ZtFIApThz1vXdfFWZtQQInxx-jALpsvkhvD_EVdbfx6FvlwDfm-
ReNDSnrUoFkfx8NpIrkqP8KUFhnX-
TRy0nUvqlaiB9C1L8FZGOJbBn0uiyloZe4DNP3Z39jViy37UntHeuMPnIqOYEsmPrSMTiJU
BAypy4_I5irWuR0PpxfrttP6nlEi80V5YrmO3l2-
ZJBRDKz8TdMkxclw3IT0qulTzFPqB3cXg45PGQ",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15;
rv:78.0) Gecko/20100101 Firefox/78.0",
"consoleSessionId": "csidff49902144a1a3c98bd4e5f49c1c"
},
"request": {
"id": "csidff49902144a1a3c98bd4e5f49c1c/
37d3a7113f1e462fbd5a741dc5d52ef7/57472323A2FFABC31623FB7660F519AB",
"path": "/20160918/databases/
ocid1.database.oc1.sea.abzwkljs5xinda6nughtf5tzapxhcq7at54bpsmdricyq4o4
trsr3pyiqhpq/actions/upgrade",
"action": "POST",
"parameters": {},
"headers": {}
},
"response": {
"status": "200",
"responseTime": "2021-07-15T11:02:36.072Z",
"headers": {},
"payload": null,
"message": "UpgradeDatabase succeeded"
},
"stateChange": {
"previous": null,
"current": {
"definedTags": {
"Operators": {
"Created_By": "[email protected]",
"Created_Time": "2021-07-15T11:01:24.085Z"
}
},
"displayName": "DB211507",
"freeTags": {},
"lifecycleState": "UPGRADING"
}
},
"additionalDetails": {
"action": "UPGRADE",
"currentDbVersion": "18.14.0.0",
"lifecycleState": "IN_PROGRESS",
"source": "DATABASE_HOME",
7-160
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"targetDbVersion": "19.10.0.0",
"timeStarted": "2021-07-15T11:02:34Z",
"upgradeHistoryEntryId":
"ocid1.dbupgradehistory.oc1.sea.abzwkljstw7dymj6mfnaotkxpuie2bdxmlizqr5ie46de
wcuzdh35md7fuhq"
}
}
}
{
"eventType": "com.oraclecloud.DatabaseService.UpgradeDatabase.end",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "DatabaseService",
"eventId": "e6c8a9e4-53b0-4bb8-be65-a39d157f04b2",
"eventTime": "2021-07-15T11:03:56.028Z",
"contentType": "application/json",
"data": {
"eventGroupingId": "csidff49902144a1a3c98bd4e5f49c1c/
37d3a7113f1e462fbd5a741dc5d52ef7/57472323A2FFABC31623FB7660F519AB",
"eventName": "UpgradeDatabase",
"compartmentId":
"ocid1.tenancy.region1..aaaaaaaae34gwbez3dbo7urtcf462wj3mnmanbba5xqinczgm2z5d
64cnl5q",
"compartmentName": "sic-dbaas",
"resourceName": "DB211507",
"resourceId":
"ocid1.database.oc1.sea.abzwkljs5xinda6nughtf5tzapxhcq7at54bpsmdricyq4o4trsr3
pyiqhpq",
"availabilityDomain": "",
"freeformTags": {},
"definedTags": {
"Operators": {
"Created_By": "[email protected]",
"Created_Time": "2021-07-15T11:01:24.085Z"
}
},
"identity": {
"principalName": null,
"principalId": null,
"authType": null,
"callerName": null,
"callerId": null,
"tenantId": null,
"ipAddress": null,
"credentials": null,
"userAgent": null,
"consoleSessionId": null
},
7-161
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"request": {
"id": "8f7b5283-4896-4ce0-aefa-a4156971e07b",
"path": null,
"action": null,
"parameters": null,
"headers": null
},
"response": {
"status": null,
"responseTime": null,
"headers": null,
"payload": null,
"message": "UpgradeDatabase"
},
"stateChange": {
"previous": null,
"current": {
"definedTags": {
"Operators": {
"Created_By": "[email protected]",
"Created_Time": "2021-07-15T11:01:24.085Z"
}
},
"displayName": "DB211507",
"freeTags": {},
"lifecycleState": "AVAILABLE"
}
},
"additionalDetails": {
"databaseEdition": "ENTERPRISE_EDITION_EXTREME",
"databaseId":
"ocid1.database.oc1.sea.abzwkljs5xinda6nughtf5tzapxhcq7at54bpsmdricyq4o
4trsr3pyiqhpq",
"dbHomeId":
"ocid1.dbhome.oc1.sea.abzwkljs7obwmwq2kgkjgeko4voudfcd5chu6iuonnew7uuxc
ulsvdralzda",
"dbUniqueName": "Audit_check",
"dbVersion": "19.10.0.0",
"exadataInfrastructureId":
"ocid1.exadatainfrastructure.oc1.sea.abzwkljsqtwpumvorlttjuxcx6qtkxhuas
vmyu4qy3bng74sqolpwjunsrqa",
"lifecycleState": "AVAILABLE",
"timeCreated": "2021-07-15T11:01:24Z",
"timeUpdated": "2021-07-15T11:03:56Z",
"vmClusterId":
"ocid1.vmcluster.oc1.sea.abzwkljsghfg7e3q3xh3gzqqxijt72fepczowmk35t554w
xbpew7txnooprq"
}
}
}
7-162
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
“eventID”: “af1cdf4e-4001-11eb-9fb6-f45c89b1cb17",
“eventTime”: “2020-12-17T00:49:14.123Z”,
“extensions”: {
“compartmentId”: “ocid1.compartment.oc1..unique_id”
},
“eventType”:
“com.oraclecloud.databaseservice.createexternalpluggabledatabase”,
“eventTypeVersion”: “2.0”,
“cloudEventsVersion”: “0.1”,
“source”: “databaseservice”,
“contentType”: “application/json”,
“definedTags”: {},
“data”: {
“compartmentId”: “ocid1.compartment.oc1.......unique_id”,
“compartmentName”: “MyCompartment”,
“resourceName”: “11092020_PKS_PDB1”,
7-163
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
“resourceId”: “ocid1.externalpluggabledatabases.oc1.phx.unique_id”,
“availabilityDomain”: “XXIT:PHX-AD-1”,
“freeFormTags”: {},
“definedTags”: {},
“additionalDetails”: {
“id”: “ocid1.externalpluggabledatabases.oc1.phx.unique_id”,
“timeCreated”: “2020-11-13T21:15:59.000Z”,
“timeUpdated”: “2020-11-13T21:15:59.000Z”,
“externalCDBId”:
“ocid1.externalcontainerdatabase.oc1.....unique_id”,
“lifecycleState”: “AVAILABLE”,
“lifecycleDetails”: “External Pluggable Database is available”,
“dbUniqueName”: “CDB122_phx16q”,
“dbId”: “3455094890",
“dbVersion”: “12.2.0.1.0",
“dbEdition”: “ENTERPRISE_EDITION_EXTREME_PERFORMANCE”,
“timeZone”: “US/Pacific”,
“databaseManagementServiceStatus”: “ENABLED”,
“databaseManagementServiceConnectorId”:
“ocid1.externaldatabaseconnector.oc1.....unique_id”,
“displayName”: “External Pluggable Database - Create”
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.vmclusteraddvirtualmachine.begin",
"source": "databaseservice",
"eventTypeVersion": "1.0",
7-164
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "Vmcluster-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-09-03T12:00:00.000Z",
"timeUpdated": "2019-09-03T12:30:00.000Z",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExatraInfra-unique_ID",
"vmClusterNetworkId": "VmCluster-unique_ID",
"cpuCoreCount": 2,
"dataStorageSizeInTBs": 4,
"memorySizeInGBs": 30,
"dbNodeStorageSizeInGBs": 60,
"dbVersion": "19.0.0.0",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"giVersion": "19.0.0.0",
"dbNodeIds": "[ocid1.dbnode.1, ocid1.dbnode.2,...]",
"dbServerIds": "[ocid1.dbserver.1, ocid1.dbserver.2,...]",
"timeZone": "US/Pacific"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.vmclusteraddvirtualmachine.end",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
7-165
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"resourceId": "Vmcluster-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-09-03T12:00:00.000Z",
"timeUpdated": "2019-09-03T12:30:00.000Z",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExatraInfra-unique_ID",
"vmClusterNetworkId": "VmCluster-unique_ID",
"cpuCoreCount": 2,
"dataStorageSizeInTBs": 4,
"memorySizeInGBs": 30,
"dbNodeStorageSizeInGBs": 60,
"dbVersion": "19.0.0.0",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"giVersion": "19.0.0.0",
"dbNodeIds": "[ocid1.dbnode.1, ocid1.dbnode.2,...]",
"dbServerIds": "[ocid1.dbserver.1, ocid1.dbserver.2,...]",
"timeZone": "US/Pacific"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.vmclusterterminatevirtualmachine.begin
",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "Vmcluster-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-09-03T12:00:00.000Z",
7-166
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"timeUpdated": "2019-09-03T12:30:00.000Z",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExatraInfra-unique_ID",
"vmClusterNetworkId": "VmCluster-unique_ID",
"cpuCoreCount": 2,
"dataStorageSizeInTBs": 4,
"memorySizeInGBs": 30,
"dbNodeStorageSizeInGBs": 60,
"dbVersion": "19.0.0.0",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"giVersion": "19.0.0.0",
"dbNodeIds": "[ocid1.dbnode.1, ocid1.dbnode.2,...]",
"dbServerIds": "[ocid1.dbserver.1, ocid1.dbserver.2,...]",
"timeZone": "US/Pacific"
}
}
}
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.vmclusterterminatevirtualmachine.end",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-06-27T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_database",
"resourceId": "Vmcluster-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "AVAILABLE",
"timeCreated": "2019-09-03T12:00:00.000Z",
"timeUpdated": "2019-09-03T12:30:00.000Z",
"displayName": "testDisplayName",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExatraInfra-unique_ID",
"vmClusterNetworkId": "VmCluster-unique_ID",
"cpuCoreCount": 2,
"dataStorageSizeInTBs": 4,
"memorySizeInGBs": 30,
"dbNodeStorageSizeInGBs": 60,
7-167
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"dbVersion": "19.0.0.0",
"licenseType": "BRING_YOUR_OWN_LICENSE",
"giVersion": "19.0.0.0",
"dbNodeIds": "[ocid1.dbnode.1, ocid1.dbnode.2,...]",
"dbServerIds": "[ocid1.dbserver.1, ocid1.dbserver.2,...]",
"timeZone": "US/Pacific"
}
}
}
Note:
Events flow on ExaDB-C@C depends on the following components: Oracle
Trace File Analyzer (TFA), sysLens, and Oracle Database Cloud Service
(DBCS) agent. Ensure that these components are up and running.
7-168
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
# tfactl status
.-------------------------------------------------------------------------
------------------------.
| Host | Status of TFA | PID | Port | Version | Build
ID | Inventory Status|
+----------------+---------------+--------+------+------------
+----------------------+------------+
| node1 | RUNNING | 41312 | 5000 | 22.1.0.0.0 |
22100020220310214615 | COMPLETE |
| node2 | RUNNING | 272300 | 5000 | 22.1.0.0.0 |
22100020220310214615 | COMPLETE |
'----------------+---------------+--------+------+------------
+----------------------+------------'
• To start the Oracle Trace File Analyzer daemon on the local node, run the tfactl start
command as root:
# tfactl start
Starting TFA..
Waiting up to 100 seconds for TFA to be started..
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
Successfully started TFA Process..
. . . . .
TFA Started and listening for commands
• To stop the Oracle Trace File Analyzer daemon on the local node, run the tfactl stop
command as root:
# tfactl stop
Stopping TFA from the Command Line
Nothing to do !
Please wait while TFA stops
Please wait while TFA stops
TFA-00002 Oracle Trace File Analyzer (TFA) is not running
TFA Stopped Successfully
Successfully stopped TFA..
7-169
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
Manage sysLens
• If sysLens is running, then once every 15 minutes data is collected in the local
domU to discover the events to be reported. To check if sysLens is running, run
the systemctl status syslens command as root in the domU:
• If the sysLens is enabled, when there is a reboot of the domU, then sysLens starts
automatically. To validate if sysLens is enabled to collect telemetry, run the
systemctl is-enabled syslens command as root in the domU:
7-170
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
SUCCESS)
Main PID: 10055 (sudo)
CGroup: /system.slice/dbcsagent.service
‣ 10055 sudo -u opc /bin/bash -c umask 077; /bin/java -
Doracle.security.jps.config=/opt/oracle/...
• To start the agent if it is not running, run the systemctl start command as the root
user:
Related Topics
• Using the Console to Create a VM Cluster
To create your VM cluster, be prepared to provide values for the fields required for
configuring the infrastructure.
• Using the Console to Enable, Partially Enable, or Disable Diagnostics Collection
You can enable, partially enable, or disable diagnostics collection for your Guest VMs
after provisioning the VM cluster. Enabling diagnostics collection at the VM cluster level
applies the configuration to all the resources such as DB home, Database, and so on
under the VM cluster.
• Overview of Events
• Notifications Overview
7-171
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
Note:
7-172
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-173
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-174
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-175
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-176
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-177
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-178
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-179
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-180
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
{
"eventType" : "com.oraclecloud.databaseservice.dbnode.critical",
"cloudEventsVersion" : "0.1",
"eventTypeVersion" : "2.0",
"source" : "SYSLENS/host_Name/DomU",
"eventTime" : "2022-03-07T23:17:47Z",
"contentType" : "application/json",
"data" : {
"compartmentId" : "compartment_ID",
7-181
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"compartmentName" : "compartment_Name",
"resourceName" : "resource_Name",
"resourceId" : "resource_ID",
"additionalDetails" : {
"serviceType" : "EXACC",
"hostName" : "host_Name",
"description" : "EXACHK is reporting 6 checks in critical status.
Results in: /u02/oracle.ahf/data/host_Name/exachk/user_root/output/
exachk_host_Name_v1c2_030722_150746.zip",
"eventName" : "HEALTH.DB_CLUSTER.EXACHK.CRITICAL_ALERT",
"status" : "online"
}
},
"eventID" : "cce55ca2-9e6c-11ec-90e6-00163e9b4de8",
"extensions" : {
"compartmentId" : "compartment_ID"
}
}
{
"eventType" : "com.oraclecloud.databaseservice.dbnode.critical",
"cloudEventsVersion" : "0.1",
"eventTypeVersion" : "2.0",
"source" : "SYSLENS/host_Name/DomU",
"eventTime" : "2022-03-06T18:14:57Z",
"contentType" : "application/json",
"data" : {
"compartmentId" : "compartment_ID",
"compartmentName" : "compartment_Name",
"resourceName" : "resource_Name",
"resourceId" : "resource_ID",
"additionalDetails" : {
"serviceType" : "EXACC",
"hostName" : "host_Name",
"description" : "Parameter ClientAliveCountMax has incorrect
value.",
"eventName" : "CONFIGURATION.DB_GUEST.SSHD.INVALID",
"status" : "online"
}
},
"eventID" : "5453554e-9d79-11ec-8096-00163eb980bb",
"extensions" : {
"compartmentId" : "compartment_ID"
}
}
{
"eventType" : "com.oraclecloud.databaseservice.dbnode.critical",
"cloudEventsVersion" : "0.1",
"eventTypeVersion" : "2.0",
"source" : "SYSLENS/host_Name/DomU",
"eventTime" : "2022-03-04T18:19:42Z",
"contentType" : "application/json",
7-182
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"data" : {
"compartmentId" : "compartment_ID",
"compartmentName" : "compartment_Name",
"resourceName" : "resource_Name",
"resourceId" : "resource_ID",
"additionalDetails" : {
"serviceType" : "EXACC",
"hostName" : "host_Name",
"description" : "The '/' filesystem is over 90% used.",
"eventName" : "HEALTH.DB_GUEST.FILESYSTEM.FREE_SPACE",
"status" : "online"
}
},
"eventID" : "a9752630-9be7-11ec-a203-00163eb980bb",
"extensions" : {
"compartmentId" : "compartment_ID"
}
}
{
"eventType" : "com.oraclecloud.databaseservice.dbnode.critical",
"cloudEventsVersion" : "0.1",
"eventTypeVersion" : "2.0",
"source" : "SYSLENS/host_Name/DomU",
"eventTime" : "2022-03-04T18:49:25Z",
"contentType" : "application/json",
"data" : {
"compartmentId" : "compartment_ID",
"compartmentName" : "compartment_Name",
"resourceName" : "resource_Name",
"resourceId" : "resource_ID",
"additionalDetails" : {
"serviceType" : "EXACC",
"hostName" : "host_Name",
"description" : "Huge Pages is configured more than 90% of total memory
amount.",
"eventName" : "CONFIGURATION.DB_GUEST.MEMORY.HUGEPAGES_TOO_LARGE",
"status" : "online"
}
},
"eventID" : "d0724fac-9beb-11ec-a203-00163eb980bb",
"extensions" : {
"compartmentId" : "compartment_ID"
}
}
7-183
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
You can also restrict automatic diagnostic collection at a granular level, for example,
only for ORA-00600 or even only ORA-00600 with specific arguments.
Syntax
Parameters
Parameter Description
add|remove|print| Adds, removes, or prints blackout conditions.
targettype type Limits blackout only to the specified target type.
Target type: host|crs| host: The whole node is under blackout. If there is host blackout,
asm|asmdg|database| then every blackout element that's shown true in the Telemetry
dbbackup | JSON will have the reason for the blackout.
db_dataguard| crs: Blackout the availability of the Oracle Clusterware resource or
db_tablespace | events in the Oracle Clusterware logs.
pdb_tablespace|pdb| asm: Blackout the availability of Oracle Automatic Storage
listener|service|os Management (Oracle ASM) on this machine or events in the Oracle
ASM alert logs.
asmdg: Blackout an Oracle ASM disk group.
database: Blackout the availability of an Oracle Database, Oracle
Database backup, tablespace, and so on, or events in the Oracle
Database alert logs.
dbbackup: Blackout Oracle Database backup events (such as CDB
or archive backups).
db_dataguard: Blackout Oracle Data Guard events.
db_tablespace: Blackout Oracle Database tablespace events
(container database).
pdb_tablespace: Blackout Oracle Pluggable Database
tablespace events (Pluggable database).
pdb: Blackout Oracle Pluggable Database events.
listener: Blackout the availability of a listener.
service: Blackout the availability of a service.
os: Blackout one or more operating system records.
target all|name Specify the target for blackout. You can specify a comma-delimited
list of targets.
By default, the target is set to all.
7-184
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
Parameter Description
container name Specify the database container name (db_unique_name) where
the blackout will take effect (for PDB, DB_TABLESPACE, and
PDB_TABLESPACE).
pdb pdb_name Specify the PDB where the blackout will take effect (for
PDB_TABLESPACE only).
events Limits blackout only to the availability events, or event strings, which
all|"str1,str2" should not trigger auto collections, or be marked as blacked out in
telemetry JSON.
all: Blackout everything for the target specified.
string: Blackout for incidents where any part of the line contains the
strings specified.
Specify a comma-delimited list of strings.
timeout nh|nd|none Specify the duration for blackout in number of hours or days before
timing out. By default, the timeout is set to 24 hours (24h).
c|local Specify if blackout should be set to cluster-wide or local.
By default, blackout is set to local.
reason comment Specify a descriptive reason for the blackout.
docollection Use this option to do an automatic diagnostic collection even if a
blackout is set for this target.
7-185
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
.-------------------------------------------------------------------
--------------------------------------------------------------------
----------------------------------------.
|
myhostname
|
+---------------+---------------------+-----------
+------------------------------+------------------------------
+--------+---------------+--------------------------------------+
| Target Type | Target | Events | Start
Time | End Time | Status | Do
Collection | Reason |
+---------------+---------------------+-----------
+------------------------------+------------------------------
+--------+---------------+--------------------------------------+
| HOST | ALL | ALL | Thu Mar 24
16:48:39 UTC 2022 | Thu Mar 24 17:48:39 UTC 2022 | ACTIVE |
false | Disabling all events during patching |
| DATABASE | MYDB | ORA-00600 | Thu Mar 24
16:39:03 UTC 2022 | Fri Mar 25 16:39:03 UTC 2022 | ACTIVE |
false | NA |
| DATABASE | ALL | ORA-04031 | Thu Mar 24
16:39:54 UTC 2022 | Thu Mar 24 17:39:54 UTC 2022 | ACTIVE |
false | NA |
| DB_DATAGUARD | MYDB | ALL | Thu Mar 24
16:41:38 UTC 2022 | Thu Mar 24 17:11:38 UTC 2022 | ACTIVE |
false | NA |
| DBBACKUP | MYDB | ALL | Thu Mar 24
16:40:47 UTC 2022 | Fri Mar 25 16:40:47 UTC 2022 | ACTIVE |
false | NA |
| DB_TABLESPACE | SYSTEM_CDBNAME_MYDB | ALL | Thu Mar 24
16:45:56 UTC 2022 | Thu Mar 24 17:15:56 UTC 2022 | ACTIVE |
false | NA |
'---------------+---------------------+-----------
+------------------------------+------------------------------
+--------+---------------+--------------------------------------'
7-186
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
• To remove blackout for db backup events on target type: dbbackup, target: mydb
• To remove blackout for host events on target type: host, target: all
Remediation
These topics cover some common issues you might run into and how to address them.
• HEALTH.DB_GUEST.FILESYSTEM.FREE_SPACE
• HEALTH.DB_GUEST.FILESYSTEM.CORRUPTION
• CONFIGURATION.DB_GUEST.MEMORY.HUGEPAGES_TOO_LARGE
• CONFIGURATION.DB_GUEST.SSHD.INVALID
• HEALTH.DB_CLUSTER.EXACHK.CRITICAL_ALERT
• AVAILABILITY.DB_GUEST.CRS_INSTANCE.DOWN
• AVAILABILITY.DB_CLUSTER.SCAN_LISTENER.DOWN
• AVAILABILITY.DB_GUEST.CLIENT_LISTENER.DOWN
• AVAILABILITY.DB_GUEST.CDB_INSTANCE.DOWN
• HEALTH.DB_CLUSTER.CDB.CORRUPTION
• HEALTH.DB_CLUSTER.CDB.ARCHIVER_HANG
• HEALTH.DB_CLUSTER.CDB.DATABASE_HANG
• HEALTH.DB_CLUSTER.CDB.BACKUP_FAILURE
• HEALTH.DB_CLUSTER.DISK_GROUP.FREE_SPACE
• Managing the Log and Diagnostic Files on Oracle Exadata Database Service on
Cloud@Customer
HEALTH.DB_GUEST.FILESYSTEM.FREE_SPACE
Problem Statement: One or more VM guest file systems has free space below 10% free.
Risk: Insufficient VM guest file system free space can cause disk space allocation failure,
which can result in wide-ranging errors and failures in Oracle software (Database,
Clusterware, Cloud, Exadata).
Action:
Oracle Cloud and Exadata utilities run automatically to purge old log files and trace files
created by Oracle software to reclaim file system space.
7-187
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
If the automatic file system space reclamation utilities cannot sufficiently purge old files
to clear this event, then perform the following actions:
1. Remove unneeded files and/or directories created manually or by customer-
installed applications or utilities. Files created by customer-installed software are
outside the scope of Oracle's automatic file system space reclamation utilities. The
following operating system command, run as the opc user, is useful for identifying
directories consuming excessive disk space:
Only remove files or directories you are certain can be safely removed.
2. Reclaim /u02 file system disk space by removing Database Homes that have no
databases. For more information about managing Database Homes, see Manage
Oracle Database Homes on Exadata Database Service on Cloud@Customer
Systems.
3. (Exadata Cloud@Customer only) Increase /u02 file system size. For more
information about scaling up local storage, see Introduction to Scale Up or Scale
Down Operations.
4. Open service request to receive additional guidance about reducing file system
space use.
Related Topics
• Manage Oracle Database Homes on Exadata Database Service on
Cloud@Customer Systems
Learn to manage Oracle Database homes on Exadata Database Service on
Cloud@Customer.
• Introduction to Scale Up or Scale Down Operations
With the Multiple VMs per Exadata system (MultiVM) feature release, you can
scale up or scale down your VM cluster resources.
HEALTH.DB_GUEST.FILESYSTEM.CORRUPTION
1. Stop running services, if any, that are using the file system, such as Oracle
Clusterware, Trace File Analyzer (TFA), and Enterprise Manager (EM) agent.
2. Unmount the file system.
3. Run file system check and repair.
• ext4: Refer to Checking and Repairing a File System.
• xfs: Refer to Checking and Repairing an XFS File System.
7-188
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
• If the file system cannot be repaired then open a service request with Oracle Support
for assistance.
4. Mount the file system.
5. Start the services.
/ (root) file system:
Related Topics
• Checking and Repairing a File System
• Checking and Repairing an XFS File System
CONFIGURATION.DB_GUEST.MEMORY.HUGEPAGES_TOO_LARGE
CONFIGURATION.DB_GUEST.SSHD.INVALID
7-189
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
Risk: SSHD configuration is unexpected which may cause Oracle Cloud automation
failure or prevent customer SSH access to the VM.
Action: Change SSHD to match expected configuration.
1. Verify SSHD service is active.
7-190
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
3. Change SSHD configuration to match the expected values according to the table shown
in the Problem Statement section above.
HEALTH.DB_CLUSTER.EXACHK.CRITICAL_ALERT
Problem Statement: A CRITICAL Exachk check failed and should be reviewed and
addressed as soon as possible.
Risk: A CRITICAL check is expected to impact a large number of customers AND should be
addressed immediately (for example, within 24 hours) AND meets one or more of the
following criteria:
1. On-disk corruption or data loss
2. Intermittent wrong results with Exadata feature usage (e.g. smart scan)
3. System wide availability impact
4. Severe system wide performance impact seriously affecting application service Service
Level Agreements (SLAs)
7-191
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
If the check results are returning false data, then log a Service Request.
If there is a CRITICAL check that needs to be temporarily excluded, then follow the
"Skipping Specific Best Practice Checks in Exadata Cloud" section of Oracle
Exadata Database Machine Exachk (Doc ID 1070954.1).
Related Topics
• Oracle Exadata Database Machine Exachk (Doc ID 1070954.1)
AVAILABILITY.DB_GUEST.CRS_INSTANCE.DOWN
Problem Statement: The Cluster Ready Stack is in an offline state or has failed.
Risk: If the Cluster Ready Service is offline on a node, then the node cannot provide
database services for the application.
Action:
1. Check if CRS was stopped by your administrator, as part of a planned
maintenance event, or a scale up or down of local storage.
a. The following patching events will stop CRS:
i. GRID Patching
ii. Exadata VM patching of Guest
iii. Exadata VM Patching of Host
2. If CRS has stopped unexpectedly, then the current status can be checked by
issuing the crsctl check crs command.
a. If the node is not responding, then the VM node may be rebooting. Wait for the
node reboot to finish, CRS will normally be started through the init process.
3. If CRS is still down, then investigate the cause of the failure by referring to the
alert.log found in /u01/app/grid/diag/crs/<node_name>/crs/trace.
Review the log entries corresponding to the date/time of the down event. Act on
any potential remediation.
4. Restart the CRS, by issuing the crsctl start crs command.
7-192
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
AVAILABILITY.DB_CLUSTER.SCAN_LISTENER.DOWN
Problem Statement: A SCAN listener is down and unable to accept application connections.
Risk: If all SCAN listeners are down, then application connections to the database through
the SCAN listener will fail.
Action:
Start the SCAN listener to receive the DOWN_CLEARED event.
AVAILABILITY.DB_GUEST.CLIENT_LISTENER.DOWN
7-193
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
AVAILABILITY.DB_GUEST.CDB_INSTANCE.DOWN
7-194
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
[oracle@vm ~] . <dbName>.env
HEALTH.DB_CLUSTER.CDB.CORRUPTION
Problem Statement: Corruptions can lead to application or database errors and in worse
case result in significant data loss if not addressed promptly.
A corrupt block is a block that was changed so that it differs from what Oracle Database
expects to find. Block corruptions can be categorized as physical or logical:
• In a physical block corruption, which is also called a media corruption, the database does
not recognize the block at all; the checksum is invalid or the block contains all zeros. An
7-195
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
example of a more sophisticated block corruption is when the block header and
footer do not match.
• In a logical block corruption, the contents of the block are physically sound and
pass the physical block checks; however, the block can be logically inconsistent.
Examples of logical block corruption include incorrect block type, incorrect data or
redo block sequence number, corruption of a row piece or index entry, or data
dictionary corruptions.
For more information, see Physical and Logical Block Corruptions. All you wanted to
know about it. (Doc ID 840978.1).
Block corruptions can also be divided into interblock corruption and intrablock
corruption:
• In an intrablock corruption, the corruption occurs in the block itself and can be
either a physical or a logical block corruption.
• In an interblock corruption, the corruption occurs between blocks and can only be
a logical block corruption.
Oracle checks for the following errors in the alert.log:
• ORA-01578
• ORA-00752
• ORA-00753
• ORA-00600 [3020]
• ORA-00600 [kdsgrp1]
• ORA-00600 [kclchkblk_3]
• ORA-00600 [13013]
• ORA-00600 [5463]
Risk: A data corruption outage occurs when a hardware, software, or network
component causes corrupt data to be read or written. The service-level impact of a
data corruption outage may vary, from a small portion of the application or database
(down to a single database block) to a large portion of the application or database
(making it essentially unusable). If remediation action is not taken promptly, then
potential downtime and data loss can increase.
Action:
The current event notification currently triggers on physical block corruptions
(ORA-01578), lost writes (ORA-00752, ORA-00753 and ORA-00600 with first
argument 3020), and logical corruptions (typical detected from ORA-00600 with first
argument of kdsgrp1, kdsgrp1, kclchkblk_3, 13013 OR 5463).
Oracle recommends the following steps:
1. Confirm that these corruptions were reported in the alert.log trace file. Log a
Service Request (SR) with latest EXAchk report, excerpt of the alert.log and trace
file containing the corruption errors, any history of recent application, database or
software changes and any system, clusterware and database logs for the same
time period. For all these cases, a TFA collection should be available and should
be attached to the SR.
2. For repair recommendations, refer to Handling Oracle Database Corruption Issues
(Doc ID 1088018.1).
7-196
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
For physical corruptions or ORA-1578 errors, the following notes will be helpful:
• Doc ID 1578.1 : OERR: ORA-1578 "ORACLE data block corrupted (file # %s, block #
%s)" Primary Note
• Doc ID 472231.1 : How to identify all the Corrupted Objects in the Database reported by
RMAN
• Doc ID 819533.1 : How to identify the corrupt Object reported by ORA-1578 / RMAN /
DBVERIFY
• Depending on the object that has the corruption, follow the guidance in Doc ID
1088018.1. Note RMAN can be used to recover one or many data block that are
physically corrupted. Also using Active Data Guard with real time apply, auto block repair
of physical data corruptions would have occurred automatically.
For logical corruptions caused by lost writes (ORA-00752, ORA-00753 and ORA-00600 with
first argument 3020) on the primary or standby databases, they will be detected on the
primary or with standby's redo apply process. The following notes will be helpful:
• Follow the guidance, follow Doc ID 1088018.1.
• If you have a standby and lost write corruption on the primary or standby, refer to
Resolving ORA-00752 or ORA-00600 [3020] During Standby Recovery (Doc ID
1265884.1)
For logical corruptions (typical detected from ORA-00600 with arguments of kdsgrp1,
kclchkblk_3, 13013 OR 5463):
• Follow the guidance, follow Doc ID 1088018.1 for specific guidance on the error that was
detected.
• If you have a standby and logical corruption on the primary, refer to Resolving Logical
Block Corruption Errors in a Physical Standby Database (Doc ID 2821699.1)
Related Topics
• Physical and Logical Block Corruptions. All you wanted to know about it. (Doc ID
840978.1)
• OERR: ORA-1578 "ORACLE data block corrupted (file # %s, block # %s)" Primary Note
(Doc ID 1578.1)
• How to identify all the Corrupted Objects in the Database with RMAN (Doc ID 472231.1)
• How to identify the corrupt Object reported by ORA-1578 / RMAN / DBVERIFY (Doc ID
819533.1)
• Resolving ORA-00752 or ORA-600 [3020] During Standby Recovery (Doc ID 1265884.1)
• Resolving Logical Block Corruption Errors in a Physical Standby Database (Doc ID
2821699.1)
HEALTH.DB_CLUSTER.CDB.ARCHIVER_HANG
Problem Statement: CDB RAC Instance may temporarily or permanently stall due to the log
writer's (LGWR) inability to write the log buffers to an online redo log. This occurs because all
online logs need archiving. Once the archiver (ARC) can archive at least one online redo log,
LGWR will be able to resume writing the log buffers to online redo logs and the application
impact will be alleviated.
7-197
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
Risk: If the archiver hang is temporary, then this can result in a small application
brown out or stall for application processes attempting to commit their database
changes. If the archiver is not unblocked, applications can experience extended delay
in processing.
Action:
• See, Script To Find Redo log Switch History And Find Archivelog Size For Each
instance In RAC (Doc ID 2373477.1) to determine the hourly frequency for each
thread/instance.
• If any hourly bucket is greater than 12, then consider resizing the online redo logs.
See item 2 below for resizing steps.
• If the database hangs are temporary, then the archiver may be unable to keep up
with the redo log generated. Check the alert.log, $ORACLE_BASE/diag/
rdbms/<dbName>/<instanceName>/trace/alert_<instanceName>.log,
for "All online logs need archiving", multiple events in a short period can indicate 2
possible solutions.
– If the number of redo logs groups per thread is less than 4, then consider
adding additional logs groups to reach 4, see item 1 below for add redo log
steps.
– The other possible solution is to resize the redo logs, see item 2 below for
resizing steps.
• For Data Guard and Non Data Guard review the Configure Online Redo Logs
Appropriately of section Oracle Database High Availability Overview and Best
Practices for sizing guidelines.
1. Add a redo log group for each thread. The additional redo log should equal the
current log size.
a. Use the following query:
b. Add one new group per thread using the same size as the current redo logs.
2. Resize the online redo logs by adding larger redo logs and dropping the current
smaller redo logs.
a. Use the following query:
7-198
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
ii. The original smaller redo logs should be deleted. A redo log can only be deleted
if its status is inactive.
To determine the status of a redo logs issue:
• If the database is hung, the primary log archive destination and alternate may be full.
Review the HEALTH.DB_CLUSTER.DISK_GROUP.FREE_SPACE for details on freeing
space in RECO and DATA disk groups.
Related Topics
• Script To Find Redolog Switch History And Find Archivelog Size For Each Instances In
RAC (Doc ID 2373477.1)
• Configure Online Redo Logs Appropriately
• HEALTH.DB_CLUSTER.DISK_GROUP.FREE_SPACE
HEALTH.DB_CLUSTER.CDB.DATABASE_HANG
$ORACLE_BASE/diag/rdbms/<dbName>/<instanceName>/trace/
alert_<instanceName>.log
3. For ora-32701: An overloaded system can cause slow progress, which can be
interpreted as a hang.
The hang manager may attempt to resolve the hang by terminating the final blocker
process.
7-199
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
4. For DIA0 Critical Database Process messages: Review the related diagnostic
lines indicating the process and the reason for the hang.
HEALTH.DB_CLUSTER.CDB.BACKUP_FAILURE
HEALTH.DB_CLUSTER.DISK_GROUP.FREE_SPACE
7-200
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
ASM disk group used space is determined by the running the following query while
connected to the ASM instance.
7-201
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
Managing the Log and Diagnostic Files on Oracle Exadata Database Service on
Cloud@Customer
Note:
Configure an optimal retention period for each type of log or diagnostic file.
An insufficient retention period will hinder root cause analysis and problem
investigation.
7-202
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
7-203
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
$ cd /var/opt/oracle/cleandb
$ ./cleandblogs.pl
When running the script manually, you can specify an alternate configuration file to
use instead of cleandblogs.cfg by using the --pfile option:
$ exit
Related Topics
• Automatic Diagnostic Repository (ADR)
• Connecting to a Virtual Machine with SSH
You can connect to the virtual machines in an Exadata Database Service on
Cloud@Customer system by using a Secure Shell (SSH) connection.
{
"id":
"ocid1.eventschema.oc1.phx.abyhqljrdsa7ybmw6mjndfutmibmw6a4ztvu7sgm562o
jbudo3le6qwsspdq",
"exampleEvent": {
"cloudEventsVersion": "0.1",
7-204
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.adddbservervmclusternetwork.begin",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-08-29T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_vmcluster_network",
"resourceId": "VmClusterNetwork-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "UPDATING",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExadataInfra-unique_ID",
"displayName": "testDisplayName"
}
}
},
"serviceName": "Database",
"displayName": "VM Cluster Network - Add DB Server Network Begin",
"eventType":
"com.oraclecloud.databaseservice.adddbservervmclusternetwork.begin",
"additionalDetails": [
{ "name": "id", "type": "string" },
{ "name": "timeCreated", "type": "string" },
{ "name": "timeUpdated", "type": "string" },
{ "name": "displayName", "type": "string" },
{ "name": "lifecycleState", "type": "string" },
{ "name": "lifecycleDetails", "type": ["null", "string"] },
{ "name": "exadataInfrastructureId", "type": ["null", "string"] }
],
"timeCreated": "2019-06-26T13:31:31.979Z"
}
This is a reference event for VM Cluster Network - Add DB Server Network Begin:
{
"id":
"ocid1.eventschema.oc1.phx.abyhqljrupbmw5ksic23bmwnqc4rssbmwc23eslydoumcnr6rc
um6mtmgg3a",
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
7-205
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"eventType":
"com.oraclecloud.databaseservice.adddbservervmclusternetwork.end",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-08-29T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_vmcluster_network",
"resourceId": "VmClusterNetwork-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "NEEDS_ATTENTION",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
"lifecycleDetails": "detail message",
"displayName": "testDisplayName",
"exadataInfrastructureId": "ExadataInfra-unique_ID"
}
}
},
"serviceName": "Database",
"displayName": "VM Cluster Network - Add DB Server Network End",
"eventType":
"com.oraclecloud.databaseservice.adddbservervmclusternetwork.end",
"additionalDetails": [
{ "name": "id", "type": "string" },
{ "name": "timeCreated", "type": "string" },
{ "name": "timeUpdated", "type": "string" },
{ "name": "displayName", "type": "string" },
{ "name": "lifecycleState", "type": "string" },
{ "name": "lifecycleDetails", "type": ["null", "string"] },
{ "name": "exadataInfrastructureId", "type": ["null", "string"] }
],
"timeCreated": "2019-06-26T13:31:31.979Z"
}
This is a reference event for VM Cluster Network - Remove DB Server Network Begin:
{
"id":
"ocid1.eventschema.oc1.phx.abyhqljrdsa7ybmw6mjndfutmifv46a4ztvu7sgm562o
jbudo3le6qwsspdq",
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
7-206
Chapter 7
Oracle Exadata Database Service on Cloud@Customer Events
"com.oraclecloud.databaseservice.removedbservervmclusternetwork.begin",
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-08-29T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_vmcluster_network",
"resourceId": "VmClusterNetwork-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "UPDATING",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
"lifecycleDetails": "detail message",
"exadataInfrastructureId": "ExadataInfra-unique_ID",
"displayName": "testDisplayName"
}
}
},
"serviceName": "Database",
"displayName": "VM Cluster Network - Remove DB Server Network Begin",
"eventType":
"com.oraclecloud.databaseservice.removedbservervmclusternetwork.begin",
"additionalDetails": [
{ "name": "id", "type": "string" },
{ "name": "timeCreated", "type": "string" },
{ "name": "timeUpdated", "type": "string" },
{ "name": "displayName", "type": "string" },
{ "name": "lifecycleState", "type": "string" },
{ "name": "lifecycleDetails", "type": ["null", "string"] },
{ "name": "exadataInfrastructureId", "type": ["null", "string"] }
],
"timeCreated": "2019-06-26T13:31:31.979Z"
}
This is a reference event for VM Cluster Network - Remove DB Server Network End:
{
"id":
"ocid1.eventschema.oc1.phx.abyhqljrupbmw5ksic23bmwnqc4rsskxwc23eslydoumcnr6rc
um6mtmgg3a",
"exampleEvent": {
"cloudEventsVersion": "0.1",
"eventID": "60600c06-d6a7-4e85-b56a-1de3e6042f57",
"eventType":
"com.oraclecloud.databaseservice.removedbservervmclusternetwork.end",
7-207
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
"source": "databaseservice",
"eventTypeVersion": "1.0",
"eventTime": "2019-08-29T21:16:04.000Z",
"contentType": "application/json",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..unique_ID"
},
"data": {
"compartmentId": "ocid1.compartment.oc1..unique_ID",
"compartmentName": "example_name",
"resourceName": "my_vmcluster_network",
"resourceId": "VmClusterNetwork-unique_ID",
"availabilityDomain": "all",
"freeFormTags": {},
"definedTags": {},
"additionalDetails": {
"id": "ocid1.id..oc1...unique_ID",
"lifecycleState": "ALLOCATED",
"timeCreated": "2019-08-29T12:00:00.000Z",
"timeUpdated": "2019-08-29T12:30:00.000Z",
"lifecycleDetails": "detail message",
"displayName": "testDisplayName",
"exadataInfrastructureId": "ExadataInfra-unique_ID"
}
}
},
"serviceName": "Database",
"displayName": "VM Cluster Network - Remove DB Server Network End",
"eventType":
"com.oraclecloud.databaseservice.removedbservervmclusternetwork.end",
"additionalDetails": [
{ "name": "id", "type": "string" },
{ "name": "timeCreated", "type": "string" },
{ "name": "timeUpdated", "type": "string" },
{ "name": "displayName", "type": "string" },
{ "name": "lifecycleState", "type": "string" },
{ "name": "lifecycleDetails", "type": ["null", "string"] },
{ "name": "exadataInfrastructureId", "type": ["null", "string"] }
],
"timeCreated": "2019-06-26T13:31:31.979Z"
}
7-208
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
Note:
For more information on Policies, see "How Policies Work".
For a sample policy, see "Let database admins manage Exadata Database Service
on Cloud@Customer instances".
• About Resource-Types
Learn about resource-types you can use in your policies.
• Resource-Types for Exadata Database Service on Cloud@Customer
Review the list of resource-types specific to Exadata Database Service on
Cloud@Customer.
• Supported Variables
Use variables when adding conditions to a policy.
• Details for Verb + Resource-Type Combinations
Review the list of permissions and API operations covered by each verb.
• Permissions Required for Each API Operation
Review the list of API operations for Exadata Database Service on Cloud@Customer
resources in a logical order, grouped by resource type.
Related Topics
• How Policies Work
• Let database admins manage Exadata Database Service on Cloud@Customer instances
About Resource-Types
Learn about resource-types you can use in your policies.
An aggregate resource-type covers the list of individual resource-types that directly follow.
For example, writing one policy to allow a group to have access to the database-family is
equivalent to writing eight separate policies for the group that would grant access to the
exadata-infrastructures, vmcluster-networks, vmclusters, backup-destinations, db-
nodes, and the rest of the individual resource-types. For more information, see Resource-
Types.
Aggregate Resource-Type
database-family
7-209
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
Individual Resource-Types
exadata-infrastructures
vmclusters
backup-destinations
db-nodes
db-homes
databases
backups
database-software-images
autonomous-vmclusters
autonomous-container-databases
autonomous-databases
key-stores
autonomousContainerDatabaseDataguardAssociations
AutonomousDatabaseDataguardAssociation
Supported Variables
Use variables when adding conditions to a policy.
Exadata Database Service on Cloud@Customer supports only the general variables.
For more information, see "General Variables for All Requests".
Related Topics
• General Variables for All Requests
7-210
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
7-211
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
Related Topics
• Permissions
• Verbs
• Resource-Types
exadata-infrastructures
Review the list of permissions and API operations for exadata-infrastructures
resource-type.
Granting permissions on exadata-infrastructure resources grants permissions on
associated vmcluster-network resources.
7-212
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
vmcluster-networks
Review the list of permissions and API operations for vmcluster-networks resource-type.
7-213
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
vmclusters
Review the list of permissions and API operations for vmclusters resource-type.
7-214
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
backup-destinations
Review the list of permissions and API operations for backup-destinations resource-type.
7-215
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
db-nodes
Review the list of permissions and API operations for db-nodes resource-type.
7-216
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
db-homes
Review the list of permissions and API operations for db-homes resource-type.
7-217
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
databases
Review the list of permissions and API operations for databases resource-type.
7-218
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
backups
Review the list of permissions and API operations for backups resource-type.
database-software-image
Review the list of permissions and API operations for database-software-image resource-
type.
7-219
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
autonomous-vmclusters
Review the list of permissions and API operations for autonomous-vmclusters
resource-type.
7-220
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
autonomous-container-databases
Review the list of permissions and API operations for autonomous-container-databases
resource-type.
7-221
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
autonomous-databases
Review the list of permissions and API operations for autonomous-databases
resource-type.
7-222
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
key-stores
Review the list of permissions and API operations for key-store resource-type.
pluggable-databases (PDBs)
Review the list of permissions and API operations for pluggable-databases resource-type.
7-223
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
dbServers
Review the list of permissions and API operations for dbServers resource-type.
7-224
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
7-225
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
7-226
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
7-227
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
7-228
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
7-229
Chapter 7
Policy Details for Exadata Database Service on Cloud@Customer
7-230
Chapter 7
Managing Exadata Resources with Oracle Enterprise Manager Cloud Control
Related Topics
• Permissions
7-231
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
Visualization
Enterprise Manager Cloud Control allows you to visualize the database and related
targets associated with each Exadata Cloud and Exadata Cloud@Customer system.
7-232
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
Responsibilities
Exadata Cloud@Customer is jointly managed by the customer and Oracle. The Exadata
Cloud@Customer deployment is divided into two major areas of responsibilities:
• Customer accessible services:
Components that the customer can access as part of their subscription to Exadata
Cloud@Customer:
– Customer accessible virtual machines (VM)
– Customer accessible database services
• Oracle-managed infrastructure:
– Power Distribution Units (PDUs)
– Out-of-band (OOB) management switches » InfiniBand switches
– Exadata Storage Servers
– Physical Exadata database servers
Customers control and monitor access to customer services, including network access to
their VMs (through layer 2 VLANs and firewalls implemented in the customer VM),
authentication to access the VM, and authentication to access databases running in the VMs.
Oracle controls and monitors access to Oracle-managed infrastructure components. Oracle
staff are not authorized to access customer services, including customer VMs and databases.
Customers access Oracle Databases running on Exadata Cloud@Customer through a layer
2 (tagged VLAN) connection from customer equipment to the databases running in the
customer VM using standard Oracle Database connection methods, such as Oracle Net on
port 1521. Customers access the VM running the Oracle Databases through standard Oracle
Linux methods, such as token based SSH on port 22.
7-233
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
Exadata Database Machine Security. This secures the core operating environment
by restricting the installation image to only the required software packages,
disabling unnecessary services, and implementing secure configuration
parameters throughout the system.
In addition to inheriting all the strength of Exadata Database Machine's mature
platform, because Exadata Cloud@Customer provisions systems for customers,
additional secure default configuration choices are implemented in the service
instances. For example, all database tablespaces require transparent data
encryption (TDE), strong password enforcement for initial database users and
superusers, and enhanced audit and event rules.
Exadata Cloud@Customer also constitutes a complete deployment and service,
so it is subjected to industry-standard external audits such as PCI, HIPPA and
ISO27001. These external audit requirements impose additional value-added
service features such as antivirus scanning, automated alerting for unexpected
changes to the system, and daily vulnerability scans for all Oracle-managed
infrastructure systems in the fleet.
• Least Privilege
To ensure that processes only have access to the privileges they require, Oracle
Secure Coding Standards require the paradigm of least privilege.
Each process and daemon, must run as a normal, unprivileged user unless it can
prove a requirement for a higher level of privilege. This helps contain any
unforeseen issues or vulnerabilities to unprivileged user space and not
compromise an entire system.
This principle also applies to Oracle operations team members who use individual
named accounts to access the Oracle Exadata Cloud@Customer infrastructure for
maintenance or troubleshooting. Only when necessary will they use the audited
access to higher levels of privilege to solve or resolve an issue. Most issues are
resolved through automation, so we also employ least privilege by not permitting
human operators to access a system unless the automation is unable to resolve
the issue.
• Auditing and Accountability
When required, access to the system is allowed, but all access and actions are
logged and tracked for accountability.
This ensures that both Oracle and customers know what was done on the system
and when that occurred. These facts not only ensure we remain compliant with
reporting needs for external audits, but also can help match up some change with
a change in perceived behavior in the application.
Auditing capabilities are provided at all infrastructure components to ensure all
actions are captured. Customers also have ability to configure auditing for their
database and Guest VM configuration and may choose to integrate those with
other enterprise auditing systems.
• Automating Cloud Operations
By eliminating manual operations required to provision, patch, maintain,
troubleshoot, and configure systems, the opportunity for error is reduced and a
secure configuration is ensured.
The service is designed to be secure and by automating all provisioning,
configuration, and most other operational tasks, it is possible to avoid missed
configurations and ensure all necessary paths into the system are closed tightly.
7-234
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
Related Topics
• Overview of Oracle Exadata Database Machine Security
Security Features
• Hardened Operating System Image
– Minimal package installation:
Only the necessary packages required to run an efficient system are installed. By
installing a smaller set of packages, the attack surface of the operating system is
reduced and the system remains more secure.
– Secure configuration:
Many non-default configuration parameters are set during installation to enhance the
security posture of the system and its content. For example, SSH is configured to
only listen on certain network interfaces, sendmail is configured to only accept
localhost connections, and many other similar restrictions are implemented during
installation.
– Run only necessary services:
Any services that may be installed on the system, but not required for normal
operation are disabled by default. For example, while NFS is a service often
configured by customers for various application purposes, it is disabled by default as
it is not required for normal database operations. Customers may choose to
optionally configure services per their requirements.
• Minimized Attack Surface
As part of the hardened image, attack surface is reduced by disabling services.
• Additional Security Features Enabled (grub passwords, secure boot)
– Leveraging Exadata image capabilities, Exadata Cloud@Customer enjoys the
features integrated into the base image such as grub passwords and secure boot in
addition to many others.
– Through customization, customers may wish to further enhance their security posture
with additional configurations detailed later in this chapter.
• Secure Access Methods
– Accessing database servers through SSH using strong cryptographic ciphers. Weak
ciphers are disabled by default.
– Accessing databases via encrypted Oracle Net connections. By default, our services
are available using encrypted channels and a default configured Oracle Net client will
use encrypted sessions.
– Accessing diagnostics through Exadata MS web interface (https).
• Auditing and Logging
By default, auditing is enabled for administrative operations and those audit records are
communicated to OCI internal systems for automated review and alerting when required.
• Deployment-Time Considerations
– Wallet file download contents and sensitivity: The wallet file download that is obtained
by a customer to enable the deployment to occur contains sensitive information and
should be handled appropriately to ensure the contents are protected. The content of
the wallet file download is not needed after deployment is completed, so it should be
destroyed to ensure no information leakage occurs.
7-235
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
bin:x:1:1:bin:/bin:/bin/false
daemon:x:2:2:daemon:/sbin:/bin/false
adm:x:3:4:adm:/dev/null:/bin/false
mail:x:8:12:mail:/var/spool/mail:/bin/false
nobody:x:99:99:Nobody:/:/bin/false
systemd-network:x:192:192:systemd Network Management:/:/bin/false
dbus:x:81:81:System message bus:/:/bin/false
rpm:x:37:37::/var/lib/rpm:/bin/false
sshd:x:74:74:Privilege-separated SSH:/var/empty/sshd:/bin/false
rpc:x:32:32:Rpcbind Daemon:/var/lib/rpcbind:/bin/false
nscd:x:28:28:NSCD Daemon:/:/bin/false
saslauth:x:999:76:Saslauthd user:/run/saslauthd:/bin/false
mailnull:x:47:47::/var/spool/mqueue:/bin/false
smmsp:x:51:51::/var/spool/mqueue:/bin/false
chrony:x:998:997::/var/lib/chrony:/bin/false
rpcuser:x:29:29:RPC Service User:/var/lib/nfs:/bin/false
uucp:x:10:14:Uucp user:/var/spool/uucp:/bin/false
nslcd:x:65:55:LDAP Client User:/:/bin/false
tcpdump:x:72:72::/:/bin/false
exawatch:x:1010:510::/:/bin/false
7-236
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
dbmmonitor:x:2003:2003::/home/dbmmonitor:/bin/rbash
root:x:0:0:root:/root:/bin/bash
oracle:x:1001:1001::/home/oracle:/bin/bash
grid:x:1000:1001::/home/grid:/bin/bash
opc:x:2000:2000::/home/opc:/bin/bash
dbmadmin:x:2002:2002::/home/dbmadmin:/bin/bash
– root: Linux requirement, used sparingly to run local privileged commands. root is
also used for some processes like Oracle Trace File Analyzer Agent and ExaWatcher.
– grid: Owns Oracle Grid Infrastructure software installation and runs Grid
Infastructure processes.
– oracle: Owns Oracle database software installation and runs Oracle Database
processes.
– opc:
* Used by Oracle Cloud automation for automation tasks.
7-237
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
7-238
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
Related Topics
• Security Features of Oracle Exadata Database Machine
7-239
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
• Management Server (MS): Part of Exadata image software for managing and
monitoring the image functions.
– Runs as dbmadmin user.
– Process table shows it running as a Java process.
7-240
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
7-241
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
Note:
TNS listener opens dynamic ports after initial contact to well known ports
(1521, 1525).
#iptables -L -n -v
Chain INPUT (policy ACCEPT 0 packets, 0 bytes)
pkts bytes target prot opt in out source
destination
Customer Responsibilities
7-242
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
Option Description
-s, --status Displays current user password aging.
-u USER, --user=USER A valid interactive user's username.
--defaults Sets all password-aging values to *Exadata
factory defaults for all interactive users.
--secdefaults Sets all password-aging values to **Exadata
secure defaults for all interactive users.
--policy Sets all password-aging values to the aging policy
as defind by the password-policy command
(or /etc/login.defs) for all interactive users.
-M int, --maxdays=int Maximum number of days a password may be
used. Input limited to from 1 to 99999.
7-243
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
Option Description
-m int, --mindays=int Minimum number of days allowed between
password changes. Input limited to from 0 to
99999, 0 for anytime.
-W int, --warndays=int Number of days warning given before a password
expires. Input limited to from 0 to 99999.
host_access_control password-policy --PASS_MAX_DAYS integer (60)*
--PASS_MIN_DAYS integer ( 1)*
--PASS_MIN_LEN integer ( 8)*
--PASS_WARN_AGE integer ( 7)*
--defaults
--status
Options Description
-h, --help Shows this help message and exits.
-d DENY, --deny=DENY Number of failed login attempts before an
account will be locked. Input is limited to from
1 to 10. (*Exadata factory default is 5)
-l LOCK_TIME, --lock=LOCK_TIME Number of seconds (integer) an account will
be locked due to a single failed login attempt.
Input is limited to from 0 to 31557600 (one
year) (*Exadata factory default is 600 (10m))
-p list, --passwdqc=list FOR SYSTEMS RUNNING ON LESS THAN
OL7
Comma-separated set of 5 values:
N0,N1,N2,N3,N4 defining the minimum
allowed length for different types of password/
passphrases. Each subsequent number is
required to be no larger than the preceding
one. The keyword "disabled" can be used to
disallow passwords of a given kind regardless
of their length. (Refer to the pam_passwdqc
manpage for an explanation).
Passwords must use three character classes.
Character classes for passwords are digits,
lowercase letters, uppercase letters, and other
characters. Minimum password length is 12
characters when using three character
classes.
Minimum password length is 8 characters
when using four character classes. ( *Exadata
factory default is 5,5,5,5,5) (**Exadata secure
default is disabled,disabled,16,12,8)
7-244
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
Options Description
-q PWQUALITY, --pwquality=PWQUALITY FOR SYSTEMS RUNNING ON OL7 AND
GREATER
Integer, ranging from 6 to 40, defining the
minimum allowed password length. defined by
the Exadata secure defaults. All classes will be
required for password changes as well as
other checks enforced for lengths >7. For
lengths <8, class requirements are not used.
(*Exadata factory default is: minlen=8
dcredit=-1 ucredit=-1 lcredit=-1 ocredit=-1
difok=8 maxrepeat=3 maxclassrepeat=4)
(**Exadata secure default is: minlen=15
dcredit=-1 ucredit=-1 lcredit=-1 ocredit=-1
difok=8 maxrepeat=3 maxclassrepeat=4)
(Refer to the pam_pwquality manpage for
details)
-r REMEMBER, --remember=REMEMBER The last n passwords to remember for
password change history. Valid range is an
integer from 0 to 1000.
(*Exadata factory default is 10)
--defaults Sets all pam-auth values to *Exadata factory
defaults.
--secdefaults Sets all pam-auth values to **Exadata secure
defaults.
-s, --status Displays current PAM authentication settings.
man iptables : To get iptables help. Various websites online have many tutorials as well.
Refer to earlier section "Guest VM Network Security" for details on what ports may be
required on Guest VM. To configure the firewall manually, create commands like the following
example. Note that it is possible to lock yourself out of the system by blocking the ports over
which you connect, so it's recommended to consult a test system and engage an experienced
iptables administrator if possible.
1. At the command prompt, enter the appropriate command for each port to be opened, for
example:
7-245
Chapter 7
Security Guide for Exadata Database Service on Cloud@Customer Systems
Pay Attention to What Actions May Impact Service-Related Logins for Cloud
Automation
For example, procedures will include ensuring that authorized keys used for cloud
automation actions remain intact.
For more information about Physical Network access controls including guidelines for
Oracle Cloud Automation, see Oracle Gen2 Exadata Cloud@Customer Security
Controls.
7-246
Chapter 7
Troubleshooting Exadata Database Service on Cloud@Customer Systems
Oracle Cloud Automation access to the customer VM is controlled through token based SSH.
Public keys for Oracle Cloud Automation access are stored in the authorized keys files of the
oracle, opc, and root users of the customer VM. The private keys used by the automation
are stored and protected by the Oracle Cloud Automation software running in the Exadata
Cloud@Customer hardware in the customer’s data center. The customer’s OCI Identity and
Access Management (IAM) controls govern if and how a customer can execute Oracle Cloud
Automation functionality against the customer VM and databases. The customer may further
control access through the management network and Oracle Cloud Automation keys by
blocking network access (firewall rules, disabling network interface), and by revoking the
credentials used by the Oracle Cloud Automation (remove the public keys from the
authorized keys files). Oracle Cloud Automation Access may be temporarily restored by the
customer to permit the subset of functionality required to access the customer VM and
customer databases, such as customer VM operating system patching. Oracle Cloud
Automation does not need network access the customer VM to perform OCPU scaling, and
OCPU scaling functionality will function normally when customers block Oracle Cloud
Automation network access to the customer VM.
7-247
Chapter 7
Troubleshooting Exadata Database Service on Cloud@Customer Systems
7-248
Chapter 7
Troubleshooting Exadata Database Service on Cloud@Customer Systems
If Oracle Grid Infrastructure is down, then restart by running the following commands:
The system returns a message including the database instance status. The instance status
must be Open for the patching operation to succeed.
If the database is not running, use the following command to start it:
7-249
Chapter 7
Troubleshooting Exadata Database Service on Cloud@Customer Systems
DBAASCLI Logs
/var/opt/oracle/log/dbaascli
• dbaascli.log
For more information about the usage of this utility, see DBAAS Tooling: Using
dbaascli to Collect Cloud Tooling Logs and Perform a Cloud Tooling Health Check.
Related Topics
• DBAAS Tooling: Using dbaascli to Collect Cloud Tooling Logs and Perform a
Cloud Tooling Health Check
7-250
Chapter 7
Troubleshooting Exadata Database Service on Cloud@Customer Systems
Action:
1. Upgrade Grid Infrastructure version to 19.11 or above.
(OR)
Disable rhphelper before updating and enable it back after updating.
To disable before updating is started:
/u01/app/19.0.0.0/grid/srvm/admin/rhphelper /u01/app/19.0.0.0/grid
19.10.0.0.0 -setDrainAttributes ENABLE=false
If you disable rhphelper, then there will be no database connection draining before
database services and instances are shutdown on a node before the operating system is
updated.
2. If you missed disabling RHPhelper and upgrade is not progressing and hung, then it is
observed that the draining of services is taking time:
a. Inspect the /var/log/cellos/dbnodeupdate.trc trace file, which contains a
paragraph similar to the following:
(ACTION:) Executing RHPhelper to drain sessions and shutdown instances.
(trace: /u01/app/grid/crsdata/<nodename>/rhp//executeRHPDrain.150721125206.trc)
If rhphelper hangs, then the trace file contains the message as follows:
(ACTION:) Executing RHPhelper to drain sessions and shutdown instances.
c. Identify the rhphelper processes running at the operating system level and kill them.
There are two commands that will have the string “rhphelper” in the name – a Bash
shell, and the underlying Java program, which is really rhphelper executing.
rhphelper runs as root, so must be killed as root (sudo from opc).
For example:
7-251
Chapter 7
Troubleshooting Exadata Database Service on Cloud@Customer Systems
d. Verify that the dbnodeupdate.trc file moves and the Grid Infrastructure
stack on the node is shutdown.
For more information about RHPhelper, see Using RHPhelper to Minimize
Downtime During Planned Maintenance on Exadata (Doc ID 2385790.1).
Related Topics
• Using RHPhelper to Minimize Downtime During Planned Maintenance on Exadata
(Doc ID 2385790.1)
Cause: Data Guard-enabled databases will not be extended to the newly added VM.
And therefore, the <db>.ini file will also not be updated because the database
instance is not configured in the new VM.
7-252
Chapter 7
Troubleshooting Exadata Database Service on Cloud@Customer Systems
Action: To add an instance to primary and standby databases and to the new VMs (Non-
Data Guard), and to remove an instance from a Data Guard environment, see My Oracle
Support note 2811352.1.
Related Topics
• https://support.oracle.com/epmos/faces/DocContentDisplay?id=2811352.1
common_dcs_agent_bindHost=<IP_Address>
common_dcs_agent_port=7070
Note:
The common_dcs_agent_port value is 7070 always.
For example:
You can specify either of the two IP addresses, <IP address 1> or <IP address 2> for the
common_dcs_agent_bindHost parameter.
7-253