Skip to main content
Skip table of contents

Upgrade Procedure Checklist

This document provides a checklist to reference when upgrading your LogRhythm deployment.

This checklist is not intended to replace the LogRhythm Software Upgrade Guide, which contains important information about the upgrade process. It is strongly recommended that you perform your upgrade by following the detailed procedures in that guide, using this checklist to track your progress.

This checklist assumes that your deployment is not in HA or DR. For HA or DR deployments, use the HA or DR checklist.

Prepare for the Upgrade

  • Get the latest version of the LogRhythm Software Upgrade Guide from docs.logrhythm.com (or download the PDF).
  • Review the upgrade requirements and considerations.
    • Scheduling the upgrade and planning downtime
    • FIPS Mode support
    • Core services and Client Console compatibility
    • SQL Server security hardening impacts
    • System Monitor Agent considerations
    • OS requirements for the Windows components
    • Microsoft .NET 8.0.3+ Core requirements
    • Microsoft .NET Framework 4.7.2 requirements
    • Web Console prerequisites
    • Component compatibility
  • Ensure that you have the required Administrator credentials.
    • Local Administrator privileges for the LogRhythm servers
    • SQL Server password for the LogRhythmAdmin account
    • SQL Server sa password for the LogRhythm Databases
    • LogRhythm Service accounts referenced within the Configuration Manager

      For a list of these passwords, see LogRhythm Default Passwords.
  • Download software to upgrade a LogRhythm deployment.
    • LogRhythm Database Upgrade Tool
    • LogRhythm Install Wizard
    • Linux Data Indexer Installer
      • Required only if you have a Linux Data Indexer
    • (Optional) System Monitor Packages
    • (Optional) Threat Intelligence Service
    • (Optional) TrueIdentity Sync Client
    • (Optional) SOAP API
  • Record service credentials.
  • Request a LogRhythm license file at least one business day prior to upgrade.

    If you are upgrading to a new LogRhythm major version, a license file is required.
  • Modify web.config for the LR API.
    • Required only if you are using the LR API
  • Note Web Console environmental variables.
    • Required only if you are overriding the Configuration Manager settings on one or more Web Console servers
  • Note Platform Manager IP, LogRhythm Web UI password, and login warning banner.
  • Synchronize stored Knowledge Base
    • Required only if you have downloaded a Knowledge Base but have not yet synchronized it
  • Set the System Monitor service to Startup Type = Automatic.
  • Verify deployment status in the LogRhythm Infrastructure Installer.
  • Shut down antivirus and endpoint protection software.
  • Exit all LogRhythm Client Consoles.

Upgrade the LogRhythm Deployment

  • Stop the LogRhythm core services on Windows appliances.
    • Platform Manager Servers
      • Alarming and Response Manager
      • Job Manager
      • AI Engine Cache Drilldown
    • Data Processor Servers
      • Mediator Server Service
    • AI Engine Servers
      • AI Engine
      • AI Engine Communication Manager
    • Web Console Servers
      • Web Services Host API
      • Web Indexer
      • Web Console UI
      • Web Console API
      • Case API
    • SecondLook Servers
      • SecondLook API
    • (Optional) Kibana
    • Exit all LogRhythm Client Consoles.
    • System Monitor Agents can remain running throughout the upgrade.
    • Any services not mentioned in the above list are not required to be stopped for the upgrade. The Database Upgrade Tool might stop a few additional services on the PM/XM, but this is expected behavior.
  • Verify that no open connections for LogRhythm accounts are present in SQL Activity Monitor.

  • Run the LogRhythm Database Upgrade Tool.
  • Upgrade the LogRhythm appliances.
    • Run the LogRhythm Install Wizard on the primary PM/XM.
    • Configure the remaining hosts by running the LogRhythm Infrastructure Installer package on the required appliances.
      • Platform Manager
      • Data Processors
      • AI Engine Servers
      • Web Console Servers
      • Data Indexers

        If you have Linux Data Indexers (DXs), run the LogRhythm Infrastructure Installer package when upgrading the DX. For more information see Upgrade the LogRhythm Data Indexer.
        • Update the hosts file to contain the hot and warm additions with the host entries.
        • Run the PreInstall.sh script from the DX node you want to run the upgrade from.
        • When prompted to enter the path location for the hosts file, enter the full path location—for example, home/logrhythm/Soft/hosts.
        • Run the installer with the hosts file argument.

          • An --es-cluster-name is required only for new install, not for an upgrade

      • (Optional) Configure additional servers.
      • Verify cluster status.
    • Run the LogRhythm Install Wizard on all remaining Windows appliances.
      • Data Processors
      • AI Engine Servers
      • Web Console Servers
      • SecondLook Servers
  • Perform post-upgrade procedures.
    • Restart the upgraded systems.
    • Import the LogRhythm license file.
    • Perform all applicable post-upgrade procedures to ensure components are configured correctly. 
    • Start the LogRhythm components.

Verify the Upgrade

  • Confirm that all LogRhythm services have started successfully.
  • Confirm that All Services Up appears in the Configuration Manager.

    This could take up to 5 minutes after the upgrade.
  • Open a web browser on the primary PM/XM, enter <localhost>:3000, click Pipeline, and then click Mediator.
    • Confirm that all Data Processors are processing logs.
    • Change the dashboard time filter to Last 5 minutes.
  • Enter <localhost>:3000, click Data Indexer, click Maintenance, and then confirm that the DX cluster is green or yellow.

    • If you have a large deployment, the cluster may remain yellow for a significant amount of time while the indices come online.
    • Depending on the size of the DX cluster and how much data it contains, it could take several minutes for the cluster to turn from red to yellow or green after the upgrade. After it turns yellow, then indexing and searching capabilities should be reinstated.
  • Enter <localhost>:3000, click Data Indexer, click Logs Indexing, and then confirm that logs are being indexing into the DX cluster.
  • Enter <localhost>:3000, click AIE, click AIE Metrics, and then confirm that all LMs (DPs) are connected to the AIE servers required, and that the AIE servers are receiving and processing data.
  • In the Web Console:
    • Verify that you can see data on your key dashboards.
    • Conduct a search in the Web Console with the following parameters:
      • Timeframe: Last 30 minutes
      • Filters: remove all filters
      • Repository: Logs

This check tests 90% of the SIEM's core functionality. If you get results, then the deployment's processing, indexing, and searching functionality are working. If you do not get results, then you may need to wait for the DX cluster to turn yellow before trying this search again.

  • If you have any test AIE correlation rules set to trigger an alarm, generate one of these and verify that it appears in the Alarms tab of the Web Console.

    If you have already had AIE correlation rules trigger an alarm post-upgrade, then there is no need to complete this step.
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.