2 Installing Oracle API Manager

This chapter describes how to install the Oracle API Manager software.

The following topics are covered:

2.1 Planning the Installation

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.

2.1.1 Product Distribution

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

https://edelivery.oracle.com/

Note:

You must accept the license agreement before you download the installation files.

2.1.2 Verifying Certification, System Requirements, and Interoperability

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.

2.1.2.1 Verifying Your Environment Meets Certification Requirements

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.

2.1.2.2 Using the System Requirements Document to Verify Certification

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.

2.1.2.3 Verifying Interoperability Among Multiple Products

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.

2.2 Installing Software Required for an API Manager Installation

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:

2.2.1 Installing a Certified JDK

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.

2.2.2 Installing and Configuring a Certified Database

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:

2.2.3 Installing Oracle Fusion Middleware 12c Infrastructure

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

https://edelivery.oracle.com/

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.

2.3 Installing the Oracle API Manager Software

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:

  1. Acquire the Oracle Service Bus 12.2.1 installation zip file from the Oracle Software Delivery Cloud at https://edelivery.oracle.com/:
    1. Sign onto the Oracle Software Delivery Cloud.
    2. Enter Oracle Service Bus into the Product field.
    3. Click Select Platform, select the platform on which you want to install the product, and then click Select.
    4. Click Continue.
    5. Expand the release series, and then select only the entry for the Service Bus 12.2.1 release. Ensure the other options are not selected.
    6. Click Continue. Review any license agreements that appear, select the option that indicates that you have reviewed and accept the license terms, and then click Continue.
    7. Click Download All to download the Service Bus 12.2.1 installation zip.
  2. Extract the contents of the installation zip file to a local directory. Verify that the extracted directory contains the installation file: fmw_12.2.1.0.0_osb.jar
  3. Review and complete the tasks described in the following sections in Installing and Configuring Oracle Service Bus:
The API Manager software is now installed.

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.

2.4 Next Steps

The next steps include creating the required database schemas and configuring the Oracle WebLogic Server domain for API Manager.

See Configuring the Oracle API Manager Domain to complete the necessary tasks.