HOW TO UPGRADE LIGHTSTREAMER
============================

First of all, please see CHANGELOG.HTML to know all the differences from
the previous versions of the Lightstreamer Server components.


------------------------------------
Upgrading from 7.4.7 to This Version
------------------------------------

If you have an existing installation of Lightstreamer 7.4.7,
then this new release brings only a new feature,
but it also includes the update of a few third-party libraries
affected by vulnerability advices.
To update, we suggest you to do a fresh install of Lightstreamer 7.4.8, then:

- CONFIGURATION:
  All configuration files under the "conf" folder and subfolders can be
  copied in the new installation unchanged.

  If you modified the launch scripts under "bin" (e.g. LS.sh, LS.bat),
  you can copy them in the new installation unchanged; just ensure that
  your modifications are not affected by removals and name changes
  regarding third-party libraries.

- ADAPTERS:
  The Server upgrade to 7.4.8 extends the support of the Java In-process
  SDK to the new 8.1.0 version.
  However, you can deploy your existing in-process as well as Remote Adapter
  binaries unchanged. The adapters.xml files can be left unchanged as well.

- CLIENTS:
  The Server upgrade to 7.4.8 doesn't affect the client protocol.
  Anyway, the Server is always compatible with all client libraries
  available at the time of release and with all previous client
  libraries, so your existing clients will work with no issues.

  Some client SDKs have changed recently. On the download page you can
  find the current versions of the SDKs.
  In order to upgrade the clients, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

  The Server upgrade to 7.4.8 doesn't involve the SDK for JMX Extensions.

- MPN MODULE DATABASE (where available):
  If leveraging the MPN module, you can deploy your existing database
  unchanged on the new installation.

------------------------------------
Upgrading from 7.4.6 to This Version
------------------------------------

If you have an existing installation of Lightstreamer 7.4.6,
then this new release brings only a bug fix, a new feature, and minor extensions,
but it also includes the update of a few third-party libraries
affected by vulnerability advices.
To update, we suggest you to do a fresh install of Lightstreamer 7.4.8, then:

- CONFIGURATION:
  All configuration files under the "conf" folder and subfolders can be
  copied in the new installation unchanged.
  With regard to lightstreamer_edition_conf.xml, to take advantage of a few
  new configuration opportunities, you may prefer to rather take note
  of any changes you performed and apply them to the new factory files.

  If you modified the launch scripts under "bin" (e.g. LS.sh, LS.bat),
  you can copy them in the new installation unchanged; just ensure that
  your modifications are not affected by removals and name changes
  regarding third-party libraries.

- ADAPTERS:
  The Server upgrade to 7.4.8 extends the support of the Java In-process
  SDK to the new 8.1.0 version.
  However, you can deploy your existing in-process as well as Remote Adapter
  binaries unchanged. The adapters.xml files can be left unchanged as well.

- CLIENTS:
  The Server upgrade to 7.4.8 doesn't affect the client protocol.
  Anyway, the Server is always compatible with all client libraries
  available at the time of release and with all previous client
  libraries, so your existing clients will work with no issues.

  Various client SDKs have changed recently. On the download page you can
  find the current versions of the SDKs.
  In order to upgrade the clients, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

  The Server upgrade from 7.4.6 or earlier to 7.4.8 also implies the upgrade
  of the SDK for JMX Extensions from version 5.8.1 to 5.8.2, but just
  to add inspection of licenses for the new C++ Client SDK.

- MPN MODULE DATABASE (where available):
  If leveraging the MPN module, you can deploy your existing database
  unchanged on the new installation.

--------------------------------------------------
Upgrading from 7.4.0 through 7.4.5 to This Version
--------------------------------------------------

If you have an existing installation of Lightstreamer 7.4.0 through 7.4.4,
then this new release brings only bug fixes, a new feature, and minor extensions,
including some improvements in the optional MPN Module,
but it also includes the update of a few third-party libraries
affected by vulnerability advices.
To update, we suggest you to do a fresh install of Lightstreamer 7.4.8, then:

