Atina JDE Connector - Quick Setup Overview

Table of Contents

Introduction
Prerequisites
Step 1: Generate INI Configuration Files
- Step 1.1 - Download the Tool
- Step 1.2 - Run the Tool
Step 2: Generate JAR Libraries
Step 3: Microservice Installation
Step 4: Install Mule JDE Connector

Introduction

The MuleSoft ATINA JDE Connector requires an Atina JDE Microservice to work. This guide provides a streamlined, step-by-step walkthrough to get you up and running.

The setup consists of four main steps:

Generate JDE INI Files — Create the base configuration files from your JDE Server Manager.
Generate JAR Libraries — Package JD Edwards libraries into deployable JARs.
Microservice Installation — Deploy the Atina JDE Microservice using Docker.
Install Mule JDE Connector — Add the connector to your MuleSoft project.

Prerequisites

This setup requires:

Administrative access to your JDE environment and servers
JDE interoperability and network access configured for the microservice
OpenJDK 8 installed
Maven 3.8.1 or higher
Docker and Docker Compose
Network access and credentials to JDE Server Manager
Access to JDE Deployment Server

For detailed prerequisite information, see the Atina JDE Microservices Installation Guide.

Step 1: Generate INI Configuration Files

The JDE Atina Generate Configuration Files Tool is a Java CLI application that generates base INI files. It retrieves all information from the JDE Enterprise Server Manager using its REST API. During execution, you will be asked to select the HTML Client instance for your environment.

Prerequisites for this step:

OpenJDK 8 installed
Network access and credentials to JDE Server Manager

Step 1.1 - Download the Tool

Linux:

curl "https://jfrog.atina-connection.com/artifactory/libs-release-local/com/atina/jd-create-ini-files/1.0.0/jd-create-ini-files-1.0.1.jar" \
  -o jd-create-ini-files-1.0.1.jar

Windows PowerShell:

