OCI Utilities

Oracle Linux instances come with the Oracle Cloud Infrastructure (OCI) utilities (oci-utils) package installed. These utilities aren't available on other distributions.

To use the OCI utilities, you must meet the following prerequisites:

• The oci_included repository is enabled. This repository is enabled by default in Oracle Linux platform images. The repository contains all required packages, including the required OCI SDK and Python packages. The oci-utils package provides all the dependencies.
• The OCI utilities have the required permissions to access Oracle Cloud Infrastructure. This can be achieved by doing one of the following:
  • Create the SDK configuration file for the host. For more information, see SDK and CLI Configuration File.
    Note
    
    You might need to install the CLI before running the oci setup config command to create the SDK configuration file. For more information, see Installing the CLI.
  • Use instance principals by adding the instance to a dynamic group that has access to Oracle Cloud Infrastructure services. For more information, see Managing Dynamic Groups.
  • Configure oci-utils to let the root account use a unprivileged user's OCI configuration files. For more information, see the configuration file in the instance's /etc/oci-utils.conf.d directory.
• After ensuring that the OCI utilities have the necessary permissions, select which of the following methods to use to access the utilities and perform any required setup for that method:
  • OCI CLI from an instance or remote host: A CLI terminal connected to an instance or remote host where you can run the OCI utilities. For more information about the CLI and how to get started with it, see Command Line Interface (CLI) and CLI Quickstart.
  • OCI Software Development Kit (SDK): A set of developer tools that let you write code and manage OCI resources. For more information, see Software Development Kits and Command Line Interface.

For a video showing how to install and set up the OCI utilities, see Enabling OCI Utilities in Oracle Linux on Oracle Cloud Infrastructure Instances.

To update to the latest version of oci-utils, run the following command:

sudo dnf update oci-utils

The ocid daemon is the service component of oci-utils. It monitors changes in the VNIC and iSCSI configuration of the instance and tries to automatically attach or detach devices as they appear or disappear. For example, when they're created, or deleted using the Oracle Cloud Infrastructure Console, CLI, or the API.

To start the ocid daemon immediately using systemd and start automatically when the system boots, run the following command:

sudo systemctl enable --now ocid.service

To confirm that the service is active (running), run the following command:

sudo service ocid status

The output is similar to the following:

$ sudo service ocid status
Redirecting to /bin/systemctl status ocid.service
● ocid.service - Oracle Cloud Infrastructure utilities daemon
     Loaded: loaded (/etc/systemd/system/ocid.service; enabled; preset: disabled)
     Active: active (running) since date and time; 9s ago
 Invocation: edd65c2c534949f3a3fb1a77d0aecccf
   Main PID: 361841 (python3)
      Tasks: 4 (limit: 72765)
     Memory: 127.3M (peak: 127.8M)
        CPU: 1.424s
     CGroup: /system.slice/ocid.service
             └─361841 /usr/bin/python3 /usr/lib/python3.12/site-packages/oci_utils/impl/ocid_main.py --no-daemon
date and time hostname systemd[1]: Starting ocid.service - Oracle Cloud Infrastructure utilities daemon...
date and time hostname systemd[1]: Started ocid.service - Oracle Cloud Infrastructure utilities daemon.