- CONFIGURATION:
  All configuration files under the "conf" folder and subfolders can be
  copied in the new installation unchanged.
  With regard to lightstreamer_edition_conf.xml, the MPN configuration
  files under conf/mpn, and any adapters.xml used to
  configure Remote Adapters, to take advantage of a few new configuration
  opportunities, you may prefer to rather take note of any changes you
  performed and apply them to the new factory files.

  If you modified the launch scripts under "bin" (e.g. LS.sh, LS.bat),
  you can copy them in the new installation unchanged; just ensure that
  your modifications are not affected by removals and name changes
  regarding third-party libraries.

- ADAPTERS:
  The Server upgrade to 7.4.8 extends the support of the Java In-process
  SDK to the new 8.1.0 version.
  However, you can deploy your existing in-process adapter binaries
  unchanged. The adapters.xml files can be left unchanged as well.

  Note that the Server upgrade from 7.4.0 to 7.4.8 involves an update of the
  ARI Protocol from version 1.9.1 to 1.9.2, but this does not affect
  the protocol itself.
  So, you can deploy your existing Remote Adapter binaries unchanged.

- CLIENTS:
  The Server upgrade to 7.4.8 doesn't affect the client protocol.
  Anyway, the Server is always compatible with all client libraries
  available at the time of release and with all previous client
  libraries, so your existing clients will work with no issues.

  Various client SDKs have changed recently. On the download page you can
  find the current versions of the SDKs.
  In order to upgrade the clients, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

  The Server upgrade from 7.4.2 or earlier to 7.4.8 also implies the upgrade
  of the SDK for JMX Extensions from version 5.8.0 to 5.8.2, but just
  to add inspection of licenses for the new visionOS and C++ Client SDKs.

- MPN MODULE DATABASE (where available):
  If leveraging the MPN module, you can deploy your existing database
  unchanged on the new installation.

--------------------------------------------------
Upgrading from 7.3.0 through 7.3.3 to This Version
--------------------------------------------------

If you have an existing installation of Lightstreamer 7.3.x,
then this new release brings various improvements (most of which
in the Adapter Remoting Infrastructure and the optional MPN Module)
and a few bug fixes.
Many of the deployed third-party libraries have also been updated
or removed.
So, we suggest you to do a fresh install of Lightstreamer 7.4.8, then:

- CONFIGURATION:
  All configuration files under the "conf" folder and subfolders can be
  copied in the new installation unchanged.
  With regard to lightstreamer_edition_conf.xml, the MPN configuration
  files under conf/mpn, and any adapters.xml used to
  configure Remote Adapters, to take advantage of a few new configuration
  opportunities, you may prefer to rather take note of any changes you
  performed and apply them to the new factory files.

  If you modified the launch scripts under "bin" (e.g. LS.sh, LS.bat),
  you can copy them in the new installation unchanged; just ensure that
  your modifications are not affected by removals and name changes
  regarding third-party libraries.
  However, if you modified the Install/Uninstall scripts in "bin/windows",
  you will need to port them. Look for "NSSM" in the Server changelog
  for details.

  Also consider that if you run the Server with a license of "file" type,
  a license upgrade will be needed.

