On-premise assets, such as servers and printers, configured behind your firewall are not connected to the cloud. While configuring these assets behind a firewall ensures your network remains secure, the firewall prevents installations, updates, and data transfers with cloud-based applications to the on-premise assets. The EAP Gateway Appliance connection gives your on-site assets secure access to the cloud. 

Currently, the Gateway Appliance connects to the on-premise assets:

  • JD Edwards World database (read-only)
  • EPP configured label printers

Once installed and configured, the appliance gives you the ability to:

  • Connect to local printers and route print jobs.
  • Configure database connectivity and perform data synchronization between cloud-based applications and your on-site database.
  • Upgrade and manage versions of the Gateway Appliance.

Security is provided for the appliance by an integration user account with a specified password.

Gateway Appliance installation

To install the Gateway Appliance, you must ensure your firewall and device requirements are met, install the appliance, then configure and connect your on-premise assets to the platform. 

To see minimum requirements for hardware, operating systems, and software installations, see Gateway Appliance minimum technical requirements.

Firewall requirements

Ensure your firewall system settings allow the Gateway Appliance to:

  • Have internet access to particular domains.
  • Use HTTPS and WebSocket (WSS) protocols to send requests to and receive responses from the Nextworld Cloud on port 443.

Device requirements

Note the following default ports used during the installation process:

  • Gateway Appliance: 8080
  • JDE-World  Pluggable Service: 8081
  • Printing Pluggable Service: 8082
  • EPP Configuration: 9082

User requirements

In addition to the default ports, the Gateway Appliance requires you to create an integration user in Nextworld that represents the appliance in all requests. The integration user can be the account for a designated employee, or it can be a dummy account you set up specifically for connection purposes. In the Users application, you must add the following two roles to the user record:

  • SYS - Base User
  • SYS - Integration Security Administrator

Other roles may also be applied to the user record. In addition to the roles, ensure that Multi-Factor Authentication is disabled for the integration user account. 

Gateway Appliance Management application

In Nextworld, create a record for your gateway appliance. In the Gateway Appliance Management application, you must:

  • Create a new record for the appliance. 
  • Populate the Services subtable with the services this appliance uses. 
  • Optionally, select the environments that can send requests to the appliance. If no environments are selected, the appliance can only connect to the default environment for the appliance user.

Gateway Appliance installation process

To install the gateway appliance, you must:

  • Ensure your integration user account and firewall are established according to the instructions above.
  • Log in to support.nextworld.net and search for "Gateway Appliance," then open the appropriate support article and download the appliance executable file. 
  • Navigate to the executable and open the installer tool.
  • Follow the steps in the installation tool. Many of the fields are populated by default, however, you must supply the following values:
    • User Id and Password: These values are from the integration user you created in Nextworld.
    • JD Edwards World Configuration fields: Find these values in the JDE system setup.
    • EPP Configuration > Host: Find this values in your EPP system setup.

Post-Installation information

In the Windows operating system, the Gateway Appliance installs to the C:\Program Files\gateway folder by default. In the Linux system, the Gateway Appliance installs to the /opt/GatewayAppliance folder by default. On both systems, this folder contains useful subfolders and files for any post-installation troubleshooting you need to perform:

  • Access the logs folder to check the gateway appliance's event records when troubleshooting.
  • Open the appliance folder and access the application.properties file to change any configurations after installing the gateway appliance, such as the integration user account or the service port and host information.
    • The jdeworld and printing folders also have application.properties files in their respective config subfolders if you need to adjust configurations directly to those connected assets after you have completed your initial installation.

Additional platform configurations

If your Gateway Appliance is being used in a connector, you must register your data source to complete the connection. Learn more in Connector configuration overview.

If your Gateway Appliance is being used for EPP printing, you must:

  • Add a record for your onsite printers in the Printer Definitions application.
  • Add a logic block, or add to an existing logic block, that inserts a record with all of the required information into the WriteEPPPrintRequests table. There is a table trigger configured on this table that routes the information to the gateway appliance. 

Gateway Appliance minimum technical requirements

Because your on-premise assets process your data, certain minimum requirements must be in place for the Gateway Appliance to function correctly. Your hardware, operating systems, and software installations must meet or exceed the following standards.

Hardware

CategoryMinimum requirement
Processors
  • 4+ cores
  • 2.6 Ghz+ processing speed
Memory
  • 16 GB+
Hard drive
  • 512 GB+
  • Solid state drive (preferred)

Operating systems

SystemSupported versions
Linux
Windows
  • Windows 10+
  • Windows Server 2016+

Software

Software nameSupported versions
Postgres
Java
  • Java 21+ LTS versions

Gateway Appliance Management application

System administrators use the Gateway Appliance Management application to define the services between the Gateway Appliance and the platform.

Services the Gateway Appliance can have enabled include:

  • Connecting to local printers and routing print jobs.
  • Data synchronization between the platform and your on-site database.

Once you select the services you want enabled, you can optionally:

  • Define the environments which the appliance connects to. If no environments are selected, the connector only applies to the appliance user's default environment.
  • Modify the behavior of the Gateway Appliance using the Configuration Properties subtable. For example, you could create a configuration property that specifies the frequency that a pluggable service runs health checks. 

Once a record is created in the Gateway Appliance Management application, you reference it a connector configuration. Learn more in Connector configuration overview.

Gateway Appliance Message History application

System administrators use the Gateway Appliance Message History application to review messages passed between the appliance and Nextworld. 

Records include information such as number of attempts and delivery status for each message. This application is useful for debugging. 

Gateway Appliance Service Catalog application

System administrators use the Gateway Appliance Service Catalog application to review the services available for their appliances. 

Add services to records in the Gateway Appliance Management application to enable them. Then, reference that management record in the Connector Configuration Management application. 

Learn more in Connector configuration overview.

Printer Definition application

System administrators use the Printer Definitions application to register their onsite printers for use with the Gateway Appliance. 

Add the printer name, description, and site, then reference the name of the gateway appliance that fulfills the printing requests.