B Installing the Cloud Management API and CLI

This appendix describes how to install and configure Cloud Management API and CLI interfaces in the Exalogic Elastic Cloud environment.

It contains the following topics:

B.1 Prerequisites

The following are the prerequisites for installing Cloud Management API and CLI:

  • Installation of Java Runtime Environment (JRE) or Java Development Kit (JDK) version 1.6 or higher, necessary for the platform on which the Cloud Management API and the CLI will be installed

  • Access to the VM that hosts the Enterprise Controller component of Exalogic Control

B.2 Installation

This section contains the following topics:

B.2.1 Installing Cloud Management API

The Cloud Web Service is automatically installed in the VM that hosts the Enterprise Controller component of Exalogic Control during the Exalogic Control installation. You do not need to install the API separately on the VM that hosts the Enterprise Controller.

B.2.2 Installing Java Client API

The Java Client API is delivered as a separate package with Oracle Enterprise Manager Ops Center. You can install the Java Client API as a standalone package on a different machine with connection to the VM that hosts the Enterprise Controller component of Exalogic Control.

If you are installing this client API on a machine running Oracle Solaris, you must install the ORCL-sysman-iaas-api.pkg package. If you are installing this client API on a machine running Oracle Linux, you must install the orcl-sysman-iaas-api.rpm package.

You must copy these packages from the VM that hosts the Enterprise Controller component of Exalogic Control (/var/opt/orcl/orcl-sysman-oes-template-config/dvd/Linux_i686/Product/components/packages/ or /var/opt/orcl/orcl-sysman-oes-template-config/dvd/SunOS_i386/Product/components/packages/) to the remote machine on which you are installing the Java Client API.

You can install the Java client API on the remote machine as follows:

  1. Log in to the remote machine as the root user.

  2. Move to the directory in which you copied the Java Client API package from the VM hosting the Enterprise Controller.

  3. Install the package as follows:

    On Solaris: #pkgadd -d ORCLsysman-iaas-api

    On Linux: #rpm -i orcl-sysman-iaas-api*.rpm

    Note:

    The files from the API jar package are stored in the /opt/oracle/iaas/iaas-java-api directory. Before using the API jar file, set the JAVA_HOME environment variable and ensure that it is included your PATH environment variable.

B.2.3 Installing Cloud Management CLI

The Cloud Management CLI is delivered as a separate package with Oracle Enterprise Manager Ops Center. You can install this package as a standalone package on a different machine with connection to the VM that hosts the Enterprise Controller component of Exalogic Control.

If you are installing the CLI on a machine running Oracle Solaris, you must install the ORCL-sysman-iaas-cli.pkg package. If you are installing this CLI on a machine running Oracle Linux, you must install the orcl-sysman-iaas-cli.rpm package.

You must copy these packages from the VM that hosts the Enterprise Controller component of Exalogic Control (/var/opt/orcl/orcl-sysman-oes-template-config/dvd/Linux_i686/Product/components/packages/ or /var/opt/orcl/orcl-sysman-oes-template-config/dvd/SunOS_i386/Product/components/packages/) to the remote machine on which you are installing the IaaS CLI client.

You can install the CLI client on the remote machine as follows:

  1. Log in to the remote machine as the root user.

  2. Move to the directory in which you copied the IaaS CLI packages from the VM that hosts the Enterprise Controller component of Exalogic Control.

  3. Install the package as follows:

    On Solaris: #pkgadd -d ORCLsysman-iaas-cli

    On Linux: #rpm -i orcl-sysman-iaas-cli*.rpm

    Note:

    The files from the package are stored in the /opt/oracle/iaas/cli directory. The user running the CLI commands must have permissions to access this directory.

  4. Run the following commands:

    #cd /opt/oracle/iaas/cli/bin

    #export IAAS_HOME=/opt/oracle/iaas/cli

    #export JAVA_HOME=<location_of_Java>

  5. As a Cloud Admin user or Cloud User, set the base URL to the location of Enterprise Controller, as follows:

    ./akm-describe-accounts --base-url https://<EC_URL>/--user root --password-file ~/root.pwd.file

    EC_URL is the location of Enterprise Controller. You can set the variable IAAS_BASE_URL to avoid typing the location when running additional commands.

    #export IAAS_BASE_URL=https://<EC_URL>/