- ADAPTERS:
  The Server upgrade to 7.4.8 implies the upgrade of the SDK for
  Java In-Process Adapters from version 7.4.0 or above to 8.1.0,
  which brings several interface changes for Metadata Adapters.
  However, the Server includes a specific support for Adapter binaries based
  on Java In-Process Adapters SDK versions since 7.0.0,
  with only a few corner cases not covered.
  So, you can deploy your existing in-process Adapter binaries unchanged,
  but first check the SDK changelog to ensure that no corner case applies.

  The adapters.xml files can and should be left unchanged. However, upon
  rebuild and update of a Metadata Adapter to leverage the new interface
  changes, the related adapters.xml should be revised according with the
  Server CHANGELOG. To simplify the operation, we suggest you using the
  online Configuration File Upgrade Tool; it is available at:
  https://service.lightstreamer.com/ConfigUpgrade

  The Server upgrade to 7.4.8 also involves important changes in the
  embedded Adapter Remoting Infrastructure; however, they don't affect
  the ARI Protocol, which just passes from version 1.9.0 to 1.9.1.
  Anyway, backward compatibility since protocol version 1.8.0 is provided.
  So, you can deploy your existing Remote Adapter binaries unchanged.

  Note that all Remote Adapter SDKs have changed to take advantage of the new
  features. On the download page you can find the current versions of the SDKs.
  In order to upgrade the adapters, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

- CLIENTS:
  The Server upgrade to 7.4.8 implies the upgrade of client protocol from
  TLCP version 2.4.0 to 2.5.0. Anyway, the Server is always compatible with
  all client libraries available at the time of release and with all previous
  client libraries, so your existing clients should work with no issues.

  Many client SDKs have changed recently. On the download page you can find
  the current versions of the SDKs.
  In order to upgrade the clients, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

  The Server upgrade to 7.4.8 also implies the upgrade of the SDK for
  JMX Extensions from version 5.7.0 to 5.8.2, with only a few changes and
  extensions of some metrics.
  See the CHANGELOG of the JMX SDK, that you can find on the download page,
  for details.

- MPN MODULE DATABASE (where available):
  If leveraging the MPN module, you can deploy your existing database
  unchanged on the new installation.

------------------------------------
Upgrading from 7.2.2 to This Version
------------------------------------

If you have an existing installation of Lightstreamer 7.2.2,
then this new release brings various improvements and a few bug fixes
in the Server and related SDKs (ARI, JMX, TLCP) and the MPN Module.
Moreover, these improvements involve new deployed third-party
libraries and changes or removals in many others.
So, we suggest you to do a fresh install of Lightstreamer 7.4.8, then:

- CONFIGURATION:
  All configuration files under the "conf" folder and subfolders can be
  copied in the new installation unchanged.
  With regard to lightstreamer_edition_conf.xml, the MPN configuration
  files under conf/mpn, and any adapters.xml used to
  configure Remote Adapters, to take advantage of a few new configuration
  opportunities, you may prefer to rather take note of any changes you
  performed and apply them to the new factory files.

  If you modified the launch scripts under "bin" (e.g. LS.sh, LS.bat),
  you can copy them in the new installation unchanged; just ensure that
  your modifications are not affected by changes on third-party libraries.
  However, if you modified the Install/Uninstall scripts in "bin/windows",
  you will need to port them. Look for "NSSM" in the Server changelog
  for details.

  Also consider that if you run the Server with a license of "file" type,
  a license upgrade will be needed.

- ADAPTERS:
  The Server upgrade to 7.4.8 implies the upgrade of the SDK for
  Java In-Process Adapters from version 7.2.0 or above to 8.1.0,
  which brings significant interface changes.
  However, the Server includes a specific support for Adapter binaries based
  on Java In-Process Adapters SDK versions since 7.0.0,
  with only a few corner cases not covered.
  So, you can deploy your existing in-process Adapter binaries unchanged,
  but first check the SDK changelog to ensure that no corner case applies.
  
  The adapters.xml files can and should be left unchanged. However, upon
  rebuild and update of a Metadata Adapter to leverage the new interface
  changes, the related adapters.xml should be revised according with the
  Server CHANGELOG. To simplify the operation, we suggest you using the
  online Configuration File Upgrade Tool; it is available at:
  https://service.lightstreamer.com/ConfigUpgrade

  The Server upgrade to 7.4.8 also involves important changes in the embedded
  Adapter Remoting Infrastructure, which has moved from ARI Protocol
  version 1.8.3 to 1.9.1. However, backward compatibility since protocol
  version 1.8.0 is provided.
  So, you can deploy your existing Remote Adapter binaries unchanged.

  Note that all Remote Adapter SDKs have changed to take advantage of the new
  features. On the download page you can find the current versions of the SDKs.
  In order to upgrade the adapters, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

