Sun Java logo     Précédent      Contenu      Index      Suivant     

Sun logo
Guide de mise à niveau de Sun Java Enterprise System 5 pour UNIX 

Chapitre  7
Web Server

Ce chapitre décrit la procédure de mise à niveau de Web Server vers Java ES 5 (version 5) : Sun Java System Web Server 7.0.

Ce chapitre présente les considérations relatives à la mise à niveau pour les différentes méthodes de mise à niveau prises en charge par la version 5. Il traite des mises à niveau sur les systèmes d'exploitation Solaris et Linux :

Présentation des mises à niveau de Web Server

Cette section présente les aspects généraux de Web Server qui ont un impact sur la mise à niveau vers Java ES 5 (version 5) :

À propos de Web Server pour Java ES version 5

Web Server pour Java ES version 5 représente, par ses nombreuses améliorations d’interface et nouveautés, une version majeure par rapport à la version 4.

Web Server version 5 possède une nouvelle infrastructure d’administration, dotée de nouveaux outils. L’infrastructure d’administration inclut une instance du server d'administration qui héberge les informations de configuration pour un nombre indéterminé d’instances de Web Server. Une nouvelle interface de ligne de commande (wadm) et une nouvelle interface graphique utilisateur permettent de créer des instances de Web Server, localement ou sur des ordinateurs distants, mais aussi de configurer et de gérer ces instances. Les nouveaux outils d’administration requièrent un nom d’utilisateur et un mot de passe administrateur.

Pour plus d’informations sur la nouvelle infrastructure d’administration, reportez-vous au manuel Guide de l'administrateur de Web Server 7.0 , http://docs.sun.com/doc/819-2629.

Ces modifications apportées à l’interface d’administration de Web Server ont un impact significatif sur la mise à niveau.

Présentation de la mise à niveau de Web Server

Le Tableau 7-2 répertorie les méthodes de mise à niveau de Web Server vers Java ES version 5 prises en charge. Il s’applique à la fois à Solaris et Linux.

Tableau 7-2  Méthodes de mise à niveau vers Java ES 5 (version 5) : Web Server 7.0

Version de Java ES

Web Server Version

Approche globale

Reconfiguration
requise

Version 4

Sun Java System Web Server 6.1 SP5 2005Q4

Mise à niveau directe :
nouvelle installation suivie d’une migration des données

Migration de la configuration des instances vers les nouvelles instances

Version 3

Sun Java System Web Server 6 2005Q1 Update 1 SP 4

Mise à niveau directe :
nouvelle installation suivie d’une migration des données

Migration de la configuration des instances vers les nouvelles instances

Version 2

Sun Java System Web Server 6 2004Q2 Update 1 SP 2
Enterprise Edition et Platform Edition

Mise à niveau directe :
nouvelle installation suivie d’une migration des données

Migration de la configuration des instances vers les nouvelles instances

Version 1

Sun ONE Web Server 6.1 (2003Q4)

Mise à niveau directe non certifiée :
en revanche, elle peut être réalisée en effectuant une nouvelle installation, suivie d’une migration des données.

Migration de la configuration des instances vers les nouvelles instances

Versions antérieures à Java ES

 

Pas de mise à niveau directe.

 

Données de Web Server

Le tableau suivant affiche les types de données susceptibles d'être affectés par une mise à niveau du logiciel Web Server.

Tableau 7-3  Utilisation des données de Web Server

Type de données

Emplacement

Utilisation

Données de configuration

Web Server 6.x (Java ES versions 2, 3 et 4) : WebServer6-base/https-nomInstance/config/

Configuration des instances de Web Server

Web Server 7.0 (Java ES version 5) :

Configuration d’instance
WebServer7Config-base/https-nomConfig/config1/

Stockage de configuration central
Accessible par la Console Web Server et l’interface de ligne de commande wadm.

 

1Notez que le chemin WebServer7Config-base est nettement différent du chemin WebServer6-base.

Stratégie de mise à niveau de Web Server

De manière générale, la stratégie à utiliser pour effectuer la mise à niveau de Web Server dépend de nombreuses considérations, décrites dans le Chapter 1, "Planification des mises à niveau" : méthode de mise à niveau, dépendances entre les composants Java ES, mise à niveau sélective ou globale, déploiements portant sur plusieurs instances et ainsi de suite.

