Documentation:GA:user:InstallationPackages:DRAFT

Packages d'installation

Ce volet vous permet de gérer les packages d'installation en les téléchargeant vers un référentiel de GAX et en les déployant vers des hôtes.

Le volet Packages d'installation sur la gauche de l'écran affiche une liste de packages d'installation que vous êtes autorisé à voir dans votre environnement. La liste est triée par groupes. Vous pouvez développer un groupe pour afficher sa liste de packages d'installation.

Important

Les packages d'installation sont stockés dans la base de données et non dans le système de fichiers local.

Le déploiement de solution respecte les paramètres d'autorisation du locataire. Vous ne pouvez accéder qu'aux objets pour lesquels vous avez un droit d'accès.

Vous pouvez filtrer le contenu de cette liste de deux façons :

• Entrez le nom ou une partie du nom d'un objet dans le champ Filtre rapide.
• Cliquez sur l'icône en forme de cube pour ouvrir le volet du filtre Répertoire des locataires. Dans ce volet, cliquez sur le locataire que vous souhaitez sélectionner. Utilisez le champ Filtre rapide de ce volet pour filtrer la liste des locataires.

Vous pouvez trier les éléments d'une liste en cliquant sur un en-tête de colonne. Pour inverser l’ordre de tri, cliquez une seconde fois sur l’en-tête de la colonne active.

Affichage des packages d’installation

La liste dans le volet Packages d'installation affiche les informations suivantes :

• Nom—Nom du package d'installation.
• Version—Numéro de version du package d'installation.
• ID de paramètres régionaux—Indique la langue utilisée par le plug-in.
• Système d'exploitation—Système d'exploitation et version bits requis par le package d'installation.
• Etat—Indique l'état actuel du package d'installation. Par exemple, l'état Terminé indique que le package d'installation a été déployé avec succès.
• Heure de mise à jour—Horodateur indiquant la dernière mise à jour du package d'installation.

Cliquez sur le package d'installation pour afficher plus de détails dans le volet qui s'ouvre sur la droite. Ce volet affiche les informations suivantes sur le package d'installation :

• Nom—Nom du package d'installation.
• Surnom—Surnom du package d'installation.
• Description—Description facultative du package d'installation (peut être modifiée si nécessaire).
• Version—Numéro de version du package d'installation.
• ID de paramètres régionaux—Indique la langue utilisée par le plug-in.
• Système d'exploitation—Système d'exploitation requis par le package d'installation.
• Etat—Indique l'état actuel du package d'installation. Par exemple, l'état Terminé indique que le package d'installation a été déployé avec succès.
• Heure de mise à jour—Horodateur indiquant la dernière mise à jour du package d'installation.
• Groupe—Groupe auquel appartient ce package d'installation. Si vous modifiez le nom du groupe, le package d'installation est réattribué à ce groupe. Si le nom de groupe que vous saisissez n'existe pas, il est créé. Ces actions sont immédiatement appliquées dans la liste Packages d'installation.

Utilisation des packages d’installation

Depuis ce volet, vous pouvez effectuer les actions suivantes :

• Télécharger des packages d'installation—Télécharge un package d'installation vers le référentiel.
• Copier vers des locataires—Copie le package d'installation vers les locataires.
• Déployer—Déploie le package d'installation vers les hôtes.
• Télécharger—Télécharge une copie du package d'installation.
• Supprimer—Supprime le package d'installation.

Téléchargement de packages d'installation

[+] Cliquez pour afficher la procédure