- CLIENTS:
  The Server upgrade to 7.4.8 implies the upgrade of client protocol from
  TLCP version 2.3.0 to 2.5.0. Anyway, the Server is always compatible with
  all client libraries available at the time of release and with all previous
  client libraries, so your existing clients should work with no issues.

  Many client SDKs have changed recently. On the download page you can find
  the current versions of the SDKs.
  In order to upgrade the clients, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

  The Server upgrade to 7.4.8 also implies the upgrade of the SDK for
  JMX Extensions from version 5.6.0 to 5.8.2, with only a few changes
  and extensions, but see the CHANGELOG of the JMX SDK, that you can find
  on the download page, to learn about any possible compatibility issues.

- MPN MODULE DATABASE (where available):
  If leveraging the MPN module, you can deploy your existing database
  unchanged on the new installation.

------------------------------------
Upgrading from 7.2.0 to This Version
------------------------------------

If you have an existing installation of Lightstreamer 7.2.0,
then this new release brings various improvements and a few bug fixes
in the Server and related SDKs (ARI, JMX, TLCP) and the MPN Module.
Moreover, these improvements involve new deployed third-party
libraries and removals or changes in many others.
So, we suggest you to do a fresh install of Lightstreamer 7.4.8, then:

- CONFIGURATION:
  The configuration files under the "conf" folder
  (e.g. lightstreamer_conf.xml, lightstreamer_log_conf.xml) can be copied
  in the new installation unchanged, but for "conf/mpn/hibernate.cfg.xml";
  for this file, you should stick to the new factory version, and if you
  customized it, then you should take note of the changes you performed
  and apply them to the new factory file; but first see the Server
  CHANGELOG for details.

  However, for lightstreamer_log_conf.xml, lightstreamer_edition_conf.xml,
  the MPN configuration files under conf/mpn,
  and any adapters.xml used to configure Remote Adapters, to take advantage
  of new configuration opportunities, you may prefer to rather take note
  of any changes you performed and apply them to the new factory files.
  For lightstreamer_log_conf.xml we suggest converting it through the online
  Configuration File Upgrade Tool, available at:
  https://service.lightstreamer.com/ConfigUpgrade

  On the other hand, if you changed the launch scripts under "bin"
  (e.g. LS.sh, LS.bat), check on the Server CHANGELOG if you can copy
  them unchanged or should rather take note of any changes you performed
  and apply them to the new factory files.
  However, if you modified the Install/Uninstall scripts in
  "bin/windows", you will need to port them. Look for "NSSM" in the Server
  changelog for details.

  Also consider that if you run the Server with a license of "file" type,
  a license upgrade will be needed.

- ADAPTERS:
  The Server upgrade to 7.4.8 implies the upgrade of the SDK for
  Java In-Process Adapters from version 7.2.0 or above to 8.1.0,
  which brings significant interface changes.
  However, the Server includes a specific support for Adapter binaries based
  on Java In-Process Adapters SDK versions since 7.0.0,
  with only a few corner cases not covered.
  So, you can deploy your existing in-process Adapter binaries unchanged,
  but first check the SDK changelog to ensure that no corner case applies.
  
  The adapters.xml files can and should be left unchanged. However, upon
  rebuild and update of a Metadata Adapter to leverage the new interface
  changes, the related adapters.xml should be revised according with the
  Server CHANGELOG. To simplify the operation, we suggest you using the
  online Configuration File Upgrade Tool; it is available at:
  https://service.lightstreamer.com/ConfigUpgrade

  The Server upgrade to 7.4.8 also involves important changes in the embedded
  Adapter Remoting Infrastructure, which has moved from ARI Protocol
  version 1.8.3 to 1.9.1. However, backward compatibility since protocol
  version 1.8.0 is provided.
  So, you can deploy your existing Remote Adapter binaries unchanged.

  Note that all Remote Adapter SDKs have changed to take advantage of the new
  features. On the download page you can find the current versions of the SDKs.
  In order to upgrade the adapters, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

