How to install Javonet JLupin extension on JLupin Next Server

Purpose

In this tutorial you will learn how to install Javonet JLupin Extension on JLupin Next Server to host .NET microservices or SOA services applications.

Javonet JLupin Extension

JJE is the extension module for JLNS platform version 1.2 or higher. JJE extends the capabilities of JLNS platform with the ability to host and execute .NET modules as JLNS applications.

JLupin Next Server

JLupin Next Server is an amazing application server technology for enterprise solutions covering out of the box most of the needs defined by good microservices architecture:

  • Extreme performance
  • Zero downtime deployments
  • Built-in JVM multicontainer approach
  • Simplified & scalable architecture
  • Highest availability of microservices and SOA services

Read more at: JLupin Home Page

JJE Features

JJE is aimed to make sure that all the features of JLNS dedicated for Java applications will be available for .NET applications and the same scope of JLNS platform benefits will be shared between the two technologies.

Prerequisites

To use JJE the JLNS platform must meet following conditions:

JLNS Version 1.2 or higher
Hosting environment Windows Server
.NET Framework 3.5 or higher
Visual C++ Runtime For use with .NET Framework 3.5 (supports .NET 3.5 DLLs):
Visual C++ Runtime 2008: x86 or x64 depending on your JDK/JRE architecture.
.NET Framework 3.5: http://www.microsoft.com/en-us/download/details.aspx?id=22For use with .NET Framework 4.0 (supports .NET 4.0 and 3.5 DLLs):
Visual C++ Runtime 2010: x86 or x64 depending on your JDK/JRE architecture.
.NET Framework 4.0: http://www.microsoft.com/en-us/download/details.aspx?id=17718

For use with .NET Framework 4.5 (supports .NET 4.5, 4.0 and 3.5 DLLs):
Visual C++ Runtime 2013: x86 or x64 depending on your JDK/JRE architecture.
.NET Framework 4.5: http://www.microsoft.com/en-us/download/details.aspx?id=30653

JJE Package

JJE package consist of following items:

  • third-party-extension folder – This folder contains all the binaries required by the JJE
  • javonet-default-configuration.xml – JJE configuration file
  • JLupinSampleDotNetApplicationConfigurationImpl.java – sample .NET application configuration file for JLNS
Extension Installation

Installation of JJE can be performed on any existing or new JLNS instance. No additional preparation steps are required. The installation process can be performed on running instance of JLNS platform.

Installing Extension Binary Files

The installation process consist of few simple steps:

  • Download and unzip the “JJE-Package.zip” file
  • Copy the content of “third-party-extension” folder into “JLNS_HOME\server\server-lib\third-party-extension”
  • Copy the “javonet-default-configuration.xml” config file into “JLNS_HOME\server\server-resources”

These are all of the steps required to install JJE binary files on JLNS platform. Before running first application the JJE must be configured.

Extension – Global Configuration

All of the configuration should be performed within the “javonet-default-configuration.xml” file stored in the “JLNS_HOME\server\server-resources” folder.

The file is the Java spring configuration file which contains the Javonet configuration and definition of custom Javonet JLupin Sequencer and input output converters for .NET objects.

To setup the extension you need to modify the first registration of javonetJLupinConfigurationData bean. Below you can see the default content of that registration.

<bean id="javonetJLupinConfigurationData">
<property name="licenseKey" value="your-javonet-license-key" />
<property name="email" value="your@mail.com" />
<property name="dotNetFramework" value="v40" />
<property name="autoScanDlls" value="true" />
</bean>

Here you should modify the properties setters to proper values.

Table below represents the details about each property and valid inputs:

Property Description Value
email Your email address assigned to your Javonet license key. Your email address.
licenseKey Javonet license key. Here you should place your Javonet license key. You can obtain free 30 day trial license key by signing up at: https://www.javonet.com/signup-for-trial/ Javonet license key.
dotNetFramework .NET framework version. This property specifies which .NET framework version should be used by the application. This argument accepts one of the following values:

  • v45
  • v40
  • v35
autoScanDlls Auto scan for .NET dlls. This argument is used to indicated if you want Javonet to automatically scan the JLNS application folder and load all the .NET dlls or if you want to specify the DLL names manually. true/false
dllsToLoad (optional) This property should be used only if autoScanDlls has been set to false.

This property expects the list of strings with the DLL names that should be loaded by Javonet.

<array>
<value>myDll1.dll</value>
<value>myDll2.dll</value>
</array>

After completing this configuration you are ready to build and deploy your first .NET application on JLNS platform.

Download

Want to kick start your trial? Press button below to download JLupin Next Server 1.3 with pre-installed JJE extension:

Download JLNS 1.3 with JJE