Upgrade Primary Server

This applies to upgrading from ENPS 9.0.0.230 or later. See Upgrade from ENPS versions earlier than 9.0.0.230 to upgrade from earlier versions.

Preparation

Before you start the upgrade process, make sure you do the following on the Primary Server:

  1. Check for Windows updates on the Primary Server, installing and then rebooting the server at a convenient time.

    Do not reboot both ENPS servers at the same time.

  2. Check the F:\Common folder for unexpected subfolders.

    AUDIT, BUDDY, C_SUPPORT, DBSCRIPTS, ELECTION, G_SUPPORT, and G_SUPPORTBACKUP are expected. Any other folders are should be deleted or moved to the C:\ drive.

  3. Create a backups folder on your desktop

  4. Copy the following files and folders to the backups folder:

    C:\inetpub\wwwroot
    E:\Search Server\data\enps\conf (if applicable - legacy from v8.2.X)
    E:\Search Server\SOLRJavaService (where applicable)
    F:\Common\G_Support
    F:\ENPS
    F:\NOM\nom.ini
    F:\NOM\AC
    F:\NWP
    F:\SearchServer
    F:\ServerName\S_SUPPORT
    F:\ServerName\S_PRIV

    The backups folder should now look like this:

  5. Switch users to the Buddy NOM by blocking the NOM on the Primary Server:

    Remind users that they will see failover messages throughout the upgrade process. Users can continue working without interruption.

    1. Open the NOM Buddy Maintenance tool on the Primary server.

    2. Ensure there is no queue in the top window.

    3. Open the News Object Manager (NOM) on the Primary server.

    4. Open Window > NOM Configuration/Status and ensure the Block Primary Access box is ticked.

  6. Confirm that users can work on the Buddy Server.

  7. Close all ENPS components on the Primary Server, starting with NOM Watcher.

  8. Stop the SOLRJavaServer service:

    1. Open the Server Manager tool.

    2. Browse to Local Server > Tools > Services.

    3. Stop the SOLRJavaServer service.

Corretto for Solr

Uninstall any versions of Corretto other than version 17:

  1. Open Start Menu > Apps & Features.

  2. Search the apps list for Corretto.

  3. Click on each Corretto entry to check the version.

  4. Uninstall all Corretto installations that are not version 17.

    If you can't uninstall Corretto because it is still in use:

    1. Open Task Manager.

    2. Open the Services tab.

    3. Right-click SolrJavaService in the list and select Stop from the popup menu.

    4. Try deleting Corretto again.

    If prompted to restart your system:

    1. Remove the Watch.exe shortcut from the startup folders:

      1. Click Start, type Run and enter the following in the Run dialog to open the first startup folder:

        shell:startup

      2. Remove the Watch.exe shortcut from the folder if it exists.

      3. Click Start, type Run and enter the following in the Run dialog to open the second startup folder:

        shell:common startup

      4. Remove the Watch.exe shortcut from the folder if it exists.

    2. Click Yes to restart.

For details about using Solr in ENPS, see Solr Search.

Installation

Once all Preparation is complete, continue with installation:

  1. Right-click on the ENPS Platform Installer .zip file downloaded in Download Installer and select Properties.

  2. Ensure that the General tab > Unblock box is ticked if it exists, then click OK.

  3. Extract the ENPS installer from the ENPS Platform Installer .zip file.

  4. Run the extracted ENPS Platform Installer.

  5. On the Product Selection screen select the following for a typical ENPS installation:

    • ENPS Server Components - Upgrade

    • ENPS NOM Web Services - Upgrade

    • ENPS Elections API Ingest Service - Upgrade or Install

    Your screen should look like this:

    The installer will flag if the server does not meet certain prerequisites, such as the required version of Corretto installed.

    If you see this message, click Install Requirements.

    Click Next if all prerequisites are met:

  6. On the End User License Agreement screen, read the agreement and accept the terms.

  7. Click Next.

  8. Configure admin login using either:

    Alternatively, do not use auto login on this server.

    The actual screens shown in this step depend on what you already have configured. The Do not auto login to this server option is not available if the server is already configured to use an admin login method.

  9. Click Next.

  10. On the Configuration > Search Configuration screen, enter a username and password for Solr and ensure that Override and configure SOLR specific settings is ticked.

    Do not forget the User Name and Password as they are required to connect with Solr.

  11. On the Configuration > IIS Settings screen, Webservice should be preselected with the correct Application Pool (NOMWebServicesAppPool).

  12. Click Next Step.

  13. Click Next.

    Click Run in any prompts that appear.

  14. Click Continue to start installation.

  15. Wait for installation to complete.

  16. Copy the G_SUPPORT files:

    If your Primary Server is NOT your Central Server, meaning you have a separate Central Server, provided that has been upgraded, then skip this step.

    This step is only necessary if your Primary Server is also your Central Server.

    1. Open File Explorer.

    2. Copy the following files in the F:\Common\G_Support folder:

      G_Fielddef

      G_Langen

    3. Paste them to same folder on the Primay/Central Server.

  17. Click Install Details.

  18. Click Finish.

  19. Click OK to close the installer.

    Do not start NOM Watcher.

