Submit a ticketCall us

Have You Auto Renewed? If not, you're missing out.
The SolarWinds Renewal Program comes with a host of benefits including the most recent product updates, 24/7 technical support, virtual instructor-led training and more. Experience all of this with the convenience of Auto Renewal, and never worry about missing any of these great benefits. Learn More.

Home > Success Center > Log & Event Manager (LEM) > Log and Event Manager (LEM) 6.3.1 Hotfix 2 ReadMe

Log and Event Manager (LEM) 6.3.1 Hotfix 2 ReadMe

Updated December 22, 2016

A newer hotfix is available. The ReadMe for the latest LEM 6.3.1 Hotfix is available here.

This hotfix can be downloaded from your Customer Portal.

Notes

Hotfix 2 includes changes to LDAP settings that are not backwards compatible. If LEM is configured for single sign-on / LDAP authentication, you cannot uninstall this hotfix after it is installed.

Fixed issues

This is a cumulative hotfix that includes fixes from Hotfix 1.

 

Hotfix 2 addresses the following issues:

  • LEM Manager: Fixed an out-of-memory issue that occurs when sending alerts to the console. The fix improves performance when a large number of events are sent to the console.
  • LEM Manager: Fixed agent-manager communication issues: periodic disconnect and others.
  • LEM Manager: Fixed an issue with nDepth log retention (logging missing date in raw records).
  • LEM Manager: Fixed an issue that prevents logging in to LEM if using UserPrincipalName with a custom Alias or SAMAccountName with NETBIOS.
  • LEM Manager: Added the ability to use sub-alias LDAP environments.
  • LEM Manager: Removed field limitations in the normalized alert database.
  • LEM Manager: Fixed a log rotation issue that causes connectors to stop working if log lines are too long.
  • LEM Manager: Fixed a single sign-on (SSO) issue that occurs if a Kerberos ticket is unusually long because a user belongs to many groups.
  • LEM Manager: Added the ability to configure custom LDAP groups for authentication.
  • LEM Manager: Set an agent memory limit for agents upgraded from older versions.
  • LEM Manager: Fixed other agent-manager communication issues.
  • LEM Manager: Additional improvements to assist customer support, including improved logging, and added diagnostics.


The following fixes from Hotfix 1 are also included in this Hotfix:

  • LEM Manager: The threat-feeds server certificate changed. LEM cannot download thread-feeds IPs.
  • LEM Manager: Unable to use a domain containing a dash in the LDAP configuration.
  • LEM Manager: Unable to recover a password when HTTP is disabled.
  • LEM Manager: Exceptions during a fast evaluation are not logged.

Environment

This hotfix includes updates to the SolarWinds LEM Virtual Appliance and to the agents. 

To install Hotfix 2, verify that the LEM Appliance is running release 6.3.1 or 6.3.1 HF1. (Verification steps are provided in the next section.)

To install Hotfix 2 on the agents, use one of the following methods:

  • Use the auto-upgrade feature to automatically upgrade agents if the feature is enabled.
  • If the auto-upgrade feature is disabled, or if there are communication issues between agents and the LEM Manager, follow the manual installation steps included in the "Install Hotfix 2 on agents (Manual Steps)" section of this ReadMe.  

If upgrading older agent versions, the agent is first upgraded to version 6.3.1, and then to version 6.3.1.hotfix2.

Verify the LEM appliance release version

  1. Open the LEM console and log in to the LEM Virtual Appliance.

  2. Click Manage > Appliances.

  3. Under the Version column, check the current LEM version. 

  • If the version is Release 6.3.1 or 6.3.1 HF1, install the hotfix.
  • If the version is not Release 6.3.1 or 6.3.1 HF1, do not install the hotfix.

Install Hotfix 2 on the LEM Manager

  1. Using the LEM Console or an SSH client (such as PuTTY), log in to CMC and do the following:

    1. At the cmc> prompt, enter:

      manager

    2. At the cmc::manager# prompt, enter:

      hotfix

  2. Follow the instructions on your screen, providing the network path to your Hotfix 2 files and the appropriate credentials with Read access to this path.

    For example:

    \\server\share\unzipped_hotfix_folder\hotfix

    If you receive a message stating that no upgrades were found, ensure that you entered the correct path to the files.

    When completed, a CMC: prompt appears.

  3. Reboot the appliance:

    1. Exit the cmc::manager# prompt or at the cmc# prompt, enter:

      appliance

    2. At the prompt, enter:

      reboot

  4. After the appliance reboots, log in to CMC.

    At the prompt, enter:

    manager

  5. At the prompt, enter:

    viewsysinfo

    The system info appears on your screen.

  6. At the top of your screen, the following message should appear if the hotfix was installed correctly:

           SolarWinds manager version is: 6.3.1
           SolarWinds manager build is: hotfix2

    Hotfix 2 is installed on LEM Manager.

Install Hotfix 2 on the Agents (Manual Steps)

Use these steps to apply Hotfix 2 to the agents if the auto-upgrade feature is turned off, or if there are communication issues between the agents and the LEM Manager. 

  1. Copy the included agentUpgrade_6.3.1.hotfix2.zip file to the agent machine.
  2. Extract the contents of the ZIP file to any folder. 
    The extracted archive contains 8 JAR files and 2 BAT files. 
  3. Install Hotfix 2 on each agent using one of the following methods:
    • If upgrading a Windows agent, do the following:
      1. Right-click the installAgentUpgrade_6.3.1.hotfix2.bat file and choose "Run as administrator."
    • To install the upgrade manually:
      1. Stop the agent service.
      2. Back up the replaced *.jar files in the ContegoSPOP/6.3.1/jars folder.
      3. Replace the *.jar files with the new versions from the ZIP file.
      4. If you are installing a Windows agent, then copy the collectLogs.bat file to the ContegoSPOP folder.
      5. Start the Agent service.
  4. Verify that the agent was successfully upgraded:
    1. Log in to the LEM console and choose Manage > Nodes. 
      The Nodes table opens. 
    2. Verify that the Version column shows 6.3.1.hotfix2 for upgraded agents.

Uninstalling Hotfix 2

To uninstall Hotfix 2, contact SolarWinds Technical Support at www.solarWinds.com/company/contact-us.

As noted above, if LEM is configured for single sign-on / LDAP authentication, you cannot uninstall this hotfix after it is installed. 

 

Last modified

Tags

Classifications

Public