Installation d'IBM Support Assistant V3

Table des matières :

1. Introduction
2. Configuration système requise
3. Installation d'IBM Support Assistant V3
4. Exécution d'IBM Support Assistant V3
5. Désinstallation d'IBM Support Assistant V3
6. Maintenance, identification et résolution des incidents

1. Introduction

Ce document contient des informations d'aide à l'installation d'IBM Support Assistant V3.0.0. IBM Support Assistant utilise le programme d'installation InstallShield pour effectuer l'installation sur les systèmes Microsoft Windows, Unix et Linux. Vous trouverez également des instructions pour la modification des paramètres de l'application pendant et après l'installation ainsi que pour la désinstallation d'IBM Support Assistant de votre machine.

2. Configuration système requise

IBM Support Assistant V3.0 est compatible avec les systèmes d'exploitation suivants : Sous Windows, IBM Support Assistant utilise la fenêtre de navigateur imbriquée Eclipse. La fenêtre imbriquée requiert MS Internet Explorer 6.x.

Sur les plateformes Unix et Linux, l'application IBM Support Assistant peut être utilisée avec les navigateurs Web suivants :

3. Installation d'IBM Support Assistant

Il existe trois modes d'installation de l'application IBM Support Assistant sur toutes les plateformes :

Installation via l'interface utilisateur graphique (GUI) :

Il s'agit du mode d'installation par défaut. Vous pouvez le démarrer en cliquant sur le fichier exécutable du programme d'installation pour votre système d'exploitation. Il lance le programme d'installation d'IBM Support Assistant dans un assistant graphique qui guide l'utilisateur dans le processus d'installation.

Mode d'installation Console :

Ce mode d'installation lance le programme d'installation d'IBM Support Assistant dans un assistant qui guide l'utilisateur dans le processus d'installation à l'aide de messages. Il est utile lorsque l'installation GUI n'est pas possible et que l'utilisateur souhaite utiliser un assistant d'installation dans un environnement de texte.
L'installation via la console peut être lancée avec la commande suivante :

Mode d'installation silencieux :

Ce mode d'installation ne requiert aucune intervention de l'utilisateur. L'utilisateur peut spécifier les paramètres de l'assistant dans un fichier texte et n'a pas besoin d'exécuter l'assistant via l'interface graphique ou la console. Pour lancer l'installation automatique, utilisez les arguments de ligne de commande suivants pour l'exécution du programme d'installation :
où :
Fichier d'options :
Le fichier d'options indique les valeurs pouvant être définies pendant l'installation. Il permet de configurer une installation avec les options spécifiées ci-dessous lorsque l'assistant est lancé avec l'option de ligne de commande "-options". Lisez la documentation relative à chaque paramètre pour savoir comment modifier sa valeur. Vous devez indiquer ces paramètres dans un fichier texte qui peut servir de fichier d'options. Un exemple de fichier d'options se trouve dans l'archive de téléchargement IBM Support Assistant V3.
Vous devez inclure les paramètres suivants dans le fichier d'options pour l'installation automatique d'IBM Support Assistant :

1. Acceptation de licence : Le fichier d'options doit confirmer l'acceptation des dispositions du contrat de licence figurant dans le fichier de contrat de licence d'IBM Support Assistant. Pour ce faire, ajoutez les lignes suivantes :
où :
2. Emplacement d'installation Le fichier d'options doit indiquer l'emplacement dans lequel le programme d'installation automatique doit installer IBM Support Assistant. Pour ce faire, ajoutez la ligne suivante :
où :


3. Type d'installation (facultatif)

où :

Remarques importantes :
si IBM Support Assistant v2 est déjà installé sur le même système, le programme d'installation ne permet pas d'installer IBM Support Assistant V3 dans le même emplacement. Le processus d'installation sera bloqué par un message vous invitant à changer d'emplacement d'installation pour éviter tout conflit. En mode d'installation automatique, une erreur de type 2004 sera détectée et l'installation échouera.

4. Poursuite de l'installation si l'application est déjà installée : si IBM Support Assistant V3 est déjà installé sur une machine, l'installation en mode silencieux s'arrête et prend fin en émettant le code d'erreur 2003. Cette situation s'explique par le fait qu'IBM Support Assistant V3 est conçu pour disposer d'une seule instance d'installation pour chaque machine ou d'une instance pour chaque utilisateur (autres plateformes). Toutefois, si vous voulez modifier l'installation existante pour continuer d'installer des fonctions supplémentaires, le fichier d'options doit l'indiquer explicitement :

Sur les systèmes Unix et Linux : Après avoir téléchargé le programme d'installation, vérifiez qu'il dispose de l'autorisation appropriée pour être exécuté. Vous pouvez exécuter la commande suivante :