Proceed to the Post-installation instructions.

Post-installation

Before Server Restart

After Installation is complete and before restarting the server:

  1. Open F:\NOM\NOM.ini in Notepad.

  2. Ensure that the following setting exists in the NOM section of the file. If not, add it and save the file:

    ContinueIfSOLRDown=1

  3. Open the backups folders created during Primary Server Preparation.

  4. Open the ENPS\v7\ENPSClient.exe.config file.

  5. Compare this file with the same file in F:\ENPS\v7 on the Primary Server, specifically:

    1. Check that the Primary and Secondary webservice settings are correct.

Continue with these steps:

  1. If this server ingests FTP wires, confirm if the FTP wire log files (.DC) are in the NWP folder.

    If not, restore them from the backup of the NWP folder created during Preparation.

  2. Edit the NomWebServiceAppPool application pool:

    1. Open Internet Information Services (IIS) Manager.

    2. In the Connections pane, expand the server name and select Application Pools.

    3. In the Application Pools pane on the right, right-click NomWebServiceAppPool and select Advanced Settings.

    4. Set the Idle Time-out (minutes) option to 0 in the Advanced Settings popup.

    5. Click OK.

    6. Right-click NomWebServiceAppPool again and ensure that it is started.

  3. Delete the contents of the F:\NOM\MOS\OUT folder if it exists.

  4. Remove the Watch.exe shortcut from the startup folders:

    1. Click Start, type Run and enter the following in the Run dialog to open the first startup folder:

      shell:startup

    2. Remove the Watch.exe shortcut from the folder if it exists.

    3. Click Start, type Run and enter the following in the Run dialog to open the second startup folder:

      shell:common startup

    4. Remove the Watch.exe shortcut from the folder if it exists.

Now restart the server.

After Server Restart

After restarting the server:

  1. Launch the News Object Manager (NOM) in block mode on the primary server by entering this into a command line:

    F:\NOM\nom.exe /block

    There is a space after .exe and before /block.

    If your ENPS data drive is something other than F:\, use that drive letter instead.

  2. Wait for Solr to start if prompted.

    After a restart it can take several minutes for Solr to become fully functional. The NOM may indicate as such.

    You can proceed once this screen has disappeared and the NOM has fully launched.

  3. Open Window > NOM Configuration/Status and ensure the Block Primary Access box is ticked.

  4. Regenerate the schema by entering the following at a command prompt

    1. F:\SearchServer\SOLRSchemaManager.exe /regenerate /reset:true

  5. Click Start, type Run and enter the following in the Run dialog to open the user startup folder:

    shell:startup

  6. Copy the Watch shortcut from the desktop to the startup folder.

  7. Open NOM Watcher, which starts the other processes on the Primary Server.

    Keep Block Primary Access checked for now.

  8. Confirm that all wires are ingesting as expected.

    If any FTP wires are not ingesting, deactivate the wire, re-enter the password for the FTP server, and activate the wire again.

  9. If your users do not have local admin rights on their workstations, you may enter credentials they can use for the upgrade in the application, F:\NOM\Setadmin.exe. These credentials should have local admin rights on all workstations.

    This will ensure that the ENPS Client can be upgraded on these workstations.

  10. Ensure there is not a queue in the Buddy Maintenance Process window on the Buddy Server.

  11. Unblock the Primary Server once the Buddy queue is empty.

  12. Try launching a client to check if it upgrades.

    If so, have one regular user close and relaunch ENPS.

    If the upgrade fails, try a different account in setadmin.exe. It’s fine if it’s an account with an expiring password. You only need setadmin credentials to be current on a day you’re upgrading ENPS.

  13. Launch a client on a machine without local admin rights to confirm that the client upgrades.

  14. Upgrade all control room and set machines at this time (recommended).

