- 0 minutes to read

Update Nodinite v7

Upgrade your Nodinite v7 with confidence and ease. This guide empowers you to perform a secure, efficient, and hassle-free update to the latest version, ensuring your integration environment remains robust and future-proof.

What you’ll achieve by following this guide:

  • ✅ Minimize downtime and disruption for end-users
  • ✅ Protect your data with clear backup and validation steps
  • ✅ Benefit from the latest features and improvements in Nodinite v7
  • ✅ Access expert support and resources throughout the process
graph LR subgraph "Nodinite v7" roPortal(fal:fa-person-to-portal Nodinite Portal) roEnvironment(fal:fa-leaf Environments) roZIP(fal:fa-file-zip Download ZIP) roPS(fal:fa-terminal PowerShell Script) roPortal --> roEnvironment roEnvironment --> roZIP roZIP --> roPS end subgraph "Nodinite Instances" roCustomerSouth(fal:fa-code-commit Development) roPS -.- roCustomerSouth roCustomerAcme(fal:fa-code-commit PreProd) roPS -.-> roCustomerAcme roCustomerNorth(fal:fa-code-commit Prod) roPS --> roCustomerNorth end

Visual overview of the update process for multiple environments.

Install Nodinite v7

Tip

If you have a non-prod environment, test the upgrade process there first. This lets you validate all steps and configurations before applying them to production.

Looking for a partner to help you update? Contact any of our certified Partners.

This guide assumes you already have Nodinite version 7 installed, potentially with Monitoring Agents and Log Agents.

Important

You must know the account names and their passwords and have administrative rights on the Nodinite Application Server to perform the update.

Prerequisites

Before you begin the update process, ensure you have the following prerequisites in place:

  • Inform end-users about the update and potential downtime.
  • Backup your Nodinite databases and configuration files. This is crucial to prevent data loss in case of any issues during the update.
  • Existing Nodinite v7 installation with Monitoring Agents and Log Agents configured. Everything will be updated to the latest version.
  • Valid Nodinite 7 product key available in the Nodinite Portal. If it has expired or is nearing expiry, create a new one. If you cannot do this, contact your partner or Nodinite Support.
  • The Prerequisites for Installing Nodinite v7 must be met.

Estimated time

On a high level, there are a few distinct steps in the update process:

Running the script typically takes a few minutes. This estimate includes updating all Monitoring Agents and Log Agents.

graph LR A["Select Environment"] --> B["Download/Extract ZIP (Core and Agents)"] B --> C["Run PowerShell Script"]

Example of the main steps in the update process.

Step 1: Select Environment

💡Find the environment for the Licensee

In the Nodinite Portal, select your environment by following these steps:

  1. Navigate to the existing Customer entry.
    Customer Overview
    Find and Click on the Customer entry.

  2. Ensure you have a valid Nodinite 7 product key available. If not, create it by clicking on Create Product Key button.
    Product Key Entry
    Example of a Nodinite 7 product key entry.

    Important

    You must have a valid Nodinite 7 product key to proceed with the upgrade. If you can't create one, please contact your partner or Nodinite Support.

  3. Click the Environment tab and find the entry to update.
    Environment
    Example of Environment to update for a selected Licensee in the Nodinite Portal.

Step 2: Download/Extract ZIP (Core and Agents)

💡Download all Nodinite binaries and scripts as single ZIP file to perform the update.

  1. Click the Actions button and click the Download menu item:
    Download
    Example of the Upgrade from Nodinite v6 button in the Add Environment modal.

While generating your ZIP package with the necessary binaries the following screen will be displayed:
Downloading Nodinite Binaries
Example of the Downloading Nodinite Binaries screen.

Once the download is complete, you can proceed to the next step.

Step 3: Run PowerShell 7 Script

💡Run the PowerShell 7 script to update your environment.

In this step, you will run the PowerShell 7 script to update your environment. This script will perform the necessary actions to update your environment with the latest Nodinite 7 Core Services and Agents.

  1. Extract the ZIP.
  2. Open a PowerShell 7 terminal with administrative privileges.
  3. Navigate to the folder where you extracted the downloaded ZIP file.
  4. Run the script by executing the following command (If you run the script like this, you will be prompted to enter the mandatory values interactively.
    ):
dir -r | unblock-file

*At first, you must unblock all files in the extracted folder.*

``` powershell
.\Nodinite7-%ENVIRONMENTNAME%-Installation.ps1

Replace %ENVIRONMENTNAME% with the name of your environment.

Important

If you provided bogus values in the previous steps, you must NOT edit the script to provide the correct values for the parameters. This includes the database connection string, service account names, and other settings you specified in the Nodinite Portal. You must run the script providing the new values, for example (you can use tab to switch between the available parameters):

dir -r | unblock-file

First, you must unblock all files in the extracted folder.

$serviceAccountPassword = ConvertTo-SecureString 'P@ssw0rd' -AsPlainText -Force
.\Nodinite7-DEMO-Installation.ps1 -WebClientServiceAccount 'Domain\n-svc' -WebClientServiceAccountPassword $serviceAccountPassword

Important

The password is SecureString. You must create a separate variable and use it accordingly for each unique password.
You must use a single quote (') when providing the account name and password to avoid issues with special characters.

Override variables
Example of overriding variables in the PowerShell script.

  1. Open the Web Client and perform some basic checks to ensure the update was successful.

Contact our support

If you have questions or encounter issues during the upgrade, contact your partner for 1st line support or email us at support@nodinite.com.

Next Step

Nodinite Portal

Install Nodinite v7
Log API
Logging Service
Monitoring Service
Web API
Web Client