Uninstalling Nodinite Pickup LogEvents Service Logging Agent
The Nodinite Pickup Log Events Service Logging Agent provides robust, end-to-end logging and seamless integration. When your requirements change or you need to migrate to another solution, you can safely uninstall the agent using either Portal-based PowerShell automation (v7) or the Windows installer (v6/v7).
Understanding Agent Uninstallation
Key Considerations
Before uninstalling, ensure you understand the approach and method available for your version:
- Nodinite v7: Portal-based PowerShell scripts provide centralized, automated uninstallation
- Nodinite v6 & v7 Legacy: Windows 'Add or Remove Programs' or direct MSI installer uninstallation
- Resource Cleanup: Queues, tables, folders, and subscriptions must be disabled/removed manually
- Service State: The Windows Service must be stopped before uninstallation can complete
Prerequisites: Disable Intermediate Storage Access
Before uninstalling the agent in either version, ensure that any applications or services no longer create messages to the intermediate storage destinations. The agent must not receive new messages while being uninstalled.
Disable logging code in all custom applications Stop any processes that send events to message queues, files, or databases monitored by this agent Verify no new messages are being created in:
- ActiveMQ message brokers
- AMQP message services
- Azure Blob Containers or Event Hubs
- File shares or local folders
- MSMQ message queues
- PostgreSQL or SQL Server databases
- Azure Service Bus topics/queues
Nodinite version 7
Uninstalling the Pickup LogEvents Service Logging Agent in Nodinite v7 requires completing several steps to ensure the agent is fully removed and will not be reinstalled during future updates. Follow these steps carefully:
Step 1: Remove from Portal
Remove the Pickup LogEvents Service Logging Agent from the Nodinite Portal so it is not reinstalled during the next system update:
- Log in to the Portal
- Navigate to Marketplace → Logging Agents
- Locate Pickup LogEvents Service Logging Agent
- Click Remove or uncheck the agent to disable it from automatic installation
Step 2: Remove from Web Client Installed Agents List
Remove the Pickup LogEvents Service agent from the list of installed agents in the Nodinite Web Client. Follow the Delete Monitoring Agent instructions in the Add or manage Monitor Agent guide.
Step 3: Run the Uninstall Script
To complete the removal of the Pickup LogEvents Service along with the entire Nodinite core services, follow the Uninstall Nodinite v7 process:
- Download a new Nodinite v7 ZIP file to obtain the latest uninstall script (
Nodinite7-%ENVIRONMENTNAME%-UnInstall.ps1) - Run the uninstall script to remove all Nodinite components
- Run the install script to reinstall Nodinite core services and configured agents (without the Pickup LogEvents Service, since it was removed from the Portal)
After both scripts complete successfully:
- Nodinite will be updated to the latest version
- The Pickup LogEvents Service Logging Agent will no longer be installed
- Other agents will be restored as configured
See also: Uninstall Nodinite v7 for complete step-by-step instructions
Nodinite version 6 (Add or Remove Programs - Legacy)
Warning
The Add or Remove Programs uninstallation method for Nodinite v6 is deprecated and will be retired. Please upgrade to Nodinite v7 for the modern Portal-based scripted uninstallation experience.
Important
Before uninstalling, always disable logging to all destinations. Failing to do so may waste resources, fill queues, and cause disk issues for your team.
Uninstall Guide
After completing the prerequisites above (Disable Intermediate Storage Access), follow these steps to uninstall:
Remove all queues, tables, and folders that the Nodinite Pickup Log Events Service Logging Agent used to fetch LogEvents from any supported source:
- ActiveMQ
- AMQP
- Blobs in Containers (Azure Storage Account)
- Event Hub and syncpoint in Azure Storage Account
- File Folder (SMB)
- MSMQ
- PostgreSQL database(s)
- SQL Server
- Service Bus
You can start the uninstall process with either of the following methods:
Step 1: Add or Remove Programs
Example of the Windows 'Add or Remove Programs' interface for uninstalling the agent.
Step 2: Start the Installer
Alternatively, double-click the MSI file to launch the uninstaller for the Nodinite Pickup Log Events Service Logging Agent.
Example of the MSI installer file used for uninstallation.
Step 3: Welcome Screen
After starting the uninstaller, you will see the Welcome screen.
Example of the Welcome screen displayed by the uninstaller.
Click Next to continue or Cancel to exit.
Step 4: Change, Repair, Remove
In the 'Change, Repair, Remove' dialog, click Remove to uninstall the agent.
Example of the 'Change, Repair, Remove' dialog.
If the service is still running, a dialog may appear. Click 'Ok' to close and continue.
Example of the 'Service is in Use' dialog.
If the service cannot be closed, another dialog may appear. Click 'Ok' to proceed.
Example of the 'Unable To Close' dialog.
Step 5: Remove Program
Click Remove to finalize the uninstallation.
Example of the 'Remove Program' dialog.
Step 6: Completed Setup
The final step displays either a successful uninstall or a premature exit.
Example of a successful uninstallation screen.
Click Finish to exit the uninstaller.
Troubleshooting
Failed Uninstallation
If the uninstall fails, you will see a premature exit.
Example of a failed uninstallation with premature exit.
Additional Resources
If you need help, contact our Support.
Additional troubleshooting information may be available in the Windows Event Logs.