NOM Maint Processes

There are three processes that you may find need fine-tuning to run certain tasks when it's the least busiest time for your users:

  • Delete Expired Items time in NOM Maintenance.

  • Folder Info time in NOM Maintenance.

  • NOM Web Services Application Pool recycle time in Internet Information Services (IIS) Manager.

By default, ENPS sets these to 2:00am local time. However, this time may not be the least busy time for your users and may cause disruptions.

Therefore, we suggest that you poll your editorial leaders to determine the time that is least busiest, and set the tasks in the three processes to run around that time on the Primary and Buddy servers. See the sub-sections below for instructions.

If you adjust the NOM Maintenance times you may also need to adjust the create times of any rundowns that are autocreated.

Rundowns should not be set to autocreate within the same hour as the Delete Expired Items on the Primary Server. For example, if Delete Expired Items is set for 00:30, no rundowns should be set to autocreate from 00:30-01:30.

Primary Server Times

On the Primary Server:

  1. Open NOM Maintenance.

  2. Open Window > Delete Expired Items.

  3. Set the Delete expired items each day at to field to the time the editorial leader said was least busy.

    For example, to set to 1am enter 01:00:00.

  4. Open Window > Folder Info.

  5. Set the Scan folders each day at field to one hour later than the Delete expired items each day at to time.

    For example, if that field was set to 01:00:00 then enter 02:00:00 here.

  6. Open Internet Information Services (IIS) Manager.

  7. Expand the server name in the Connections pane and click Application Pools.

  8. Right-click NOMWebServicesAppPool and select Recycling... from the popup menu.

  9. Set Specific time(s) to 10 minutes earlier than the Delete expired items each day at to field.

    For example, if that field was set to 1:00:00 then enter 00:50 here. Note that seconds aren't required.

    Ensure nothing else is checked under Fixed Intervals.

  10. Click Next.

  11. Click Finish.

  12. Restart IIS.

Buddy Server Times

On the Buddy Server:

  1. Open NOM Maintenance.

  2. Open Window > Delete Expired Items.

  3. Set the Delete expired items each day at to field to the same as the Folder Info > Scan folders each day at field on the Primary Server.

    For example, if Delete expired items each day at to was set to 01:00:00 on the Primary Server then set Folder Info > Scan folders each day at to 02:00:00 on the Buddy Server.

  4. Open Window > Folder Info.

  5. Set the Scan folders each day at field to one hour later than the Delete expired items each day at to time.

    For example, if that field was set to 02:00:00 then enter 03:00:00 here.

  6. Open Internet Information Services (IIS) Manager.

  7. Expand the server name in the Connections pane and click Application Pools.

  8. Right-click NOMWebServicesAppPool and select Recycling... from the popup menu.

  9. Set Specific time(s) to 10 minutes earlier than the Delete expired items each day at to field.

    For example, if that field was set to 2:00:00 then enter 01:50 here. Note that seconds aren't required.

    Ensure nothing else is checked under Fixed Intervals.

  10. Click Next.

  11. Click Finish.

  12. Restart IIS.

Solr Recrawl

Perform a recrawl only if you are updating from version 9.5.0 or earlier.

To do so, open a command prompt and enter:

F:\SearchServer\SearchCrawler.exe

Recrawling data does not impact users. It simply means that searching in ENPS will gradually become available on the server as data is reindexed.

Next Steps

You have now upgraded the Primary Server!

Proceed to Upgrade Buddy Server if not already done. Otherwise proceed toUpgrade Mobile Server if applicable.