1. Dans le volet Packages d'installation, cliquez sur +. Un nouveau volet, Assistant d'installation de logiciel, s'ouvre sur la droite.
2. Dans le volet Assistant d'installation de logiciel, sélectionnez une méthode d'importation du package d'installation :
   Important

   Si votre package d'installation contient deux modèles ou plus, vous devez utiliser la procédure Téléchargement de package d'installation (inclut modèles).
   • Téléchargement de package d'installation (inclut modèles)—Télécharge un fichier contenant un package d'installation et les modèles associés. Ces fichiers sont en général fournis par le service client de Genesys.
   • Téléchargement de package d'installation (modèle téléchargé séparément)—Télécharge un package d'installation et les modèles associés.
   • Chemin UNC d'accès à un CD monté ou un répertoire—Télécharge un package d'installation sur un CD monté ou un répertoire réseau.
   • Chemin UNC d'accès à un référentiel administrateur existant—Télécharge un package d'installation vers un référentiel Genesys Administrator existant.
   • Chemin UNC d'accès aux packages d'installation compressés du support—Télécharge un fichier .zip fourni par le service client de Genesys sur un CD monté ou un répertoire réseau. Ce fichier contient un package d'installation et les modèles associés.
3. Le téléchargement des fichiers s'effectue de votre système de fichiers vers Genesys Administrator Extension. Vous pouvez suivre son déroulement dans la barre de progression qui s'affiche. La progression du téléchargement s'affiche aussi dans la colonne Etat du volet Packages d'installation.

Important

Lorsque vous téléchargez un plug-in, GAX utilise le fichier modèle (.tpl) pour créer un modèle d'application et il extrait les options par défaut pour le plug-in. GAX stocke ces options dans la base de données et les fusionne avec l'objet central Application GAX lors du déploiement. Pendant cette fusion, seules les nouvelles options sont ajoutées ; les paires clé-valeur existantes ne sont pas écrasées.

Téléchargement de package d'installation (inclut modèles)

1. Dans le volet Assistant d'importation de logiciel, sélectionnez Téléchargement de package d'installation (inclut modèles) et cliquez sur le bouton Suivant.
2. Le volet s'actualise. Cliquez sur Choisir un fichier pour sélectionner le fichier à télécharger.
3. Cliquez sur Terminer.
4. Le fichier est téléchargé depuis votre système de fichiers vers Genesys Administrator Extension. Lorsque le téléchargement est terminé, le package d'installation s'affiche dans la liste Packages d'installation.

Téléchargement de package d'installation (modèle téléchargé séparément)

1. Dans le volet Assistant d'importation de logiciel, sélectionnez Téléchargement de package d'installation (modèle téléchargé séparément) et cliquez sur le bouton Suivant.
2. Le volet s'actualise et affiche trois cases : Télécharger un package, Télécharger un modèle XML et Télécharger un modèle APD. Cliquez sur Choisir un fichier.
   • Télécharger un package—Fichier .zip contenant le package d'installation.
   • Télécharger un modèle XML—Fichier de modèle XML correspondant à ce package d'installation. Il s'agit du modèle référencé par le fichier de description du package d'installation. Ce fichier ne doit pas être modifié par rapport à la version du répertoire de modèles.
   • Télécharger un modèle APD—Fichier de modèle APD correspondant à ce package d'installation. Il s'agit du modèle référencé par le fichier de description du package d'installation. Ce fichier ne doit pas être modifié par rapport à la version du répertoire de modèles.
   Le volet s'actualise.
3. Cliquez sur Terminer.
4. Le fichier est téléchargé depuis votre système de fichiers vers Genesys Administrator Extension. Lorsque le téléchargement est terminé, le package d'installation s'affiche dans la liste Packages d'installation.

Chemin UNC d'accès à un CD monté ou un répertoire

1. Dans le volet Assistant d'installation de logiciel, sélectionnez Chemin UNC d'accès à un CD monté ou un répertoire.
2. Dans le champ de texte, tapez le chemin d’accès à l'emplacement de stockage du package d'installation.
3. Cliquez sur Suivant pour ouvrir le chemin.
4. Le volet s'actualise pour afficher les packages d'installation détectés à l'emplacement spécifié. Cochez les cases en regard des packages d'installation à télécharger.
5. Cliquez sur Terminer.
6. Le volet affiche maintenant une barre de progression pour le processus du téléchargement. Vous pouvez cliquer sur Fermer à tout moment pour fermer le volet sans interrompre la procédure de téléchargement. L'état du téléchargement du package d'installation s'affiche dans la liste Packages d'installation.

Chemin UNC d'accès à un référentiel administrateur existant

