Introduction

This blog post explains how to install a Boomi Atom on an Ubuntu Linux (64-bit) machine following the official guidelines from Installing a local Atom on Linux, as well as the Boomi Atom Installation Checklist (Linux). This single script approach includes installing Amazon Corretto 11 for Java, creating a dedicated boomi user, and finally running the official Boomi Atom install script. Side Note: This script is a solid starting point, but you should always tailor it to your production and security needs—especially regarding credential management, logging, and compliance with your organization’s policies.

Prerequisites

• 64-bit Ubuntu Linux environment (physical, virtual, or cloud-based)
• Sudo (root) privileges to install packages and create a user
• Internet connectivity to download Amazon Corretto and Boomi installation script and push the atom.
• (Optional) A Boomi installation token if you want a non-interactive install
• Latest .deb download URL for Amazon Corretto 11

Implementation Script

Below is a single script that handles everything: installing Amazon Corretto, creating a dedicated boomi user, downloading the Boomi Atom installation script, and running that script. This aligns with the steps outlined in Boomi’s Installing a local Atom on Linux and Installation Checklist guides.

#!/usr/bin/env bash
#------------------------------------------------------------------------------
# Boomi Atom Installation Script for Ubuntu (64-bit)
#
# References:
#   - Boomi Docs: 
#       https://help.boomi.com/docs/atomsphere/Integration/Atom,%20Molecule,%20and%20Atom%20Cloud%20setup/t-atm-Installing_a_local_Atom_on_Linux_4bcd02f0-6f21-444c-a861-cbdfba8f1550
#       https://help.boomi.com/docs/atomsphere/integration/atom,%20molecule,%20and%20atom%20cloud%20setup/int-atom_installation_checklist_linux_a00ebe62-be96-4bd8-9142-07b702f22e88/
#   - Amazon Corretto 11:
#       https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html
#
# Steps:
#   1) Install or verify Amazon Corretto 11 (Java)
#   2) Create a dedicated 'boomi' user (for security isolation)
#   3) Download the official Boomi Atom installer (atom_install64.sh)
#   4) Run the installer (using environment variables if set for non-interactive mode)
#
# Usage:
#   chmod +x install-boomi-atom.sh
#   sudo ./install-boomi-atom.sh
#
# Optional Environment Vars:
#   BOOMI_ACCOUNTID  - Boomi Account ID
#   BOOMI_TOKEN      - Boomi Installation Token
#   BOOMI_ATOMNAME   - Friendly Atom name
#   BOOMI_INSTALLDIR - Where to install the Atom (default: ~/Boomi_Atom)
#------------------------------------------------------------------------------
set -euo pipefail
#------------------------------------------------------------------------------
# STEP 1: Ensure the script is run with sudo or as root
#------------------------------------------------------------------------------
if [[ $(id -u) -ne 0 ]]; then
  echo "ERROR: This script must be run as root or with sudo privileges."
  exit 1
fi
#------------------------------------------------------------------------------
# STEP 2: Update package lists, install dependencies (wget, dpkg)
#------------------------------------------------------------------------------
echo ">>> Updating package lists..."
apt-get update -y
apt-get install -y wget dpkg
#------------------------------------------------------------------------------
# STEP 3: Download and Install Amazon Corretto 11
#         (Replace the URL with the latest link from Corretto 11 downloads)
#------------------------------------------------------------------------------
CORRETTO_DEB="amazon-corretto-11.deb"
echo ">>> Downloading Amazon Corretto 11 .deb package..."
wget -q -O "${CORRETTO_DEB}" "https://corretto.aws/downloads/latest/amazon-corretto-11-x64-linux-jdk.deb"
echo ">>> Installing Amazon Corretto 11..."
dpkg -i "${CORRETTO_DEB}" || apt-get install -f -y
rm -f "${CORRETTO_DEB}"
echo ">>> Verifying Java installation..."
java -version
#------------------------------------------------------------------------------
# STEP 4: Create a dedicated 'boomi' user
#------------------------------------------------------------------------------
echo ">>> Ensuring 'boomi' user exists..."
if ! id boomi &>/dev/null; then
  useradd -m -s /bin/bash boomi
  # Optionally set a password for 'boomi':
  # echo "boomi:<YourSecurePassword>" | chpasswd
  echo ">>> 'boomi' user created."
