Install Windows 32-bit Atom Desktop

~boomi ~windows ~32-bit

The Boomi Atom is generally installed as a 64-bit application on Windows, with Java 11, and as a service. However, there are two connectors, which require the Atom to be installed as a 32-bit application and in Desktop mode. The connectors are the QuickBooks Desktop Edition and Sage 50/Peachtree. This article covers how to install the Boomi Atom as a 32-bit application on Windows for this specific use case.

Install Windows 32-bit Atom Desktop

  1. Download 32-bit Java 11

Run the following command in PowerShell to download the 32-bit version of Java 11.

Invoke-WebRequest -Uri https://corretto.aws/downloads/latest/amazon-corretto-11-x86-windows-jdk.zip -OutFile amazon-corretto-11-x86-windows-jdk.zip

Unzip and add the jdk11.0.23_9 directory to C:\Program Files\Java. Use the current directory name. This is the directory name in the current version. 

  1. Download Java 8 32-bit

Run the following command in PowerShell to download the 32-bit version of Java 8.

Invoke-WebRequest -Uri https://corretto.aws/downloads/latest/amazon-corretto-8-x86-windows-jdk.zip -OutFile amazon-corretto-8-x86-windows-jdk.zip

Unzip and add the jdk1.8.0_412 directory to C:\Program Files\Java. Use the current directory name. This is the directory name in the current version. 

  1. Set JAVA_HOME and PATH Env Variables
setx JAVA_HOME "C:\Program Files\Java\jdk11.0.23_9"
setx PATH "%PATH%,%JAVA_HOME%\bin"
  1. Download and install Boomi Atom
Invoke-WebRequest -Uri https://platform.boomi.com/atom/atom_install.exe -OutFile atom_install.exe

Right-click installer and run as administrator. Use either a Username and Password or an installer token for the installation.

  1. Set Heap Size

Under Manage > Atom Management > Properties > Basic properties, set the heap size to 1024m or less, and click Save and restart. 32-bit processes have a 2GB limit.

  1. Set pref-jre.cfg to Java 8 32-bit version

Navigate to /.install4j/pref-jre.cfg. Open the file in a text editor and update the contents with the 32-bit Java 8 version.

C:\Program Files\Java\jdk1.8.0_412\jre

Create New Local User

Creating a new local user is not required but this section is suggested. 

  1. Click start and run.
  2. Enter lusrmgr.msc and click OK.
  3. Right-click on Users > New User
  4. Create a new user.

boomi user needs to have Log on as a batch job permissions

Add the boomi user to the Administrator group.

Task Scheduler

To make the Desktop application automatically start/restart a Task Scheduler needs to be enabled. Boomi Doc: Starting or configuring an Atom to run as a desktop application

  1. Stop the Service and set to start manually.   - Search for Services >> Stop Atom service and set the startup type to Manual.

  2. Open Task Scheduler - Search for run >> execute taskschd.msc

  3. Create a New Tasks   - Right-click on the Task Scheduler Library folder and click Create Tasks   - Provide the name “Boomi Atom”

  4. Set Triggers   - On a schedule. This will check to make sure the Atom is running every 5 minutes.  

  5. Set Actions   - Start a program. Select the bin/atomdesktop.exe executable within the atom installation directory. The full path is required.

  6. Set Conditions

  7. Set Settings

The atom should now run as a desktop application.

References

The article was originally posted at Boomi Community.