1. Dans le volet Assistant d'installation de logiciel, sélectionnez Chemin UNC d'accès à un référentiel administrateur existant.
2. Dans le champ de texte, tapez le chemin d'accès au référentiel Genesys Administrator existant.
3. Cliquez sur Suivant pour ouvrir le chemin.
4. Le volet s'actualise pour afficher les packages d'installation détectés à l'emplacement spécifié. Cochez les cases en regard des packages d'installation à télécharger.
5. Cliquez sur Terminer.
6. Le volet affiche maintenant une barre de progression pour le processus du téléchargement. Vous pouvez cliquer sur Fermer à tout moment pour fermer le volet sans interrompre la procédure de téléchargement. L'état du téléchargement du package d'installation s'affiche dans la liste Packages d'installation.

Chemin UNC d'accès aux packages d'installation compressés du support

1. Dans le volet Assistant d'installation de logiciel, sélectionnez Chemin UNC d'accès aux packages d'installation compressés du support.
2. Dans le champ de texte, tapez le chemin d’accès à l'emplacement de stockage du package d'installation.
3. Cliquez sur Suivant.
4. Le volet s'actualise pour afficher les packages d'installation détectés à l'emplacement spécifié. Cochez les cases en regard des packages d'installation à télécharger.
5. Cliquez sur Terminer.
6. Le volet affiche maintenant une barre de progression pour le processus du téléchargement. Vous pouvez cliquer sur Fermer à tout moment pour fermer le volet sans interrompre la procédure de téléchargement. L'état du téléchargement du package d'installation s'affiche dans la liste Packages d'installation.

Important

• Une barre de progression verte indique que le téléchargement du package d'installation s'est effectué avec succès. Une barre de progression rouge indique que le téléchargement du package d'installation a échoué. Vous pouvez vérifier l'étape qui a échoué dans le champ Etat de la liste Packages d'installation.
• Vous ne pouvez pas télécharger un package d'installation si une version de ce package existe déjà dans le référentiel. Vous devez disposer de privilèges Remplacer packages d'installation et définitions de solution pour remplacer un package d'installation dans le référentiel.

Copier des packages d'installation vers des locataires

[+] Cliquez pour afficher la procédure

1. Cliquez sur le nom d'un package d'installation pour le sélectionner. Un nouveau volet s'ouvre sur la droite.
2. Dans le volet des détails Package d'installation, cliquez sur Lié et sélectionnez Copier vers des locataires. Un nouveau volet appelé Copier vers des locataires s'ouvre sur la droite.
3. Dans le volet Copier vers des locataires, tapez le nom d'un locataire dans le champ Filtre rapide ou cliquez sur Parcourir pour parcourir la liste des locataires dans votre environnement. Un nouveau volet appelé Locataires s'ouvre sur la droite.
4. Cochez la case en regard de chaque locataire devant recevoir le package d'installation. Le nom du locataire apparaît dans le volet Copier vers des locataires de la section Locataires ciblés.
5. Cliquez sur Suivant en bas du volet Copier vers des locataires.
6. Cliquez sur Terminer pour copier le package d'installation vers le ou les locataires.

Déployer des packages d'installation

[+] Cliquez pour afficher la procédure

1. Cliquez sur le nom d'un package d'installation pour le sélectionner. Un nouveau volet s'ouvre sur la droite.
2. Dans le volet des détails Package d'installation, cliquez sur Lié et sélectionnez Installer. Un nouveau volet, Assistant de déploiement de packages d'installation, s'ouvre sur la droite.
3. Suivez les instructions de l'assistant de déploiement. Cliquez sur l'onglet Assistant de déploiement, ci-dessus, pour plus d'informations.

Important

• Vous ne pouvez pas télécharger un package d'installation si une version de ce package existe déjà dans le référentiel. Vous devez disposer de privilèges Remplacer packages d'installation et définitions de solution pour remplacer un package d'installation dans le référentiel.
• Le déploiement de package d'installation ne nécessite pas l'utilisation d'un fichier SPD (définition de solution).
• Si vous installez un plug-in par le biais de GAX sous Windows, l’assistant de déploiement vous invite à spécifier uniquement le chemin d’installation du plug-in.

