4.3.1 - Starting and Stopping an Atom

This article provides instructions for manually starting or stopping an Atom that has been deployed locally. You will need to be on the machine where the Atom is installed. These instructions do not apply to hosted Atoms.

Jump To:

• Windows - Service
• Windows - Console
• Linux - Daemon
• Linux - Console

Windows

An Atom is automatically started as a Windows Service when deployed on your local Windows machine.  This is the recommended way of running Boomi On Demand, since it will prevent the server from shutting the Atom down when the user logs off of the machine.

Running as a Service

To manually control the starting and stopping of your Boomi On Demand Atom, you must utilize Windows Services by following the steps below.

1. Go to Control Panel -> Administrative Tools -> Services
2. Locate the 'Atom' Service Name and click on it to highlight it
   
3. Click on the desired status link
   
4. Right click on the Atom service instance and choose Properties to configure the service properties
   

To stop the Atom running as a service, simply locate the Atom service and click the Stop link.

Running as a Console

Connecting to some client applications, such as QuickBooks, requires the Atom be running as a console instead of a service.

1. Manually stop the service (see above instructions on how to stop the service from the Windows Control Panel).
   NOTE: If you don't plan on using the Atom as Windows Service, you should disable it or set it to manual startup. This can be done by changing the startup type in the services properties window (shown above in step 4). If the service is not disabled or set to manual startup, you will need to manually stop it again upon rebooting before you can use the console version. The installer always installs and and starts the Atom as a Windows Service as that is Boomi's recommended running environment (if technically possible based on the your needs).
2. Go to the ..\<atom root>\bin directory and double click the atom-console.bat file. Do not run the atom-console.exe file. Running the *.bat file will enable the Atom to properly restart during periodic updates.

To stop the Atom running as a console, simply close the console window.

Linux

Running as a Daemon Thread

Once your Atom is deployed on your machine, you can set your Atom up to run as a Daemon thread. This is the recommended way of running Boomi On Demand, since it will prevent the server from shutting the Atom down when the user logs off of the machine.

1. Open up a console window and go to the Atom installation "bin" directory and execute the atom start command.  This will start the Atom if it is not started already. If the Atom is already started, then this command will do nothing.
   

To confirm that your Atom is running as a daemon thread, you can execute the status command as shown above.

To stop the Atom running as a daemon Thread:

1. Open up a console window and go to the Atom installation "bin" directory and execute the atom stop command.  This will stop the Atom if it is running already. If the Atom is already stopped, then this command will do nothing.
   
   

Running as a Console

1. Make sure that the Atom is not running as a Daemon Thread. If Atom is running as a Daemon Thread, you would need to stop the Atom (see above instructions on how to stop the Daemon Thread).
2. Execute the console.bat file in the Atom install "bin" directory.

To stop the Atom running as a console, simply close console window.