Cette section aborde spécifiquement les questions susceptibles d'influencer le plan de mise à niveau de Web Server.

Problèmes de compatibilité

Web Server pour Java ES version 5 ne présente pas de modification des interfaces publiques et, par conséquent, est compatible avec les versions antérieures de ce point de vue précis. En revanche, les nouvelles interfaces d’administration ne sont pas compatibles avec leurs homologues antérieures. Cela influe sur la mise à niveau et le redéploiement des applications Web (notamment les composants Java ES par exemple).

En particulier, Web Server version 5 utilise des paramètres par défaut différents pour les noms d’annuaires d’instances et de serveurs virtuels, comme l’indique le tableau suivant.

Tableau 7-4  Noms par défaut de Web Server

Élément

Valeurs par défaut pour Web Server 6.x pour
Java ES versions 2, 3 et 4

Valeurs par défaut pour Web Server 7.0 pour
Java ES version 5

Nom de la configuration

 

nomHôte.nomDomaine

Chemin du répertoire de l’instance

WebServer6-base/
https-nomHôte.nomDomaine

WebServer7Config-base
https-nomHôte.nomDomaine

Nom de serveur virtuel

https-nomHôte.nomDomaine

nomHôte.nomDomaine

Dépendances de Web Server

Web Server présente des dépendances par rapport aux composants Java ES suivants :

Double mise à niveau

La double mise à niveau, qui permet à la fois la mise à niveau de Web Server et du système d'exploitation (comme le décrit la section Mises à niveau doubles : Java ES et système d'exploitation) peut être effectuée en utilisant la méthode de mise à niveau d'un système d'exploitation existant :

  1. Sauvegardez les données de Web Server.

    2. Reportez-vous à Données de Web Server concernant l'emplacement des données fondamentales.

  2. Mettez à niveau le système d'exploitation.

    3. La mise à niveau ne modifie pas le système de fichiers existant.

  3. Procédez à la mise à niveau de Web Server vers la version 5.

    4. Reportez-vous à la section correspondante du présent chapitre, en fonction de la méthode de mise à niveau.

Mise à niveau de Web Server à partir de Java ES version 4

Cette section fournit des informations sur la mise à niveau de Web Server à partir de Java ES 2005Q4 (version 4) vers Java ES 5 (version 5). La section aborde les thèmes suivants :

Introduction

Lors de la mise à niveau de Web Server pour Java ES version 4 vers la version 5, tenez compte des aspects suivants du processus de mise à niveau :

Mise à niveau de Web Server pour la version 4

Cette section explique comment effectuer la mise à niveau de Web Server de Java ES version 4 vers Java ES version 5 sur les plates-formes Solaris et Linux. Lorsqu'une rubrique traite de procédures spécifiques à une plate-forme, le système d'exploitation auquel elle fait référence est indiqué. La section aborde les thèmes suivants :

Tâches à exécuter avant la mise à niveau

Avant de mettre à niveau Web Server, vous devez effectuer les tâches suivantes :

Vérifier les informations sur la version actuelle

Vous pouvez vérifier la version actuelle de Web Server en démarrant le serveur d'instance Web Server avec l'option -version :

WebServer6-base/https-nomHôte.nomDomaine/start -version

Tableau 7-5  Résultat de la vérification de la version de Web Server

Version de Java ES

Numéro de version de Web Server

Version 2

6.1SP2

Version 3

6.1SP4

Version 4

6.1SP5

Version 5

7.0

Mise à niveau des dépendances de Web Server

Il est généralement recommandé de mettre à jour tous les composants de Java ES sur un système informatique (et dans un environnement informatique) vers Java ES version 5. Toutefois, le programme d’installation de Java ES utilisé pour mettre à niveau Web Server vers la version 5 met automatiquement à niveau tous les composants partagés requis par Web Server (voir le Tableau 1-9).

Sauvegarde des données de Web Server

La mise à niveau de Web Server version 4 vers la version 5 ne modifie pas les données de configuration existantes : celles-ci restent intactes. Il est donc inutile de sauvegarder les données actuelles.

Obtention des mots de passe et informations de configuration requis

Vous devez vous connecter en tant que superutilisateur pour réaliser la mise à niveau et le compte utilisateur exécutant la migration doit disposer des autorisations appropriées pour accéder aux répertoires d’installation existants de Web Server.

