ADOBE INDESIGN CS5 SERVER INTRODUCTION À ADOBE INDESIGN CS5 SERVER

Transcription

1 ADOBE INDESIGN CS5 SERVER INTRODUCTION À ADOBE INDESIGN CS5 SERVER

2 2010 Adobe Systems Incorporated. All rights reserved. Introduction à Adobe InDesign CS5 Server Note technique n If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement. The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide. Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure to obtain any permission required from the copyright owner. Any references to company names in sample templates are for demonstration purposes only and are not intended to refer to any actual organization. Adobe, the Adobe logo, InDesign, and Version Cue are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Mac OS is a trademark of Apple Computer, Incorporated, registered in the United States and other countries. Java is a trademark or registered trademark of Sun Microsystems, Incorporated in the United States and other countries. All other trademarks are the property of their respective owners. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Notice to U.S. Government End Users. The Software and Documentation are Commercial Items, as that term is defined at 48 C.F.R. 2,101, consisting of Commercial Computer Software and Commercial Computer Software Documentation, as such terms are used in 48 C.F.R. 12,212 or 48 C.F.R. 227,7202, as applicable. Consistent with 48 C.F.R. 12,212 or 48 C.F.R. 227, through 227,7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA , USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60, , and The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.

3 Sommaire Terminologie Feuille de route Documentation Création de scripts Java C COM Service Windows Démon launchd Performances et évolutivité Installation d InDesign Server Configuration système requise Exécution du programme d installation Ensemble de fonctions CJC Pare-feu Installation du service Windows InDesign Server (sous Windows uniquement) Installation du kit SDK d InDesign Server Exécution d InDesign Server Arguments d InDesign Server Lancement d InDesign Server à partir de la ligne de commande Lancement d InDesign Server pour une utilisation avec la technologie SOAP Lancement d InDesign Server pour une utilisation avec la technologie CORBA Lancement à partir d un autre programme ou d un autre script Exécution de plusieurs instances d InDesign Server Fermeture d InDesign Server Configuration du service Windows InDesign Server Configuration d un démon launchd InDesign Server pour Mac OS Communication avec InDesign Server basée sur la technologie SOAP Utilisation de sampleclient pour exécuter un script InDesign Server Communication avec InDesign Server basée sur la technologie Java Ecriture d un composant Java Exécution d une application Java d InDesign Server Communication avec InDesign Server par le biais d un module externe

4 Sommaire Communication avec InDesign Server basée sur la technologie COM (Windows uniquement) Visual Basic C# Communication avec InDesign Server basée sur la technologie LBQ Gestion des messages d erreur Accès aux erreurs et messages Redirection des erreurs et messages Etapes suivantes Création de scripts, modules externes et composants Java pour InDesign Server JavaScript SOAP Java CORBA Forum aux questions Puis-je spécifier un port SOAP et un fichier IOR lors du lancement du serveur? Existe-t-il un index de tous les objets et méthodes figurant dans l API Java d InDesign Server? Existe-t-il un index de toutes classes et méthodes figurant dans le modèle DOM de création de scripts d InDesign Server? Comment puis-je invoquer mon module externe depuis l API Java d InDesign Server? Puis-je interagir avec InDesign Server si je n utilise ni SOAP ni CORBA? Comment renvoyer une valeur de mon script à mon application SOAP client? Introduction à Adobe InDesign CS5 Server

5 Terminologie Introduction à Adobe InDesign CS5 Server Le présent document fournit une vue d ensemble d Adobe InDesign Server. Il explique comment installer et exécuter InDesign Server dans un environnement simple et décrit de manière concise comment communiquer avec InDesign Server à partir de composants externes. InDesign Server est utilisé par les intégrateurs système et les développeurs tiers pour créer des solutions de publication serveur. InDesign Server peut être considéré comme une version d InDesign sans interface utilisateur. InDesign Server utilise les mêmes bases de code que la version de bureau d InDesign, mais il a été adapté pour être utilisé comme serveur. Ses fonctionnalités incluent la prise en charge de plusieurs instances, la collecte et l enregistrement des erreurs, ainsi que la communication à l aide des technologies SOAP et CORBA (Common Object Request Broker Architecture). A l instar de la version de bureau, InDesign Server offre un environnement de développement perfectionné. Outre la prise en charge des standards ouverts tels que XML, InDesign Server se caractérise également par sa prise en charge performante des scripts et son évolutivité. En effet, les API fournies dans les kits SDK (Software Developer s Kit) des produits InDesign et le kit SDK d InDesign Server permettent d étendre facilement les fonctionnalités de ce produit. Ces API peuvent être utilisées pour la création de modules externes C++, de composants Java, de scripts JavaScript, de scripts AppleScript et de scripts VBScript. Terminologie Vous trouverez ci-dessous une définition des termes utilisés dans ce document. Ant : Another Neat Tool, un outil de construction Java. Client : émetteur d une demande de services depuis un serveur situé dans un système informatique distribué. CORBA : Common Object Request Broker Architecture, un modèle d objet distribué indépendant du langage. COM : Component Object Model, une technologie facilitant l interopérabilité des applications et des composants. IDS : InDesign Server. Fichier IOR : Interoperable Object Reference, un fichier de référence d objet interopérable. Ce fichier est utilisé par CORBA et ses clients pour identifier un objet dans le modèle d objet CORBA. IPv6 : Internet Protocol version 6, le successeur de l IPv4. L IPv6 est pris en charge par InDesign CS4 Server et les versions ultérieures. Job queueing (mise en file d attente des travaux) : mécanisme qui place les travaux envoyés dans une file d attente, les exécute de manière asynchrone et permet de vérifier ultérieurement l état d un travail. Load balancing (équilibrage des charges) : distribution des travaux sur plusieurs instances et serveurs en fonction des disponibilités. Introduction à Adobe InDesign CS5 Server 5

