You are on page 1of 6

TABLE OF CONTENTS: -

1 Introduction:...........................................................................................................................4
 Purpose of the Document:.............................................................................................4
 Intended Audience:...........................................................................................................4
2 Scope of the Document.......................................................................................................4
3 Atom System Requirements.............................................................................................5
4 Minimum hardware Requirements.................................................................................5
5 Install The Atom....................................................................................................................5
5.1 Procedure..................................................................................................................................5
6 Result.........................................................................................................................................9

Page - 1
Copyright © 2020, Jade Global Inc. All rights reserved.
1 Introduction:
 Purpose of the Document:
This document is intended to provide business IT team an overview of the local
atom installation on linux machine in Credo project.

This document will capture what needs to be done in Linux Machine to install
the local atom.

Objectives of this document are as follows:


 Explain the atom installation for Boomi integration

 Intended Audience:
The main intended audience for this document:

 Admin Users.
 Business IT team.
 Project Implementation team

2 Scope of the Document


Scope of this document is to
 Local Atom On Linux Machine
 Installation procedure

3 Atom system requirements

Linux 64-bit

 Any Linux distribution that supports Java 8 or 11 Runtime.


 Synchronize system clocks using NTP

4. Minimum hardware requirements


Page - 2
Copyright © 2020, Jade Global Inc. All rights reserved.
The requirements for a single Atom, Molecule node, or Cloud Molecule node, or
Cloud Molecule, within an Atom Cloud that must process high volumes of data are:

Processor: Dual 64-bit processors or higher


Memory: 8GB of RAM (minimum 4GB dedicated to the Atom)

Hard disk: 100GB of hard disk space

5. Install the Atom

Install the downloaded Linux version of the local Atom by running the
executable file. In the security options, make sure to generate token if you
want to authenticate the installation using token.

Atoms require the Java 8 JRE or the Java 11 JDK. Boomi internally tested


Oracle Java 1.8.0_302 and Amazon Corretto Open JDK 11.0.12.7.1.

The installer installs a private copy of Java 11 (11.0.12.7.1) for the Atom to
use. Alternatively, you can manage your own distribution of the Java 11
JDK by downloading the JDK from Amazon prior to installing the Atom.

Before completing these steps, download the local Atom installer.

Note: If you choose not to use the user interface to install a local Atom, you can
use the console mode option (-c) of the install4j installer.

5.1 Procedure
1. Locate the Atom installer file that you downloaded and saved to your
computer.
After downloading the file, you can run the installation wizard using a
command line, which Boomi recommends, or with the user interface.

2. Installing using Command line:


 If you want to run the installer in console mode from a command line,
run the file with the -c flag:
 sh /<path>/atom_install64.sh -c

Page - 3
Copyright © 2020, Jade Global Inc. All rights reserved.
 Here, it will ask whether you want to authenticate using username
and password or token.

 After authentication details are provided, it will ask you for atom
name, by default atom name is set to the ip address. You can change
it based on Dev or Production atom.
 It will ask whether you want to use Proxy. Select N.
 It will ask you to choose an installation directory. You can use the
default directory provided. It will look like
/home/<<folder>>/Boomi_Atomsphere/Atom/<<Atom Name>>
 It will ask to create Symlinks. Press N. The atom installation will start.
 Once the atom is installed, go to the /bin directory of the atom and
run the command ./atom start to start the atom that you just
installed.
The atom installation can also be performed using bash command
depending on the linus machine used.

3. Installing using user interface:


 If you install with the user interface, double-click the installation file
(you might need to change the properties to allow the Linux shell

Page - 4
Copyright © 2020, Jade Global Inc. All rights reserved.
script to run: chmod +x atom_install64.sh) or run the file from the
command line without the command-only flag:
sh /<path>/atom_install64.sh

 If the installer cannot find the JRE on your computer, you receive a
prompt to download the file.
 On the Welcome page, click Next.

 On the User Information page, do the following:

o Select User Name and Password or Token, depending on how


you want AtomSphere to authenticate the Atom.

o Enter one of the following, depending on the option you


selected:

Page - 5
Copyright © 2020, Jade Global Inc. All rights reserved.
 Your AtomSphere user name and password
 Valid installer token

When downloading the Atom installer from the Atom Setup dialog, you can
generate installer tokens. A token is valid only for the account that creates
it. Tokens expire after a set time ranging from 30 minutes to 24 hours.
o Enter a name for the Atom.

The Atom name is the one you see when you go to Manage > Atom
Management. The name defaults to the local host name, but you can
change it to something more familiar.

Note: The following characters are reserved and cannot be used in the


name: asterisk (*), backslash (\), caret (^), colon (:), dollar sign ($), greater
than (>), less than (<), percent (%), pipe (|), question mark (?), quotation
mark ("), slash mark (/), Yen sign (¥).

o Click Next.

You connect to AtomSphere with your credentials authenticated. The


Accounts page appears if you specify a user name and password. If you
specified an installer token, the Select Directory for Symlinks page appears

 On the Select Directory for Symlinks page, select Don't create


symlinks and click Next.

 On the Information page, review the installation settings and


click Next.

After installing all of the necessary files for your Atom, messages appear
saying that the installer is retrieving the build number, extracting files,
downloading Atom files, and finishing the installation.

 When the installation is complete, click Finish to start the Atom.

6. Result
A local atom is installed on the linux machine. The Atom runs as a daemon thread.
You can view the Atom online by going to Manage > Atom Management.

The installation log file is located in <atom_installation_directory>/tmp and its file


name starts with i4j.

Page - 6
Copyright © 2020, Jade Global Inc. All rights reserved.

You might also like