How to Install Nodinite v7 for a Proof of Concept (POC)

Get your Nodinite v7 Proof of Concept up and running quickly with this streamlined checklist. This guide provides everything you need for a successful POC evaluation:

• ✅ Fast-track setup - Clear prerequisites and step-by-step installation checklist
• ✅ Modern architecture - PowerShell 7 automation, OAuth 2.0 support, optional HTTPS hardening
• ✅ Proven scenarios - Recommended use cases to demonstrate Nodinite value
• ✅ Post-installation - Agent configuration, alerting setup, and security best practices

Tip

New to Nodinite? This quick-start guide gives you the essential steps for a POC. For detailed explanations, architecture diagrams, and troubleshooting, see Install Nodinite v7.

Free e-learning: Sign up at nodinite.com/learn to accelerate your Nodinite expertise.

What Should Your POC Prove?

Define clear success criteria for your POC. We recommend proving Nodinite value through at least three scenarios:

1. Simple scenario - Managed file transfer or single-system integration
2. Moderate complexity - Request-response with multiple systems and message transformations
3. Advanced scenario - Correlated events, message splits, multiple receivers, business user self-service

Example POC goals:

• Reduce troubleshooting time by 70% with centralized logging
• Enable business users to track order status without IT involvement
• Detect and alert on integration failures within 60 seconds

Understanding Nodinite v7 Architecture

Before starting your POC, understand how Nodinite v7 components work together:

Nodinite v7 collects logs from integration platforms, monitors system health, and provides a unified web interface for operations and business users.

Key Components

POC Prerequisites Checklist

Complete these prerequisites before registering your environment in the Nodinite Portal:

Infrastructure Requirements

Service Account Requirements

SQL Server Configuration

IIS Configuration

Security & HTTPS (Optional for POC)

Note

HTTPS is optional for POC but recommended if evaluating OAuth 2.0 or deploying on a network-accessible server.

Installation Steps

Step 1: Register Environment in Portal

1. Log in to Nodinite Portal
2. Navigate to your Customer → Environments tab
3. Click Add Environment → Install Fresh Nodinite 7
4. Configure environment settings (see Install Nodinite v7 for detailed field explanations):

Required Configuration Tabs:

Save and Download:

1. Save environment configuration
2. Download installation package (ZIP file)

Step 2: Run Installation Script

1. Extract downloaded ZIP to temporary location (e.g., C:\Temp\NodiniteInstall\)
2. Unblock files: dir -r | unblock-file
3. Open PowerShell 7 as Administrator
4. Navigate to extracted folder
5. Run: .\Nodinite7-<ENVIRONMENTNAME>-Installation.ps1
6. Enter passwords when prompted (script runs interactively)

Important

Use PowerShell 7, not Windows PowerShell 5.1. Verify version: $PSVersionTable.PSVersion

Tip

Installation typically takes 5-15 minutes. For detailed troubleshooting and advanced options, see Install Nodinite v7.

What the script does:

• Creates SQL databases (Configuration Database + Log Databases)
• Deploys IIS applications (Web Client, Web API, Log API)
• Installs Windows services (Logging Service, Monitoring Service)
• Deploys selected Log Agents and Monitor Agents
• Configures service accounts and application pools
• Applies database migrations

Step 3: Verify Installation

1. Check Windows Services:

   Get-Service | Where-Object { $_.DisplayName -like "*Nodinite*" }
   

   Expected services (should be Running):

   • Nodinite Logging Service
   • Nodinite Monitoring Service

2. Check IIS Sites:

   Open IIS Manager → Verify applications under Default Web Site:

   • NodiniteWebClient
   • NodiniteWebAPI
   • NodiniteLogAPI

3. Access Web Client:

   Open browser → Navigate to: http://localhost/NodiniteWebClient/

   • Login with Windows credentials (if Windows Auth)
   • Or OAuth credentials (if configured)

4. Verify Database Creation:

   -- In SQL Server Management Studio
   SELECT name FROM sys.databases WHERE name LIKE 'Nodinite%'
   

   Expected databases:

   • NodiniteConfig (or your custom name)
   • NodiniteLog (or your custom name)