6 Feuille de route LBQ : module complémentaire introduit dans InDesign CS5 Server qui permet de mettre les travaux en file d attente et d équilibrer les charges de plusieurs instances d InDesign Server. ORB : Object Request Broker, un logiciel qui implémente le modèle d objet CORBA. <SDK> : chemin vers l emplacement dans lequel vous avez installé le kit SDK d InDesign Server. Serveur : fournisseur de services dans un système informatique distribué. Fenêtre d invite de commande : fenêtre de ligne de commande. Sous Windows, utilisez Invite de commandes (situé dans le dossier Accessoires du menu Démarrer). Sous Mac OS, utilisez l utilitaire Terminal (situé sous /Applications/Utilitaires). SOAP : Simple Object Access Protocol, un protocole de communication basé sur le langage XML permettant l échange de messages entre les programmes et les plates-formes. InDesign Server prend en charge plusieurs versions de SOAP : les versions standard 1.1 et 1.2 de SOAP (RPC et doc/lit) ainsi que le format WSDL 1.1. WSDL : Web Service Description Language, ou langage de description de services Web, un format reposant sur le langage XML qui permet de décrire comment accéder à un service Web et d indiquer les opérations restant à effectuer. Feuille de route Les sections suivantes portent sur l utilisation et sur l extension d InDesign Server. Documentation Le kit SDK d InDesign Server et le kit SDK des produits InDesign renferment des documents et exemples de code, qui vous aideront dans l extension d InDesign Server. Vous pouvez télécharger ces deux kits SDK sur le site Adobe.com. La documentation citée dans ce document est incluse dans les kits SDK. Création de scripts A l instar d InDesign, InDesign Server prend en charge l écriture de scripts JavaScript, AppleScript et VBScript. Ecriture d un script Les documents suivants vous guideront lors de l écriture de scripts InDesign Server : Didacticiel de scripts d Adobe InDesign CS5 Guide des scripts d Adobe InDesign CS5 Guide des scripts d Adobe InDesign CS5 Server Vous pouvez également accéder au document intitulé InDesign CS5 Object Model Viewer (Afficheur de modèles d objet d InDesign CS5) à partir du menu d aide d Adobe ExtendScript Toolkit CS5. 6

7 Feuille de route Exécution d un script InDesign Server propose une méthode SOAP, appelée RunScript, qui permet d envoyer un script à InDesign Server. Votre version d InDesign Server comprend un exemple d application SOAP client, appelé SampleClient, que vous pouvez utiliser pour exécuter un script. Voir la section «Utilisation de sampleclient pour exécuter un script InDesign Server», page 21. SampleClient repose sur le langage C++ ; son code source et ses fichiers de projet sont inclus dans le kit SDK des produits InDesign. Le kit SDK d InDesign Server contient d autres exemples de projets client fondés sur plusieurs langages, dont Java, C#, PHP, VB.NET et Flex. Java Ecriture d un composant Java InDesign Server comporte une API Java qui utilise la technologie CORBA pour communiquer avec InDesign Server. Pour plus de détails, voir la section «Communication avec InDesign Server basée sur la technologie Java», page 24 et la documentation intitulée Working with Adobe InDesign CS5 Server Java (Utilisation de la technologie Java d Adobe InDesign CS5 Server). C++ Ecriture d un module externe C++ InDesign Server repose sur le langage C++ et prend en charge les modules externes C++ développés à l aide de l API C++ d InDesign. Pour plus de détails, voir la section «Communication avec InDesign Server par le biais d un module externe», page 26, ainsi que les documents intitulés Adobe InDesign CS5 Programming Guide (Guide de programmation Adobe InDesign CS5) et Adobe InDesign CS5 Server Plug-in Techniques (Techniques de création de modules externes pour Adobe InDesign CS5 Server). Accès à votre module externe à l aide de la création de scripts ou de Java Pour que votre module externe soit accessible à partir d un script ou d un composant Java, il doit prendre en charge les scripts. Pour plus de détails, voir le chapitre «Scriptable Plug-in Fundamentals» (Eléments fondamentaux du module externe pour scripts) de la documentation Adobe InDesign CS5 Programming Guide (Guide de programmation Adobe InDesign CS5). Pour accéder à votre module externe à partir d un composant Java, vous devez également régénérer le fichier JAR de l API Java (InDesignServerAPI.jar) ainsi que le module externe de prise en charge de la technologie CORBA, comme décrit dans la documentation intitulée Regenerating the Adobe InDesign CS5 Server Java API (Régénération de l API Java d Adobe InDesign CS5 Server). COM InDesign Server publie une bibliothèque de types à utiliser pour créer des composants COM qui interagissent avec InDesign Server. Les composants COM peuvent être créés dans plusieurs langages. Pour plus de détails sur l utilisation de Visual Basic et de C#, voir la section «Communication avec InDesign Server basée sur la technologie COM (Windows uniquement)», page 27. Introduction à Adobe InDesign CS5 Server 7

