This chapter describes how to install the Oracle API Manager software.
The following topics are covered:
This section describes topics you must be familiar with prior to installing Oracle API Manager, including where to acquire the software, verifying that your system meets the operating requirements, and installing software that is required for an API Manager installation.
The Oracle API Manager software is installed using the Oracle Service Bus 12.2.1 installation files. You must obtain the Oracle Service Bus 12.2.1 installation files from the Oracle Software Delivery Cloud located at
Note:
You must accept the license agreement before you download the installation files.
Oracle recommends that you use the certification matrix and system requirements documents in conjunction with each other to verify that your environment meets the necessary requirements for installation.
Make sure that you are installing your product on a supported hardware and software configuration. For more information, see the certification document for your release on the Oracle Fusion Middleware Supported System Configurations page.
Oracle has tested and verified the performance of your product on all certified systems and environments; whenever new certifications occur, they are added to the proper certification document right away. New certifications can occur at any time, and for this reason the certification documents are kept outside of the documentation libraries and are available on Oracle Technology Network.
Oracle recommends that you use the Oracle Fusion Middleware System Requirements and Specifications document to verify that the requirements of the certification are met. For example, if the certification document indicates that your product is certified for installation on 64-Bit Oracle Linux 6, this document should be used to verify that your Oracle Linux 6 system has met the required minimum specifications, like disk space, available memory, specific platform packages and patches, and other operating system-specific items. System requirements can be updated at any time, and for this reason the system requirement documents are kept outside of the documentation libraries and are available on Oracle Technology Network.
The Understanding Interoperability and Compatibility document defines interoperability, defines compatibility, and describes how multiple Fusion Middleware products from the same release or mixed releases may be used with each other. You should read this document if you are planning to install multiple Fusion Middleware products on your system.
You must complete the tasks described in this section to install the required software before installing API Manager. You must install a certified JDK, install and configure a certified database, and install the Oracle Fusion Middleware 12c infrastructure.
This section describes the following topics:
Before you can install Oracle API Manager, you must download and install a supported JDK on your system before attempting to run the installer.
Make sure that the JDK is installed outside of the Oracle home. The Oracle Universal Installer validates that the designated Oracle home directory is empty, and the install will not progress until an empty directory is specified. If you install JDK under Oracle home, you will experience issues in future operations. So, it is recommended that you use the /home/oracle/products/jdk directory for the location of your JDK installation. You can then use the java -jar command to run the installer JAR file.
At the time this document was published, Oracle Fusion Middleware products required JDK 8.0 Update 40 or later. However, you should always verify the required JDK version by reviewing the certification information, as described in Verifying Certification, System Requirements, and Interoperability.
To download the required JDK, use your browser to navigate to the following URL and download the Java SE JDK: http://www.oracle.com/technetwork/java/javase/downloads/index.html.
Oracle API Manager requires database schemas prior to domain configuration. If you do not already have a database where you can install these schemas, you must install and configure a certified database.
To find a certified database for your operating system, see the certification document for your release on the Oracle Fusion Middleware Supported System Configurations page.
To make sure your database is properly configured for schema creation, see "Verifying Requirements for Oracle Repository Creation Utility" in the Oracle Fusion Middleware System Requirements and Specifications document.
Note:
For 12c (12.2.1), only a certified Oracle database can be used for the Oracle Fusion Middleware Infrastructure standard installation topology.
See the following references for more information about creating your product schemas:
The Repository Creation Utility (RCU) is the tool used to create schemas in your database. This tool is available by installing the Oracle Fusion Middleware Infrastructure. For more information, see Installing and Configuring the Oracle Fusion Middleware Infrastructure.
See Creating the Database Schemas for the specific schemas required by Oracle API Manager along with instructions to create the schemas.
Refer to Creating Schemas with the Repository Creation Utility for more information about the Repository Creation Utility.
After you have installed the JDK and installed and configured a certified database, you must install an Oracle WebLogic Server instance. After installing Oracle API Manager and creating the required database schemas, you configure a domain and deploy the application to a WebLogic server instance.
The latest version of Oracle WebLogic Server is available by installing the Oracle Fusion Middleware Infrastructure.
Note:
You must install Oracle WebLogic server using the Oracle Fusion Middleware 12c (12.2.1.0.0) Infrastructure installer that includes Java Required Files (JRF). JRF consists of components not typically included in WebLogic Server installations that provide common functionality for Oracle business applications and application frameworks.
You must obtain this installer from the Oracle Software Delivery Cloud located at
Installing WebLogic Server using another installer will cause the API Manager installation to fail.
For more information about installing and configuring the Oracle Fusion Middleware Infrastructure, see Installing and Configuring the Oracle Fusion Middleware Infrastructure.
API Manager is installed when you install Oracle Service Bus 12.2.1. API Manager and Oracle Service Bus must be installed into the same Oracle home into which you installed the Oracle Fusion Middleware infrastructure. See "Planning Your Oracle Service Bus Installation" and "Installing the Oracle Service Bus Software" in Installing and Configuring Oracle Service Bus for more information about installing Service Bus.
To install API Manager and Oracle Service Bus:
Note:
You do not need to deploy Oracle Service Bus to a WebLogic Server domain. The Service Bus domain template will be selected and deployed as a part of the API Manager domain configuration, as described in Configuring the Oracle API Manager Domain.
Extending an existing Service Bus domain with an API Manager domain is not supported in this release.
Complete the tasks in Configuring the Oracle API Manager Domain to create the required database schemas and configure the Oracle WebLogic Server domain for API Manager.