Si vous installez un plug-in par le biais de GAX sous Linux, l’assistant de déploiement vous invite à spécifier à la fois le chemin du répertoire GAX et le chemin d’installation du plug-in. Si le chemin d’installation de GAX est incorrect, l’assistant de déploiement installe le plug-in, mais ne copie pas les fichiers du plug-in dans le répertoire de GAX. Dans ce cas, vous devez manuellement copier les fichiers du plug-in à partir du chemin d’installation du plug-in vers le chemin d’installation de GAX.

Télécharger des packages d'installation

[+] Cliquez pour afficher la procédure

1. Cliquez sur le nom d'un package d'installation pour le sélectionner. Un nouveau volet s'ouvre sur la droite.
2. Cliquez sur Télécharger. Genesys Administrator Extension initie la procédure de téléchargement dans votre navigateur.

Supprimer des packages d'installation

[+] Cliquez pour afficher la procédure

1. Cliquez sur le nom d'un package d'installation pour le sélectionner. Un nouveau volet s'ouvre sur la droite.
2. Dans le volet des détails Package d'installation, cliquez sur Supprimer.
3. Une boîte de dialogue apparaît pour confirmer la suppression. Effectuez l'une des actions suivantes :

• Cliquez sur OK pour supprimer définitivement le package d'installation.
• Cliquez sur Annuler pour annuler la suppression du package d'installation.

Important

Cette action est disponible uniquement si l'utilisateur dispose du privilège Supprimer les packages d'installation et les SPD.

Important

• Si le fichier de métadonnées XML du composant contient des questions appelant une réponse durant l'installation d'un package d'installation, l'utilisateur est invité à répondre à ces questions lors de l'installation.
• Le déploiement de package d'installation ne nécessite pas l'utilisation d'un fichier SPD (définition de solution).

Assistant de déploiement

L'Assistant de déploiement automatique déploie un package d'installation ou une définition de solution vers les hôtes spécifiés, puis installe et configure le service selon les instructions de la définition de package de service.

Avant de commencer

Prenez en compte les points suivants lorsque vous utilisez l'Assistant de déploiement automatique :

• La plupart des champs de l'Assistant sont des champs à saisie semi-automatique. Vous pouvez saisir une partie de la valeur dans le champ et vous voyez s'afficher une liste contenant toutes les entrées qui contiennent le texte que vous avez saisi. Vous pouvez alors sélectionner l'élément approprié.
• L'assistant vérifie les packages d'installation, en fonction du système d'exploitation des hôtes ciblés. Lorsque vous sélectionnez des hôtes, assurez-vous que ces hôtes exécutent le système d'exploitation requis.
• Par défaut, si un package d'installation est déjà installé sur un hôte, l'assistant réinstalle le package. Tous les paramètres entrés lors du déploiement précédent sont enregistrés par Genesys Administrator Extension et pré-renseignés automatiquement dans l'assistant.
• Lorsque vous mettez à niveau un package d'installation existant, les autorisations et les connexions du package sont mises à jour pour le nouvel objet Application.

Eléments fusionnables

Pour les scénarios dans lesquels le package d'installation existant et le nouveau package d'installation présentent des valeurs incompatibles, les valeurs existantes du package d'installation sont conservées. Si le package d'installation existant ne contient pas de valeur, la valeur du nouveau package est utilisée. Les valeurs suivantes peuvent être fusionnées :

• options
• annex
• connections
• ports
• timeout
• autorestart
• commandlinearguments
• commandline
• state
• shutdowntimeout
• attempts
• redundancytype
• isprimary
• startuptimeout

Les plug-ins sont installés en suivant la même procédure que les packages d'installation. Toutefois, notez les éléments suivants :

• Le profil d'installation du plug-in recherche automatiquement les objets Application GAX pour les objets Hôte sélectionnés.
• Les options du plug-in sont fusionnées dans les objets Application GAX concernés.
• Certains champs de saisie n'apparaissent pas, comme ceux liés à l'Objet Application, au Port Application et à l'Objet Locataire.