8 Installation d InDesign Server Service Windows Démon launchd Vous pouvez utiliser un service Windows pour gérer InDesign Server. Pour avoir recours à ce service, commencez par installer InDesignServerService comme décrit à la section «Installation du service Windows InDesign Server (sous Windows uniquement)», page 10. Utilisez ensuite le composant logiciel enfichable Microsoft Management Console d InDesign Server pour configurer InDesignServerService. Utilisez un démon launchd pour gérer InDesign Server sous Mac OS. Pour plus de détails sur la configuration d un démon, voir la section «Configuration d un démon launchd InDesign Server pour Mac OS», page 18. Performances et évolutivité La documentation et les outils relatifs aux performances et à l évolutivité d InDesign Server sont disponibles dans le kit SDK d InDesign Server. Installation d InDesign Server Avant d installer InDesign Server, assurez-vous que votre système est conforme à la configuration requise. Exécutez ensuite le programme d installation obtenu via le système ESD (Electronic Software Download, distribution électronique de logiciels). Une fois l installation terminée, exécutez InDesign Server à partir de la ligne de commande comme décrit à la section «Exécution d InDesign Server», page11. Veuillez noter que la sérialisation d InDesign Server intervient sur la ligne de commande au premier lancement, à l aide de l argument -serialnumber. Configuration système requise Pour plus de détails sur la configuration système requise pour l exécution d InDesign Server, voir le fichier Lisez-moi de l application. Pour exécuter le service Windows InDesign Server, vous devez disposer de Microsoft.NET Framework version 2.0 ou ultérieure. Pour écrire un code Java utilisant l API Java d InDesign Server, vous devez disposer du kit JDK (Java Development Kit) version ou ultérieure. 8

9 Installation d InDesign Server Exécution du programme d installation Après avoir téléchargé et développé le système ESD (Electronic Software Download, distribution électronique de logiciels) pour InDesign Server, cliquez deux fois sur l icône du programme d installation pour l exécuter. Suivez les instructions affichées à l écran. Pendant l installation, vous pouvez spécifier le dossier dans lequel installer InDesign Server ou utiliser l emplacement par défaut. Sous Windows uniquement, lorsque vous installez InDesign Server sur un système d exploitation 64 bits, la version 64 bits de l application est installée par défaut ; vous pouvez toutefois choisir d'installer la version 32 bits d InDesign Server. Lors d une installation sur un système d exploitation 32 bits, seule la version 32 bits d InDesign Server peut être installée. Ensemble de fonctions CJC Pare-feu Pour la composition, InDesign Server utilise l ensemble de fonctions activé Romain (anglais) ou Japonais (CJC). Sous Windows, des paramètres de registre permettent de spécifier l ensemble de fonctions. Mac OS inclut, quant à lui, deux applications : l une activant l ensemble de fonctions Romain et l autre activant l ensemble de fonctions CJC. Lors de l installation d InDesign Server sur une version anglaise de Windows, l ensemble de fonctions par défaut est défini sur Romain. Lors de l installation sur une version chinoise de Windows (par exemple), l ensemble de fonctions par défaut est défini sur CJC. Lors de l installation sur une version anglaise de Windows, si vous choisissez le chinois comme langue dinstallation, l ensemble de fonctions par défaut est défini sur CJC. Vous pouvez changer l ensemble de fonctions par défaut en exécutant regedit et en modifiant les clés suivantes (modifiez le numéro de version, le cas échéant) : Application 32 bits sous Windows 32 bits : HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\InDesign Server\<version> Application 64 bits sous Windows 64 bits : HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\InDesign Server\<version> Application 32 bits sous Windows 64 bits : HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Adobe\InDesign Server\<version> Définissez la clé Feature Set Locale Setting sur 400 pour Romain ou sur 401 pour CJC. Le paramètre est appliqué au lancement d InDesign Server. Vous devez configurer de manière appropriée tout pare-feu existant entre un ordinateur (un serveur) exécutant InDesign Server et les clients du serveur, afin que ces derniers puissent établir une connexion avec le serveur. Pour plus de détails, voir la documentation de votre pare-feu ou contactez votre administrateur réseau. Introduction à Adobe InDesign CS5 Server 9

