Agnostic Guides
Developers Guide

log4j Update

1min

Below is an overview of the process to upgrade an existing installation of Link Enterprise. This must be performed for each Link Enterprise instance (ie: Link Enterprise windows service).

At the time of this writing, 2.17.1 is the latest log4j release. In the future if new versions are to be utilized, change the version numbers in the below steps accordingly.
  1. Stop the Gimmal Link Enterprise service
  2. Take note of the "Log On" tab if you are running the service under a named account.
  3. Download and move new log4j files (log4j-core-2.16.0.jar, log4j-api-2.16.0.jar) to /lib/log4j/
  4. Delete/rename old l4j file(s)
  5. Go to /services folder
  6. Uninstall the service
    • Start a Windows CMD prompt as administrator
    • In the CMD prompt run /services/uninstallService.bat
    • Refresh your Windows Service list to confirm it is no longer present
      • If the Link Enterprise service still exists, please edit the uninstallService.bat file to reflect the correct service name.
  7. Edit installService.bat in the /services directory
    1. For upgrade from 1.2.15:
      • Delete the string "\lib\log4j\log4j-1.2.16.jar;"
      • Add a new entry "\lib\log4j\log4j-core-2.16.0.jar;\lib\log4j\log4j-api-2.16.0.jar;"
      • This entry should proceed "\lib\connector-service-6.5.7-fat.jar"
    2. For upgrade from 2.16.0 or later:
      1. Replace the two instances of "2.16.0" <or your current version> with "2.17.1"
  8. Reinstall the service
    • Start a Windows CMD prompt as administrator
    • In the CMD prompt run the updated /services/installService.bat
  9. Refresh your Windows Service list to confirm the service has been re-installed
  10. Note: If you were running the service under a named account in the Log On tab of the Windows Service, you must reapply those changes.
  11. Open the service.txt log file with baretail
  12. Start the Gimmal Link Enterprise service
  13. View baretail and ensure Link Enterprise activity is being logged