Download

Goto to download section and get your copy of JLupin Next Server Community Edition.


Install

JLupin Next Server (JLNS) is distributed as zip file, in contains 'server' directory where all JLNS's resources are located. To order to install JLNS:

  1. Choose the name of the destination directory (ex. jln14ee). Please be advised that on Windows platform the name should not contain any whitespace characters.

  2. Create the destination directory (ex. /opt/jlupin14 or c:\Program Files\jlupin14)

  3. Extract downloaded archive into that directory. The full path, providing to JLNS resources (simply - files) is called JLUPIN_HOME. In our examples it would be:

on Windows:

JLUPIN_HOME = c:\Program Files\jlupin14\server

on Linux:

JLUPIN_HOME = /opt/jlupin14/server

  1. On Linux, please remember about proper rights for certain files:
chmod 750 server/start/start.sh
chmod 750 server/start/control.sh


Configure

Directory structure

tbd.

Initial parameters

The initial configuration are provided by:

$JLUPIN_HOME/start/configuration/setenv

where the following parameters can be useful now:

  • JAVA_HOME - by default JLupin Next Server's start script tries to set the value automatically. Set the JAVA_HOME here when automatic mechanisms fail.
  • JAVA_OPTS - memory settings for Main Server' JVM process. The default value is enough for most use cases. Increase it only in case of performance issues and after consulting with support service.

If you want to get to know all possibilities read this chapter please

Now, JLNS is ready to serve :)


Run and manage

How to start ?

Go to JLUPIN_HOME/start directory and execute:

  • on Windows: start.cmd
  • on Linux: start.sh

Easy, isn't it ?

How to check ?

If you go through this quickstart with Community Edition you can get to the example application in microservice architecture. Enter this URL to your browser:

http://localhost:8000/exchange

You should get the following result:

Figure 1. The example application.

The diagram also shows the traffic flow of the request coming from you (your browser) :)

If you start JLupin Next Server on another node than your own workstations, modify the address in your browser accordingly.

How to manage ?

Go to $JLUPIN_HOME/start directory and execute:

  • on Windows: control.cmd
  • on Linux: control.sh

to start the local console in interactive mode. Run help to get the full list of available commands. The most popular use cases are presented below. The full description is available in further chapters.

Operate the microservice

NOTICE that all examples are prepared for interactive mode of the local console, in order to run it in batch mode follow the pattern:

  • on Windows:
control.cmd <command_with_its_parameters>
  • Linux:
control.sh <command_with_its_parameters>

Ok, so let's go through some use cases:

  • Check status of the microservice

    > microservice status exchange-rates
  • Stop the microservice

    > microservice stop exchange-rates
  • Start the microservice

    > microservice start exchange-rates
  • Restart the microservice

    > microservice restart exchange-rates

If you would like to execute command in scope of all microservices (ex. restart all) don't specify the name of microservice. For example, to restart all, execute:

> microservice restart *

Operate the node

  • Stop JLupin Next Server (and all microservices)

    > node shutdown
  • Stop force JLupin Next Server (and all microservices)

    > node terminate


What's next ?

tbd.