- CLIENTS:
  The Server upgrade to 7.4.8 implies the upgrade of client protocol from
  TLCP version 2.3.0 to 2.5.0. Anyway, the Server is always compatible with
  all client libraries available at the time of release and with all previous
  client libraries, so your existing clients should work with no issues.

  Many client SDKs have changed recently. On the download page you can find
  the current versions of the SDKs.
  In order to upgrade the clients, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

  The Server upgrade to 7.4.8 also implies the upgrade of the SDK for
  JMX Extensions from version 5.6.0 to 5.8.2, with only a few changes
  and extensions, but see the CHANGELOG of the JMX SDK, that you can find
  on the download page, to learn about any possible compatibility issues.

- MPN MODULE DATABASE (where available):
  If leveraging the MPN module, you can deploy your existing database
  unchanged on the new installation.

---------------------------------------------
Upgrading from 7.1.2 or 7.1.3 to This Version
---------------------------------------------

If you have an existing installation of Lightstreamer 7.1.2 or 7.1.3,
then this new release brings various improvements and a few bug fixes
in the Server and related SDKs (ARI, JMX, TLCP) and the MPN Module.
In particular, the Adapter Remoting Infrastructure is now fully embedded
in the Server and it is no longer versioned separately. Hence the
Remote Adapter SDKs now must express their compatibility with respect
to the Server version directly.

However, the Server improvements also involve new deployed third-party
libraries and revovals or changes in many others.
So, we suggest you to do a fresh install of Lightstreamer 7.4.8, then:

- CONFIGURATION:
  The configuration files under the "conf" folder
  (e.g. lightstreamer_conf.xml, lightstreamer_log_conf.xml and those under
  "conf/mpn") have undergone various changes and cannot be copied in the
  new installation unchanged.  Rather, you should take note of any changes
  you performed and apply them to the new factory files.
  For lightstreamer_conf.xml and lightstreamer_log_conf.xml, you can
  also use the online Configuration File Upgrade Tool, available at:
  https://service.lightstreamer.com/ConfigUpgrade

  On the other hand, if you have changed the launch scripts under "bin"
  (e.g. LS.sh, LS.bat), take note of any changes you performed and apply
  them to the new factory files.
  In particular, if you modified the Install/Uninstall scripts in
  "bin/windows", you will need to port them. Look for "NSSM" in the Server
  changelog for details.

  Also consider that if you run the Server with a license of "file" type,
  a license upgrade will be needed.

- ADAPTERS:
  The Server upgrade to 7.4.8 implies the upgrade of the SDK for
  Java In-Process Adapters from version 7.2.0 or above to 8.1.0,
  which brings significant interface changes.
  However, the Server includes a specific support for Adapter binaries based
  on Java In-Process Adapters SDK versions since 7.0.0,
  with only a few corner cases not covered.
  So, you can deploy your existing in-process Adapter binaries unchanged,
  but first check the SDK changelog to ensure that no corner case applies.
  
  The adapters.xml files should initially be ported only to Server version
  7.2.0 according with the Server CHANGELOG. Only upon rebuild and update
  of a Metadata Adapter to leverage the new interface changes, should the
  related adapters.xml be ported to Server version 7.4.8.
  To simplify these steps, we suggest you using the
  online Configuration File Upgrade Tool; it is available at:
  https://service.lightstreamer.com/ConfigUpgrade

  The Server upgrade to 7.4.8 also involves important changes in the embedded
  Adapter Remoting Infrastructure, which has moved from ARI Protocol
  version 1.8.2 to 1.9.1. However, backward compatibility since protocol
  version 1.8.0 is provided.
  So, you can deploy your existing Remote Adapter binaries unchanged.

  However, if you use Remote Adapters, your adapters.xml files should
  be revised according with the Server CHANGELOG. To simplify the
  operation, we suggest you using the online Configuration File
  Upgrade Tool; it is available at:
  https://service.lightstreamer.com/ConfigUpgrade

  Note that all Remote Adapter SDKs have changed to take advantage of the new
  features. On the download page you can find the current versions of the SDKs.
  In order to upgrade the adapters, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

