Upgrading NetX on Windows

NetX provides an installer package for Windows that can be used for a new installation or to upgrade your existing installation.

Before you begin

Question Answer
Which version are you upgrading from?

If you are upgrading from a version prior to NetX 9, you must perform additional steps before completing this tutorial:

After completing the process outlined in Upgrading to Solr 7 on Windows, you can return to this article to finish the NetX upgrade process.

Are you running NetX in a distributed configuration? When upgrading multiple server instances, all server nodes should first be shut down. Each node should be upgraded in succession. Only once the first node has started up completely should the other nodes be started. This is because the application may be in the middle of database schema changes that need to complete before other nodes start using the database.
Have you backed your NetX instance? See Backing Up NetX for more details. 
Are you using supported software to host the latest version of NetX? Please review Supported Platforms to verify that your environment is supported for the latest release of NetX.
Have you reviewed the release notes? Occasionally, functionality is changed or removed in new releases. Make sure your users are familiar with the changes the upgrade will bring and re-train if necessary.

Upgrading NetX

If you are using a custom synonyms.txt file, make a copy of it before running the NetX upgrade. This file is usually located here: C:\Program Files\Solr\server\solr\netx\conf\synonyms.txt. You will need to restore this backup after the upgrade.

  1. Download the latest NetX Windows Installer from our Service Portal.
  2. Right-click on the exe file and Run As Administrator. The installation wizard will begin; click Next to continue.
  3. Click I Agree to accept the license agreement and continue.
  4. Choose the folder that your existing installation resides in.
  5. Choose the folder where your Java JDK installation resides. The installer should automatically find this location, so taking the default path is recommended. Click Next to continue.
  6. The installer will inform you on which version you are upgrading. Click the OK button to continue.
  7. To complete the installation, click Finish. Proceed to the Upgrading Solr section below.

Upgrading Solr

If you are upgrading from a version older than 9.x, and have already followed the instructions in  Upgrading to Solr 7 on Windows, please skip to Verifying the upgrade.

Each time that you upgrade NetX, you will need to copy the new version of the Solr core into your Solr application folder.

  1. Stop the Solr application by typing: 'C:\Program Files\Solr\bin\solr.cmd' stop in Powershell.
  2. Copy the  C:\Program Files\NetXposure\solr-cores\7\netx  folder into  C:\Program Files\Solr\server\solr\  and overwrite when prompted.
  3. Paste the synonyms.txt file you backed up earlier into C:\Program Files\Solr\server\solr\netx\conf and overwrite when prompted.
  4. Start Solr by typing 'C:\Program Files\Solr\bin\solr.cmd' start in Powershell.

Starting the NetX service

After the NetX application files have been upgraded, the new Solr core copied over and the Solr service started, it's finally time to start the NetX service.

  1. Open the Services console.
  2. Right-click on the NetX service and click Start.

Some NetX upgrades include database schema changes that may take a long time to complete on your server. When you see the log entries shown below appear in the Tomcat log: C:\Program Files\NetXposure\logs\stderr.log, it's safe to assume that the core upgrade process (version control) has completed. DO NOT restart your server or stop the NetX service before you see these entries appear, or you may risk a corrupt installation or database state. 

If you'd like to watch the progress of version control, you can monitor the main application log here: C:\Program Files\NetXposure\logs\exogen.log.

Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: category
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: asset
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: view
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: constituent
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: version
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: glacier
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: cache
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: user
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: clock
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: statistics
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: dataset
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: system
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: websocket
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started: view_metadata
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: XMP engine: EXIFTOOL
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Event channels started.
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Guava services started.
Wed Dec 04 12:15:38 PST 2019 EXOGEN INFO: Database batch updater started.

Verifying the upgrade

  • Log into NetX, go to System > Overview, and check the Application version. The application version should match the New Version that was listed in the installer wizard.
  • Verify that assets and thumbnails are available. If they aren't, make sure that Solr is running.
  • Reindexing is often recommended after an upgrade. Some upgrades (such as new Solr versions or schema changes) will automatically begin a site-wide reindex as part of the upgrade process. If this reindex is interrupted via server restart or some other process, you must restart it manually before assets will appear. For more information on how to perform a reindex, and how to check if a reindex is running on your site, see Rebuilding the Search Index.
Was this article helpful?
0 out of 0 found this helpful