- 5 minutes to read

How do I install a new instance of Nodinite - Part 2?

Note: This is a continuation from Part 1

Configuration

Next step configures the default behaviour for Nodinite. All these settings are System Parameters unique for each instance of Nodinite and can therefore easily be changed later.

Step 9 Configuration

Configure Log Database Options

Provide options that determine how large or how old Log Databases are allowed to grow.
Configure Log Database options
Split options by size or time

  1. Size to split database on in (GB) - Default is 31 GB and modern SQL instances with great DISK IO can manage 50-100 GB
  2. Days to split database on - Default is 10000 days which means that the database will be split based on size

Step 10 Configure Logging Options

Provide options for how long time to store events and payload. This is the default setting applied on Message Types.
Logging Options
Options for how long time to keep events and payload

  1. The default number of days to keep logged events
  2. The default number of days to keep data/body logged events

Step 11 Configure Monitoring Options

Provide options for how long time to store monitoring events. This data can be seen in the graphs within Monitor Views.
png_Installation_Configure_Monitoring

Step 12 Configure Active Directory Support

Provide options for integration with Active Directory:
png_Installation_Configure_AD
Check to enable the use of Active Directory groups

Step 13 Configure Administrators

Provide options for what users are granted access to the Web Client as part of the Administrators Role.

Add users
Add what users should be Administrators

Step 14 Review Configuration

Review the configuration and click on the 'Next' button

Options Completed

Step 15 Start Logging Service

If you are installing a new instance of Nodinite then a new Log Database will be created by the Logging Service on first start. This behaviour is by design to validate and test that the account for the Logging Service has sufficient rights to create new Log Databases.

If you are upgrading Nodinite with existing old Log Databases; You must make sure all old Log Databases are first updated before starting the Logging Service. Duplicate the tab in the browser and navigate to the environment being installed and manually execute the scripts to have all existing log databases updated.
If you are using a named instance on a fail over cluster, you must ensure that the linked server localhost\instance really exists. You may need to deploy the log database manually if the Logging Service fails to create the very first log database. Contact our technical support if the problem can't be resolved at this stage

png_Installation_StartLoggingService
Click on the 'Start' button to start the Logging Service

When and if the Logging Service starts information about the online Log Database will be presented. This is either a new one or your updated old existing one.
png_Installation_StartLoggingServiceStarted
Basic information about online Log Database

Step 16 Start Monitoring Service

Your next step is to start the Monitoring Service.

png_Installation_StartMonitoringService
Click on the 'Start' button to start the Monitoring Service

png_Installation_StartMonitoringServiceStarted
Example of the successful start operation

Step 17 Finish

Congratulations! you have now successfully installed Nodinite

png_Finish

You should now be returned to the page managing the environment. From here you can click on the 'Web Client' button to quickly navigate further in a new tab to the Web Client.
Web Client Quick Link
Open the Web Client quick link button

Step 18 Post installation steps

After the installation is completed, make sure to assign access right, review Assign Access Rights user guide.

Also make sure the appropriate SQL rights were set for future Nodinite Log Databases. The Logging Service depends on the following System Parameters:

  1. ImLogAccessRoles
  2. ImLogServiceUsers

Additional tuning can be performed, review the System Parameters users guide for additional information.

Install Logging Agents

To enable Logging please review the Installing and Configuring Nodinite Log Agents user guide.

Install Monitoring Agents

To enable Monitoring please review the Installing and Configuring Nodinite Monitoring Agents user guide.

Common errors

Each input field during the installation steps must be clicked on to validate content. If you do not click on each input field, the validation process will not be performed and the installation can not continue.

#1: Missing SQL package

The file SqlPackage.exe was not found on the server 'localhost':
Missing SQL package

Solution Download and install the following file from here

  • DACFramework.msi (18.0 or later to match your version of SQL Server, higher versions are backwards compatible)

Data tier

#2 Unauthorized

If end-users can't logon to either the Web Client or the Web API although they are registered as either Users or Windows AD Groups, make sure the end-users have the local policy: "Access this computer from the network" set
png_accessthiscomputerpolicy
default settings example for Windows 2016

#3. IIS Authentication settings

If you encounter any other IIS related problems, make sure to review the IIS Authentication settings troubleshooting guide.


Next Step

Administer Nodinite
Configure BizTalk LogAgent

Download
Update
Web Client
Release Notes
Logging Service
Monitoring Service
Log Databases