- CLIENTS:
  The Server upgrade to 7.4.8 implies the upgrade of client protocol from
  TLCP version 2.2.0 to 2.5.0. Anyway, the Server is always compatible with
  all client libraries available at the time of release and with all previous
  client libraries, so your existing clients should work with no issues.

  Many client SDKs have changed recently. On the download page you can find
  the current versions of the SDKs.
  In order to upgrade the clients, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

  The Server upgrade to 7.4.8 also implies the upgrade of the SDK for
  JMX Extensions from version 5.5.6 to 5.8.2, with only a few changes
  and extensions, but see the CHANGELOG of the JMX SDK, that you can find
  on the download page, to learn about any possible compatibility issues.

- MPN MODULE DATABASE (where available):
  If leveraging the MPN module, you can deploy your existing database
  unchanged on the new installation.

---------------------------------------------------
Upgrading from 7.1.1 build 20200527 to This Version
Upgrading from 7.1.0 build 20200124 to This Version
---------------------------------------------------

If you have an existing installation of Lightstreamer 7.1.1 or 7.1.0,
then this new release brings various improvements and a few bug fixes
in the Server and related SDKs (ARI, JMX, TLCP) and the MPN Module.
In particular, the Adapter Remoting Infrastructure is now fully embedded
in the Server and it is no longer versioned separately. Hence the
Remote Adapter SDKs now must express their compatibility with respect
to the Server version directly.

More significantly, the new release no longer includes the resources
of the various SDKs in the distribution package. Now Client and Adapter
SDKs evolve independently and their resources, including the CHANGELOG,
can only be reached directly from the download page.
Moreover, the Server improvements also involve new deployed third-party
libraries and removals or changes in many others.
So, we suggest you to do a fresh install of Lightstreamer 7.4.8, then:

- CONFIGURATION:
  The configuration files under the "conf" folder
  (e.g. lightstreamer_conf.xml, lightstreamer_log_conf.xml and those under
  "conf/mpn") have undergone various changes and cannot be copied in the
  new installation unchanged.  Rather, you should take note of any changes
  you performed and apply them to the new factory files.
  For lightstreamer_conf.xml and lightstreamer_log_conf.xml, you can
  also use the online Configuration File Upgrade Tool, available at:
  https://service.lightstreamer.com/ConfigUpgrade

  On the other hand, if you have changed the launch scripts under "bin"
  (e.g. LS.sh, LS.bat), take note of any changes you performed and apply
  them to the new factory files.
  In particular, if you modified the Install/Uninstall scripts in
  "bin/windows", you will need to port them. Look for "NSSM" in the Server
  changelog for details.

  Also consider that if you run the Server with a license of "file" type,
  a license upgrade will be needed.