curl.exe "https://jfrog.atina-connection.com/artifactory/libs-release-local/com/atina/jd-create-ini-files/1.0.0/jd-create-ini-files-1.0.1.jar" `
  -o "jd-create-ini-files-1.0.1.jar"

Step 1.2 - Run the Tool

The tool is interactive — you will be asked to pick the HTML instance:

java -jar jd-create-ini-files-1.0.1.jar \
  -u <jde_admin> \
  -p <password> \
  -s http://<server-manager-host>:8999/manage \
  -e <ENV ex. JDV920>

Review the generated INI files to verify that the values are correct.

Manual Alternative

If you encounter any issues retrieving information from the servers, you can generate the INI files manually by obtaining the values directly from the JDE Server Manager. The video below shows where to find each value in the Server Manager interface.

First, run the following command to generate the folder structure with template INI files that you will need to update manually:

java -jar jd-create-ini-files-1.0.1.jar \
  -e JDV920 \
  -m Y \
  -f /tmp/build_jde_libs

This creates the directory structure with base INI files. You must then update these files with the correct values obtained from the Server Manager.

Version: 1.0.1
Running with migration options
-----------------------------------------------------------
Creating environment folder...
Folder : /tmp/demo/JDV920 has been cleaned
 Processing File: jdbj.ini
processIniFile JDBJ: File: /tmp/demo/JDV920/jdbj.ini generated
 Processing File: jdeinterop.ini
processIniFile INTEROP: File: /tmp/demo/JDV920/jdeinterop.ini generated
 Processing File: jdelog.properties
processIniFile JDELOG: File: /tmp/demo/JDV920/jdelog.properties generated
-----------------------------------------------------------
Creating Setting XML File...
 Processing File: settings.xml
 File: /tmp/demo/settings.xml generated

Watch video: Generate INI Files (includes manual Server Manager walkthrough)

For more details, see the section JDE Atina Generate Configuration Files Tool in the Atina JDE Microservices Installation Guide.

Step 2: Generate JAR Libraries

This tool packages the JD Edwards libraries into deployable JAR files required by the Atina JDE Microservice. It simplifies dependency management and ensures that all necessary classes are available at runtime.

This step is now performed through the JDE Atina Build Manager, a web-based tool available at builder.atina-connection.com. There is no need to download a CLI tool, create a folder structure, or configure a local Maven repository — you upload your Deployment Server files through the browser and the tool builds the artifacts for you.

Prerequisites for this step:

Access and credentials to JDE Deployment Server

The tool will generate the following artifacts:

JDEAtinaOverrideServicesConstants-1.0.0.jar — Provides local override of web service properties, avoiding the need to modify JDE configuration.
service-constants.properties — Contains configuration properties for the microservice.
jde-lib-wrapped-1.0.0.jar — Bundles the core JD Edwards interoperability libraries required for integration.
StdWebService-1.0.0.jar — Includes wrappers for standard JD Edwards web services.

If you are a new customer, click New Customer on the Build Manager home page, enter your company name and corporate email, and you will receive access instructions by email once approved.

For the full step-by-step guide — requesting access, uploading your Deployment Server files, running the build, and downloading the generated artifacts — see the JDE Atina Build Manager - User Guide.

For more details, see the section JDE Atina Generate Jars Files Tool in the Atina JDE Microservices Installation Guide.

Step 3: Microservice Installation

This section explains how to deploy the Atina JDE Microservice using Docker and Docker Compose.

This step is now performed through the JDE Atina Build Manager, the same web-based tool you already used in Step 2. From your customer dashboard, click Download Docker File Definition, upload the INI configuration files generated in Step 1, fill in a few parameters (installation path, port, and server hostnames), and click Generate & Download — the tool downloads the Docker Compose distribution and fills in .env, extra-hosts.txt and the docker-compose.yml volume mounts for you, ready to deploy.

Prerequisites for this step:

Docker

For the full step-by-step guide, see the JDE Atina Build Manager - Microservice Docker Setup Guide.

For more details, or to configure .env, extra-hosts.txt and docker-compose.yml by hand instead, see the section JDE Atina microservices - Installation in the Atina JDE Microservices Installation Guide.

Step 3.4 - Start the Container

docker compose --env-file .env up -d --force-recreate

Use: docker compose down -v to stop and remove the container along with its volumes for any changes to take effect on the next startup.

Step 3.5 - Check the Microservice Startup Log

Verify the startup log:

docker exec -it jd-atina-microserver cat /tmp/start.log

-JAVA Image--------------------------------------------
   javaJDKImage:  j2sdk-image-x86_64-u322-b04-20221122.tar.bz2
   DEBUG_ACTIVO:  false
-SERVICE--------------------------------------------
   Name:  172.28.0.2
   Port:  8077
-MOCKING------------------------------------------
   JDE_MICROSERVER_MOCKING:  0
-REPOSITORY-----------------------------------------
   Customer:  https://jfrog.atina-connection.com/artifactory/libs-release
   Atina:     https://jfrog.atina-connection.com/artifactory/libs-release
-ATINA services------------------------------------------
   JDEAtinaServer Version 1.0.6
   JDEAtinaOverrideServicesConstants Version 1.0.0
-LIBRARIES------------------------------------------
   StdWebService Version  1.0.0
   jde-lib-wrapped Version 1.0.0
-LICENSE--------------------------------------------
   Code:  demo
-MICROSERVER----------------------------------------
   JDE_MICROSERVER_TOKEN_EXPIRATION:  3000000
   JDE_MICROSERVER_MOCKING:  0
----------------------------------------------------
-JVM---------------------------------------------
   JDE_JAVA_XMS: 2G
   JDE_JAVA_XMX: 4G
   JDE_JAVA_HEAP_DUMP_ON_OOM: true
   JDE_JAVA_HEAP_DUMP_PATH: /tmp/jde/jvm-dumps
   JDE_JAVA_ERROR_FILE: /tmp/jde/jvm-dumps/hs_err_pid%p.log
   JDE_JAVA_EXTRA_OPTS:
   JAVA_OPTS: -Xms2G -Xmx4G -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/tmp/jde/jvm-dumps -XX:ErrorFile=/tmp/jde/jvm-dumps/hs_err_pid%p.log
----------------------------------------------------
ADDITIONAL SCRIPT: /etc/hosts entries
Added host: 52.183.27.36 JDE-ALPHA-ENT
Added host: 40.125.78.136 JDE-ALPHA-SQL
Cat /etc/hosts:
127.0.0.1	localhost
::1	localhost ip6-localhost ip6-loopback
fe00::	ip6-localnet
ff00::	ip6-mcastprefix
ff02::1	ip6-allnodes
ff02::2	ip6-allrouters
172.19.0.2	1d064a6ec7e2
52.183.27.36 JDE-ALPHA-ENT
40.125.78.136 JDE-ALPHA-SQL
----------------------------------------------------
----------------------------------------------------
 Check log cat /tmp/jde/JDEConnectorServerLog/jde_atina_server_2026-05-14.0.log
 Debug false
 Debug 5005
------------------------------------------------------------------------------------
Starting....:
------------------------------------------------------------------------------------

Check the Docker logs to confirm the microservice started correctly:

docker logs jd-atina-microserver

JDERestServer - *------------------------------------------------------*
JDERestServer - Working Directory: /var/jdeatinaserver
JDERestServer - Tmp Directory: /tmp/jde
JDERestServer - JDE Connector Version: 1.0.6
JDERestServer - JDE Atina Override Services Constants: 1.0.0
JDERestServer - ------------------------------------------------------
JDERestServer - Configuration:
JDERestServer -        SERVICE:
JDERestServer -           IP = [172.28.0.2]
JDERestServer -           Port = [8077]
JDERestServer -           Local IP = [0.0.0.0]
JDERestServer -           Token Expirtation = [3000000]
JDERestServer -           Mocking = [false]
JDERestServer -           Last Build = [2020-08-31-004]
JDERestServer -           Last Build = [2026-05-13 13:40]
JEConnectorServer - Cleanning Temporal Folder: /tmp/jde
JDEConnectorServer - Clean Done
JDEConnectorServer - Created SessionsCleanerTask for 60 minutes
JDEConnectorServer - Created CleannerUtil for 60 minutes
JDEConnectorServer - Iniciando JDE Service Impl con JAVA [1, 8, 0-jdk8u322-b04]
JDERestServer - *---------------------------------------*
JDERestServer - *   Starting JDE Microservice 1.0.6     *
JDERestServer - *   JDE Microservice started!           *
JDERestServer - *---------------------------------------*

Step 3.6 - Validate the Microservice Deployment

Once the microservice is deployed and running, you can validate that it can connect to JD Edwards and invoke a basic web service.

The easiest way to validate the deployment is the JDE Atina Panel Manager, a browser-based tool that lets you check the microservice status, view active connections, and run BSFN / Web Service validation tests without installing anything extra. See the JDE Atina Panel Manager - User Guide.

Alternatively, you can validate the deployment from the command line using the JD Atina Check Microservice Tool.

Download the Check Tool:

curl https://jfrog.atina-connection.com/artifactory/libs-release-local/com/atina/jd-check-microservice/1.0.0/jd-check-microservice-1.0.0.jar \
  --output jd-check-microservice-1.0.0.jar

Run the test:

java -jar jd-check-microservice-1.0.0.jar \
  -u JDE \
  -w XXXXXX \
  -e JDV920 \
  -r "*ALL" \
  -s localhost \
  -p 8077 \
  -m TestLoggindAndGetAddressBookWS \
  -a 28 \
  -n "Prueba - Argentina - 28                 "

-a: Address Book number of an existing record in your JDE environment.
-n: Name of the Address Book record corresponding to the number specified in -a.

If everything is correctly configured, you will see output like the following:

Watch video: Microservice Installation

For more details, see the section JDE Atina microservices - Installation in the Atina JDE Microservices Installation Guide.

Step 4: Install Mule JDE Connector

Step 4.1 - Configure Maven Repository

After creating your MuleSoft project, add the Atina repository to your pom.xml (within <repositories>):

<repository>
    <id>atina-central</id>
    <name>libs-release</name>
    <url>https://jfrog.atina-connection.com/artifactory/libs-release</url>
</repository>

Step 4.2 - Declare the Connector Dependency

Inside the <dependencies> section of your pom.xml, add:

<dependency>
    <groupId>com.atina-connection</groupId>
    <artifactId>mule-jde-atina-connector</artifactId>
    <version>1.0.0-RC1</version>
    <classifier>mule-plugin</classifier>
</dependency>

Step 4.3 - Define the Global Connector Configuration

In your Mule project, create or open a flow file (e.g., jde-demo.xml), then:

Open Global Configuration Elements and click Create.
Under Connector Configuration, select JDE Atina Config.

Configure the connection parameters:

For more details, see the section Preliminary Setup in the Atina JDE Connector User Guide.