For IBM i platforms

Commande iAdmin

La commande prend en charge l'exécution d'un serveur Liberty sur la plateforme IBM® i. Le fichier de commandes se trouve dans le répertoire wlp/lib/native/os400/bin. Il s'agit d'un script qui s'appelle iAdmin.

Syntaxe

La syntaxe de la commande est la suivante :

iAdmin task [options]
où la valeur de tâche peut être l'une des options suivantes :
  • POSTINSTALL
  • PREUNINSTALL
  • GRANTAUTH
La tâche POSTINSTALL configure la commande server start afin de lancer les serveurs en tant que travaux dans le sous-système QWAS9. De plus, la tâche :
  • Configure Liberty pour l'exécution de serveurs sous le profil utilisateur QEJBSVR.
  • Configure l'emplacement du kit JDK par défaut en associant WLP_DEFAULT_JAVA_HOME dans le fichier wlp/etc/default.env à l'emplacement de la version 32 bits du niveau Java™ minimal pris en charge.
  • Ajoute une entrée pour le produit dans le registre de produits natifs IBM i.
  • Crée des bibliothèques et des objets IBM i natifs, tels que le sous-système QWAS9 et le profil utilisateur QEJBSVR.

Appelez la commande iAdmin POSTINSTALL seulement après l'installation de Liberty via l'extraction d'un fichier archive.

La tâche GRANTAUTH accorde au profil utilisateur QEJBSVR les droits d'accès au fichier nécessaires ainsi que la propriété pour le rôle de serveur. La tâche POSTINSTALL définit la propriété du fichier et les droits d'accès correctement pour le profil utilisateur QEJBSVR. Toutefois, si vous créez des fichiers manuellement ou si vous modifiez les droits d'accès à des fichiers utilisés par le serveur Liberty, vous pouvez appeler la commande iAdmin GRANTAUTH pour vous assurer que QEJBSVR dispose des droits appropriés.

La tâche PREUNINSTALL supprime les bibliothèques et les objets natifs créés par la tâche POSTINSTALL. Appelez la commande iAdmin PREUNINSTALL avant de supprimer l'environnement de traitement des applications Liberty de votre système ; sachez toutefois que cette opération n'est nécessaire que si le profil Liberty a été installé en exécutant un fichier JAR.

Remarque :
  • Vous devez disposer des droits spéciaux *ALLOBJ et *SECADM pour pouvoir utiliser les commandes POSTINSTALL et PREUNINSTALL.
  • Vous devez disposer du droit spécial *ALLOBJ et du droit *OBJMGT pour tous les objets qui se trouvent dans les sous-arborescences de répertoire spécifiées pour pouvoir utiliser la commande GRANTAUTH.
  • Une fois la tâche POSTINSTALL exécutée, vous devez aussi disposer des droits spéciaux *ALLOBJ et *SECADM pour pouvoir démarrer et arrêter le serveur Liberty.

Options

Les options suivantes sont disponibles pour la commande iAdmin :
--outputdir rép_utilisateur_wlp
Répertoire des fichiers générés par le serveur. Cette option doit correspondre à un chemin d'accès absolu. Elle est facultative pour la tâche GRANTAUTH et est ignorée pour toutes les autres tâches. Si elle n'est pas spécifiée, l'emplacement par défaut de la sortie générée par le serveur est utilisé.
--rolename nom_rôle
Rôle attribué au profil utilisateur. Actuellement, le rôle de serveur est le seul rôle pris en charge. Cette option est requise pour la tâche GRANTAUTH et ignorée pour toutes les autres tâches.
--userdir rép_utilisateur_wlp
Répertoire contenant des ressources partagées et des définitions de serveur. Cette option doit correspondre à un chemin d'accès absolu. Elle est facultative pour la tâche GRANTAUTH et ignorée pour toutes les autres tâches. Si elle n'est pas spécifiée, l'emplacement par défaut des ressources partagées et des définitions de serveur est utilisé.
--userprofilename nom_profil_utilisateur
Profil utilisateur auquel accorder les droits. Actuellement, QEJBSVR est le seul nom de profil utilisateur pris en charge pour le rôle de serveur. Cette option est requise pour la tâche GRANTAUTH et ignorée pour toutes les autres tâches.

Scénarios d'utilisation

Les exemples qui suivent utilisent la syntaxe appropriée. Exécutez la commande mentionnée dans les exemples suivants sur une seule ligne.
  • Configuration de Liberty pour démarrer en tant que travail dans le sous-système QWAS9 et pour basculer sur le profil utilisateur QEJBSVR lors de son exécution.
    wlp/lib/native/os400/bin/iAdmin POSTINSTALL
  • Attribution du rôle de serveur au profil utilisateur QEJBSVR pour les ressources partagées, les définitions de serveur et les emplacements de sortie configurés pour l'environnement d'exécution de Liberty.
    wlp/lib/native/os400/bin/iAdmin GRANTAUTH --rolename server --userprofilename QEJBSVR
  • Suppression des bibliothèques et des objets natifs créés par la tâche POSTINSTALL.
    wlp/lib/native/os400/bin/iAdmin PREUNINSTALL

Icône indiquant le type de rubrique Rubrique de référence

Nom du fichier : rwlp_command_iadmin.html