L'Assistant de déploiement automatisé vous permet d'exécuter les scénarios ci-dessous :

• Installation d'un package d'installation
• Mise à niveau d'un package d'installation
• Restauration d'un package d'installation

Installation d'un package d'installation

[+] Cliquez pour afficher la procédure

1. Dans le volet Packages d'installation, sélectionnez le package d'installation à utiliser pour l'installation.
2. Un nouveau volet contenant des informations supplémentaires sur le package d'installation s'affiche sur la droite. Cliquez sur Lié et sélectionnez Installer.
3. Le volet Assistant de déploiement automatisé s'affiche sur la droite. Cliquez sur Suivant.
4. Le volet affiche maintenant la liste de sélection d'hôtes. Sélectionnez l'hôte qui recevra le package d'installation. Cliquez sur Suivant.
5. Le volet affiche maintenant la liste Paramètres d'application. Dans le champ Objet Application GAX pour l'hôte, sélectionnez l'objet Application Genesys Administrator Extension.
6. Cliquez sur Suivant.
7. Le volet affiche maintenant la liste Paramètres d'installation (silent.ini). Vous pouvez définir le chemin d'installation cible dans ce champ.
8. Cliquez sur Suivant.
9. Le volet affiche maintenant le rapport Déploiement. Vérifiez les paramètres et effectuez l'une des actions suivantes :
   • Cliquez sur Terminer pour installer le package d'installation.
   • Cliquez sur Précédent pour revenir à un volet précédent et modifier les paramètres.
10. Le volet affiche maintenant une barre de progression pour le déploiement. Ces informations sont aussi affichées dans le volet Packages d'installation déployés.

Important

Si un déploiement échoue, vous pouvez consulter le journal correspondant en sélectionnant le package dans le volet Packages d'installation déployés. Un nouveau volet contenant des informations supplémentaires sur le package s'affiche. Cliquez sur Journal d'actions de déploiement.

Mise à niveau d'un package d'installation

[+] Cliquez pour afficher la procédure

1. Dans le volet Packages d'installation déployés, sélectionnez le package à utiliser pour la mise à niveau.
2. Un nouveau volet contenant des informations supplémentaires sur le package d'installation s'affiche sur la droite. Cliquez sur Déployer le profil : Mettre à niveau vers (numéro de version).
3. Le volet Assistant de déploiement automatisé s'affiche sur la droite. Cliquez sur Suivant.
4. Le volet affiche maintenant la liste de sélection d'hôtes. Sélectionnez l'hôte qui recevra le package d'installation. Par défaut, l'hôte qui a reçu la version précédente du package est déjà sélectionné. Cliquez sur Suivant.
5. Le volet affiche maintenant la liste Paramètres d'application. Les valeurs de la version précédente du déploiement du package d'installation peuvent être affichées dans les champs suivants :
   • Objet Application existant—Ce champ est automatiquement créé par Genesys Administrator Extension pour chaque hôte vers lequel un package d'installation est ciblé. Il s'agit de l'objet Application de Configuration Server pour lequel Genesys Administrator Extension mettra à jour les connexions.
   • Objet locataire—Locataire défini dans l'objet Application du package d'installation. Cliquez sur Parcourir pour sélectionner un locataire dans la liste.
   • Port Application—Spécifiez un numéro de port pour l'objet Application à utiliser.
   • Configuration Server principal—Cliquez sur Parcourir pour sélectionner le serveur Configuration Server principal à utiliser. Par défaut, ce champ est réglé sur un objet Application de Genesys Administrator Extension.
   • Configuration Server de secours—Cliquez sur Parcourir pour sélectionner le serveur Configuration Server de secours à utiliser. Par défaut, ce champ est réglé sur un objet Application de Genesys Administrator Extension.
   • Ignorer la réinstallation du package d'installation—Choisissez une des options suivantes :
     • Vrai—Réinstalle le package d'installation uniquement si l'objet Application n'existe pas dans Configuration Server.
     • Faux—Réinstalle toujours le package d'installation.
