Installation de Crystal Enterprise Embedded Edition Ce guide explique comment installer et configurer Crystal Enterprise Embedded Edition sur un système Windows en vue d'une utilisation avec IIS (Microsoft Internet Information Services) et des serveurs d'application Web J2EE pris en charge. Installation de Crystal Enterprise Embedded Edition 1
Présentation de l'installation Présentation de l'installation Le RAS (Report Application Server) qui est installé avec Crystal Enterprise Embedded Edition fournit aux développeurs Web un large éventail de services de création d'états basés sur serveur, permettant de traiter des états, de visualiser des états zéro client et de modifier des états lors de l'exécution. Utilisé conjointement avec Microsoft IIS et/ou des serveurs d'application Web J2EE pris en charge, le RAS répond aux demandes de création d'états effectuées via le Web par les utilisateurs. Cette souplesse d'utilisation permet aux développeurs Web de créer des applications Web ASP,.NET et JSP qui comportent les fonctionnalités de création d'états du RAS. Les services de création d'états sont fournis par les fonctionnalités RAS suivantes : Report Application Server (serveur RAS) Le serveur RAS fonctionne comme un service Windows et répond aux demandes de création d'états émises par le SDK du RAS. Selon les indications fournies, le serveur RAS ouvre les états Crystal (fichiers.rpt), les traite et les enregistre à l'aide du moteur d'impression de Crystal Reports. Le programme d'installation contient les mêmes pilotes de base de données, pilotes d'exportation et composants de création de cartes et diagrammes que ceux de Crystal Reports. Installez le serveur RAS sur votre serveur Web ou sur un autre ordinateur. Kit de développement du Report Application Server (SDK du RAS) Le SDK du RAS fournit les interfaces clientes COM, Java et.net par le biais desquelles les applications Web communiquent avec le serveur RAS et les visualiseurs d'états. Installez le SDK du RAS sur le serveur Web qui exécute votre code d'application. Si le serveur RAS est installé sur un autre ordinateur que le serveur Web, vous devez configurer le SDK du RAS de sorte qu'il puisse communiquer efficacement avec le serveur RAS. Le programme d'installation du RAS inclut les autres fonctionnalités suivantes : Exemples d'applications Cette option installe plusieurs exemples d'applications ASP, JSP, C# et VB.NET qui montrent comment utiliser le RAS. Installez les exemples d'applications et le SDK du RAS sur le même ordinateur. Par défaut, les exemples d'applications sont installés dans : C:\Program Files\Crystal Decisions\Report Application Server 10\Samples\ Exemples d'états Cette option installe plusieurs exemples d'états, un exemple de base de données ainsi qu'une connexion ODBC à la base de données. Les exemples d'applications utilisent ces états. Installez les exemples d'états et le serveur RAS sur le même ordinateur. 2 Installation de Crystal Enterprise Embedded Edition
Installation de Crystal Enterprise Embedded Edition Fichiers d'aide Cette option installe la documentation RAS destinée aux développeurs (des documents de référence, des didacticiels, des exemples de code, etc.), et ajoute le lien Documentation de Crystal Enterprise pour développeurs dans le groupe de programmes Crystal Enterprise 10 du menu Démarrer de Windows. Installez les fichiers d'aide sur l'ordinateur de développement. Astuce : Pour obtenir de la documentation complémentaire et d'autres exemples d'applications, spécifiques notamment au développement.net, visitez la page Developer Zone à l'adresse : http://www.crystaldecisions.com/products/dev_zone/ Installation des logiciels requis Avant de procéder à l'installation du RAS, vérifiez que votre environnement Web est installé et configuré correctement (Microsoft IIS pour le développement ASP et.net, ou un serveur d'application Web J2EE pris en charge pour le développement JSP). Installez tout logiciel client de base de données nécessaire sur chaque ordinateur où seront installés les composants du serveur RAS. Le programme d'installation détecte automatiquement le logiciel client de base de données pris en charge et installe d'autres fichiers s'il y a lieu. (Ces fichiers correspondent aux pilotes de base de données natifs qui permettent au moteur d'impression de Crystal Reports de communiquer avec votre logiciel client de base de données.) Pour obtenir la liste des environnements testés, consultez le fichier Platforms.txt fourni avec votre produit. Ce fichier répertorie les versions et les Service Pack requis pour les systèmes d'exploitation, les bases de données de création d'états, les serveurs Web, les serveurs d'application Web J2EE et les navigateurs Web pris en charge. Installation des composants RAS Installation sur un seul ordinateur Vous pouvez installer tous les composants RAS sur un seul ordinateur qui exécute IIS (Microsoft Internet Information Services) et/ou un serveur d'application Web J2EE pris en charge. Exécutez le programme d'installation et effectuez une installation Complète en suivant les instructions fournies à l'écran. L'installation Complète configure Microsoft IIS automatiquement, ce qui permet aux développeurs ASP et.net de découvrir les fonctionnalités aussitôt l'installation terminée. Pour en savoir plus, voir " Utilisation du Report Application Server ", page 8. Installation de Crystal Enterprise Embedded Edition 3
Installation des composants RAS En revanche, l'installation Complète ne configure pas automatiquement les serveurs d'application Web J2EE. Pour savoir comment effectuer la configuration, voir " Configuration des composants RAS ", page 5. Installation des composants SDK et serveur sur des ordinateurs distincts Vous pouvez répartir votre installation entre plusieurs ordinateurs ; pour cela, installez d'abord le serveur RAS sur un ou plusieurs ordinateurs, puis installez le SDK du RAS sur votre serveur Web ou sur les serveurs d'application Web J2EE. Lorsque vous séparez ainsi les différents composants, vous devez connecter le SDK du RAS au serveur RAS (en utilisant un fichier de configuration ou le code de l'application). Après avoir terminé les étapes de cette section, voir " Connexion du SDK du RAS aux serveurs RAS ", page 6. Pour installer le serveur RAS 1 Exécutez le programme d'installation du RAS sur l'ordinateur sur lequel vous souhaitez installer le serveur RAS. 2 Suivez les instructions fournies dans chaque boîte de dialogue du programme d'installation qui s'affiche, jusqu'à ce que vous atteigniez la boîte de dialogue Type d'installation. 3 Cliquez sur Personnalisée, et ensuite sur Suivant. 4 Dans la boîte de dialogue Sélection des fonctionnalités, assurez-vous que les fonctionnalités suivantes sont sélectionnées : Exemples d'états (facultatif) Report Application Server Vous pouvez changer l'ensemble de sous-fonctionnalités par défaut de cette fonctionnalité de manière appropriée à votre environnement de création d'états, ou installer l'intégralité de la fonctionnalité. 5 Désactivez toutes les autres fonctionnalités. 6 Cliquez sur Suivant et terminez l'installation selon les instructions affichées. Pour installer les SDK du RAS 1 Exécutez le programme d'installation du RAS sur un ordinateur sur lequel s'exécute Microsoft IIS ou un serveur d'application Web J2EE pris en charge. Remarque : Le programme d'installation installe les interfaces.net uniquement si le.net Framework est déjà installé sur l'ordinateur local. 2 Suivez les instructions fournies dans chaque boîte de dialogue du programme d'installation qui s'affiche, jusqu'à ce que vous atteigniez la boîte de dialogue Type d'installation. 3 Cliquez sur Personnalisée, et ensuite sur Suivant. 4 Installation de Crystal Enterprise Embedded Edition
Installation de Crystal Enterprise Embedded Edition 4 Dans la boîte de dialogue Sélection des fonctionnalités, assurez-vous que les fonctionnalités suivantes sont sélectionnées : Kit de développement de logiciels pour le Report Application Server Exemples d'applications (facultatif) Fichiers d'aide (facultatif) 5 Désactivez toutes les autres fonctionnalités. 6 Cliquez sur Suivant et terminez l'installation selon les instructions affichées. 7 Configurez le SDK du RAS pour qu'il communique avec votre serveur RAS. Pour en savoir plus, voir " Connexion du SDK du RAS aux serveurs RAS ", page 6. Configuration des composants RAS Une fois l'installation des composants RAS terminée, une configuration supplémentaire peut être nécessaire pour permettre l'exécution des exemples d'applications ou le développement avec le SDK du RAS : Pour le développement JSP, vous devez créer des répertoires virtuels et des fichiers JAR sur votre serveur d'application Web J2EE. Voir " Création des répertoires virtuels sur le serveur Web ", page 5 et " Accès aux SDK Java ", page 6. Si vous avez installé les composants RAS sur des ordinateurs distincts, vous devez configurer le SDK du RAS pour qu'il communique avec votre serveur ou vos serveurs RAS. Voir " Connexion du SDK du RAS aux serveurs RAS ", page 6. Création des répertoires virtuels sur le serveur Web Lorsque le programme d'installation du RAS détecte Microsoft IIS, il crée automatiquement des répertoires virtuels sous Site Web par défaut (accessible via le Gestionnaire des services Internet). Le programme d'installation du RAS n'apporte aucune modification de configuration à votre serveur d'application Web J2EE. Après l'installation, vous devez créer les répertoires virtuels requis comme indiqué dans la documentation de votre serveur d'application Web J2EE. Le RAS nécessite les répertoires virtuels suivants : /RASSamples10 Ce répertoire virtuel fournit l'accès au Report Application Server Launchpad et aux exemples d'applications installés. Dans le cas d'une installation par défaut, ce répertoire virtuel doit être mappé au répertoire suivant sur votre serveur Web : C:\Program Files\Crystal Decisions\Report Application Server 10\Samples\ Installation de Crystal Enterprise Embedded Edition 5
Configuration des composants RAS Accès aux SDK Java /crystalreportviewers10 Ce répertoire virtuel est requis par le SDK des visualiseurs. Dans le cas d'une installation par défaut, ce répertoire virtuel doit être mappé au répertoire suivant sur votre serveur Web : C:\Program Files\Fichiers communs\crystal Decisions\2.5\crystalreportviewers10\ Le programme d'installation installe un ensemble de fichiers JAR (Java Archive) qui constituent les SDK Java du RAS et des visualiseurs. Par défaut, les fichiers JAR sont installés dans le répertoire suivant : C:\Program Files\Fichiers communs\crystal Decisions\2.5\jars\ Avant d'exécuter une application Web du RAS, assurez-vous que tous les fichiers de ce répertoire sont accessibles à votre serveur d'application Web J2EE. Cette vérification s'effectue de différentes façons selon la configuration de votre environnement de développement : Copiez le contenu du répertoire dans un dossier qui est défini dans la variable d'environnement CLASSPATH de votre serveur d'application Web. Ajoutez ce repertoire à la variable d'environnment CLASSPATH de votre serveur d'application Web. Regroupez les fichiers JAR dans un fichier WAR (Web Archive) avec les fichiers source de votre application lorsque vous êtes prêt à déployer l'application. Remarque : Pour obtenir des instructions complètes sur la configuration de votre environnement Java, consultez la documentation fournie avec votre serveur d'application Web J2EE. Connexion du SDK du RAS aux serveurs RAS Si vous installez les composants sur des ordinateurs distincts, vous devez configurer le SDK du RAS pour qu'il communique efficacement avec un ou plusieurs serveurs RAS. Pour rechercher un serveur RAS, le SDK du RAS utilise en premier lieu les données du fichier de configuration clientsdkoptions.xml. Par défaut, le fichier clientsdkoptions.xml correspondant au développement ASP et.net se trouve dans le répertoire suivant : C:\Program Files\Crystal Decisions\Report Application Server 10\ Par défaut, le fichier clientsdkoptions.xml spécifique au développement Java se trouve dans le même répertoire que les fichiers JAR constituant le SDK : C:\Program Files\Fichiers communs\crystal Decisions\2.5\jars\ 6 Installation de Crystal Enterprise Embedded Edition
Installation de Crystal Enterprise Embedded Edition De même que tous les fichiers JAR, le fichier clientsdkoptions.xml doit être accessible à votre serveur d'application Web J2EE. Veillez à modifier une copie du fichier XML situé dans le même répertoire que les fichiers JAR utilisés par votre serveur d'application Web J2EE (voir " Accès aux SDK Java ", page 6). Pour configurer le fichier clientsdkoptions.xml 1 Ouvrez le fichier clientsdkoptions.xml approprié dans un éditeur de texte tel que le Bloc-notes, puis recherchez les lignes suivantes : <ServerInfo version="2" xsi:type="crystalreports.serverinfo" id="2"> <Server>NOM</Server> <Adapter>TCPIP</Adapter> </ServerInfo> Par défaut, le programme d'installation remplace la variable NOM par le nom de l'ordinateur sur lequel il a été exécuté. 2 Modifiez le fichier en fonction de la configuration de votre environnement : Pour connecter le SDK du RAS au Report Application Server exécuté sur un autre ordinateur, remplacez NOM par le nom de domaine complet de l'ordinateur sur lequel s'exécute votre Report Application Server. Pour répartir les demandes de création d'états de façon circulaire (méthode "round robin") entre plusieurs ordinateurs Report Application Server, ajoutez des éléments <ServerInfo> et augmentez la valeur de l'attribut id, comme indiqué dans l'exemple ci-dessous : <ServerInfo version="2" xsi:type="crystalreports.serverinfo" id="2"> <Server>SERVER01</Server> <Adapter>TCPIP</Adapter> </ServerInfo> <ServerInfo version="2" xsi:type="crystalreports.serverinfo" id="3"> <Server>SERVER02</Server> <Adapter>TCPIP</Adapter> </ServerInfo> Astuce : Vous pouvez remplacer la valeur Server définie dans le fichier clientsdkoptions.xml de manière dynamique, lors de l'exécution, par le biais du SDK du RAS. Cette technique est particulièrement utile si vous souhaitez que chaque application installée sur un serveur Web distinct utilise un serveur RAS qui lui est spécifique pour le traitement des états. Pour en savoir plus, voir "Setting up the development environment" dans le manuel Report Application Server COM SDK Guide ou le manuel Report Application Server Java SDK Guide installés avec le produit. Installation de Crystal Enterprise Embedded Edition 7
Utilisation du Report Application Server Utilisation du Report Application Server Une fois que vous avez installé le Report Application Server, vous pouvez accéder à différents outils à partir du groupe de programmes Crystal Enterprise 10 dans le menu Démarrer de Windows. Crystal Configuration Manager Le CCM (Crystal Configuration Manager) est un outil des gestion de serveurs qui permet de configurer des serveurs en vue d'une utilisation de produits Crystal sur Windows. Avec le CMM, vous pouvez démarrer et arrêter les serveurs ou encore afficher et configurer des paramètres serveur avancés. Le CCM est utilisé avec Crystal Enterprise, le Report Application Server et le Référentiel Crystal. Son aspect et ses fonctionnalités varient en fonction des composants des produits Crystal que vous avez installés. Le CCM comporte une aide en ligne qui décrit les fonctionnalités offertes par les différents composants de la famille de produits Crystal. En outre, cette aide en ligne explique comment effectuer les principales tâches de configuration des serveurs. Pour accéder à l'aide, démarrez le CCM et cliquez sur Aide (ou appuyez sur F1). Report Application Server Launchpad Le Report Application Server Launchpad est l'endroit à partir duquel vous pouvez découvrir et utiliser le Report Application Server ainsi que les exemples d'applications. Documentation de Crystal Enterprise pour développeurs Cette documentation SDK est constituée de documents de référence, de didacticiels et d'exemples de code qui expliquent aux développeurs comment créer des applications Web à l'aide des interfaces COM et Java qui sont installées avec le Report Application Server. Pour obtenir de la documentation complémentaire et d'autres exemples d'applications, spécifiques notamment au développement.net, visitez la page Developer Zone à l'adresse : http://www.crystaldecisions.com/products/dev_zone/ La documentation SDK installée de Crystal Enterprise montre également de quelle manière Crystal Enterprise étend les fonctionnalités fournies par le Report Application Server. Assistant d'enregistrement Crystal Utilisez cet assistant pour enregistrer votre produit auprès de Crystal Decisions, Inc. et accéder à divers autres services, tels que des exemples, des mises à jour du produit et des bulletins d'informations. 8 Installation de Crystal Enterprise Embedded Edition