DOCUMENTATION NTi

Configuration initiale et installation

Toutes les opérations liées à la licence s’exécutent exclusivement sur l’IBM i.

1. Démarrage des services TCP/IP IBM i

Les services TCP *DATABASE, *RMTCMD et *SIGNON doivent être démarrés. S'ils ne le sont pas, démarrez-les à l'aide des commandes suivantes:

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

2. Ajout de la licence NTi (IBM i)

Récupérez le script SQL fourni par AUMERIAL: il contient votre clé et les valeurs associées.

Ouvrez Run SQL Scripts (ACS) ou tout client SQL connecté à la partition IBM i, puis exécutez le 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. Renouvellement de la licence NTi (IBM i)

Pour renouveler votre clé, exécutez le nouveau script contenant le renouvellement de votre clé de licence. La mise à jour prend effet immédiatement, et aucune action n'est requise côté .NET.

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

4. Référencement du package NTi dans un projet .NET

Dans un nouveau projet console, ajoutez le package Aumerial.Data.Nti via le gestionnaire de packages NuGet ou l'interface en lignes de commandes de votre editeur de code.

Importez le package NTi dans la classe Program (fichier Program.cs):

using Aumerial.Data.Nti;

Ensuite dans la méthode Main() de la classe Program, créez un connecteur NTi et implémentez la chaîne de connexion à votre IBM i pour confirmer qu'elle s'établit: c’est la façon la plus rapide de valider l’installation (services TCP/IP + licence).

/*
Remplacez ci-dessous respectivement USERNAME, PASSWORD et SERVER
par votre nom d'utilisateur, votre mot de passe et l'adresse IP ou nom d'hôte de votre partition IBM i
*/
using var conn = new NTiConnection("server=server;user=username;password=password");
conn.Open();

Console.WriteLine(conn.State == ConnectionState.Open
    ? "✅ Connexion IBM i et licence NTi OK."
    : "❌ Connexion impossible.");

Une fois ces étapes réalisées, la licence NTi a été installée et les services IBM i sont fonctionnels. Vous pouvez profitez des nombreux avantages offerts par NTi