Instances created using Oracle-Provided Images based on Oracle Linux include a pre-installed set of utilities that are designed to make it easier to work with Oracle Linux images. These utilities consist of a service component and related command line tools that can help with managing block volumes (attach, remove, and automatic discovery), secondary VNIC configuration, discovering the public IP address of an instance, and retrieving instance metadata.
The following table summarizes the components that are included in the OCI utilities.
||The service component of oci-utils. This normally runs as a daemon started via
||Expands the root filesystem of the instance to its configured size.|
||Used to display and configure iSCSI devices attached to a compute instance. If no command line options are specified, lists devices that need attention.|
||Displays metadata for the compute instance. If no command line options are specified, lists all available metadata. Metadata includes the instance OCID, display name, compartment, shape, region, availability domain, creation date, state, image, and any custom metadata that you provide, such as an SSH public key.|
||Lists or configures Virtual Network Interface Cards (VNICs) attached to the compute instance. Lists the current Virtual Network Interface Cards (VNICs) provisioned in the cloud and configured on the instance. When a secondary VNIC is provisioned in the cloud, it must be explicitly configured on the instance using this script or similar commands.|
||Displays a detailed report for a given compartment or network.|
||Displays the public IP address of the current system in either human-readable or JSON format.|
Installing the OCI Utilities
The OCI utilities are automatically included with instances launched with an Oracle Linux image. They are not currently available on other distributions.
The Oracle Cloud Infrastructure CLI can be installed using
yum install python-oci-cli
For configuration information, please see the Oracle Cloud Infrastructure Python SDK documentation and the documentation for configuring the Oracle Cloud InfrastructureCLI.
Updating the OCI Utilities
To update to the latest version of the OCI Utilities:
$ sudo yum update oci-utils
Using the OCI Utilities
To use the OCI utilities, you first need to start the ocid service:
sudo systemctl start ocid.service
Redirecting to /bin/systemctl start ocid.service