10 Installation d InDesign Server Installation du service Windows InDesign Server (sous Windows uniquement) Le service Windows InDesign Server surveille des instances données d InDesign Server et les relance si elles sont interrompues ou si l ordinateur est redémarré. Il redirige les messages dindesign Server vers le journal d événements Windows et autorise la visualisation locale ou à distance de ces messages. Ce service autorise également la configuration des instances d InDesign Server avec un nom et un mot de passe utilisateur différent des nom et mot de passe de l utilisateur actuel. Vous pouvez installer ce service Windows à l aide du programme d installation d InDesign Server ou à partir d une ligne de commande. Dans le premier cas, il vous suffit d exécuter le programme d installation d InDesign Server et de sélectionner l option d installation des fichiers du service Windows pour InDesign Server. Dans le second cas, définissez le dossier dans lequel vous avez installé InDesign Server comme répertoire actif, puis exécutez la commande suivante : InDesignServerService /install Pour désinstaller le service Windows InDesign Server à l aide de la ligne de commande, définissez le dossier contenant InDesign Server comme répertoire actif, puis exécutez la commande suivante : InDesignServerService /install /u Le second composant du service Windows InDesign Server est le composant logiciel enfichable Microsoft Management Console. Si vous avez installé le service à l aide du programme d installation d InDesign Server, le composant logiciel enfichable a également été installé. Si vous avez utilisé la ligne de commande pour installer le service, vous devez également installer le composant logiciel enfichable, comme décrit dans cette section. Pour installer le composant logiciel enfichable sur un ordinateur 32 bits, exécutez la commande suivante : regsvr32 InDesignServerMMC.dll Pour l installer sur un ordinateur 64 bits, exécutez la commande suivante : regsvr64 InDesignServerMMC64.dll Pour désinstaller le composant logiciel enfichable Microsoft Management Console d InDesign Server, utilisez la même procédure, en ajoutant un argument de ligne de commande supplémentaire : regsvr32 InDesignServerMMC.dll /u ou regsvr64 InDesignServerMMC.dll /u Pour plus de détails sur la configuration du composant logiciel enfichable, voir la section «Configuration du service Windows InDesign Server», page 16. Installation du kit SDK d InDesign Server Le kit SDK d InDesign Server contient des exemples, des scripts, ainsi que la documentation d InDesign Server. Vous pouvez télécharger le kit SDK d InDesign Server depuis le site Adobe.com. Si vous le souhaitez, vous pouvez déplacer le dossier du kit SDK après l avoir configuré. 10

11 Exécution d InDesign Server Exécution d InDesign Server Vous pouvez lancer InDesign Server à partir d une ligne de commande ou d un autre programme ou script. Chaque méthode autorise des arguments de ligne de commande qui contrôlent l exécution et la configuration d InDesign Server. Arguments d InDesign Server Les arguments de ligne de commande d InDesign Server vous permettent de configurer divers aspects d InDesign Server. La syntaxe de la ligne de commande suit le schéma ci-dessous ; chaque argument est décrit dans le Tableau 1 : InDesignServer [arguments] TABLEAU 1 Arguments de ligne de commande d InDesign Server Argument -configuration name Description Facultatif. Cet argument spécifie le nom de configuration de cette instance d InDesign Server. Utilisé par InDesign Server lors de la création du dossier de configuration dans lequel sont stockées les données privées, le cache et les fichiers de configuration, name doit désigner un nom de dossier valide du système actif. Par défaut, le nom de ce dossier est «configuration_noport» ou «configuration_n», n correspondant au numéro de port (si l option -port est spécifiée). Le dossier de configuration est créé dans : Sous Windows : C:\Documents and Settings\<nom d utilisateur>\application Data\ Adobe\InDesign Server\<version>\<langue>\ Sous Windows Vista et Windows Server 2008 : C:\Users\<nom d utilisateur>\appdata\roaming\adobe\indesign Server\<version>\<langue>\ Sous le service Windows, le dossier de configuration est créé dans : Sous Windows : C:\Documents and Settings\All Users\Application Data\ Adobe\InDesign Server\<version>\<langue>\ Sous Windows Vista et Windows Server 2008 : C:\ProgramData\Adobe\InDesign Server\<version>\<langue>\ Sous Mac OS, le dossier de configuration est créé dans : /Users/<nom d utilisateur>/library/preferences/adobe InDesign Server/<version>/<langue>/ Introduction à Adobe InDesign CS5 Server 11

12 Exécution d InDesign Server Argument -[no]console -[no]errorlist -help -iorfile filepath -LogToApplicationEventLog -maxerrors number -pluginpath path[,path] Description Facultatif. Sous Windows uniquement. Cet argument crée une nouvelle fenêtre de console (une interface de commande) et redirige stderr et stdout vers cette fenêtre. Si -noconsole est spécifié, stdout et stderr sont acheminés jusqu au terminal (ou la fenêtre) qui a lancé InDesign Server. Cet argument se révèle utile lorsque vous utilisez le débogueur de Microsoft Visual Studio pour déboguer un module externe InDesign Server en cours de développement. En effet, les données écrites dans stderr et stdout sont supprimées par défaut par le débogueur. Cet argument peut également se révéler utile lorsque vous lancez InDesign Server depuis une autre application, comme un serveur d applications. Il n est disponible qu avec InDesignServer.exe et non avec InDesignServer.com. L option par défaut est -noconsole. Facultatif. Cet argument détermine si InDesign Server doit stocker les erreurs de script d appels SOAP dans la mémoire. La liste d erreurs n est pas effacée automatiquement ; si cette liste contient trop d erreurs, les nouvelles erreurs seront perdues. L option par défaut est -noerrorlist. Facultatif. Affiche une courte description de tous les arguments. Cet argument est indispensable si vous utilisez la technologie Java/CORBA ; sinon, il est facultatif. Il indique à InDesign Server où créer le fichier contenant la référence IOR de l objet Application. La référence IOR de ce fichier permet à un client de créer une référence à l objet Application d InDesign Server. Vous pouvez le considérer comme un cookie que votre code client utilise pour accéder à l objet Application d InDesign Server. Chaque instance du serveur requiert un fichier IOR unique. De nombreux clients accèdent à un serveur donné à l aide du fichier IOR de ce serveur. L affichage du message «[serveur] Writing IOR to...» (Ecriture du fichier IOR en cours sur...) confirme l écriture de la référence IOR dans le fichier spécifié. Facultatif. Sous Windows, cet argument dirige les sorties de la console d InDesign Server vers le journal d événements d applications de Windows. Vous pouvez les visualiser dans l Observateur d événements d applications par défaut accessible depuis le Panneau de configuration de l outil Gestion de l ordinateur. Sous Macintosh, cet argument est conseillé si vous utilisez InDesign Server en tant que démon launchd. Vous pouvez visualiser les sorties dans la console standard de Mac OS. Facultatif. number spécifie le nombre maximum d erreurs de script des appels SOAP qu InDesign Server doit stocker en mémoire. Le nombre par défaut est Cet argument est indispensable si vous utilisez la technologie Java/CORBA ; sinon, il est facultatif. Il commande au serveur de charger tous les modules externes dans les dossiers et sous-dossiers correspondants spécifiés. Lorsque vous indiquez le sous-répertoire server/corba installé, le module externe de prise en charge de la technologie Corba d InDesign Server est chargé et activé. path est un chemin relatif basé sur le dossier d installation d InDesign Server (par exemple, l indication «Server/Corba» fait référence au dossier C:\Program Files\Adobe\Adobe InDesign CS5 Server\Server\Corba). N utilisez jamais un chemin absolu. L affichage du message «[serveur] ApplicationIOR :...» confirme le bon chargement du module externe de prise en charge de la technologie Corba. 12