- ADAPTERS:
  The Server upgrade to 7.4.8 implies the upgrade of the SDK for
  Java In-Process Adapters from version 7.2.0 or above to 8.1.0,
  which brings significant interface changes.
  However, the Server includes a specific support for Adapter binaries based
  on Java In-Process Adapters SDK versions since 7.0.0,
  with only a few corner cases not covered.
  So, you can deploy your existing in-process Adapter binaries unchanged,
  but first check the SDK changelog to ensure that no corner case applies.
  
  The adapters.xml files should initially be ported only to Server version
  7.2.0 according with the Server CHANGELOG. Only upon rebuild and update
  of a Metadata Adapter to leverage the new interface changes, should the
  related adapters.xml be ported to Server version 7.4.8.
  To simplify these steps, we suggest you using the
  online Configuration File Upgrade Tool; it is available at:
  https://service.lightstreamer.com/ConfigUpgrade

  The Server upgrade to 7.4.8 also involves important changes in the embedded
  Adapter Remoting Infrastructure, which has moved from ARI Protocol
  version 1.8.2 to 1.9.1. However, backward compatibility since protocol
  version 1.8.0 is provided.
  So, you can deploy your existing Remote Adapter binaries unchanged.

  However, if you use Remote Adapters, your adapters.xml files should
  be revised according with the Server CHANGELOG. To simplify the
  operation, we suggest you using the online Configuration File
  Upgrade Tool; it is available at:
  https://service.lightstreamer.com/ConfigUpgrade

  Note that all Remote Adapter SDKs have changed to take advantage of the new
  features. On the download page you can find the current versions of the SDKs.
  In order to upgrade the adapters, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

- CLIENTS:
  The Server upgrade to 7.4.8 implies the upgrade of client protocol from TLCP
  version 2.1.0 or 2.2.0 to 2.5.0. Anyway, the Server is always compatible with
  all client libraries available at the time of release and with all previous
  client libraries, so your existing clients should work with no issues.

  Many client SDKs have changed recently. On the download page you can find
  the current versions of the SDKs.
  In order to upgrade the clients, read carefully through the CHANGELOG
  of the involved SDKs to learn about any possible compatibility issues.

  The Server upgrade to 7.4.8 also implies the upgrade of the SDK for
  JMX Extensions from version 5.5.x to 5.8.2, with only a few changes
  and extensions, but see the CHANGELOG of the JMX SDK, that you can find
  on the download page, to learn about any possible compatibility issues.

- MPN MODULE DATABASE (where available):
  If leveraging the MPN module, you can deploy your existing database
  unchanged on the new installation.

---------------------------------------------------
Upgrading from 7.0.3 build 20190107 to This Version
Upgrading from 7.0.2 build 20181003 to This Version
Upgrading from 7.0.1 build 20180614 to This Version
Upgrading from 7.0.0 build 20180228 to This Version
---------------------------------------------------

If you have an existing installation of Lightstreamer 7.0.0 build 20180228
through 7.0.3 build 20190107, then this new release brings various
improvements and bug fixes in the Server and related SDKs (ARI, JMX, TLCP).
In particular, the Adapter Remoting Infrastructure is now fully embedded
in the Server and it is no longer versioned separately. Hence the
Remote Adapter SDKs now must express their compatibility with respect
to the Server version directly.

More significantly, the new release no longer includes the resources
of the various SDKs in the distribution package. Now Client and Adapter
SDKs evolve independently and their resources, including the CHANGELOG,
can only be reached directly from the download page.
The release also brings an upgrade of the Server's MPN Module implementation.
Moreover, the Server improvements also involve new deployed third-party
libraries and removals or changes in many others.
So, we suggest you to do a fresh install of Lightstreamer 7.4.8, then:

- CONFIGURATION:
  The configuration files under the "conf" folder
  (e.g. lightstreamer_conf.xml, lightstreamer_log_conf.xml and those under
  "conf/mpn") have undergone various changes and cannot be copied in the
  new installation unchanged.  Rather, you should take note of any changes
  you performed and apply them to the new factory files.
  For lightstreamer_conf.xml and lightstreamer_log_conf.xml, a better option
  is to use the online Configuration File Upgrade Tool, available at:
  https://service.lightstreamer.com/ConfigUpgrade

  If you are leveraging the MPN Module, the MPN related configuration files
  under the "conf/mpn" folder should be ported manually according with
  the Server CHANGELOG.

  If you are leveraging the possibility to define custom extensions to the
  logging subsystem, the deployment of such extensions may need to be modified
  according with the Server CHANGELOG.

  On the other hand, if you have changed the launch scripts under "bin"
  (e.g. LS.sh, LS.bat), take note of any changes you performed and apply
  them to the new factory files.
  In particular, if you modified the Install/Uninstall scripts in
  "bin/windows", you will need to port them. Look for "NSSM" in the Server
  changelog for details.

  Also consider that if you run the Server with a license of "file" type,
  a license upgrade will be needed.

