oracle / oci-utils

Oracle Cloud Infrastructure utilities

OCI Utilities

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;
• retrieving instance metadata;
• sending notification messages.

The following list summarizes the components that are included in the OCI utilities.

• ocid The service component of oci-utils. This normally runs as a daemon started via systemd. This service scans for changes in the iSCSI and VNIC device configurations and caches the OCI metadata and public IP address of the instance.
• oci-growfs Expands the root filesystem of the instance to its configured size.
• oci-iscsi-config Used to display and configure iSCSI devices attached to a compute instance.
• oci-metadata Displays metadata for the compute instance.
• oci-network-config Lists or configures virtual network interface cards (VNICs) attached to the Compute instance.
• oci-network-inspector Displays a detailed report for a given compartment or network.
• oci-public-ip Displays the public IP address of the current system in either human-readable or JSON format.
• oci-notify Sends a message to an OCI notification service.

For usage details, see the OCI Utilities section of the Oracle Cloud Infrastructure documentation.

oci-utils's Issues

The script oci-image-cleanup needs to remove /root/.ssh/authorized_keys

The script oci-image-cleanup needs to remove /root/.ssh/authorized_keys.

Currently it doesn’t if the /etc/passwd is not containing /bin/bash or /bin/sh. Probably /bin/csh needs to be added too. In my case the value is /sbin/nologin I think

oci-public-ip -j doesn't print valid json, -g has extra text

In some situations, it looks like warning messages are getting sent to stdout when they should maybe get sent to stderr.
I don't know why this warning appears either, as it's a vanilla instance in IAD with 1 vnic. Actual ip obfuscated.

sudo dnf list installed | grep utils | grep oci
oci-utils.noarch                         0.14.0-2.el8                                @ol8_oci_included 

oci-public-ip -j
No public ip addresses found from OCI, falling back to the stun servers.
The stun servers do not provide details on the vNIC and might find only the primary IP address.

[{"IP Address": "XXX"}]

oci-public-ip -j 2>/dev/null
No public ip addresses found from OCI, falling back to the stun servers.
The stun servers do not provide details on the vNIC and might find only the primary IP address.

[{"IP Address": "XXX"}]

oci-public-ip -j 2>/dev/null | jq .
parse error: Invalid numeric literal at line 1, column 3

oci-public-ip -g
No public ip addresses found from OCI, falling back to the stun servers.
The stun servers do not provide details on the vNIC and might find only the primary IP address.

   XXX

oci-public-ip -g 2>/dev/null
No public ip addresses found from OCI, falling back to the stun servers.
The stun servers do not provide details on the vNIC and might find only the primary IP address.

   XXX

oci-public-ip fails

Hi, running oci-public-ip is failing in my oci instance:

  Instance shape: VM.Standard2.1
  Image ID: ocid1.image.oc1.iad.aaaaaaaabip6l5i5ikqsnm64xwrw2rrkj3tzo2dv47frowlt3droliwpvfaa
  ociAdName: iad-ad-1
  regionIdentifier: us-ashburn-1

Stacktrace:

Traceback (most recent call last):
  File "/usr/lib/python3.6/site-packages/oci_utils/impl/oci-public-ip-main.py", line 175, in <module>
    sys.exit(main())
  File "/usr/lib/python3.6/site-packages/oci_utils/impl/oci-public-ip-main.py", line 140, in main
    stun_host=args.stun_server)[1]
  File "/usr/lib/python3.6/site-packages/oci_utils/packages/stun/__init__.py", line 332, in get_ip_info
    stun_host=stun_host, stun_port=stun_port)
  File "/usr/lib/python3.6/site-packages/oci_utils/packages/stun/__init__.py", line 256, in get_nat_type
    ret = stun_test(s, stun_host, port, source_ip, source_port)
  File "/usr/lib/python3.6/site-packages/oci_utils/packages/stun/__init__.py", line 178, in stun_test
    bind_resp_msg = dictValToMsgType[msgtype] == "BindResponseMsg"
KeyError: b'0101'

I've made no changes to the instance since provisioning, other than installing a jvm package (java-latest-openjdk-headless.x86_64) and mounting a block volume.

James

oci-growfs: command not found

Curerent Package

oci-utils-0.12.7-1.el7.noarch

I checked with others command like oci-metadata, and also see

ocid: command not found

[enhancement] extend OS support: ubuntu

It will be great that if we can provide a guideline to install oci-utils on Ubuntu or debian-like system.