Exadata Cloud Management Interfaces
Oracle Exadata Database Service on Cloud@Customer provides a variety of management interfaces to fit your use case and automation needs.
- Introduction to Exadata Cloud Management Interfaces
The Exadata Cloud resources on Oracle Cloud Infrastructure (OCI) are created and managed through a variety of interfaces provided to fit your different management use cases. - OCI Control Plane Interfaces
- Local VM Command-Line Interfaces
Introduction to Exadata Cloud Management Interfaces
The Exadata Cloud resources on Oracle Cloud Infrastructure (OCI) are created and managed through a variety of interfaces provided to fit your different management use cases.
- OCI Console interface and automation tools, see Using the Console
- Application Programming Interfaces (APIs)
- Command-Line Interfaces (CLIs)
- OCI Control Plane Interfaces
- Local Exadata Cloud VM CLIs
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
Parent topic: Exadata Cloud Management Interfaces
OCI Control Plane Interfaces
The OCI APIs are typical REST APIs that use HTTPS requests and responses. The OCI Console, an intuitive, graphical interface for creating and managing your Exadata Cloud and other OCI resources, is one of the interfaces to the OCI APIs. When looking to develop automation utilizing the OCI APIs, a number of additional interfaces including: kits, tools and plug-ins, are provided to facilitate development and simplify the management of OCI resources. A subset of these APIs apply to Exadata Cloud resources and its infrastructure. Each of these interfaces can be used to accomplish the same functionality, all calling the OCI APIs, and are provided to enable flexibility and choice depending on preference and use case.
- Command Line Interface (CLI): The OCI CLI is a small footprint tool that you can use on its own or with the Console to complete Exadata Cloud resource and other OCI tasks. The CLI provides the same core functionality as the Console, plus additional commands. Some of these, such as the ability to run scripts, extend the Console's functionality.
- Software Development Kits (SDK): OCI provides SDKs to enable the developing custom solutions for your Exadata Cloud and other OCI based services and applications.
- DevOps Tools and Plug-ins: These tools can simplify provisioning and managing infrastructure, enable automated processes and facilitate development. Tools include the OCI Terraform Provider used with Resource Manager and OCI Ansible Collection.
- Cloud Shell: Cloud Shell is a free-to-use, browser-based terminal, accessible from the OCI Console, that provides access to a Linux shell with pre-authenticated OCI CLI and other useful developer tools. You can use the shell to interact with Exadata Cloud and other OCI resources, follow labs and tutorials, and quickly run OCI CLI commands.
- Appendix and Reference: This general reference shows how to configure the SDKs and other developer tools to integrate with Oracle Cloud Infrastructure services.
- REST APIs: This complete reference provides details on the Oracle
Cloud Infrastructure REST APIs, including descriptions, syntax, endpoints, errors,
and 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 Oracle Exadata Database Service on Cloud@Customer Infrastructure
- Using the API to Manage Oracle Exadata Database Service on Cloud@Customer Backup Destinations
- Using the API to Manage Oracle Exadata Database Service on Cloud@Customer VM Clusters
- Using the API to Create Oracle Database Home on Oracle Exadata Database Service on Cloud@Customer
- Using the API to Manage Oracle Database Home on Oracle Exadata Database Service on Cloud@Customer
- Using the API to Manage Oracle Database Components
- Using the API to Manage Data Guard Associations on an Oracle Exadata Database Service on Cloud@Customer System
- Using the API to Manage Database Backup and Recovery
- Using the API for Patching and Updating VM Cluster and Database Homes
Parent topic: Exadata Cloud Management Interfaces
Local VM Command-Line Interfaces
In addition to the OCI REST-based APIs, CLI utilities located on the VM guests, provisioned as part of the VM clusters on the Exadata Cloud Infrastructure, are available to perform various lifecycle and administration operations.
The best practice is to use these utilities when a corresponding OCI API is not available or the Exadata Cloud@Customer is in a disconnected mode.
- dbaascli: Use the
dbaascli
utility to perform various database lifecycle and administration operations on the Exadata Cloud Service such as- changing the password of a database user
- starting a database
- managing pluggable databases (PDBs)
- scaling the CPU core count in disconnected mode
- bkup_api: Use the
bkup_api
utility to perform various backup and recovery operations on the Exadata Cloud Service such as creating an on-demand backup of a complete database or an individual pluggable database (PDB), or to customize backup settings used by the automatic backup configuration - ExaCLI: Use the ExaCLI command-line utility to perform monitoring and management functions on Exadata storage servers in the Exadata Cloud.
These utilities are provided in addition to, and separate from, the OCI
API-based interfaces listed above. To use the local VM command-line utilities, you must
be connected to a virtual machine in an Exadata Cloud VM cluster and use the VM
operating system user security, not the OCI user security, for execution. The utilities
can be used to perform operations if the Exadata Cloud@Customer is disconnected from the
OCI Control Plane. Most operations executed by these utilities sync their changes back
to the OCI Control Plane using a process called DB Sync
. However, there
can be operations not synced with the Control Plane.
The cloud tooling software on the virtual machines, containing these CLI utilities, is automatically updated by Oracle on a regular basis. If needed, the tooling can be updated manually by following the instructions in Updating Cloud Tooling Using dbaascli.
Related Topics
- About Using the dbaascli Utility on Oracle Exadata Database Service on Cloud@Customer
- Creating an On-Demand Backup by Using the bkup_api Utility
- Customizing Backup Settings by Using a Generated Configuration File
- Monitoring and Managing Exadata Storage Servers with ExaCLI
- Updating Cloud Tooling Using dbaascli
Parent topic: Exadata Cloud Management Interfaces