13 Exécution d InDesign Server Argument -port number -[no]previews -[no]seh -[no]sendcrashlogs -serialnumber number Description Cet argument est indispensable si vous utilisez le protocole SOAP ; sinon, il est facultatif. Il s agit du numéro de port du socket utilisé par InDesign Server pour traiter les requêtes SOAP envoyées par les applications clientes. S il n est pas spécifié, le système ne peut utiliser aucun port et ne peut donc traiter aucune requête SOAP. Chaque instance d InDesign Server exécutée sur un même système doit disposer d un port unique pour activer la technologie SOAP. Le numéro de port doit être une valeur entière positive. Facultatif. Cet argument précise si une prévisualisation est nécessaire ou non lors de l importation d images. L option par défaut est -nopreviews. Facultatif. Sous Windows uniquement. Cet argument spécifie l utilisation ou non d un SEH (structured exception handling). L option par défaut est -seh. Sous Mac OS uniquement. Cet argument envoie automatiquement des journaux d incidents à Adobe. L option par défaut est -nosendcrashlogs. Cet argument entre le numéro de série de l application. Il ne doit être utilisé qu une seule fois pour déverrouiller l application. Lancement d InDesign Server à partir de la ligne de commande 1. Ouvrez une nouvelle fenêtre d invite de commande sur le système sur lequel InDesign Server est installé. Sous Windows, utilisez Invite de commandes ; sous Mac OS, utilisez l utilitaireterminal. 2. Définissez le dossier dans lequel InDesign Server est installé comme répertoire actif. Sous Windows, le dossier contient l application InDesignServer.com. Sous Mac OS, le dossier contient le package d applications InDesignServer.app. Par exemple : Sous Windows : cd "c:\program Files\Adobe\Adobe InDesign CS5 Server\" Sous Mac OS : cd '/Applications/Adobe InDesign CS5 Server/' 3. Exécutez la commande ci-dessous. (Sous Windows, InDesignServer.com est exécuté par défaut. L application configure les chemins et exécute InDesignServer.exe.) InDesignServer 4. InDesign Server affiche les messages de lancement dans la fenêtre d invite de commande. Une fois InDesign Server prêt à être utilisé, le message «[serveur] Server Running» (Serveur en cours d exécution) s affiche à l écran. Pendant l exécution, les messages, de même que les erreurs, sont affichés dans la fenêtre d invite de commande. Cette fenêtre peut donc servir au suivi d InDesign Server. Introduction à Adobe InDesign CS5 Server 13

