How to manually update the Node.js or MongoDB packages used by the Next-Generation License Server

In some cases, you may need to update the version of MongoDB or Node.js that are installed alongside and used with the Next-Generation License Server, for security vulnerability concerns or otherwise. These packages can be manually updated with minimal risk as long as you keep with the exact same major AND minor version of the products included with the Next-Generation License Server.
 

License Server version	Default MongoDB version	Default Node.js version
4.1	5.0.15	16.19.1
4.2.1	6.0.9	18.18.2
4.3	6.0.16	18.20.4

 

WARNING: Alternative versions of MongoDB and Node.js have not been fully tested for compatibility with the License Server, but they should work as long as the specific versioning guidelines below are followed. Proceed at your own risk!

 

Updating MongoDB 

1. First determine which version of MongoDB is used by the License Server version you have installed. This can be found in the installation guide under "System Requirements" (Linux | Windows). For example, the Linux documentation mentions that "...the License Server requires an Intel/AMD 64-bit processor and a Linux distribution. In general, the License Server should successfully function on the Linux systems supported by MongoDB Community Server 6.0 and Node.js 18." So in this case, you will need to make sure you stay with mainline MongoDB version 6.0. Make sure to verify which version you need before proceeding! 
2. With that versioning in mind, MongoDB Community Edition can be downloaded here: https://www.mongodb.com/try/download/community. In addition to downloading the correct version for the correct platform, make sure also to get the "server" package version (this dropdown is only there for Linux). 
3. Before installing the updated MongoDB, stop the Next-Generation License Server service. 
   1. Linux: 

      sudo INSTALL_DIR/node/bin/node INSTALL_DIR/service.js stop
      

   2. Windows: Open Windows Service panel, then right-click the NV5 Geospatial License Server service and select Stop.
       
4. After installing the new MongoDB version, restart the Next-Generation License Server service.
   1. Linux:

      sudo INSTALL_DIR/node/bin/node INSTALL_DIR/service.js start

   2. Windows: Open Windows Services panel, then right-click the NV5 Geospatial License Server service and select Start.

 

Updating Node.js

1. First determine which version of Node.js is used by the License Server version you have installed. This can be found in the installation guide under "System Requirements" (Linux | Windows). For example, the Linux documentation mentions that "...the License Server requires an Intel/AMD 64-bit processor and a Linux distribution. In general, the License Server should successfully function on the Linux systems supported by MongoDB Community Server 6.0 and Node.js 18." So in this case, you will need to make sure you stay with mainline Node version 18. Make sure to verify which version you need before proceeding! 
2. With that versioning in mind, Node.js can be downloaded here: https://nodejs.org/dist/. You can download a standalone installer or use a package manager. 
3. Before installing the updated Node.js package, stop the Next-Generation License Server service.
   1. Linux: 

      sudo INSTALL_DIR/node/bin/node INSTALL_DIR/service.js stop
      

   2. Windows: Open Windows Service panel, then right-click the NV5 Geospatial License Server service and select Stop.
       
4. After installing the new Node.js version, restart the Next-Generation License Server service.
   1. Linux:

      sudo INSTALL_DIR/node/bin/node INSTALL_DIR/service.js start

   2. Windows: Open Windows Services panel, then right-click the NV5 Geospatial License Server service and select Start.

 

 

 

 

 

 

Created by BC-US 6/10/2024 | Reviewed by TS 6/11/2024