Configuration de référentiels et de paramètres de proxy pour la commande installUtility

Dans le fichier repositories.properties, vous pouvez configurer la façon dont la commande installUtility accède aux référentiels basés sur des répertoires locaux, aux instances du Service du référentiel d'actifs Liberty et au Référentiel Liberty.

Pourquoi et quand exécuter cette tâche

La commande installUtility permet d'accéder aux référentiels suivants :
  • Le Référentiel Liberty, référentiel public hébergé par IBM®, est accessible via Internet. Pour plus d'informations, voir Référentiel Liberty.
  • Le Service du référentiel d'actifs Liberty est un service open source que vous pouvez utiliser pour créer un référentiel sur site accessible à distance derrière le pare-feu d'une entreprise. Pour plus d'informations, voir l'article WASdev/tool.lars project on GitHub.
  • Les référentiels locaux à base de répertoires que vous créez à l'aide de l'action installUtility download ou en téléchargeant le fichier wlp-featureRepo-<version>.zip, qui contiennent toutes les fonctions et tous les modules complémentaires applicables. Pour plus d'informations, voir Téléchargement d'actifs avec la commande installUtility.

Les commandes installUtility et featureManager utilisent le même fichier de propriétés de configuration, repositories.properties. Les paramètres de proxy sont partagés, mais les paramètres de référentiel sont uniquement utilisés par la commande installUtility. Pour gérer des actifs et exécuter des opérations d'installation, de recherche ou de désinstallation basées sur un référentiel, utilisez la commande installUtility à la place de la commande featureManager.

Conseil : Vous pouvez télécharger ou installer des utilisateurs à partir d'un référentiel basé sur un répertoire local en spécifiant le référentiel dans l'option --from. Aucune configuration supplémentaire dans le fichier repositories.properties n'est requise. Pour plus d'informations, voir Commande installUtility.
Pour accéder au référentiel IBM WebSphere Liberty avec un accès Internet restreint ou via un pare-feu, assurez-vous d'avoir accès aux hôtes et ports suivants :
  • public.dhe.ibm.com sur le port 443
  • asset-websphere.ibm.com sur le port 443
Remarque : La commande installUtility prend en charge uniquement les serveurs proxy avec les protocoles HTTP/HTTPS.

