Install Windows 32-bit Atom Desktop

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 requires 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 will cover 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. 

2. 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. 

3. Set JAVA_HOME and PATH Env Variables

setx JAVA_HOME "C:\Program Files\Java\jdk11.0.23_9"
setx PATH "%PATH%,%JAVA_HOME%\bin"

4. 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.

5. 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.

6. 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

• Boomi Doc: Starting or configuring an Atom to run as a desktop application
• Boomi Doc: QuickBooks Desktop Edition
• Boomi YouTube: Installing a 32-bit Atom for use with the QuickBooks Connector

The article was originally posted at Boomi Community.