pour attribuer l'autorisation d'exécution au programme d'installation.

4. Exécution d'IBM Support Assistant

IBM Support Assistant est une application Web J2EE. Sur Windows, IBM Support Assistant fournit sa propre interface graphique en utilisant la fenêtre de navigation imbriquée Eclipse. Sur toutes les autres plates-formes, l'utilisateur interagit avec IBM Support Assistant en utilisant un navigateur Web.

Plateforme Windows :

Démarrez IBM Support Assistant depuis le menu Démarrer (Démarrer->Programmes->IBM Support Assistant->IBM Support Assistant V3), ou depuis le raccourci IBM Support Assistant V3 sur le bureau. Pour arrêter l'application, cliquez sur l'icône ISA dans l'angle supérieur gauche, puis sur 'Fermer' et 'OK.'

Autres plateformes :

Démarrez IBM Support Assistant en exécutant le script startisa.sh depuis l'invite de commande. Une fois le script appelé, la commande affiche des messages, puis le navigateur Mozilla démarre et la page de bienvenue d'IBM Support Assistant version 3 s'affiche. Si le navigateur Mozilla n'est pas installé sur le système (mozilla binaire), un navigateur pris en charge devra être ouvert manuellement et l'URL d'IBM Support Assistant devra être saisie dans la zone d'adresse. Vous trouverez l'adresse URL d'IBM Support Assistant URL dans le fichier <install_root>/workspace/logs/isaurl.log.

Pour arrêter IBM Support Assistant, exécutez le script stopisa.sh à partir de l'invite de commande. Un message du type suivant apparaît dans la console :

Remarque : l'utilisateur qui arrête l'application doit posséder les droits appropriés (il s'agit en général de l'utilisateur qui a démarré l'application ou d'un superutilisateur).

Les messages qui apparaissent dans la console lors de l'exécution des scripts de démarrage et d'arrêt figurent également dans les fichiers startisa.log et stopisa.log respectivement, qui se trouvent dans le dossier d'installation d'IBM Support Assistant.

5. Désinstallation d'IBM Support Assistant

Plateforme Windows :

Vous pouvez désinstaller IBM Support Assistant de trois manières :

Ajout/Suppression de programmes : IBM Support Assistant V3 peut être désinstallé via la tâche Ajout/Suppression de programmes disponible dans le panneau de configuration.

2.Emplacement de l'installation : Vous pouvez exécuter le programme de désinstallation d'IBM Support Assistant à partir de l'emplacement d'installation. Pour ce faire, accédez au dossier _uninst dans le répertoire d'installation d'IBM Support Assistant et exécutez le fichier uninstaller.exe.

3.Menu Démarrer : Vous pouvez désinstaller IBM Support Assistant en cliquant sur l'option Désinstaller IBM Support Assistant dans le menu Démarrer de Windows (Démarrer->Programmes->IBM Support Assistant).
Le mode de désinstallation par défaut est le mode graphique (GUI). Pour désinstaller le produit via la console ou en mode automatique, utilisez les commandes suivantes en lançant le programme de désinstallation conformément à la deuxième méthode décrite ci-dessus.
Mode Console :

Mode silencieux : Remarque : un exemple de fichier d'options de désinstallation se trouve dans l'archive de téléchargement IBM Support Assistant V3. Si vous ne définissez pas l'attribut -options, ni un fichier d'options de désinstallation, une désinstallation complète est exécutée.

Autres plateformes :

Vous pouvez désinstaller IBM Support Assistant en lançant l'exécutable de désinstallation qui se trouve dans le dossier _uninst du répertoire d'installation d'IBM Support Assistant. Le mode de désinstallation par défaut est le mode graphique (GUI). Pour désinstaller le produit via la console ou en mode automatique, utilisez les commandes suivantes en lançant le programme de désinstallation conformément à la deuxième méthode décrite ci-dessus.
Mode Console :

Mode silencieux : Remarque : un exemple de fichier d'options de désinstallation se trouve dans l'archive de téléchargement IBM Support Assistant V3. Si vous ne définissez pas l'attribut -options, ni un fichier d'options de désinstallation, une désinstallation complète est exécutée.

6. Maintenance, identification et résolution des incidents

Journal d'installation et de désinstallation :

Le fichier journal d'installation et de désinstallation, log.txt, se trouve dans le répertoire d'installation d'IBM Support Assistant. Si l'installation échoue avant la création de ce dossier de destination, vous pouvez consulter le fichier journal figurant dans le répertoire temp de votre plateforme ou indiquer un autre emplacement pour le journal. Pour ce faire, ajoutez -is:log <log_file> après l'exécutable du programme d'installation. Exemple :