Procédure

  1. Facultatif : Lorsque vous configurez pour la première fois les paramètres de référentiel ou de proxy, vous pouvez exécuter la commande installUtility viewSettings pour obtenir un modèle de configuration pour le fichier repositories.properties.

    Copiez ce modèle dans un nouveau fichier de propriétés dans ${wlp.install.dir}/etc/repositories.properties. Le fichier de propriétés doit être au format ASCII pour toutes les plateformes.

  2. Définissez les paramètres dans le fichier ${wlp.install.dir}/etc/repositories.properties.

    Si vous avez copié le modèle depuis la commande installUtility viewSettings, modifiez le modèle en changeant l'exemple de paramètres de référentiel et proxy afin de faire référence à votre environnement. Les lignes débutant par un signe dièse (#) ne sont pas traitées.

    • Pour désactiver l'accès au Référentiel Liberty, mettez la propriété useDefaultRepository à false. Le Référentiel Liberty est activé par défaut et est le dernier référentiel auquel vous accédez lors de l'installation ou du téléchargement d'actifs.
      useDefaultRepository=false
    • Pour définir un référentiel, ajoutez une propriété comme nomRéfé.url=url ou nomRéfé.url=chemin_fichier. Chaque nom de référentiel doit être unique.

      Les référentiels définis sont accessibles dans l'ordre dans lequel ils sont spécifiés dans le fichier repositories.properties.

      For Windows platforms
      dev-rep.url=http://dev.repo.ibm.com:9080/ma/v1
      local-rep2.url=file:///c:/IBM/localrepo2
      local-rep3.url=C:\IBM\localrepo3
      local-rep4.url=C:\IBM\localrepo4.zip
      For HP UNIX platformsFor Solaris platformsFor LINUX platformsFor UNIX platforms
      dev-rep.url=http://dev.repo.ibm.com:9080/ma/v1
      local-rep2.url=file:///usr/IBM/localrepo2
      local-rep3.url=/usr/IBM/localrepo3
      local-rep4.url=/usr/IBM/localrepo4.zip
    • Si un référentiel requiert un nom d'utilisateur et un mot de passe, définissez les propriétés nomRéf.user=IDutilisateur et nomRéf.userPassword=motDePasse.
      Si un nom d'utilisateur et un mot de passe sont requis et ne sont pas définis, vous êtes invité à les entrer. Pour une sécurité améliorée, codez le mot de passe à l'aide de l'action securityUtility encode. Pour plus d'informations, voir Liberty : commande securityUtility.
      dev-rep.user=myname                            
      dev-rep.userPassword={aes}AH5NLyd7DfGb12pK17Pw+
    • Si votre système doit accéder au Référentiel Liberty ou à une instance du Service du référentiel d'actifs Liberty à travers un serveur proxy, définissez les propriétés proxy proxyHost, proxyPort, proxyUser et proxyPassword.

      Pour une sécurité renforcée, codez la valeur de la propriété proxyPassword en utilisant l'action securityUtility encode. Si vous ne définissez pas le nom d'utilisateur et le mot de passe, vous êtes invité à les indiquer.

      Exemple :
      proxyHost=my.proxy.server.ibm.com
      proxyPort=9080
      proxyUser=myname
      proxyPassword={aes}AH5NLyd7DfGb12pK17Pw+
  3. Sauvegardez les modifications apportées au fichier repositories.properties.
  4. Vérifiez les paramètres de référentiel et de proxy en exécutant la commande installUtility viewSettings. Lorsque vous exécutez la commande installUtility viewSettings, la configuration de référentiel et de proxy est automatiquement validées. Pour afficher les messages de validation détaillés, exécutez la commande avec l'option --viewValidationMessages.
    >installUtility viewSettings
    
    installUtility Settings
    ----------------------------------------------------------------------
    Properties File: c:\wlp\etc\repositories.properties
    Default Assets Repository: IBM WebSphere Liberty Repository
    Use Default Repository: True
    
    Validation du fichier de propriétés
    ----------------------------------------------------------------------
    Validation Results: The properties file successfully passed the 
    validation.
    
    Configured Repositories
    ----------------------------------------------------------------------
    Name: dev-rep
    Location: http://dev.repo.ibm.com:9080/ma/v1
    User Name: myname
    Password: <Unspecified>
    
    Proxy Settings
    ----------------------------------------------------------------------
    Proxy Server: my.proxy.server.ibm.com
    Port: 9080
    User Name: myname
    Password: ********
  5. Testez la connexion au référentiel en exécutant la commande installUtility testConnection. Si vous ne définissez pas le nom d'utilisateur et le mot de passe, vous êtes invité à les indiquer.
    >installUtility testConnection
    Testing the connection to all configured repositories...
    This process might take several minutes to complete.
    
    Configured Repositories
    ----------------------------------------------------------------------
    Name: dev-rep
    Location: http://dev.repo.ibm.com:9080/ma/v1
    Status: Successfully connected to the configured repository.
    Name: IBM WebSphere Liberty Repository (Default Assets Repository)
    Status: Successfully connected to the configured repository. 
    Vous pouvez tester tous les référentiels configurés dans le fichier repositories.properties en même temps en exécutant la commande installUtility testConnection sans spécifier repoName. Le nom de référentiel pour le Référentiel Liberty est default. Pour tester la connexion au Référentiel Liberty, exécutez la commande suivante :
    installUtility testConnection default

Que faire ensuite

Vous pouvez utiliser la commande installUtility pour rechercher des actifs et les installer ou les télécharger depuis les référentiels configurés.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_config_installutility.html