else
  echo ">>> 'boomi' user already exists, skipping creation."
fi
#------------------------------------------------------------------------------
# STEP 5: Download the official Boomi Atom Installer
#------------------------------------------------------------------------------
echo ">>> Downloading Boomi Atom installer..."
wget -q https://platform.boomi.com/atom/atom_install64.sh -O /home/boomi/atom_install64.sh
chmod +x /home/boomi/atom_install64.sh
chown boomi:boomi /home/boomi/atom_install64.sh
#------------------------------------------------------------------------------
# STEP 6: Run the Boomi Atom Installer as 'boomi'
#         If environment variables are set, it won't prompt for them.
#------------------------------------------------------------------------------
echo ">>> Running Boomi Atom installer as 'boomi'..."
sudo -H -u boomi bash -c "cd /home/boomi && ./atom_install64.sh"
#------------------------------------------------------------------------------
# STEP 7: (Optional) Validate installation path
#------------------------------------------------------------------------------
BOOMI_INSTALL_PATH="${BOOMI_INSTALLDIR:-/home/boomi/Boomi_Atom}"
if [[ -d "${BOOMI_INSTALL_PATH}" ]]; then
  echo ">>> Boomi Atom installed at: ${BOOMI_INSTALL_PATH}"
  echo ">>> Install Complete!"
else
  echo ">>> WARNING: Installation directory not found. Check logs and steps above."
fi

How to Use This Script

1. Save the file: Copy the script into a file named install-boomi-atom.sh.
2. Make it executable: chmod +x install-boomi-atom.sh
3. Run as root or with sudo: sudo ./install-boomi-atom.sh
4. Optional: Export any Boomi environment variables before running if you want an unattended installation: export BOOMI_ACCOUNTID=”YourBoomiAccount” export BOOMI_TOKEN=”YourBoomiToken” export BOOMI_ATOMNAME=”LocalAtom” export BOOMI_INSTALLDIR=”/opt/Boomi_Atom”
5. Check AtomSphere UI: Log in to Boomi AtomSphere > Manage > Atom Management to confirm your new Atom is online.

Troubleshooting & Common Issues

• Corretto .deb Installation: If dpkg -i fails, run sudo apt-get install -f -y to resolve dependencies.
• Incorrect Java Version: Ensure no conflicting Java versions override Corretto. Run java -version to check.
• Permission Issues: The script must be run as root or sudo. For directories like /opt, you also need the right permissions.
• Expired Boomi Token: If your BOOMI_TOKEN is invalid, regenerate a new one (valid for 24 hours) and rerun the script.
• User Creation: If the boomi user already exists, it will be reused; ensure it has the correct permissions.

Further Recommendations

• Systemd Service: Create a systemd unit file to automatically start/stop the Atom. This is especially helpful in production environments.
• Secrets Management: Avoid hardcoding tokens; use a vault or secure method to inject them at runtime.
• Resource Monitoring: Keep an eye on CPU, memory, and disk usage to ensure your Atom is properly resourced.
• Regular Updates: Keep Ubuntu and Amazon Corretto patched for security and stability.

Conclusion

By combining the official “Installing a local Atom on Linux” guide with Amazon Corretto 11 and a dedicated boomi user, you establish a secure and straightforward way to run a Boomi Atom on Ubuntu. This script aims to cover the essential steps of the Boomi Installation Checklist in a single automated approach. While this meets most basic installation requirements, you should expand it with best practices such as logging, robust system monitoring, and secure password/token handling for a truly production-ready setup.