- 3 minutes to read

Release Notes

Updating the Nodinite Log4Net Appender

Keep your Nodinite Log4Net Appender up to date to benefit from the latest features, improvements, and security fixes. This guide shows you how to update the NuGet package using Visual Studio, the Package Manager Console, or the .NET CLI.

With this guide, you will:

  • ✅ Update to the latest version of the Log4Net Appender
  • ✅ Maintain compatibility with the latest Nodinite features
  • ✅ Minimize downtime during the update process
  • ✅ Ensure all dependencies are updated correctly

Before You Begin

Important

Always review the Release Notes before updating to check for breaking changes, new features, and compatibility requirements.

Tip

Test updates in a development or staging environment before deploying to production.

Step 1: Update the NuGet Package

Choose one of the following methods to update the Nodinite Log4Net Appender:

Option A: Visual Studio NuGet Package Manager (GUI)

  1. Open your .NET Framework project in Visual Studio
  2. Right-click on the project in Solution Explorer
  3. Select Manage NuGet Packages...
  4. Click the Updates tab
  5. Locate Nodinite.LogAgent.Log4NetAppender in the list
  6. Select the package and click Update
  7. Review and accept any license agreements
  8. Wait for the update to complete

Option B: Update All Packages (Visual Studio)

  1. Right-click on the Solution in Solution Explorer
  2. Select Manage NuGet Packages for Solution...
  3. Click the Updates tab
  4. Select Nodinite.LogAgent.Log4NetAppender (and any other packages to update)
  5. Click Update

Option C: Package Manager Console

  1. Open Visual Studio
  2. Go to Tools > NuGet Package Manager > Package Manager Console
  3. Run one of the following commands:

Update to the latest version:

Update-Package Nodinite.LogAgent.Log4NetAppender

Update to a specific version:

Update-Package Nodinite.LogAgent.Log4NetAppender -Version 5.0.2

Option D: .NET CLI

Open a command prompt or terminal in your project directory and run:

Update to the latest version:

dotnet add package Nodinite.LogAgent.Log4NetAppender

Update to a specific version:

dotnet add package Nodinite.LogAgent.Log4NetAppender --version 5.0.2

Step 2: Review Configuration Changes

After updating, check the Release Notes to see if any configuration changes are required.

Note

Most updates are backward compatible and do not require configuration changes. However, major version updates may introduce new required parameters or deprecated settings.

Step 3: Rebuild and Test

  1. Rebuild your solution in Visual Studio (Build > Rebuild Solution)
  2. Test in a non-production environment to ensure the update works as expected
  3. Verify log events are being sent to Nodinite correctly by checking Log Views
  4. Deploy to production once testing is successful

Rolling Back an Update

If you encounter issues after updating, you can roll back to a previous version:

Using Visual Studio NuGet Package Manager

  1. Right-click on the project in Solution Explorer
  2. Select Manage NuGet Packages...
  3. Click the Installed tab
  4. Select Nodinite.LogAgent.Log4NetAppender
  5. In the right pane, select the Version dropdown
  6. Choose the previous version
  7. Click Install to downgrade

Using Package Manager Console 

Update-Package Nodinite.LogAgent.Log4NetAppender -Version [previous-version]

Replace [previous-version] with the version number you want to roll back to (e.g., 5.0.1).

Update Best Practices

  • ✅ Subscribe to Release Notes: Monitor the Release Notes for updates
  • ✅ Test First: Always test updates in non-production environments
  • ✅ Review Breaking Changes: Check release notes for breaking changes before updating
  • ✅ Update Dependencies: Ensure all related dependencies are updated
  • ✅ Backup Configuration: Keep a backup of your configuration files before updating

Support

If you encounter issues during the update process, contact Support.

Next Steps