Mise à niveau de la version 4 de Web Server

Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau de Web Server, suivies de la description de la procédure elle-même.

Considérations relatives à la mise à niveau

Lorsque vous mettez à niveau le logiciel Web Server vers Java ES version 5, vous devez tenir compte des considérations suivantes :

Procédure de mise à niveau

La procédure présentée ci-dessous s'applique à toutes les instances de Web Server correspondant à la même image de Web Server installée sur l'ordinateur où la mise à niveau est exécutée.

  1. Connectez-vous en tant qu'utilisateur root ou superutilisateur.

    2. su -

  2. Arrêtez toutes les instances actives de Web Server et Administration Server.

    3. WebServer6-base/https-nomInstance/stop
    WebServer6-base/https-admserv/stop

  3. Réalisez une nouvelle installation de Web Server.

    4. Procédez comme suit :

    1. Lancez le programme d’installation de Java ES.

      2. cd distribution Java ES version 5 /arch_se
      ./installer

      où arch_se correspond à votre plate-forme, telle que Solaris_sparc. (Utilisez l’option installer -nodisplay pour l’interface de ligne de commande.)

      Une fois que les pages de bienvenue et du contrat de licence se sont affichées, vous accédez à la page de sélection de composant. (Lorsque des composants installés pouvant être directement mis à niveau par le programme d’installation de Java ES sont détectés, ils sont présentés avec l’état “pouvant être mis à niveau”.)

    2. Sélectionnez Web Server dans la page de sélection de composant.
    3. Indiquez un chemin d’installation différent de celui de la version 4 de Web Server.
    4. Sélectionnez Configurer maintenant ou Configurer ultérieurement.
      • Si vous choisissez Configurer maintenant, passez à l’Step e.
      • Si vous choisissez Configurer ultérieurement, passez à l’Step f .
    5. Si vous choisissez Configurer maintenant, le programme d’installation de Java ES vous propose deux options :
      • Configurer l'instance d'administration en tant que serveur d'administration
        Utilisez cette option sur l’ordinateur qui héberge l’instance du serveur d'administration qui, entre autres tâches administratives, est requise pour procéder à la migration des instances de la version 4 vers la version 5.
      • Configurer l'instance d'administration en tant que nud d'administration
        Utilisez cette option sur les ordinateurs qui hébergent une instance de Web Server distante du serveur Administration Server. L’instance d’administration est configurée comme un agent de nud qui interagit avec le serveur d'administration.
      • Indiquez les valeurs de configuration requises.

        • Vous êtes invité à entrer le nom d’hôte, le port HTTP, le nom d’utilisateur de l’administrateur et son mot de passe.

      • Confirmez vos préférences d’installation.

        • Les packages de Web Server seront installés et un récapitulatif de l’installation affiché.

        Le programme d’installation Java ES crée une configuration par défaut nommée nomHôte.nomDomaine, avec une instance de Web Server correspondante.

      • Quittez le programme d’installation de Java ES et passez à l’Step 4.
    6. Si vous choisissez l’option Configurer ultérieurement, le programme d’installation de Java ES crée un script configureServer que vous exécuterez à l’Step IV.
      1. Confirmez vos préférences d’installation.

        2. Les packages de Web Server seront installés et un récapitulatif de l’installation affiché.

      2. Quittez le programme d'installation de Java ES.
      3. Définissez les valeurs du fichier WebServer7-base/setup/WSInstall.properties.

        4. Indiquez les valeurs pour toutes les propriétés obligatoires (non facultatives) dans le tableau suivant :

        Tableau 7-6  Valeurs de WSInstall.properties 

        Propriété

        Description

        WS_DOCROOT

        (Facultatif) Emplacement de document pouvant héberger les fichiers du contenu Web

        WS_SERVER_NAME

        Nom d’hôte pouvant être utilisé pour les requêtes HTTP

        WS_SERVER_USER

        Utilisateur Unix d'exécution Les valeurs correctes peuvent être root, n’importe quel utilisateur UNIX valide ou webservd (par défaut).

        WS_HTTP_PORT

        Port d’instance pouvant être utilisé pour analyser les requêtes HTTP

        WS_ADMIN_SSL_PORT

        Port SSL d’administration

        WS_ADMIN_HOST

        Nom de l’hôte d’administration pour les tâches du serveur d’administration

        WS_CONFIG_NAME

        Nom de configuration pour cet hôte. Cette valeur peut être la même que celle de WS_SERVER_NAME

        WS_ADMIN_SERVER_USER

        Utilisateur UNIX d’exécution du serveur d’administration. Valeurs correctes : 'root' ou même utilisateur que WS_SERVER_USER

        WS_ADMIN_LOGIN_USER

        Nom d’utilisateur de connexion au serveur d’administration

        WS_ADMIN_LOGIN_PASSWORD

        Mot de passe de connexion au serveur d’administration

        WS_ADMIN_HTTP_PORT

        (Facultatif) Port SSL autre que le port d’administration. Par défaut : 8800

        WS_START_ON_BOOT

        (Facultatif) Fonction de démarrage à l’amorçage (true/false). True permet à l’instance de serveur et à son serveur d’administration de démarrer automatiquement après le redémarrage du système. Par défaut : false

        WS_64BIT_INSTALL

        (Facultatif) Mode d’exécution du serveur (true/false). True configure le serveur en mode 64 bits (pour Solaris uniquement). False configure le serveur en mode 32 bits (pour Solaris uniquement). Valeur par défaut : false

        WS_ADMIN_IS_SERVER_MODE

        (Facultatif) Mode de configuration d’administration. (true/false). True configure le serveur en mode serveur d’administration. False configure le serveur en mode agent d’administration. Par défaut : true

        WS_REGISTER_ADMIN_AGENT

        (Facultatif) Inscription d’agent distant. (true/false). Ce paramètre n’est obligatoire que si WS_ADMIN_IS_SERVER_MODE est défini sur false. Si vous sélectionnez True, vous devez indiquer l’hôte du serveur d’administration distant pour l’inscription. Par défaut : true

        WS_AGENT_SSL_PORT

        (Facultatif) Port SSL de l’agent d’administration. Ce paramètre n’est obligatoire que si WS_ADMIN_IS_SERVER_MODE est défini sur false.

        WS_AGENT_HOST=

        (Facultatif) Nom d’hôte de l’agent d’administration. Ce paramètre n’est obligatoire que si WS_ADMIN_IS_SERVER_MODE est défini sur false.

      4. Exécutez le script configureServer.

        5. WebServer7-base/setup/configureServer
        -inputfile         WebServer7-base/setup/WSInstall.properties
        -logfile         WebServer7-base/setup/WSInstall.log
        -verbose

        Le script configureServer crée une configuration par défaut nommée nomHôte.nomDomaine, avec une instance de Web Server correspondante.

  4. Démarrez le service du serveur d'administration de Web Server.

    5. WebServer7Config-base/admin-server/bin/startserv

  5. Faites migrer les configurations d’instance de Web Server version 4 vers la version 5.

    6. Vous pouvez utiliser les outils d’administration de la ligne de commande (wadm) ou de l’interface graphique utilisateur (connectez-vous à l’interface graphique utilisateur du serveur d'administration de Web Server). La procédure suivante est basée sur l’interface de ligne de commande wadm.

    Par exemple, pour faire migrer une instance nommée myinstance vers une nouvelle configuration, procédez comme suit :

    WebServer7-base/bin/wadm migrate-server --user=admin
    --host=localhost --server-root=/opt/SUNWwbsvr --instance=https-myinstance --config=newconfigname

    La syntaxe de commande complète est la suivante :

    WebServer7-base/bin/wadm migrate-server

    --user=    utilisateur-admin [--password-file=fichier-motdepasse-admin] [--host=hôte-admin]
    [--echo] [--rcfile=rcfile] [--no-prompt] [--verbose]

    [--search-collection-copy-path=    cheminCollectionRecherche]
    [--log-dir=    répertoire] --serverroot=chemin
    ([--all] | [--instance=https-nomInstance] [--config=nomNouvelleConfig])

    Le premier ensemble d’options ci-dessus est commun à toutes les commandes wadm et décrit dans le Tableau 7-7 ci-dessous. Le deuxième ensemble d’options est propre à la commande migrate-server et est décrit dans le Tableau 7-8.

    Si vous appelez wadm avec uniquement le premier ensemble d’options, vous êtes dirigé à l’intérieur de l’invite de commande wadm. L’appel de commandes à l’intérieur de cette invite ne vous demande pas de spécifier à nouveau les options communes.

    Si vous appelez les commandes wadm complètes et que vous vous trouvez à l’extérieur de l’invite, vous devez spécifier au minimum les options --user et --host (si vous omettez l’option --password-file, vous devrez entrer un mot de passe et si vous omettez les autres options, la valeur définie sera la valeur par défaut). Néanmoins, dans un souci de simplicité, pour les commandes utilisées pour illustrer les procédures de ce chapitre, les options --user et --host ne sont pas incluses.

    Par défaut, wadm utilise le protocole SSL sur le port 8989.

    Pour obtenir des informations complètes sur les commandes et options wadm, reportez-vous au Manuel de référence de l'interface de ligne de commande de Web Server 7.0, http://docs.sun.com/doc/819-3283.

    Tableau 7-7  Options de commande communes de wadm  

    Option

    Description

    user

    ID utilisateur de l’administrateur Web Server autorisé

    password-file

    Fichier contenant le mot de passe pour authentifier l’utilisateur administrateur auprès du serveur d'administration. Le fichier de mot de passe doit contenir une ligne WADM_PASSWORD=mot_de_passe. Si l’option n’est pas spécifiée dans la commande, vous devrez entrer le mot de passe.

    host

    Nom de l’ordinateur sur lequel le serveur d'administration s’exécute. Par défaut : localhost.

    echo

    Si vous définissez cette valeur sur true, les saisies de la ligne de commande sont répercutées en sortie standard avant l’exécution de la commande. Par défaut : false

    interactive

    Si cette option est définie sur true, les options de mot de passe obligatoires sont demandées. Par défaut : true.

    rcfile

    Fichier de démarrage à charger au démarrage de wadm. Par défaut : ~/.wadmrc.

    no-prompt

    Si vous définissez cette option sur true, la commande ne demandera jamais de saisie de la part de l’utilisateur, quelles que soient les circonstances. Par exemple, la commande générera simplement une erreur si elle est appelée avec des paramètres manquants, au lieu d’attendre et de demander une saisie de la part de l’utilisateur. Vous pouvez définir cette commande sur true lorsque vous utilisez les commandes wadm avec un script d’invite, de sorte que la commande envoie toujours un résultat plutôt que d’attendre une saisie de la part de l’utilisateur. Par défaut : false.

    verbose

    Si vous attribuez à cette commande la valeur true, une liste détaillée s'affiche. Par défaut : false.

    Tableau 7-8  Options et opérandes de la commande wadm migrate-server  

    Option/Opérande

    Description

    search-collection-
    copy-path

    Définit le chemin dans lequel les fichiers de l’index de collection de recherche seront copiés lors de la migration des collections de recherche. Les scénarios de migration suivants sont possibles :

    Si le chemin de collection de recherche de Web Server 6.x se trouve hors de l’instance de Web Server 6.x, le chemin de collection de recherche migré pointera vers le chemin de collection de recherche de Web Server 6.x et cette option sera ignorée.

    Si le chemin de collection de recherche de Web Server 6.x se trouve à l’intérieur de l’instance de Web Server 6.x et qu’un chemin correct est défini pour cette option, les fichiers de l’index de collection de recherche seront copiés dans le répertoire suivant : cheminCollectionRecherche/nomConfig/nomServeurVirtuel/nomCollection. Si le chemin spécifié n’est pas valide, un message d’erreur sera consigné.

    Si le chemin de collection de recherche de Web Server 6.x se trouve à l’intérieur de l’instance de Web Server 6.x mais qu’aucun chemin n’est défini pour cette option, les fichiers de l’index de collection de recherche ne seront pas copiés. Un message sera consigné dans le journal de migration pour demander à l’utilisateur de copier manuellement les fichiers de l’index de collection de recherche à l’aide de la commande wadm add-documents. Dans ce cas, le chemin de collection de recherche migré sera le suivant : WebServer7Config-base/https-nomConfig/config/collections/ nomServeurVirtuel/nomCollection.

    log-dir

    Emplacement du journal de migration.
    Valeur par défaut : WebServer7Config-base/admin-serv/logs

    serverroot

    Emplacement d’installation (répertoire) dans lequel Web Server version 6.x est installé : identique à WebServer6-base.

    all

    Si cette commande est définie sur true, toutes les configurations d’instance de Web Server 6.x sont migrées vers des configurations de Web Server 7.0 portant le même nom que les instances. Si une configuration de ce nom existe déjà, nomInstance-1 est utilisé en tant que nom de configuration. Par défaut : false.

    instance

    Si des configurations d’instance doivent être migrées individuellement (all=false), il s’agit du nom de la configuration d’instance de Web Server 6.x à faire migrer (sous la forme : https-nomInstance). Le nom d’instance de Web Server 6.x par défaut est nomHôte.nomDomaine

    config

    Nom de la configuration dans laquelle la configuration d’instance de Web Server 6.x spécifiée doit être migrée. La valeur par défaut est nomInstance correspondant à la configuration d’instance de Web Server 6.x. Toutefois, si une configuration de ce nom existe déjà, la commande ajoutera un nombre entier au nom. Il s’agit d’un scénario probable si la configuration de l’instance de Web Server 6.x par défaut fait l’objet d’une migration.

    Lorsque vous utilisez la commande migrate-server, veillez à ne pas oublier les éléments suivants :

    • Si vous souhaitez faire migrer plusieurs configurations d’instance de la version 4, vous pouvez exécuter la commande migrate-server plusieurs fois avec différentes valeurs pour --instance et les arguments --config correspondants, ou utiliser l’option --all pour les faire toutes migrer en même temps.
    • Pour chaque appel de la commande migrate-server, la migration va créer un fichier journal portant le nom suivant dans un répertoire défini par l’option --log-dir (ou dans le répertoire WebServer7Config-base/admin-server/logs par défaut) :

      MIGRATION_aaaammjjhhmmss.log

      Si vous sélectionnez l’option --all, le fichier journal va stocker les informations de stockage pour toutes les instances migrées.

  6. Créez des instances de Web Server version 5.

    7. Vous devez créer une nouvelle instance de la version 5 pour chaque configuration d’instance de la version 4 ayant fait l’objet d’une migration à l’Step 5.

    1. Avant de créer une nouvelle instance, consultez le journal de migration et corrigez les éventuels problèmes dans la configuration migrée.
    2. Exécutez la commande create-instance.

      3. WebServer7-base/bin/wadm create-instance
      --config=      nomConfig hôteNud1 [hôteNud2 ...hôteNudN]

      Les options de commande communes sont décrites dans le Tableau 7-7. Les options propres à la commande create-instance sont décrites dans le tableau suivant :

      Tableau 7-9  Options et opérandes de la commande wadm create-instance

      Option/Opérande

      Description

      config

      Nom de la configuration de la version 5 vers laquelle doit pointer l’instance

      nodehost

      Nom de l’ordinateur sur laquelle l’instance est en cours de création. Vous pouvez indiquer plusieurs ordinateurs sous forme de liste nomHôte.nomDomaine séparée par des espaces, en créant ainsi plusieurs instances identiques.

      La commande create-instance crée un répertoire d’instance dans WebServer7Config-base/https-nomConfig
      sur les nuds spécifiés et déploie la configuration dans les répertoires d’instance correspondants.

  7. Démarrez chaque instance de la version 5.

    8. WebServer7Config-base/https-nomConfig/bin/startserv

    Le script startserv est créé en même temps que l’instance. Si l’instance démarre sans problème, vous obtenez un message indiquant “démarrage du serveur réussi.” L’URL par défaut de l’instance s’affiche.

Vérification de la mise à niveau

Vous pouvez vérifier que la mise à niveau de Web Server vers la version 5 est réussie, à l’aide de la procédure suivante :

  1. Consultez le fichier journal de migration qui vient d’être créé afin de trouver des messages ERROR éventuels.

    2. Si besoin, apportez des modifications manuelles (reportez-vous à la section Tâches à exécuter après la mise à niveau).

  2. Vérifiez les instances de Web Server version 5.

    3. À partir d’un navigateur Web, accédez à l’URL suivant et assurez-vous que vous obtenez la page d’accueil :

    http://nomHôte.nomDomaine:port

    où le nom d’hôte complet et le port correspondent à chaque instance.

  3. Exécutez l’instance de Web Server avec l’option -version suivante :

    4. WebServer7Config-base/https-nomConfig/bin/startserv -version

    Reportez-vous au tableau Tableau 7-5 des valeurs de résultat de version.

Tâches à exécuter après la mise à niveau

La principale tâche à exécuter après la mise à niveau concerne la migration manuelle, si nécessaire, de certaines données de la version 4. Il s’agit des données normalement associées à un ou plusieurs serveurs virtuels configurés pour la version 4 et définis dans le fichier de configuration server.xml.

Veuillez noter les procédures post-mise à niveau requises dans le cadre des situations suivantes :

Migration du contenu de la racine de documents de Web Server 6.1
  1. Copiez le contenu de la racine de documents de Web Server 6.1 où vous le souhaitez.
  2. Mettez à jour le nouveau chemin de la racine de documents à l’aide de la commande suivante :

    3. WebServer7-base/bin/wadm set-virtual-server-prop
    --config=    nomConfig --vs=nomServeurVirtuel
    document-root=chemin de la nouvelle racine de documents

    Les options de commande communes sont décrites dans le Tableau 7-7. Les options propres à la commande set-virtual-server-prop sont décrites dans le tableau suivant :

    Tableau 7-10  Options et opérandes de la commande wadm set-virtual-server-prop

    Option/Opérande

    Description

    config

    Nom de la configuration de la version 5 pour laquelle le nouveau chemin de la racine des documents est défini

    vs

    Nom du serveur virtuel auquel la racine des documents migrée correspond

    document-root

    Chemin du nouveau répertoire de la racine des documents

  3. Redéployez la configuration dans les instances de Web Server appropriées.

    4. WebServer7-base/bin/wadm deploy-config
    [--force] [--restart] [--no-reconfig]
    nomConfig

    Les options de commande communes sont décrites dans le Tableau 7-7. Les options propres à la commande deploy-config sont décrites dans le tableau suivant :

    Tableau 7-11  Options et opérandes de la commande wadm deploy-config

    Option/Opérande

    Description

    force

    Si cette commande est définie sur true, elle force l’écrasement d’une configuration d’instance qui a été manuellement modifiée depuis le déploiement de configuration précédent. Par défaut : false

    restart

    Si cette commande est définie sur true, les instances en cours d’exécution seront redémarrées afin de prélever les paramètres de configuration de la configuration déployée. Par défaut : false

    no-reconfig

    Si cette commande est définie sur true, les instances en cours d’exécution ne prélèveront pas les paramètres de configuration de la configuration déployée, tant que l’instance n’aura pas été redémarrée. Par défaut : false

    nomConfig

    Nom de la configuration de la version 5 en cours de déploiement sur une instance de Web Server dont le nom correspond au nom de configuration.

Migration des informations de collection webdav

Aucune migration manuelle supplémentaire n’est requise. Mettre à jour le chemin de la racine de documents suffit.

Migration des fichiers journaux

Copiez ces fichiers dans un emplacement connu si vous souhaitez les enregistrer (sinon, ils seront supprimés lorsque vous désinstallerez la version 4).

Migration des plug-ins NSAPI tiers
  1. Copiez les fichiers de bibliothèque de leur emplacement de la version 4 dans le répertoire WebServer7-base/lib.
  2. Exportez les fichiers de configuration magnus.conf et obj.conf dans un répertoire temporaire.

    3. WebServer7-base/bin/wadm get-config-file --config=nomConfig
    magnus.conf > /tmp/magnus.conf

    WebServer7-base/bin/wadm get-config-file --config=nomConfig
    obj.conf > /tmp/obj.conf

    Les options de commande communes sont décrites dans le Tableau 7-7.

  3. Modifiez les fichiers magnus.conf et obj.conf comme le décrit la documentation sur les plug-ins NSAPI tiers.
  4. Importez les fichiers de configuration magnus.conf et obj.conf à partir du répertoire temporaire.

    5. WebServer7-base/bin/wadm set-config-file --config=nomConfig
    --upload-file=/tmp/magnus.conf magnus.conf

    WebServer7-base/bin/wadm set-config-file --config=nomConfig
    --upload-file=/tmp/obj.conf obj.conf

    Les options de commande communes sont décrites dans le Tableau 7-7.

  5. Redéployez la configuration modifiée dans les instances de Web Server appropriées.

    6. WebServer7-base/bin/wadm deploy-config
    [--force] [--restart] [--no-reconfig]
    nomConfig

    Les options de commande sont décrites dans le Tableau 7-11.

Modification de la racine des documents de collection de recherche

La commande migrate-server possède une option de migration des informations de collection de recherche ; néanmoins, vous pouvez modifier la racine des documents de collection de recherche comme suit :

  1. Si la racine des documents pour la collection de recherche est différente de celle qui est utilisée pour la version 4, utilisez la commande suivante pour définir la racine des documents pour la collection de recherche.

    2. WebServer7-base/bin/wadm set-search-collection-prop --config=nomConfig --vs=nomServeurVirtuel --collection-name=nomCollectionRecherche document-root=nouveau chemin de la racine de documents pour la collection de recherche

    Les options de commande communes sont décrites dans le Tableau 7-7. Les options propres à la commande set-search-collection-prop sont décrites dans le tableau suivant :

    Tableau 7-12  Options et opérandes de la commande wadm set-search-collection-prop

    Option/Opérande

    Description

    config

    Nom de la configuration de la version 5 pour laquelle la racine des documents pour la collection de recherche est définie

    vs

    Nom du serveur virtuel auquel la collection de recherche correspond

    collection-name

    Nom de la collection de recherche pour laquelle le nouveau chemin de la racine des documents est défini

    document-root

    Chemin du nouveau répertoire de la racine des documents pour la collection de recherche

  2. Redéployez la configuration dans les instances de Web Server appropriées.

    3. WebServer7-base/bin/wadm deploy-config
    [--force] [--restart] [--no-reconfig]
    nomConfig

    Les options de commande sont décrites dans le Tableau 7-11.

Personnalisation des scripts de ligne de commande

Si des scripts tels que startsvr, startsvr.bat, stopsvr, stopsvr.bat, restart, reconfig et reconfig.bat ont été personnalisés, vous devrez réaliser les mêmes personnalisations sur les scripts par défaut de la version 5, lesquels se trouvent dans le répertoire suivant : WebServer7-base/bin.

Annulation de la mise à niveau

Web Server version 4 a été conservé intact par la nouvelle installation de la version 5 et la migration consécutive des configurations d’instance de Web Server. Par conséquent, l’annulation de la mise à niveau de Web Server version 5 se résume à la procédure de retour à la version 4.

  1. Connectez-vous en tant qu'utilisateur root ou superutilisateur.

    2. su -

  2. Exécutez toutes les instances Web Server en cours d’exécution, une par une.

    3. WebServer7Config-base/https-nomConfig/bin/stopserv

    Si le serveur a été arrêté correctement, vous obtenez un message indiquant “le serveur a été arrêté”.

  3. Supprimez l’installation de Web Server version 5.

    4. Vous devez supprimer toutes les instances et configurations migrées de la version 5.

    1. Supprimez toutes les instances de la version 5.

      2. WebServer7-base/bin/wadm delete-instance --user ...     --config=nomConfig nomHôte.nomDomaine

    2. Supprimez toutes les configurations de la version 5.

      3. WebServer7-base/bin/wadm delete-config --user ... nomConfig

  4. Redémarrez les instances de Web Server arrêtées lors de la mise à niveau de Web Server, comme le décrit la section Procédure de mise à niveau.

Mise à niveau de Web Server à partir de Java ES version 3

La procédure de mise à niveau de Web Server pour Java ES 2005Q1 vers la version 5 est la même que pour la mise à niveau de Web Server version 4 vers la version 5.

Pour mettre à niveau Web Server de la version 3 vers la version 5, suivez les instructions décrites dans la section Mise à niveau de Web Server à partir de Java ES version 4, mais remplacez chaque fois version 4 par version 3.

Mise à niveau de Web Server à partir de Java ES version 2

La procédure de mise à niveau de Web Server pour Java ES 2004Q2 (version 2) vers la version 5 est la même que pour la mise à niveau de Web Server version 4 vers la version 5.

Pour mettre à niveau Web Server de la version 2 vers la version 5, suivez les instructions décrites dans la section Mise à niveau de Web Server à partir de Java ES version 4, mais remplacez chaque fois version 4 par version 2.

Remarque

Si vous procédez à une mise à niveau de Web Server pour la version 2 sur la plate-forme Linux, il vous faudra procéder à une double mise à niveau (pour Web Server et le système d'exploitation). Web Server pour la version 5 n'est pas pris en charge sur RHEL 2.1. Pour plus d’informations, reportez-vous à la section Double mise à niveau.



Précédent      Contenu      Index      Suivant     

Numéro de référence : 819-6553-11
Juin 2007.   Copyright 2007 Sun Microsystems, Inc. Tous droits réservés.