Espace d'installation temporaire :

Si l'espace de l'emplacement temporaire par défaut de votre système n'est pas suffisant, vous pouvez spécifier explicitement l'emplacement temporaire à utiliser avec la commande d'installation suivante :

Un manque d'espace sur votre système peut entraîner l'émission de l'erreur Signal 11 lors de l'installation sur certains systèmes d'exploitation.

Modification du numéro de port :

Le numéro de port sur lequel s'exécute IBM Support Assistant est sélectionné de manière aléatoire à chaque démarrage de l'application. Vous pouvez toutefois le modifier après l'installation. Pour ce faire, accédez au dossier <install_root>/configuration et modifiez l'entrée com.ibm.osg.webcontainer.port dans le fichier config.ini pour qu'elle corresponde au numéro de port que doit utiliser IBM Support Assistant V3. La valeur par défaut 0 indique qu'un numéro de port aléatoire sera sélectionné lors du démarrage. Vous devez redémarrer IBM Support Assistant pour que la modification soit validée.

Démarrage d'IBM Support Assistant impossible :

Si vous avez des difficultés pour démarrer IBM Support Assistant, consultez les fichiers journaux pour identifier les incidents.

Accès autorisé par le pare-feu :

Si IBM Support Assistant n'apparaît pas ou apparaît avec une page vierge, assurez-vous que le pare-feu autorise l'accès à IBM Support Assistant sur le port spécifié dans le fichier config.ini mentionné dans la section des paramètres de maintenance Modification du numéro de port ci-dessus.

Droits des utilisateurs sur les plateformes autres que Windows :

Si un message indiquant que vous ne possédez pas les droits appropriés pour démarrer ou arrêter IBM Support Assistant apparaît, assurez-vous que c'est l'utilisateur root qui tente ces opérations ou que l'opération est effectuée par l'utilisateur qui a installé IBM Support Assistant.
Certains systèmes d'exploitation peuvent comporter des restrictions qui autorisent uniquement l'utilisateur root à exécuter des programmes sur les ports dont le numéro est inférieur à 1024.

Détection de plusieurs installations :

Si un message apparaît pour indiquer qu'IBM Support Assistant V3 est déjà installé lorsque vous lancez le programme d'installation, vérifiez que le produit n'est pas déjà installé sur votre machine. Ceci est très important pour vérifier que la maintenance et les mises à jour appropriées pourront être appliquées.
Si vous êtes sûr qu'IBM Support Assistant V3 n'est pas installé sur votre système et que vous obtenez ce message par erreur, ou si vous voulez remplacer une installation corrompue, utilisez la commande d'installation suivante :

Options d'accessibilité lors de l'installation :

Vous pouvez lancer le programme d'installation avec l'option "-accessibility". Il démarrera en mode console modifié pour faciliter la compréhension des écrans d'installation lus par les lecteurs d'écran.

Sortie de la notification sur la plateforme Windows :

Lorsque l'utilisateur quitte la fenêtre principale ISA, il doit répondre à un message de confirmation, car tous les outils et fenêtres démarrés dans ISA seront également fermés. L'utilisateur peut sélectionner la case à cocher permettant de ne pas afficher la confirmation lors de la sortie ISA. Si vous avez effectué cette opération et voulez réactiver cette boîte de dialogue de confirmation, procédez comme suit :

  1. Fermez ISA s'il est actif.
  2. Affichez la fenêtre des propriétés du raccourci 'IBM Support Assistant V3' que vous utilisez pour lancer IBM Support Assistant V3. Dans la zone 'Cible' de l'onglet 'Raccourci', ajoutez un espace à la fin de la chaîne de commande, suivi de la chaîne -promptonexit
  3. Cliquez sur le bouton 'OK'.
  4. Démarrez ISA à partir du raccourci.
Remarque : vous devez supprimer la chaîne de la zone si vous ne voulez plus afficher la confirmation lors de la sortie d'ISA.

Java ainsi que toutes les marques et tous logos incluant Java sont des marques de Sun Microsystems, Inc. aux Etats-Unis et/ou dans certains autres pays.

IBM est une marque d'International Business Machines Corporation aux Etats-Unis et/ou dans certains autres pays.

Microsoft, Windows, Windows NT et le logo Windows sont des marques de Microsoft Corporation aux Etats-Unis et/ou dans certains autres pays.

D'autres sociétés sont propriétaires des autres marques, noms de produits ou logos qui pourraient apparaître dans ce document.

(c) Copyright IBM Corp. and others 2004