6. Cliquez sur Suivant.
7. Le volet se met à jour pour afficher la liste Paramètres d'installation (silent.ini). Ces valeurs sont pré-renseignées à partir de la version précédente du package d'installation, mais elles peuvent être modifiées si nécessaire.
8. Le volet affiche maintenant le rapport Résumé du déploiement. Vérifiez les paramètres et effectuez l'une des actions suivantes :
   • Cliquez sur Terminer pour mettre à niveau le package d'installation.
   • Cliquez sur Précédent pour revenir à un volet précédent et modifier les paramètres.
9. Le volet affiche maintenant une barre de progression pour le déploiement de la mise à niveau. Ces informations sont aussi affichées dans le volet Packages d'installation déployés.

Important

Si un déploiement échoue, vous pouvez consulter le journal correspondant en sélectionnant le package dans le volet Packages d'installation déployés. Un nouveau volet contenant des informations supplémentaires sur le package s'affiche. Cliquez sur Journal d'actions de déploiement.

Restauration d'un package d'installation

[+] Cliquez pour afficher la procédure

1. Dans le volet Packages d'installation déployés, sélectionnez le package d'installation à restaurer.
2. Un nouveau volet contenant des informations supplémentaires sur le package d'installation s'affiche sur la droite. Cliquez sur le bouton Déployer le profil : Restaurer vers (numéro de version).
3. Le volet Assistant de déploiement automatisé s'affiche sur la droite. Cliquez sur Suivant.
4. Le volet affiche maintenant la liste de sélection d'hôtes. Sélectionnez l'hôte qui recevra le package d'installation. Par défaut, l'hôte qui a reçu le package précédent est déjà sélectionné. Cliquez sur Suivant.
5. Le volet affiche maintenant la liste Paramètres d'application. Les valeurs du déploiement de package d'installation précédent peuvent être affichées dans les champs suivants :
   • Objet Application existant—Ce champ est automatiquement créé par Genesys Administrator Extension pour chaque hôte vers lequel un package d'installation est ciblé. Il s'agit de l'objet Application de Configuration Server pour lequel Genesys Administrator Extension mettra à jour les connexions.
   • Objet locataire—Locataire défini dans l'objet Application du package d'installation. Cliquez sur Parcourir pour sélectionner un locataire dans la liste.
   • Port Application—Spécifiez un numéro de port pour l'objet Application à utiliser.
   • Configuration Server principal—Cliquez sur Parcourir pour sélectionner le serveur Configuration Server principal à utiliser. Par défaut, ce champ est réglé sur un objet Application de Genesys Administrator Extension.
   • Configuration Server de secours—Cliquez sur Parcourir pour sélectionner le serveur Configuration Server de secours à utiliser. Par défaut, ce champ est réglé sur un objet Application de Genesys Administrator Extension.
   • Ignorer la réinstallation du package d'installation—Choisissez une des options suivantes :
     • Vrai—Réinstalle le package d'installation uniquement si l'objet Application n'existe pas dans Configuration Server.
     • Faux—Réinstalle toujours le package d'installation.
6. Cliquez sur Suivant.
7. Le volet se met à jour pour afficher la liste Paramètres d'installation (silent.ini). Ces valeurs sont pré-renseignées à partir du déploiement précédent du package d'installation, mais elles peuvent être modifiées si nécessaire.
8. Le volet affiche maintenant le rapport Résumé du déploiement. Vérifiez les paramètres et effectuez l'une des actions suivantes :
   • Cliquez sur Terminer pour restaurer le package d'installation.
   • Cliquez sur Précédent pour revenir à un volet précédent et modifier les paramètres.
9. Le volet affiche maintenant une barre de progression pour le déploiement. Ces informations sont aussi affichées dans le volet Packages d'installation déployés.

Important

Si un déploiement échoue, vous pouvez consulter le journal correspondant en sélectionnant le package dans le volet Packages d'installation déployés. Un nouveau volet contenant des informations supplémentaires sur le package s'affiche. Cliquez sur Journal d'actions de déploiement.