14 Exécution d InDesign Server Lancement d InDesign Server pour une utilisation avec la technologie SOAP Si votre flux de travail implique l utilisation de scripts pour pouvoir fonctionner en interaction avec InDesign Server, ce flux envoie très vraisemblablement des scripts à InDesign Server par l intermédiaire de la technologie SOAP. Pour communiquer avec InDesign Server par l intermédiaire de cette technologie, vous devez utiliser l argument -port au lancement d InDesign Server. Dans l exemple de ligne de commande suivant, le numéro de port «12345» peut être remplacé par celui de votre choix. InDesignServer -port Au lancement, InDesign Server doit afficher le message suivant : "[soap] Servicing SOAP requests on port " Il indique qu InDesign Server est prêt à accepter les requêtes SOAP. Lancement d InDesign Server pour une utilisation avec la technologie CORBA Si votre flux de travail implique l utilisation du langage Java pour pouvoir fonctionner en interaction avec InDesign Server, vous devez lancer InDesign Server pour une utilisation avec la technologie CORBA. L API Java d InDesign Server fait appel au module externe de prise en charge de la technologie CORBA pour toute communication avec InDesign Server. L utilisation d un fichier texte, dans lequel une chaîne représente une référence IOR d identification unique d un objet dans CORBA, facilite la communication entre l API et InDesign Server. Une fois l instance d InDesign Server initialisée, la référence IOR est écrite pour l objet Application associé dans le fichier texte spécifié. En utilisant la référence IOR contenue dans le fichier IOR, un client peut instancier un objet de proxy pour l objet Application d InDesign Server. Pour lancer InDesign Server en vue d une utilisation avec la technologie CORBA, ajoutez les arguments -iorfile et -pluginpath à la ligne de commande. Le chemin spécifié par -pluginpath dépend du chemin de l application InDesign Server. Au lancement, InDesign Server crée le fichier texte spécifié et écrit la référence IOR pour l objet Application associé dans le fichier. Vous devez pour cela disposer d un droit d accès en écriture au chemin de fichier. Dans l exemple de ligne de commande suivant, remplacez c:\ior.txt (Windows) ou ~/ior.txt (Mac OS) par le chemin de fichier de votre choix. Sous Windows : InDesignServer -iorfile c:\ior.txt -pluginpath Server\Corba Sous Mac OS : InDesignServer -iorfile ~/ior.txt -pluginpath Server/Corba Au lancement, InDesign Server doit afficher les messages suivants : "[server] ApplicationIOR:..." "[server] Writing IOR to..." Ils indiquent qu InDesign Server est prêt à accepter les commandes CORBA et que vous pouvez accéder à la référence IOR de l objet Application d InDesign Server à partir du fichier spécifié. 14

15 Exécution d InDesign Server Lancement à partir d un autre programme ou d un autre script Vous pouvez lancer InDesign Server en tant que processus à partir d un autre programme ou d un autre script. Sous Windows, InDesign Server est généralement exécuté à l aide de l application InDesignServer.com et non d InDesignServer.exe. La version avec l extension.com diffère de la version avec l extension.exe en ce sens qu elle configure les chemins requis vers le dossier omniorb indispensable à l implémentation CORBA d InDesign Server. La version avec l extension.exe ne configure pas ces chemins. Vous risquez donc de devoir ajouter le dossier omniorb à la variable d environnement PATH pour pouvoir lancer cette application. Exécution de plusieurs instances d InDesign Server Si votre site traite un volume important de requêtes InDesign Server, vous pouvez augmenter votre débit en exécutant plusieurs instances d InDesign Server sur un même système. En règle générale, le nombre maximum d instances d InDesign Server exécutable sur un même ordinateur correspond au nombre de cœurs de processeur de l ordinateur plus un. Pour plus de détails, voir la documentation intitulée Adobe InDesign Server CS5 Performance and Scalability (Performances et évolutivité d Adobe InDesign Server CS5) du kit SDK d InDesign Server. Pour exécuter plusieurs instances, vous devez attribuer à chacune un nom de configuration unique. Pour ce faire, utilisez l argument -configuration et indiquez un nom unique pour chaque instance. Lorsque vous exécutez InDesign Server à partir d une ligne de commande, vous devez utiliser une fenêtre distincte pour chaque instance. A partir d une fenêtre d invite de commande, lancez la première instance en exécutant la commande suivante : InDesignServer -configuration myids1 Ensuite, ouvrez une nouvelle fenêtre d invite de commande et exécutez la commande suivante pour la seconde instance : InDesignServer -configuration myids2 Exécution de plusieurs instances pour une utilisation avec la technologie SOAP Si plusieurs de vos applications communiquent avec InDesign Server grâce à la technologie SOAP, vous devez affecter à chaque instance d InDesign Server un numéro de port différent. Dans les exemples ci-dessous, il n est pas nécessaire de spécifier l argument -configuration. En effet, InDesign Server crée un nom de configuration à partir du port spécifié (comme décrit à la section «Arguments d InDesign Server», page 11). Dans les exemples suivants, les noms de configuration «configuration_18383» et «configuration_18555» sont créés. Vous pouvez exécuter la première instance à l aide de la ligne de commande suivante : InDesignServer -port Vous pouvez ensuite exécuter une seconde instance à l aide de la ligne de commande suivante : InDesignServer -port Vous pouvez choisir d attribuer ou non à chaque instance un nom de configuration unique. Cependant, l utilisation de SOAP requiert absolument un numéro de port unique. Par exemple : InDesignServer -configuration myids3 -port Introduction à Adobe InDesign CS5 Server 15

