Upgrade

General rules

The latest version of JLupin Edge Balancer, compatible with the given JLupin Platform version, is always included in the latest update of the latest version JLupin Platform (latest patchset). For example:

  • the latest update (for example: u1) of the latest patchset of JLupin Platform 1.5.0 (for example: 1.5.0.2) includes the latest version of JLupin Edge Balancer 1.5.0 (for example: 1.5.0.3), which is compatible with all patchsets of JLupin Platform 1.5.0

  • the latest update of the latest patchset of JLupin Platform 1.5.1 (for example 1.5.1.2) includes the latest version of JLupin Edge Balancer 1.5.0, which is compatible with all patchsets of JLupin Platform 1.5.0

Notice that in this compatibility matrix, the major (1.x) and minor (1.x.y) versions must match, it means that you cannot use JLupin Edge Balancer 1.5.1 to JLupin Platform 1.5.0, even if it works fine - it won't be supported.

Upgrade process: 1.5.0.x -> 1.5.0.y

Embedded

  1. Deactivate the node (node deactivate)
  2. Wait 10 seconds
  3. Stop Edge Balancer (microservice tech nginx stop)
  4. Delete the Edge Balancer directory: $JLUPIN_HOME/platform/technical/nginx
  5. Download the latest update of the latest patchset of JLupin Platform 1.5.0 (for example: 1.5.0.2.u1)
  6. Extract jlupin_platform_ee_version_1_5_0_2_u1.zip/platform/technical/nginx directory into $JLUPIN_HOME/platform/technical/
  7. Start Edge Balancer (microservice tech nginx start)
  8. Activate the node (node activate)
  9. Check the availability of contexts.

Standalone

  1. Deactivate the node (cut off traffic from the node, ex. on external balancer)
  2. Stop Edge Balancer ($JLUPIN_HOME/nginx/linux/bin/stop.sh or %JLUPIN_HOME%\nginx\windows\bin\stop.cmd)
  3. Backup your configuration files:

On Linux:

$JLUPIN_HOME/nginx/linux/conf/edge.conf
$JLUPIN_HOME/nginx/linux/conf/edge_ssl/*
$JLUPIN_HOME/nginx/linux/conf/edge_servers/*

On Windows:

%JLUPIN_HOME%\nginx\windows\conf\edge.conf
%JLUPIN_HOME%\nginx\windows\conf\edge_ssl\*
%JLUPIN_HOME%\nginx\windows\conf\edge_servers\*
  1. Delete Edge Balancer instance ($JLUPIN_HOME/nginx or %JLUPIN_HOME%\nginx)
  2. Download the latest update of the latest version of JLupin Edge Balancer, remember that the major and minor versions must match (for example: Edge Balnacer 1.5.0.5 for JLupin Platform 1.5.0.3)
  3. Extract downloaded ZIP archive into JLUPIN_HOME directory
  4. Remove user configuration - delete the following files:

On Linux:

$JLUPIN_HOME/nginx/linux/conf/edge.conf
$JLUPIN_HOME/nginx/linux/conf/edge_ssl/*
$JLUPIN_HOME/nginx/linux/conf/edge_servers/*

On Windows:

%JLUPIN_HOME%\nginx\windows\conf\edge.conf
%JLUPIN_HOME%\nginx\windows\conf\edge_ssl\*
%JLUPIN_HOME%\nginx\windows\conf\edge_servers\*
  1. Restore your configuration (backuped in point 3) into original directories
  2. Start Edge Balancer ($JLUPIN_HOME/nginx/linux/bin/start.sh or %JLUPIN_HOME%\nginx\windows\bin\start.cmd)
  3. Activate the node