DOCUMENTATION NTi

Initial configuration and installation

All license operations run exclusively on the IBM i.

1. Starting the IBM i TCP/IP services

The TCP services **/*DATABASE, **/*RMTCMD, and **/*SIGNON must be running. If they aren’t, start them with the following commands:

  • STRTCPSVR SVR(*DATABASE)
  • STRTCPSVR SVR(*RMTCMD)
  • STRTCPSVR SVR(*SIGNON)

2. Adding the NTi license (IBM i)

Retrieve the SQL script provided by AUMERIAL: it already contains your key and the associated values.

Open Run SQL Scripts (ACS) or any SQL client connected to the IBM i partition, then execute the script.

CL: CRTLIB KNTI;
CREATE TABLE KNTI.NTI (SN VARCHAR(10), PN VARCHAR(10), DAT CHAR(8), NTI VARCHAR(344));
LABEL ON TABLE KNTI.NTI IS 'AUMERIAL NTi License';
LABEL ON COLUMN KNTI.NTI.SN IS 'System serial number'; 
LABEL ON COLUMN KNTI.NTI.PN IS 'LPAR Id'; 
LABEL ON COLUMN KNTI.NTI.DAT IS 'End date'; 
LABEL ON COLUMN KNTI.NTI.NTI IS 'License key';
INSERT INTO KNTI.NTI (SN, PN, DAT, NTI) VALUES ('...', '...', '...', '...');

3. Renewing the NTi license (IBM i)

To renew your key, run the new script that contains your updated license key. The change takes effect immediately, and no action is required on the .NET side.

UPDATE KNTI.NTI SET DAT = '...', NTI = '...';

4. Referencing the NTi package in a .NET project

In a new console project, add the Aumerial.Data.Nti package using the NuGet Package Manager or your code editor’s command-line interface.

Import the NTi package in the Program class (Program.cs file):

using Aumerial.Data.Nti;

Next, in the Main() method of the Program class, create an NTi connector and set up the connection string to your IBM i to verify that it connects successfull: this is the quickest way to confirm that the installation (TCP/IP services + license) is working.

/*
Replace USERNAME, PASSWORD, and SERVER 
below with your user name, password, and the IP address or host name of your IBM i partition.
*/
using var conn = new NTiConnection("server=server;user=username;password=password");
conn.Open();

Console.WriteLine(conn.State == ConnectionState.Open
    ? "✅ IBM i connection and NTi license OK."
    : "❌ Connection failed.");

Once these steps are complete, the NTi license is installed and the IBM i services are operational. You can now take advantage of the many benefits NTi offers.