Initial setup and installation

All license-related operations are performed exclusively on the IBM i.

1. Start the IBM i TCP/IP services

The TCP services *DATABASE, *RMTCMD and *SIGNON must be running. If they are not, start them with the following commands:

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

2. Add the NTi license (IBM i)

Retrieve the automatically generated SQL script from the client portal. It contains your license key and the associated partition values.

Open Run SQL Scripts (ACS) , then run the script provided from the client portal (the script below is given for reference only).

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. Renew the NTi license (IBM i)

To renew the license, retrieve the renewal script from the client portal and run it on the IBM i. The update takes effect immediately, with no action required on the .NET side.

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

4. Add the NTi package to a .NET project

In a new console project, add the Aumerial.Data.NTi package via the NuGet package manager or your editor's command line interface.

Reference the NTi package in the program class (Program.cs):

using Aumerial.Data.Nti;

Then, create an NTi connector and implement the connection string to your IBM i to confirm it connects successfully. This is the quickest way to validate the installation (TCP/IP services + license).

/*
Replace SERVER, USERNAME and PASSWORD below
with the IP address or hostname of your IBM i partition, your username and your password.
*/
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 completed, the NTi license is installed and the IBM i services are up and running.

What's next?

Your environment is ready. Continue with:

• Quick Start Guide - first connection and first IBM i calls
• Connection - connection string, pooling, MFA
• NTiConnection - complete connection class reference