Accessibility
 
Accueil / Produits / ColdFusion / Support / Notes de mise à jour
Macromedia ColdFusion Support Center Release Notes


ColdFusion MX Updater, Release 3
Notes de mise à jour Partie 1 -
Problèmes identifiés et instructions relatives à l'installation

19 mars 2003

Ce document contient des informations sur ColdFusion MX Updater, Release 3, qui est compatible avec ColdFusion MX Server et ColdFusion MX pour serveurs d'applications J2EE. Updater 3 est la première version de Updater pouvant être utilisée avec toutes les éditions et versions de ColdFusion MX.

Cette version de ColdFusion MX Updater ne prend pas en charge les versions de ColdFusion MX pour IBM WebSphere acquises via le programme de licences IBM Passport. Si vous avez acheté ColdFusion MX par l'intermédiaire de Passport, vous devez vous adresser directement à IBM pour obtenir une copie de Updater.

Les versions de Updater sont cumulatives. Updater 3 inclut toutes les corrections de Updater 1 et Updater 2. Par conséquent, vous n'êtes pas tenu d'installer Updater 1 ou 2 avant Updater 3. En outre, les bogues répertoriés dans les documents Partie 2 -- Problèmes corrigés dans cette version de Updater et Partie 3 -- Problèmes corrigés dans les versions précédentes de Updater sont résolus dans Updater 3.


Remarques
  • Pour plus de détails sur Updater, reportez-vous à la page FAQ (Forum Aux Questions) sur Updater.
  • Pour vérifier que Updater 3 est installé, lancez l'Administrateur ColdFusion MX et cliquez sur le lien Informations sur la version disponible en haut de la page. Dans la liste Détails sur le serveur de la page Informations sur la version, ColdFusion MX Server avec Updater 3 est identifié par le numéro de version 6,0,0,58500. ColdFusion MX pour serveurs d'applications J2EE avec Updater 3 est représenté par le numéro de version 6,0,0,58096.

En raison de leur volume, ces notes de mise à jour sont divisées en quatre parties.


Table des matières
Problèmes identifiés dans cette version
Installation de la mise à jour ColdFusion MX Server sous Windows
Installation de la mise à jour ColdFusion MX Server sous UNIX
Notes d'installation de ColdFusion MX Server
Installation de la mise à jour ColdFusion MX pour J2EE
Installation de la mise à jour avec un serveur web Apache

Autres parties des notes de mise à jour
Partie 2 -- Problèmes corrigés dans cette version de Updater
Partie 3 -- Problèmes corrigés dans les versions précédentes de Updater
Partie 4 -- Fichiers installés, désinstallation et installation silencieuse

Remarque : Dans ces notes de mise à jour, racine_cf fait référence au répertoire dans lequel ColdFusion est installé ou déployé. Par défaut, vous installez ColdFusion MX Server sous C:\CFusionMX (Windows) et sous /opt/coldfusionmx (UNIX). Vous déployez ColdFusion MX pour serveurs d'applications J2EE dans un répertoire dépendant du serveur d'applications.


 

Problèmes identifiés dans cette version

Les problèmes répertoriés ci-dessous ont été identifiés dans cette version de Updater. Ils s'ajoutent à tous ceux qui ont été recensés dans d'autres documents. Pour plus de détails sur les problèmes identifiés dans ColdFusion MX, consultez la ColdFusion MX TechNote Known ColdFusion MX Issues (Problèmes identifiés dans ColdFusion MX).


Problème ID
Si vous utilisez ColdFusion MX avec le serveur web Apache 2.0.x, vous devez disposer de la version 2.0.43 ou ultérieure pour pouvoir utiliser Updater 3 et de la version 2.0.44 pour pouvoir le tester. Si vous possédez une version antérieure, vous devez installer une mise à jour selon les instructions contenues dans la section Installation de la mise à jour avec un serveur web Apache. Updater 2 requiert les versions 2.0.41 à 2.0.43 et Updater 1 exige 2.0.40. N/A

Si vous installez Updater 3 avec ColdFusion MX pour J2EE et JRun 4 comme serveur d'applications, vous devez activer les services web de ColdFusion en recourant à l'une des méthodes suivantes :

