- 2 minutes to read

Step 12: Install Pickup Log Events Service

Install the new Nodinite 7 Pickup Log Events Service. There is no in-place update—you must install v7 using the Portal.


Prerequisites

  • Step 11 completed – TLS configured
  • Log API endpoint changed (now includes environment name in path)
  • Configuration Database renamed: NodiniteConfig_<ENV>Nodinite_<ENV>_Config
  • PowerShell 7 with administrator privileges

Steps

Tip

If you already configured the Pickup Log Events Service settings in the Portal during Step 11 (Configure TLS), skip steps 1–5 and go directly to Download (step 6).

  1. Go to Portal → your Environment
  2. Click Agents tab
  3. Locate Pickup Log Events Service
  4. Configure settings:
    • Service Account: Verify or update account name
    • Service Account Password: Enter password
    • Port: Verify port (default or custom)
    • Log API Endpoint: Auto-configured with new v7 address
    • Database Name: Verify Nodinite_<ENV>_Config
  5. Click Save
  6. Click Download

Preparing Download
Wait for the Portal to generate your ZIP package before downloading.

  1. Extract ZIP to Application Server
  2. Open PowerShell 7 as Administrator
  3. Navigate to extracted folder
  4. Run installation script:
    dir -r | unblock-file
    .\Install-PickupService.ps1  # Or similar script name
    

Tip

If your service account password contains special characters, pass it as a SecureString to avoid quoting issues:

$pwd = ConvertTo-SecureString 'P@ssw0rd!' -AsPlainText -Force
.\Install-PickupService.ps1 -ServiceAccountPassword $pwd
  1. Verify service running in Services console (services.msc)
  2. Check Web Client for log events being picked up

Completion Checklist

  • Pickup Service configured in Portal
  • Installation script completed successfully
  • Service running in Services console
  • Log events visible in Web Client
  • No errors in service logs

Next Step


Troubleshooting

Service Won't Start

Problem: Pickup Service fails to start.

Solution:

  • Verify service account has correct permissions
  • Check database name is correct (Nodinite_<ENV>_Config)
  • Verify Log API endpoint is accessible
  • Review Event Viewer for detailed errors

No Log Events Appearing

Problem: Service running but logs not picked up.

Solution:

  • Verify Log API endpoint configured correctly
  • Check network connectivity to Log API
  • Verify database connection string
  • Review Pickup Service logs for errors