Overview

The OCI to Umbrella BYOD Transfer Agent is an automated daemon that continuously monitors your Oracle Cloud Infrastructure (OCI) Object Storage for FOCUS cost reports and transfers them to your Umbrella BYOD S3 bucket.

What it does

• Pulls OCI Object Storage every 10 minutes for new FOCUS reports.
• Streams files directly from OCI to S3 (no disk space needed).
• Renames files with date prefixes (YYYY-MM-DD_filename.csv.gz)
• Tracks transferred files to avoid duplicates.
• Supports parallel transfers (3 files at once).
• Retries failed transfers with exponential backoff.

Setup

Prerequisites

System Requirements

• Operating System: Linux (Ubuntu, RHEL, CentOS, Debian, Fedora)
• Python: Version 3.8 or higher
• Memory: Minimum 512 MB RAM (recommended 1 GB)
• Network: Stable internet connection for OCI and AWS access

Required Access

• Oracle OCI: Read access to FOCUS reports in Object Storage
• AWS S3: Write access to Umbrella BYOD bucket

Python Dependencies

The following Python packages are required:

• boto3 - AWS SDK for Python
• oci - Oracle Cloud Infrastructure SDK
• PyYAML - YAML configuration parser

Installation

• OCI BYOD Agent github
• Installation Detailes