Méthode 1 :

  • Remplacez le fichier racine_JRun\webservices.jar par le fichier racine_cf\WEB-INF\cfusion\lib\webservices.jar. Si, par exemple, racine_JRun correspond à C:\JRun4 et racine_cf correspond à C:\JRun4\servers\default\cfusion, copiez C:\JRun4\servers\default\cfusion\WEB-INF\cfusion\lib\webservices.jar dans C:\JRun4\lib et remplacez le fichier existant.

  • Remplacez la ligne includes du fichier racine_cf\WEB-INF\cfusion\lib\jrun.properties par la ligne suivante :
    includes=org.xml.,org.w3c.,org.apache.commons

Méthode 2 :

  • Modifiez le fichier WEB-INF/jrun-web.xml de chaque application J2EE dans l'instance de serveur JRun exécutant ColdFusion MX pour J2EE afin de définir l'élément enable-jrun-web-services à false. Ce changement de paramètre désactive la prise en charge du service web natif JRun.

    ColdFusion Updater ajoute cette entrée à l'application J2EE ColdFusion MX mais ne l'ajoute pas aux autres applications J2EE déployées sur la même instance de serveur JRun que ColdFusion MX. (L'application CFIDE installée si ColdFusion est déployé à une racine de contexte différente de / ne comporte pas de fichier jrun-web.xml et ne nécessite pas cette entrée.)

  • Par défaut, chaque serveur JRun inclut une application default-ear. Si vous avez spécifié une configuration par défaut et n'avez pas supprimé l'application default-ear de l'instance de serveur JRun exécutant ColdFusion, définissez l'élément enable-jrun-web-services à false dans le fichier racine_JRun\servers\cf_app_server_name\default-ear\default-war\WEB-INF\jrun-web.xml.

    Pour définir l'élément enable-jrun-web-services à false, ajoutez la ligne à un niveau supérieur, par exemple :

    < jrun-web-app>
         < enable-jrun-web-services>false</enable-jrun-web-services>
    ...

49694

Le problème qui suit s'applique uniquement à ColdFusion MX pour J2EE. Il ne concerne pas la version autonome de ColdFusion MX Server.

Pour les serveurs d'applications autres que IBM WebSphere 4, vous devez ajouter les informations ci-après au fichier de stratégie de sécurité de la JVM (java.policy), tel que /opt/jdk1.3.1_03/jre/lib/security/java.policy) :

grant codeBase "<file:racine_cf/WEB-INF/cfusion/lib/*>" {
permission java.security.AllPermission;
};
grant codeBase "<file:racine_cf/WEB-INF/lib/*>" {
permission java.security.AllPermission;
};

racine_cf représente l'emplacement déployé de l'archive d'application cfusion.war.

Ces informations se substituent à toutes les instructions d'installation de ColdFusion MX pour J2EE nécessitant l'octroi de toutes les autorisations sur l'ensemble des fichiers.

Pour plus d'informations, reportez-vous au correctif de l'entrée pour le bogue 48718.

48718
Si l'installation de Updater échoue prématurément, il se peut que le répertoire de sauvegarde soit incomplet. En effet, lorsque vous relancez Updater, votre ancienne configuration n'est pas correctement sauvegardée. Pour garantir l'intégrité de la sauvegarde lorsque vous relancez Updater après l'échec d'une mise à jour, supprimez tout d'abord le dossier racine_cf cfmx_updater/cfmx_updater_xx, où xx identifie le numéro de version de Updater (03 pour Updater 3, par exemple). 50119

Vous devez désormais inclure des caractères de soulignement dans les noms de paramètres des services web. Avant Updater 3, si le nom de paramètre d'un service web contenait des caractères de soulignement (_), il fallait les retirer du nom. Par exemple, pour spécifier le paramètre auction_id du service web EbayWatcherService, vous deviez spécifier auctionid. Désormais, vous devez inclure le caractère de soulignement dans le nom de paramètre (auction_id).

Ce changement s'avère nécessaire car ColdFusion MX utilisait précédemment une version bêta Axis qui ne traitait pas correctement les caractères de soulignement dans les noms WSDL. Updater 3 utilise désormais Axis 1.0 pour services web qui prend en charge les caractères de soulignement.

N/A
En raison de modifications liées au compilateur dans cette version de Updater, une partie du code de l'application ColdFusion doit être recompilée pour fonctionner correctement. Pour ce faire, le programme d'installation de Updater renomme le dossier cfclasses existant (situé au chemin racine_cf\wwwroot\WEB-INF) en cfclasses_backup. Pour plus de détails, reportez-vous aux Notes d'installation. 49999

Effectuez la tâche décrite ci-dessous si vous mettez à jour une installation ColdFusion MX pour J2EE Phase 1. (ColdFusion MX pour J2EE Phase 1 était constitué des versions originales de ColdFusion JRun 4, WebSphere Application Server version 4 et Sun ONE Web Server 6, et comprenait un programme d'installation intégré.)

Après avoir exécuté Updater et avant de démarrer l'Administrateur ColdFusion MX, ouvrez le fichier WEB-INF/cfusion/lib/wizzardconfig.xml dans l'éditeur de texte de votre choix et modifiez la valeur runsetup de true à false.

49725
Les connecteurs de serveur web inclus dans Updater 3 ne sont pas compatibles avec les versions antérieures de ColdFusion MX Server. N/A
Si vous utilisez le marqueur cfhttp pour récupérer des pages dans une langue autre que l'anglais, reportez-vous à l'entrée pour le bogue 47450. 47450
Le correctif du bogue 39460 révèle un bogue connu (numéro de bogue Oracle 984040) dans l'implémentation Oracle 8i de getUpdatecount(), ce qui peut entraîner l'arrêt du pilote OCI Oracle pour les mises à jour. Oracle a corrigé ce bogue dans Oracle8i Patch Set Version 8.1.7.4.1. Pour plus de détails, reportez-vous à la documentation du Patch Set sur le site web Oracle. 39460
Les utilisateurs qui obtiennent des avertissements Apache 1.3 EAPI doivent compiler une version EAPI du connecteur de serveur web Apache à partir de la source. Pour obtenir des instructions, reportez-vous au correctif du bogue 49684. 49684
46503
33365

Le problème décrit ci-dessous s'applique uniquement à la mise à jour de ColdFusion MX Server sous Windows ; il ne se pose pas pour les mises à jour de ColdFusion MX pour J2EE.

Si vous utilisez un serveur web autre que le serveur web intégré accompagnant ColdFusion MX et si jrun.exe est en cours d'exécution lors de l'installation de Updater, la procédure d'installation des connecteurs de serveur web risque de ne pas pouvoir remplacer le fichier Jrunwin32.dll, ce qui provoque le message d'erreur suivant :

Exception in thread "main" java.lang.UnsatisfiedLinkError: isIISJrunVirtualDir

Cette erreur peut également se produire si vous exécutez wsconfig.exe, wsconfig.jar ou tout fichier bat dans racine_cf/bin/connectors pour mettre à niveau un connecteur.

Si vous rencontrez ce problème, vérifiez que le serveur web et jrun.exe sont arrêtés et réinstallez la mise à jour. Pour plus de détails, reportez-vous à l'étape 3 de la section Installation de la mise à jour de ColdFusion MX Server sous Windows. Vous pouvez également consulter le journal racine_cf/runtime/lib/wsconfig/wsconfig.log pour vous assurer que le fichier jrunwin32.dll n'a pas été verrouillé par un autre processus et qu'il a été correctement remplacé.

50038
Si vous choisissez de ne pas configurer tous les sites web avec wsconfig.jar -uninstall et si vous reconfigurez aussitôt le connecteur, le programme d'installation du connecteur risque de ne pas reconnaître le serveur JRun en cours d'exécution et ce, particulièrement dans IIS. Dans ce cas, le message d'erreur suivant s'affiche : « Could not connect to any JRun servers on host localhost. Confirm that the JRun server is started. » (Impossible de se connecter à un serveur JRun sur l'hôte local (localhost). Confirmez le démarrage de JRun Server.).

A l'apparition de ce message d'erreur, redémarrez le serveur d'applications ColdFusion MX et relancez le programme d'installation du connecteur (wsconfig.jar).

50281
Le problème qui suit s'applique uniquement à ColdFusion MX pour J2EE. Il ne concerne pas ColdFusion MX Server :

La tentative de connexion à un serveur ou à une base de données SQL Server sous Windows configuré pour utiliser le code page 437 renvoie l'exception suivante : « [DataDirect][SQLServer JDBC Driver]Character set 437 not found in com.ddtek.util.transliteration.properties. » ([DataDirect][SQLServer JDBC Driver]Jeu de caractères 437 introuvable dans com.ddtek.util.transliteration.properties).

Pour résoudre ce problème, procédez comme suit :

  1. A l'invite de commande, définissez votre répertoire de travail à racine_cf/lib.

  2. Exécutez la commande suivante sur une seule ligne pour extraire le fichier transliteration.properties de macromedia_drivers.jar :

    jar -xf macromedia_drivers.jar macromedia/util/transliteration.properties

  3. Ajoutez les lignes suivantes au fichier obtenu racine_cf/lib/macromedia/util/tranliteration.properties :

    translit.type.437=VM
    translit.name.437=Cp437

  4. Exécutez la commande suivante sur une seule ligne pour mettre à jour macromedia_drivers.jar avec le fichier modifié transliteration.properties :

    jar -uf macromedia_drivers.jar macromedia/util/transliteration.properties

  5. Supprimez les répertoires racine_cf\lib\macromedia\util et racine_cf\lib\macromedia.
35691
48051
Les versions de ColdFusion MX sont incohérentes quant à la création ou non d'un objet de requête vide dont le nom est spécifié par l'attribut name lors d'un cfquery qui ne renvoie pas un ensemble d'enregistrements, tel qu'une requête de mise à jour. Le tableau qui suit énumère les versions pour lesquelles une requête vide est créée.

Version Renvoie une requête vide
ColdFusion 5 Non
ColdFusion MX Server Oui
ColdFusion MX Server avec Updater 2 Non
ColdFusion MX Server avec Updater 3 Non
ColdFusion MX pour J2EE Phase 1 Oui
ColdFusion MX pour J2EE Phase 2 Oui
ColdFusion MX pour J2EE avec Updater 3 Non
50329
La gestion des espaces blancs est prise en charge par ColdFusion MX pour J2EE avec JRun 4 mais elle est désactivée par défaut et vous ne pouvez pas la configurer dans l'Administrateur ColdFusion MX. Pour activer la gestion des espaces blancs, arrêtez ColdFusion MX et changez le paramètre de la première valeur booléenne dans le fichier racine_cf/WEB-INF/cfusion/lib/neo-runtime.xml à true :

<wddxPacket version='1.0'>
<header/>
<data>
<array length='11'>
<boolean value='true'/>

Une valeur booléenne définie à true permet l'activation de la gestion des espaces blancs contrairement à une valeur définie à false qui désactive la gestion des espaces blancs. Après modification et enregistrement du fichier, redémarrez ColdFusion MX.

50337

Retour à la table des matières



Installation de la mise à jour ColdFusion MX Server sous Windows

Cette section explique comment installer une mise à jour ColdFusion MX sur une plate-forme Windows. Prenez connaissance des Notes d'installation avant d'installer Updater.

Pour installer une mise à jour ColdFusion MX sous Windows :

  1. Veillez à installer le dernier Updater disponible pour ColdFusion MX. Pour plus de détails, reportez-vous à la page web http://www.macromedia.com/support/coldfusion.


  2. Fermez les applications actuellement actives sur votre ordinateur.


  3. Arrêtez les services suivants :
    • Serveur d'applications ColdFusion MX
    • Agent ODBC ColdFusion MX
    • Serveur ODBC ColdFusion MX
    • Service de publication World Wide Web (si vous utilisez IIS comme serveur web pour ColdFusion MX)
    • Le serveur web (si vous utilisez un serveur web autre que IIS ou le serveur web intégré accompagnant ColdFusion MX)

  4. Exécutez cfmx_updater_windows_r3.exe. L'assistant d'installation démarre.

  5. Suivez les instructions de l'assistant et laissez l'exécution se terminer.

    Remarque : Si vous n'avez pas arrêté IIS comme indiqué à l'étape 3, ColdFusion tente de mettre fin à chaque site individuellement et les redémarre après installation de la mise à jour. Ce processus peut prendre plus ou moins de temps en fonction du nombre de sites.


  6. Après l'installation du volet Résumé avant l'installation, Updater copie les fichiers mis à jour sur votre ordinateur et met à niveau tous les connecteurs de serveur web configurés.


  7. Une fois l'installation terminée, redémarrez les services arrêtés à l'étape 3. Vous devrez peut-être aussi redémarrer votre serveur web après l'exécution de Updater.
Retour à la table des matières


 

Installation de la mise à jour ColdFusion MX Server sous UNIX

Cette section explique comment installer une mise à jour ColdFusion MX sous UNIX. Prenez connaissance des Notes d'installation avant d'installer Updater.

Remarque : Ces instructions utilisent le terme général fichier_updater_cfmx pour faire référence au fichier Updater. Le nom de fichier Updater 3 spécifique varie selon le système d'exploitation, comme indiqué ci-après :

Linux cfmx_updater_linux_r3.bin
Solaris cfmx_updater_solaris_r3.bin
HPUX cfmx_updater_hpux_r3.bin

Pour installer une mise à jour ColdFusion MX sous UNIX :

  1. Veillez à installer le dernier Updater disponible pour ColdFusion MX. Pour plus de détails, reportez-vous à la page web http://www.macromedia.com/support/coldfusion.


  2. Connectez-vous en tant que racine (root).


  3. Arrêtez ColdFusion MX à l'aide de la commande suivante :
    /racine_cf/bin/coldfusion stop


  4. Arrêtez votre serveur web.

  5. A l'aide de la commande cd, passez au répertoire contenant le fichier Updater de ColdFusion MX.


  6. Modifiez le fichier Updater avec la commande suivante :
    chmod 755 fichier_updater_cfmx


  7. Démarrez l'installation à l'aide de la commande suivante :
    ./fichier_updater_cfmx
    Le programme d'installation démarre.

  8. Suivez les invites et laissez le programme se terminer.


  9. Au terme de l'installation, démarrez votre serveur web.

  10. Démarrez ColdFusion MX à l'aide de la commande suivante :
    /racine_cf/bin/coldfusion start.

 

Retour à la table des matières


 

Notes d'installation de ColdFusion MX Server

Dans les notes qui suivent, racine_web_cf fait référence au répertoire contenant le répertoire CFIDE de ColdFusion MX. Ce répertoire est généralement le répertoire racine de documents du serveur web actif. Par exemple, pour le serveur web interne ColdFusion MX, ce répertoire est racine_cf\wwwroot. Si ColdFusion MX utilise un autre serveur web, tel que Microsoft IIS ou Apache, le répertoire a peut-être un chemin différent. Une des étapes du programme d'installation de Updater vous permet de spécifier l'emplacement de ce répertoire.

  • Updater écrit les fichiers d'information suivants dans le répertoire racine_cf :

    Macromedia_ColdFusion_MX
    _Updater_InstallLog.log
    Fichier journal fournissant des détails sur l'installation, y compris sur les fichiers installés.
    cfmx_updater_installer_debug.txt Informations détaillées de débogage.

  • Updater vérifie la présence des fichiers suivants avant d'installer la mise à jour. Si l'un de ces fichiers est absent, Updater signale une erreur et n'installe pas la mise à jour.

    Sous Windows : racine_cf\bin\cfstart.bat
    racine_cf\lib\cfusion.jar
    racine_web_cf\CFIDE\administrator\Application.cfm
    Sous UNIX : racine_cf/bin/coldfusion
    racine_cf/lib/cfusion.jar
    racine_web_cf/CFIDE/administrator/Application.cfm

  • Updater place une copie de la version initiale de chaque fichier qu'il met à jour dans l'arborescence de répertoires racine_cf/cfmx_updater/cfmx_updater_XX. (XX est un nombre (01, par exemple) indiquant la mise à jour pour laquelle les fichiers de sauvegarde ont été enregistrés.) L'emplacement de chaque fichier dans cette arborescence reflète l'emplacement du fichier initial par rapport au répertoire racine_cf.
  • Si vous réinstallez une mise à jour qui a déjà créé des fichiers de sauvegarde, l'installation ne remplace pas les fichiers de sauvegarde d'origine.

  • En raison de modifications liées au compilateur dans cette version de Updater, une partie du code de l'application ColdFusion doit être recompilée pour fonctionner correctement. Pour ce faire, le programme d'installation de Updater renomme le dossier cfclasses existant (situé au chemin racine_cf\wwwroot\WEB-INF) en cfclasses_backup.

    Vous pouvez recompiler vos applications ColdFusion à l'aide du script updater_compile installé dans le répertoire racine_cf\bin. Cette recompilation permet d'améliorer le temps initial requis pour traiter les demandes de pages mais n'est pas indispensable pour le bon fonctionnement des applications ColdFusion. Exécutez ce script à l'aide des commandes suivantes :

    Windows :
    updater_compile.bat racine_web_cf [rép_fichiers_app_cf
    ]

    UNIX :
    ./updater_compile.sh -cfuser nomutil -webroot racine_web_cf
                        [-dir rép_fichiers_app_cf]

    racine_web_cf spécifie le répertoire web racine, tel que C:\inetpub\wwwroot.

    rép_fichiers_app_cf représente le répertoire contenant les fichiers CFML à compiler. Il doit se trouver en dessous du répertoire web racine. Si vous oubliez cet attribut, le script recompile toutes les pages ColdFusion du répertoire web racine et de ses sous-répertoires.

    Dans la commande UNIX, nomutil identifie l'utilisateur runtime ColdFusion et doit correspondre à l'utilisateur qui a installé ColdFusion MX (généralement nobody).

    Après avoir recompilé et testé vos applications avec brio, vous pouvez supprimer le dossier cfclasses_backup créé par l'installation.

  • Updater met automatiquement à niveau tous les connecteurs web configurés. Dans certains cas, il est conseillé de procéder à cette mise à niveau indépendamment de Upgrader (après l'installation d'un correctif de sécurité par exemple). Pour mettre à niveau les connecteurs sous Windows, exécutez le script racine_cf\bin\connectors\Upgrade_all_connectors.bat. Ce script ne possède pas d'argument.

Retour à la table des matières


Installation de la mise à jour ColdFusion MX pour J2EE

Cette section explique comment installer une mise à jour ColdFusion MX sur un système exécutant ColdFusion MX pour serveurs d'applications J2EE. Cette mise à jour s'applique à tous les systèmes d'exploitation et à toutes les versions de ColdFusion MX pour J2EE, y compris la première version (ou « phase 1 ») compatible uniquement avec Macromedia JRun 4, IBM WebSphere 4 et Sun One Web Server 6 et la deuxième version (ou « phase 2 ») à déployer en tant qu'archive.

Updater de ColdFusion MX pour J2EE remplace intégralement votre installation ColdFusion MX pour J2EE actuelle. Il effectue une sauvegarde de la configuration existante et des fichiers de l'application ColdFusion que vous restaurez ultérieurement. Il installe la mise à jour de ColdFusion MX pour J2EE.

Remarques :

  • Les procédures présentées dans cette section se rapportent aux instructions d'installation de ColdFusion MX pour J2EE sur votre serveur d'applications. Ces instructions sont disponibles en ligne à l'adresse URL http://www.macromedia.com/go/cfmxj2ee-cert_fr. La colonne Installation de fichiers d'archive du tableau « Serveurs d'applications J2EE pris en charge » contiennent des liens vers les instructions d'installation détaillées propres à chaque serveur pris en charge. (N'utilisez pas les liens proposés dans la colonne Installateur intégré.) La section « Serveurs d'applications non pris en charge pour l'installation d'archive » comprend des liens vers les instructions d'installation spécifiques à d'autres serveurs.

  • Updater remplace la Phase 1 de ColdFusion MX pour J2EE par une installation de format Phase 2. Par conséquent, la documentation relative à l'installation de la Phase 1 n'est plus valable. Recourez aux instructions d'installation de la Phase 2.
  • Veillez à installer le dernier Updater disponible pour ColdFusion MX pour J2EE. Pour plus de détails, reportez-vous à la page web http://www.macromedia.com/support/coldfusion.

  • Si vous installez Updater 3 avec ColdFusion MX pour J2EE et JRun 4 comme serveur d'applications, vous devez activer les services web de ColdFusion en recourant à l'une des méthodes énumérées pour le bogue 49694 dans la section Problèmes identifiés dans cette version.

  • Si vous installez Updater 3 avec ColdFusion MX pour J2EE et JRun 4 comme serveur d'applications, vous n'êtes pas tenu de suivre les instructions d'exécution de ColdFusion sur JRun 4 incluses dans les notes de mise à jour de JRun 4 SP1a.

Installation de Updater avec ColdFusion MX pour J2EE


  1. Fermez les applications actuellement actives sur votre ordinateur.


  2. Si vous exécutez Windows et prenez en charge les sources de données ODBC, arrêtez les services suivants :

       Agent ODBC ColdFusion MX
       Serveur ODBC ColdFusion MX


  3. En fonction de votre serveur d'applications, arrêtez l'application ColdFusion et l'application RDS (le cas échéant) ou bien arrêtez le serveur d'applications.

  4. Exécutez Updater avec ColdFusion MX pour J2EE.
    Lancez l'exécutable que vous avez téléchargé en fonction de Windows, Linux ou Solaris :

    Windows coldfusion-j2ee-win.exe
    Linux coldfusion-j2ee-linux.bin
    Solaris coldfusion-j2ee-solaris.bin

    Pour les autres plates-formes, exécutez le fichier coldfusion-j2ee-java.jar à l'aide de la commande suivante :

       java_home/java -jar coldfusion-j2ee-java.jar -i console

  5. Dans Updater, suivez les étapes d'installation des fichiers d'archive ColdFusion MX pour J2EE. Des instructions sont disponibles en ligne à l'adresse URL http://www.macromedia.com/go/cfmxj2ee-cert_fr. Si vous avez déjà effectué l'installation des fichiers d'archive (appelée aussi installation de la Phase 2), suivez les étapes d'installation de ColdFusion MX pour J2EE ; sélectionnez, par exemple, le déploiement de fichier EAR ou WAR en fonction de votre serveur J2EE.

    Updater prévoit des étapes supplémentaires par rapport au programme d'installation original de ColdFusion MX pour J2EE Phase 2 qui ne sont pas documentées dans les instructions d'installation de ColdFusion MX pour J2EE. Ces étapes sont les suivantes :

    1. Sélectionnez Oui à l'invite d'une création de sauvegarde de votre configuration et de vos fichiers personnalisés.

    2. Sélectionnez un répertoire de destination pour les fichiers de sauvegarde. Updater place dans ce répertoire une copie de tous les fichiers de l'arborescence de répertoires propre à l'application ColdFusion J2EE qu'il ne peut remplacer en toute sécurité (y compris les fichiers de configuration ou les fichiers ne faisant pas partie de l'installation ColdFusion). L'étape 9 décrit comment recopier ces fichiers dans l'application ColdFusion MX.

    3. Spécifiez le répertoire de déploiement de ColdFusion MX pour J2EE. Dans les instructions d'installation de ColdFusion, ce répertoire est souvent désigné par racine_cf. Il contient les répertoires CFIDE et WEB-INF (y compris WEB-INF\cfusion) et, si vous installez les exemples de ColdFusion, le répertoire cfdocs. Sur certains serveurs d'applications, il porte le même nom que la racine de contexte de l'application ColdFusion.


  6. Annulez le déploiement de l'application ColdFusion MX J2EE sur votre serveur d'applications par l'intermédiaire de la procédure d'annulation de déploiement standard de votre serveur d'applications.

  7. Déployez les fichiers EAR ou WAR que vous avez créés à l'étape 5 dans le même répertoire qu'utilisé précédemment sur votre serveur d'applications. Suivez les étapes de déploiement décrites dans les instructions d'installation de ColdFusion MX pour J2EE spécifiques à votre serveur d'applications. Limitez-vous aux étapes de déploiement. Veillez notamment aux éléments suivants :

    • N'ouvrez pas l'Administrateur ColdFusion MX ou n'exécutez pas l'assistant de démarrage.
    • Il n'est pas nécessaire de suivre les étapes post-déploiement des instructions d'installation de ColdFusion MX pour J2EE, telles que la configuration des paramètres de sécurité ou la prise en charge Verity.

  8. Arrêtez l'application ColdFusion J2EE si elle est en cours d'exécution. Sur certains serveurs d'applications, il est conseillé d'arrêter le serveur d'applications J2EE.

  9. Copiez les fichiers du répertoire de sauvegarde spécifié à l'étape 5b dans le répertoire racine_cf. Assurez-vous que les fichiers de l'arborescence de répertoires de sauvegarde remplacent les fichiers équivalents dans l'arborescence de répertoires racine_cf.

  10. Sur certains serveurs d'applications, il est conseillé de renommer le fichier racine_cf\WEB-INF\cfusion\lib\tools.jar (en tools.old par exemple). Pour vérifier la nécessité de cette étape, reportez-vous aux instructions d'installation de ColdFusion MX pour J2EE spécifiques à votre serveur d'applications.

  11. Lors de la mise à jour de ColdFusion MX pour J2EE exécuté sur un serveur de Phase 1 (à savoir doté de JRun 4, WebSphere Application Server version 4 ou Sun ONE Web Server 6), ouvrez le fichier WEB-INF/cfusion/lib/wizzardconfig.xml dans l'éditeur de texte de votre choix et modifiez la valeur runsetup de true à false.

  12. Redémarrez l'application ColdFusion J2EE ou le serveur J2EE.

  13. Si vous aviez arrêté certains services à l'étape 3, redémarrez-les. Vous devrez peut-être aussi redémarrer votre serveur web après l'exécution de Updater.
Retour à la table des matières


 

Installation de la mise à jour avec un serveur web Apache

Si vous utilisez une version du serveur web Apache antérieure à la version 2.0.43 avec ColdFusion MX Server ou ColdFusion MX pour J2EE avec JRun, vous devez installer une nouvelle version de Apache pour pouvoir utiliser ColdFusion MX. Par conséquent, vous devez installer une nouvelle version de Apache à moins d'avoir installé Updater 2 avec Apache 2.0.43.

Si vous devez installer une mise à jour du serveur web Apache, suivez la procédure présentée ci-dessous pour mettre à jour ColdFusion MX Server. Si vous utilisez JRun, conformez-vous aux procédures standard de désinstallation et d'installation d'un connecteur de serveur web.
  1. Désinstallez le connecteur de serveur web. A l'invite de commande, exécutez la ligne suivante.
    Sous Windows :
    racine_cf\runtime\jre\bin\java -jar racine_cf/runtime/lib/wsconfig.jar -v -u
    Sous UNIX :
    racine_cf/jre/bin/java -jar racine_cf/runtime/lib/wsconfig.jar -v -u

  2. Arrêtez ColdFusion MX.

  3. Installez Apache 2.0.43 ou une version ultérieure. La version que vous installez doit avoir la même valeur MODULE_MAGIC_NUMBER_MAJOR (numéro magique Apache) que la version 2.0.43.

  4. Installez ColdFusion MX Updater.

  5. Redémarrez ColdFusion MX.

  6. Installez le connecteur de serveur web sur la nouvelle installation de serveur web Apache à l'aide de la ligne suivante.
    Sous Windows :
    racine_cf\runtime\jre\bin\java -cp racine_cf/lib -jar racine_cf/runtime/lib/wsconfig.jar -ws Apache -dir rép_conf_Apache -v -map .cfm,.cfc.,.cfml -coldfusion
    Sous UNIX :
    racine_cf/jre/bin/java -cp racine_cf/lib -jar racine_cf/runtime/lib/wsconfig.jar -ws Apache -dir rép_conf_Apache -v -map .cfm,.cfc.,.cfml -coldfusion

Remarque : Pour déterminer le numéro magique Apache, exécutez l'une des commandes suivantes :

Sous Windows
racine_apache\bin\Apache.exe -V

Sous UNIX
racine_apache/bin/httpd -V | grep "Numéro magique"


Retour à la table des matières
Partie 2 -- Problèmes corrigés dans cette version de Updater
Partie 3 -- Problèmes corrigés dans les versions précédentes de Updater
Partie 4 -- Fichiers installés, désinstallation et installation silencieuse