16 Exécution d InDesign Server Exécution de plusieurs instances pour une utilisation avec la technologie CORBA Si plusieurs de vos applications communiquent avec InDesign Server en utilisant la technologie Java/CORBA, vous devez attribuer à chaque instance d InDesign Server un fichier texte IOR et un nom de configuration distincts. Dans les exemples suivants, des fichiers texte IOR et des noms de configuration uniques sont créés pour chaque instance. Sous Windows, vous pouvez exécuter la première instance à l aide de la ligne de commande suivante : InDesignServer -configuration myids1 -iorfile c:\ids\ior_1.txt -pluginpath Server/Corba Vous pouvez ensuite exécuter une seconde instance à l aide de la ligne de commande suivante : InDesignServer -configuration myids2 -iorfile c:\ids\ior_2.txt -pluginpath Server/Corba Sous Mac OS, vous pouvez exécuter la première instance à l aide de la ligne de commande suivante : InDesignServer -configuration myids1 -iorfile /IDS/ior_1.txt -pluginpath Server/Corba Vous pouvez ensuite exécuter une seconde instance à l aide de la ligne de commande suivante : InDesignServer -configuration myids2 -iorfile /IDS/ior_2.txt -pluginpath Server/Corba Fermeture d InDesign Server Il existe plusieurs façons de quitter InDesign Server : Appuyez sur Ctrl+C dans la fenêtre Invite de commandes (utilitaire Terminal sous Mac OS), où InDesign Server a été lancé. Envoyez un script à InDesign Server lui commandant de s arrêter à l aide de l événement de fermeture de l application. Par exemple, le script JavaScript suivant commande à InDesignServer de s arrêter sans enregistrer les documents ouverts : app.quit(saveoptions.no); Si l instance d InDesign Server a été lancée à partir du service Windows InDesign Server, vous pouvez interrompre le service et mettre ainsi fin à toutes les instances d InDesign Server lancées par le service. Configuration du service Windows InDesign Server Pour lancer, arrêter et configurer le service Windows InDesign Server, sélectionnez la catégorie Services de la console de gestion standard de Microsoft. Pour lancer cette console, cliquez avec le bouton droit de la souris sur Poste de travail > Gérer ou cliquez sur le menu Démarrer et sélectionnez Outils d administration > Gestion de l ordinateur. Dans la fenêtre de gestion de l ordinateur, sélectionnez Services et applications, puis Services. Dans la liste de services, cliquez deux fois sur InDesignServerService. La boîte de dialogue Propriétés s affiche alors à l écran. Elle vous permet de lancer, d arrêter ou d interrompre momentanément le service, de modifier l ouverture de session ou le mode de démarrage du service. 16

17 Exécution d InDesign Server Dans l onglet Connexion, Microsoft recommande l utilisation du paramètre le moins privilégié permettant au service d accomplir ses tâches. Dans ce cas, ces tâches incluent la lecture et l écriture dans le dossier Documents and Settings ainsi qu à l emplacement des documents utilisés par le serveur, l ouverture d un port et la lecture des paramètres de registre. Loption Compte système local est plus privilégiée que LocalService ; vous devez donc d abord essayer de définir l option Ce compte sur LocalService (par exemple, NT AUTHORITY\LocalService). Dans l onglet Récupération, il est conseillé de laisser les paramètres définis sur Ne rien faire. Le service est ainsi relancé en cas de défaillance. Si le service fonctionne correctement, les instances d InDesign Server associées à des ports/configurations spécifiés ont déjà été lancées. En cas de défaillance du service, et si les instances d InDesign Server continuent de fonctionner, la nouvelle instance du service n en sera pas informée et tentera de lancer de nouvelles instances d InDesign Server ; le lancement échouera, les ports/configurations tant déjà utilisés. Ces paramètres n affectent pas le traitement des instances d InDesign Server par le service en cas de défaillance ; cette tâche est configurée par l intermédiaire des paramètres de registre MaximumFailureCount, MaximumFailureIntervalInMinutes et TrackFailures dans HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\InDesignCS5ServerWinSe rvice. Composant logiciel enfichable Management Console d InDesign Server Le second composant du service Windows est le composant logiciel enfichable Management Console d InDesign Server Pour ajouter le composant à une console de gestion, cliquez deux fois sur le ficher InDesignServerService.msc de votre installation InDesign Server. Vous pouvez également l ajouter manuellement en exécutant l application Windows mmc.exe et en sélectionnant Fichier > Ajouter/Supprimer un composant logiciel enfichable. Une liste de tous les composants logiciels enfichables MMC disponibles s affiche alors. Si ce n est pas le cas, cliquez sur Ajouter. Sélectionnez InDesignCS5ServerService dans la liste pour l ajouter à la console active. Fermez la boîte de dialogue Ajouter/Supprimer un composant logiciel enfichable. Pour ajouter une instance InDesign Server à la console, cliquez avec le bouton droit de la souris sur InDesignCS5ServerService dans le volet gauche de la console et sélectionnez Nouveau > Nouvelle instance InDesign Server. La nouvelle instance hérite des paramètres d échec de la dernière instance. Un numéro de port lui est attribué, correspondant au numéro de port le plus élevé des instances InDesignCS5ServerService existantes plus un. La ligne de commande par défaut est vide. Pour modifier la configuration d une instance (numéro de port ou ligne de commande), cliquez deux fois sur l instance dans le volet droit. La ligne de commande doit suivre le schéma indiqué à la section «Lancement d InDesign Server à partir de la ligne de commande», page 13, à l exception de l argument -port qui est défini par l entrée de port et qui ne doit donc pas être utilisé. Pour que plusieurs instances d InDesign Server puissent coexister sur un même ordinateur, chacune doit être associée à un port ou à un nom de configuration unique ; vous devez pour cela modifier les paramètres du service relatifs au port et à la ligne de commande. Bien que d ordinaire seuls le port et les paramètres de ligne de commande aient besoin d être modifiés, d autres paramètres peuvent être modifiés à partir des paramètres de registre de l instance du service. Ces paramètres sont les suivants : Introduction à Adobe InDesign CS5 Server 17