Configure Your POC Scenarios

Log Agent Configuration

Deploy and configure Log Agents based on your POC scenarios:

Quick start steps (example: BizTalk):

1. Navigate to Administration → Log Agents in Web Client
2. Click Add Log Agent → Select BizTalk Server
3. Configure connection (server name, database)
4. Enable agent and test connection
5. Send test message through BizTalk → Verify in Nodinite Log Search

Monitor Agent Configuration

Configure Monitor Agents to track system health:

Quick start steps (example: Windows Service):

1. Navigate to Monitor → Resources in Web Client
2. Click Add Resource → Select Windows Service
3. Configure service details (server, service name)
4. Set monitoring interval and alert thresholds
5. Save and verify status

Configure Alerting

Set up alert notifications for your POC evaluation:

Email Alerts (SMTP)

1. Navigate to Administration → Settings → Alarm Plugins
2. Click Add Alarm Plugin → Select Email with Options
3. Configure SMTP settings:
   • SMTP Server: your-smtp-server.com
   • Port: 587 (or 25/465)
   • From Address: nodinite-alerts@yourdomain.com
   • Recipients: poc-team@yourdomain.com

Email with Options Configuration

Webhook Alerts (Slack/Teams/PagerDuty)

1. Navigate to Administration → Settings → Alarm Plugins
2. Click Add Alarm Plugin → Select HTTP Webhook
3. Configure webhook URL and payload format

HTTP Webhook Configuration

Test Alerting

1. Create a test monitor with low threshold
2. Trigger alert condition (stop service, simulate failure)
3. Verify alert received via configured channel
4. Acknowledge alert in Web Client

Run Your POC Scenarios

Execute the scenarios defined in What Should Your POC Prove?:

Simple Scenario Example

Goal: Track file-based integration end-to-end

1. Configure file folder monitor
2. Send test file through integration
3. View log event in Nodinite with business metadata
4. Search and download original file from Web Client
5. Success metric: Find and retrieve file in <30 seconds

Moderate Complexity Example

Goal: Correlate request-response across systems

1. Configure logging for request system (e.g., BizTalk send port)
2. Configure logging for response system (e.g., SAP receiver)
3. Use Nodinite Correlation to link request → response
4. View end-to-end transaction flow in Web Client
5. Success metric: Visualize complete transaction with <60 seconds latency

Advanced Scenario Example

Goal: Enable business user self-service

1. Create custom Repository Model for order tracking
2. Configure Custom Metadata extraction (Order ID, Customer)
3. Grant business users Reader role access
4. Business user searches by Order ID in Web Client
5. Success metric: Business user finds order status without IT help

Measure POC Success

Track these metrics during your POC:

Post-Installation Security (Optional)

For POC environments exposed to network or evaluating production-readiness:

Enable HTTPS/TLS

1. Obtain SSL certificate (see Hardening Guide)
2. Install certificate in IIS
3. Configure HTTPS bindings for Web Client, Web API, Log API
4. Update Portal environment TLS settings
5. Redeploy with updated configuration

Complete HTTPS Hardening Guide

Apply Least Privilege

1. Post-install: Remove sysadmin from service account
2. Grant specific SQL permissions (see DatabaseMaintenance)
3. Create separate accounts for each service
4. Configure folder permissions for log files

Post Installation Steps

Configure OAuth 2.0 (Optional)

For modern authentication with Azure AD / Entra ID:

1. Register Nodinite application in Azure AD
2. Configure OAuth settings in Portal environment
3. Update Web Client and Web API configurations
4. Test authentication with Azure AD users

Install Nodinite v7 - OpenID

Next Steps

After completing your POC:

• Working with Nodinite - Learn advanced features and workflows
• Free E-Learning - Comprehensive training courses
• Partner Network - Find certified implementation partners
• Planning Production Deployment - Scale from POC to production

Related Topics

• Install Nodinite v7 - Complete installation guide with troubleshooting
• Planning your Nodinite Installation - Infrastructure and architecture planning
• Hardening Guide - Security best practices for production
• SQL Server Configuration - Database optimization and sizing
• Post Installation Steps - Additional configuration and tuning