- ADAPTERS:
  The Server upgrade to 7.4.8 implies the upgrade of the SDK for
  Java In-Process Adapters from version 7.0.0 or above to 8.1.0,
  which brings significant interface changes.
  However, the Server includes a specific support for Adapter binaries based
  on Java In-Process Adapters SDK versions since 7.0.0,
  with only a few corner cases not covered.
  So, you should be able to deploy your existing in-process Adapter
  binaries unchanged, but first check for possible corner cases in the
  CHANGELOG of the Java In-Process Adapter SDK.
  
  The adapters.xml files should initially be ported only to Server version
  7.2.0 according with the Server CHANGELOG. Only upon rebuild and update
  of a Metadata Adapter to leverage the new interface changes, should the
  related adapters.xml be ported to Server version 7.4.8.
  To simplify these steps, we suggest you using the
  online Configuration File Upgrade Tool; it is available at:
  https://service.lightstreamer.com/ConfigUpgrade

  The Server upgrade to 7.4.8 also involves important changes in the embedded
  Adapter Remoting Infrastructure, which has moved from ARI Protocol
  version 1.8.0 to 1.9.1. However, backward compatibility since protocol
  version 1.8.0 is provided, with only a few corner cases not covered.
  So, you should be able to deploy your existing Remote Adapter
  binaries unchanged, but first check for possible corner cases in the
  Server CHANGELOG, with regard to the Adapter Remoting Infrastructure.

  However, if you use Remote Adapters, your adapters.xml files should
  also be revised according with the Server CHANGELOG. To simplify the
  operation, we suggest you using the online Configuration File
  Upgrade Tool; it is available at:
  https://service.lightstreamer.com/ConfigUpgrade

  Note that the Remote Adapter SDKs have changed significantly. On the
  download page you can find the currently available SDKs and their
  versions.
  In order to upgrade the In-Process and Remote Adapters to newer SDK
  versions, read carefully through the CHANGELOG of the involved SDKs
  to learn about any possible compatibility issues.

- CLIENTS:
  The Server upgrade to 7.4.8 implies the upgrade of client protocol from
  TLCP version 2.1.0 to 2.5.0. Anyway, the Server is always compatible with
  all client libraries available at the time of release and with all previous
  client libraries, so your existing clients should work with no issues.
  The only exception regards Android clients leveraging the MPN support;
  see paragraph "Special Considerations on the GCM to FCM Transition" in the
  General Concepts document for clarifications.

  Note that the Client SDKs have changed significantly. On the download
  page you can find the currently available SDKs and their versions.
  In order to upgrade the Clients to newer SDK versions, read carefully
  through the CHANGELOG of the involved SDKs to learn about any possible
  compatibility issues. In particular, if you run the Server with a license
  of "file" type, a license upgrade may be needed.

  The Server upgrade to 7.4.8 also implies the upgrade of the SDK for
  JMX Extensions from version 5.4.x to 5.8.2, with various changes
  and extensions; see the CHANGELOG of the JMX SDK, that you can find
  on the download page, to learn about any possible compatibility issues.

- MPN MODULE DATABASE (where available):
  If leveraging the MPN module, and the GCM service in particular, then the
  database contents should be migrated when ported to the new Server.
  To achieve that, please contact Lightstreamer support for instructions.

-----------------------------------------------------------------
Upgrading from all Previous Versions (before 7.0) to This Version
-----------------------------------------------------------------

Port your installation to version 7.0 first, by downloading the 7.0.3
package and following the provided upgrade instructions. Then you can proceed
by referring to the instructions for 7.0.3 above.