18 Exécution d InDesign Server MaximumFailureCount : nombre de tentatives de redémarrage d une instance en cas d échec. MaximumFailureIntervalInMinutes : temps alloué à MaximumFailureCount, en minute. InDesign Server doit échouer plus de MaximumFailureCount fois en MaximumFailureIntervalInMinutes pour que le service interrompe les tentatives de redémarrage. TrackFailures : il s agit d une valeur booléenne. Si cette valeur est égale à 1 (valeur par défaut), le service tente de relancer InDesign Server ; si elle est égale à 0, le service ne fait rien. Pour modifier les paramètres, exécutez regedit et passez en revue les clés dans HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\InDesignCS5ServerWinSe rvice. Un ensemble de clés (par exemple, 065c361a-0cbe-4917-bf b ) doit être associé à chaque instance configurée à l aide d InDesignServerService.msc ou du composant logiciel enfichable Console Management. Configuration d un démon launchd InDesign Server pour Mac OS InDesign Server peut être lancé en tâche de fond (démon) sous Mac OS, sans devoir être contrôlé directement par l utilisateur final. L exécution d InDesign Server en tant que démon vous permet de configurer le lancement de l application au démarrage du système d exploitation et de définir des options de redémarrage en cas de défaillance. Pour configurer le démon, créez un fichier de configuration de liste de propriétés (plist) contenant les paramètres souhaités et installez-le dans le dossier LaunchAgents ou LaunchDaemons, selon votre choix. Fichier de configuration launchd Pour créer un fichier de configuration launchd, saisissez le contenu XML dans un éditeur de texte, comme spécifié ci-dessous. Enregistrez le fichier en utilisant le nom du démon comme nom de fichier et.plist comme extension (par exemple, com.adobe.ids.launchd plist). Vous pouvez également modifier un fichier plist dans l utilitaire XCode Property List Editor, situé sous Développeur/Applications/Utilitaires. Le Tableau 2 présente les paramètres requis pour un démon launchd InDesign Server. Pour obtenir la liste complète des options launchd, voir la page du manuel sur launchd. 18

19 Exécution d InDesign Server TABLEAU 2 Paramètres du démon InDesign Server Label OnDemand ProgramArguments RunAtLoad Identifiant unique de votre démon (par exemple, com.adobe.ids.launchd.12345). Ce paramètre doit être défini sur false pour qu InDesign Server redémarre après une fermeture ou une défaillance. Série de chaînes représentant les arguments utilisés au lancement de l application. Le chemin complet vers l application constitue le premier élément de la série. Les arguments utilisés au lancement d InDesign Server à partir de la ligne de commande constituent le reste des éléments. Pour recevoir les sorties de la console à partir d InDesign Server, vous devez utiliser l argument -LogToApplicationEventLog. Ce paramètre est défini sur true. InDesign Server est lancé une fois le démon chargé, au démarrage du système ou manuellement à l aide de launchctl. EXEMPLE 1 Format xml du fichier plist Les lignes suivantes représentent le contenu XML d un fichier de configuration plist qui exécute InDesign Server avec le port SOAP : <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" " <plist version="1.0"> <dict> <key>label</key> <string>com.adobe.ids.launchd.12345</string> <key>ondemand</key> <false/> <key>programarguments</key> <array> <string>/applications/adobe InDesign CS5 Server/InDesignServer</string> <string>-port</string> <string>12345</string> <string>-logtoapplicationeventlog</string> </array> <key>runatload</key> <true/> </dict> </plist> Introduction à Adobe InDesign CS5 Server 19

20 Exécution d InDesign Server Installation du fichier de configuration Pour installer un fichier de configuration launchd, il vous suffit de le copier dans le dossier approprié de l ordinateur où InDesign Server sera exécuté. Vous pouvez disposer de plusieurs fichiers de configuration de démon, un pour chaque instance d InDesign Server à exécuter. Pour une installation type d InDesign Server, exécutez Mac OS X Server sans comptes utilisateur. Dans ce cas, copiez le fichier de configuration à l emplacement suivant : /Library/LauchDaemons Pour exécuter InDesign Server à l aide d un compte utilisateur, copiez le fichier plist dans le dossier LaunchAgents, lui même placé dans le dossier système ou utilisateur Bibliothèque (vous devrez peut-être créer le dossier utilisateur LaunchAgents) : /Library/LaunchAgents /Users/<nom d utilisateur>/library/launchagents Chargement du démon Une fois le fichier plist copié dans le dossier de lancement, redémarrez le système pour qu il charge le démon automatiquement. Une fois le démon chargé, InDesign Server est lancé à laide des paramètres spécifiés dans le fichier plist. Pour confirmer le chargement du démon, utilisez la commande suivante dans la fenêtre de l utilitaire Terminal : launchctl list Si l identifiant apparaît, cela signifie que le démon a été chargé correctement. Pour confirmer qu InDesign Server est en cours d exécution, vous pouvez utiliser le Moniteur d activité, qui affiche tous les processus actifs. Vous pouvez charger manuellement le démon à l aide de la commande launchctl : launchctl load /Library/LaunchDaemons/com.adobe.ids.launchd plist Déchargement du démon Vous pouvez décharger le démon manuellement à l aide de launchctl ; cette action n entraîne cependant pas la fermeture de l instance d InDesign Server : launchctl unload /Library/LaunchDaemons/com.adobe.ids.launchd plist Pour quitter l instance d InDesign Server, envoyez à InDesign Server un script lui commandant de s arrêter ou utilisez le Moniteur d activité pour fermer le processus. 20