Oracle® Enterprise Manager Ops Center Cloud Infrastructure API and CLI Reference Guide 12c Release 1 (12.1.1.0.0) Part Number E25150-03 |
|
|
PDF · Mobi · ePub |
This chapter identifies the prerequisites for the Cloud Infrastructure APIs and CLI. The chapter also describes how to install and configure the APIs and CLI.
The following topics are covered in this chapter:
The following prerequisites must be met before using the APIs and CLI:
Installation of Java Runtime Environment (JRE) or Java Development Kit (JDK) version 1.6 or later appropriate for the platform where the APIs and CLI are planned to be run or installed.
Access to the Enterprise Controller.
This section explains the installation process for the APIs and CLI.
The Web Service is automatically installed on the Enterprise Controller as part of the Oracle Enterprise Manager Ops Center installation process. No further steps are required.
The Java API is delivered as a separate package as part of the Oracle Enterprise Ops Center product. This package can be installed as a standalone package in a different computer with connection to the Enterprise Controller.
Package name | Operating System |
---|---|
ORCL-sysman-iaas-api.pkg | Solaris |
orcl-sysman-iaas-api.rpm | Linux |
To install this package, follow these steps as root user:
For Solaris:
# cd <repo>/src/dvd/SunOS_i386/Product/components/packages/ # pkgadd -d ORCLsysman-iaas-api.pkg
For Linux:
# cd <repo>/src/dvd/Linux_i686/Product/components/packages/ # rpm -i orcl-sysman-iaas-api.rpm
The API jar files from the package will be stored at /opt/oracle/iaas/iaas-java-api
.
Before using the API jar file set the JAVA_HOME
environment variable and ensure that it is part of your PATH.
The Cloud Infrastructure CLI is delivered as a separate package as part of the Oracle Enterprise Ops Center product. This package can be installed as standalone package in a different computer with connection to the Enterprise Controller.
Package name | Operating System |
---|---|
ORCLsysman-iaas-cli.pkg | Solaris |
orcl-sysman-iaas-cli.rpm | Linux |
To install this package, follow these steps as root user:
For Solaris:
# cd <repo>/src/dvd/SunOS_i386/Product/components/packages/ # pkgadd -d ORCLsysman-iaas-cli.pkg
For Linux:
# cd <repo>/src/dvd/Linux_i686/Product/components/packages/ # rpm -i orcl-sysman-iaas-cli.rpm
The files from the package will be stored at /opt/oracle/iaas/cli
. The user in charge of executing the CLI commands needs to have permissions to access this directory.
Before using the Cloud Infrastructure CLI:
Set JAVA_HOME
environment variable and ensure that it is part of your PATH:
Korn and bash shells:
export JAVA_HOME=<jdk-install-dir> export PATH=$JAVA_HOME/bin:$PATH
Bourne shell:
JAVA_HOME=<jdk-install-dir> export JAVA_HOME PATH=$JAVA_HOME/bin:$PATH export PATH
C shell:
setenv JAVA_HOME <jdk-install-dir> setenv PATH $JAVA_HOME/bin:$PATH export PATH=$JAVA_HOME/bin:$PATH
Set IAAS_HOME
environment variable:
Korn and bash shells:
export IAAS_HOME=/opt/oracle/iaas/cli
Bourne shell:
IAAS_HOME=/opt/oracle/iaas/cli export IAAS_HOME
C shell:
setenv IAAS_HOME /opt/oracle/iaas/cli
Before using the APIs or CLI, the following tasks must be completed by your cloud administrator:
Create vDC and an account for the vDC.
Create a cloud user an associate it with the account and vDC.
After getting the cloud user credentials, a cloud user must create an access key for the account in order to manage any resource in the account, see "Creating an Access Key".