ADOBE INDESIGN CS6 EINFÜHRUNG IN DIE ENTWICKLUNG MIT ADOBE INDESIGN CS6 SERVER

Transkript

1 ADOBE INDESIGN CS6 EINFÜHRUNG IN DIE ENTWICKLUNG MIT ADOBE INDESIGN CS6 SERVER

2 2012 Adobe Systems Incorporated. All rights reserved. Einführung in die Entwicklung mit Adobe InDesign CS6 Server 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, InCopy, and InDesign are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Windows is either a registered trademark or a trademark 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. 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 , consisting of Commercial Computer Software and Commercial Computer Software Documentation, as such terms are used in 48 C.F.R or 48 C.F.R , as applicable. Consistent with 48 C.F.R or 48 C.F.R through , 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 Inhalt 1 Einführung in Adobe InDesign Server Adobe InDesign Server Erste Schritte Terminologie Roadmap Dokumentation Skripte C COM Windows-Dienst launchd-daemon Leistung und Skalierbarkeit Installieren und Ausführen von InDesign Server Installieren von InDesign Server Systemanforderungen Ausführen des Installationsprogramms CJK-Funktionssatz Firewalls Installieren des InDesign Server Windows-Dienstes (nur Windows) Installieren des InDesign Server-SDK Ausführen von InDesign Server Befehlszeilenargumente für InDesign Server Starten von InDesign Server von der Befehlszeile aus Starten von InDesign Server für die Verwendung mit SOAP Starten von InDesign Server für die Verwendung mit CORBA Starten von einem anderen Programm oder Skript aus Ausführen mehrerer InDesign Server-Instanzen Beenden von InDesign Server Konfigurieren des InDesign Server Windows-Dienstes Konfigurieren eines launchd-daemons für InDesign Server unter Mac OS Integration von InDesign Server Integration von InDesign Server über SOAP Verwenden von SampleClient zum Ausführen eines InDesign Server-Skripts Integration mit InDesign Server über ein Zusatzmodul Integration mit InDesign Server über COM (nur Windows) Visual Basic C# Integration von InDesign Server über LBQ

4 4 Handhabung von Fehlermeldungen Zugreifen auf Fehler und Meldungen Umleiten von Fehlern und Meldungen Häufig gestellte Fragen Kann ich sowohl einen SOAP-Anschluss als auch eine IOR-Datei festlegen, wenn ich den Server starte? Gibt es ein Verzeichnis aller Klassen und Methoden in der Skript-DOM von InDesign Server? Kann ich mit InDesign Server kommunizieren, wenn ich es ohne SOAP starte? Wie gebe ich einen Wert von meinem Skript an den SOAP-Client zurück? Nächste Schritte InDesign Server-Skripterstellung und -Zusatzmodule JavaScript SOAP

5 1 Einführung in Adobe InDesign Server Dieses Dokument bietet einen Überblick über Adobe InDesign Server. Es wird beschrieben, wie InDesign Server in einer einfachen Umgebung installiert und ausgeführt wird und wie Sie über externe Komponenten mit InDesign kommunizieren können. Adobe InDesign Server Erste Schritte Terminologie InDesign Server wird von Systemintegratoren und Lösungsentwicklern verwendet, um serverbasierte Lösungen für Veröffentlichungen zu erstellen. Sie können sich InDesign Server als eine InDesign-Version ohne Benutzeroberfläche vorstellen. Es ist auf der gleichen Codebasis aufgebaut wie die Desktop-Version von InDesign, wurde aber an die Serververwendung angepasst. Die Anpassung beinhaltet den Support mehrerer Instanzen, die Fehlererfassung und -protokollierung sowie Kommunikation über SOAP. Wie das Desktop-Gegenstück bietet InDesign Server eine funktionsreiche Entwicklungsumgebung. Die Software unterstützt offene Standards, wie z. B. XML, und ist hochgradig skriptfähig und erweiterbar. InDesign Server kann durch Verwendung der APIs aus den SDKs der InDesign-Zusatzmodule und der InDesign Server-Skripterstellung erweitert werden. Diese APIs können verwendet werden, um C++-Zusatzmodule, JavaScript-Skripte, AppleScript-Skripte und VBScript-Skripte zu erstellen. Informationen zu ersten Schritten, zum Inhalt des Installationsverzeichnisses des InDesign Server-SDK und zur Verwendung der im SDK enthaltenen Beispiele finden Sie im Dokument Getting Started with the Adobe InDesign Server SDK. In diesem Abschnitt finden Sie eine Definition der Begriffe, die in diesem Dokument verwendet werden: Ant Another Neat Tool, ein auf Java basierendes Programmierungswerkzeug. Client Ein Modul, das Dienste von einem Server in einem verteilten Computersystem anfordert. COM Component Object Model, eine Technologie, die das Zusammenspiel von Anwendungen und Komponenten fördert. IDS InDesign Server. <IDS> Der Ordner, in dem Sie InDesign Server installiert haben. <IDS SDK> Der Ordner, in dem Sie das InDesign Server-SDK installiert haben. InDesign Server-SDK Enthält verschiedene Technologien zum Arbeiten mit InDesign Server, wie zum Beispiel SOAP. Die gesamte InDesign Server-Dokumentation ist in diesem SDK enthalten. InDesign-Skript-DOM Skript-Objektmodell. Dieses bezieht sich auf Objekte in InDesign und ihre Hierarchie, nach der sie von einem Skript aus aufgerufen werden. InDesign-Skript-SDK Die API für den Zugriff auf das Skript-DOM. 5

6 KAPITEL 1: Einführung in Adobe InDesign Server Roadmap 6 IOR-Datei Interoperable Object Reference-Datei. Diese wird von CORBA und den Clients verwendet, um ein Objekt im CORBA-Objektmodell zu identifizieren. IPv6 Internet Protocol Version 6, der Nachfolger von IPv4. IPv6 wird von InDesign CS4 Server und höher unterstützt. Auftragswarteschlange Ein Mechanismus, der eingereichte Aufträge in Warteschlangen stellt, sie asynchron ausführt und eine Möglichkeit bietet, den Auftragsstatus später zu prüfen. Lastverteilung Das Verteilen von Aufträgen auf mehrere Instanzen und Server je nach Verfügbarkeit. <locale> Gibt in einem Pfad die Sprachversion von InDesign Server an, zum Beispiel deutsch. LBQ Lastverteilung und Auftragswarteschlangen. Eine Add-On-Komponente, die für mehrere IDS-Instanzen Aufträge in Warteschlangen stellt und Lastverteilung durchführt. Server Der Dienstleister in einem verteilten Computersystem. Shell-Fenster Ein Befehlszeilen-Fenster. Unter Windows verwenden Sie die Eingabeaufforderung (im Ordner Zubehör des Startmenüs). Unter Mac OS verwenden Sie das Dienstprogramm Terminal (unter /Programme/Dienstprogramme ). <Scripting SDK> Der Ordner, in dem Sie das InDesign Skript-SDK installiert haben. <SDK> Der Ordner, in dem Sie das InDesign-Zusatzmodul-SDK installiert haben. SOAP Simple Object Access Protocol, ein XML-basiertes Protokoll für den Austausch von Meldungen zwischen Programmen und Plattformen. InDesign Server unterstützt verschiedene Versionen von SOAP: die branchenüblichen SOAP-Versionen 1.1 und 1.2 (RPC und doc/lit) sowie WSDL 1.1. <version> Gibt in einem Pfad die Versionsnummer von InDesign Server an, zum Beispiel steht 8.0 für CS6. WSDL Web Service Description Language, ein XML-basiertes Format zur Beschreibung, wie auf einen Webdienst zugegriffen werden kann und welche Vorgänge dieser durchführt. Roadmap In diesem Abschnitt finden Sie eine Übersicht über verschiedene Möglichkeiten für die Arbeit mit und die Erweiterung von InDesign Server sowie Verweise auf weiterführende Informationsquellen zu den jeweiligen Themen. In den anderen Abschnitten dieses Dokuments finden Sie zusätzliche Informationen. Dokumentation Skripte Die SDKs von InDesign-Zusatzmodulen und InDesign-Skripterstellung enthalten Dokumentation und Beispielcodes, die die Erweiterung von InDesign Server erklären und veranschaulichen. Beide SDKs können von adobe.com heruntergeladen werden. Die in diesem Dokument genannten Dokumente sind ebenfalls in den SDKs zu finden. Wie InDesign bietet InDesign Server Skriptsupport für JavaScript, AppleScript und VBScript.

7 KAPITEL 1: Einführung in Adobe InDesign Server Roadmap 7 Schreiben eines Skripts Wenn Sie lernen möchten, InDesign Server-Skripte zu schreiben, lesen Sie die folgenden Dokumente: Adobe InDesign Scripting Tutorial Adobe InDesign Scripting Guide Adobe InDesign Server Scripting Guide Außerdem können Sie über das Hilfemenü von Adobe ExtendScript Toolkit auf den InDesign Object Model Viewer zugreifen. Ausführen eines Skripts InDesign Server stellt eine einzige SOAP-Methode bereit, RunScript, über die ein Skript an InDesign Server gesendet wird. Die Installation von InDesign Server umfasst einen einfachen SOAP-Client, SampleClient, den Sie zur Ausführung von Skripten verwenden können. Siehe Verwenden von SampleClient zum Ausführen eines InDesign Server-Skripts auf Seite 21. SampleClient wurde in C++ programmiert. Sein Quellcode ist im Produkt-SDK von InDesign enthalten. Das InDesign Server-SDK umfasst andere Client-Beispielprojekte, die in verschiedenen Sprachen programmiert sind, darunter C#, PHP, VB.NET und Flex. C++ Schreiben eines C++-Zusatzmoduls InDesign Server ist in C++ geschrieben und bietet Support für C++-Zusatzmodule, die mit der InDesign C++-API entwickelt wurden. Weitere Informationen finden Sie unter Integration mit InDesign Server über ein Zusatzmodul auf Seite 24 im Adobe InDesign Plug-In Programming Guide sowie unter InDesign Server Plug-in Techniques im Dokument Getting Started with Adobe InDesign Plug-In Development. Aufrufen eines Zusatzmoduls von einem Skript aus Um ein Zusatzmodul von einem Skript aus aufzurufen, muss das Zusatzmodul skriptfähig sein. Weitere Informationen finden Sie im Kapitel Scriptable Plug-in Fundamentals im Adobe InDesign Plug-In Programming Guide. COM InDesign Server veröffentlicht eine COM-Typenbibliothek, mit der COM-Komponenten mit Schnittstelle zu InDesign Server entwickelt werden können. COM-Komponenten können in verschiedenen Programmiersprachen entwickelt werden. In diesem Dokument wird unter Integration mit InDesign Server über COM (nur Windows) auf Seite 25 kurz auf die Verwendung von Visual Basic und C# eingegangen. Windows-Dienst Sie können InDesign Server über einen Windows-Dienst verwalten. Um den Dienst verwenden zu können, müssen Sie zunächst InDesignServerService installieren (siehe Installieren des InDesign Server Windows-Dienstes (nur Windows) auf Seite 10). Sie können dann InDesignServerService mit dem InDesign Server Microsoft Management Console-Snap-In konfigurieren.

8 KAPITEL 1: Einführung in Adobe InDesign Server Roadmap 8 launchd-daemon Unter Mac OS können Sie InDesign Server über einen launchd-daemon verwalten. Anweisungen zur Konfiguration eines Daemons finden Sie unter Konfigurieren eines launchd-daemons für InDesign Server unter Mac OS auf Seite 18. Leistung und Skalierbarkeit Dokumentation zur Leistung und Skalierbarkeit von InDesign Server sowie entsprechende Werkzeuge finden Sie im InDesign Server-SDK. Weitere Informationen finden Sie im Dokument Getting Started with the Adobe InDesign Server SDK.

9 2 Installieren und Ausführen von InDesign Server In diesem Kapitel wird beschrieben, wie Adobe InDesign Server installiert, ausgeführt und konfiguriert wird. Installieren von InDesign Server Bevor Sie InDesign Server installieren, überprüfen Sie Ihr System, um sicherzustellen, dass es den entsprechenden Anforderungen entspricht. Führen Sie dann das Installationsprogramm aus, das vom ESD (Electronic Software Download; Elektronisches Software-Downloadprogramm) zur Verfügung gestellt wird. Nach der Installation können Sie InDesign Server über die Befehlszeile ausführen (wie unter Ausführen von InDesign Server auf Seite 11 beschrieben). Beachten Sie, dass die Eingabe der Seriennummer für InDesign Server beim ersten Start über die Befehlszeile durch Übergabe des Arguments -serialnumber erfolgt. Systemanforderungen Eine detaillierte Auflistung der Systemanforderungen für InDesign Server finden Sie in der Datei Bitte lesen der Anwendung. Wenn Sie den InDesign Server Windows-Dienst ausführen möchten, ist Microsoft.NET Framework Version 2.0 oder höher erforderlich. Ausführen des Installationsprogramms Sobald Sie das InDesign Server-ESD heruntergeladen und extrahiert haben, können Sie das Installationsprogramm ausführen, indem Sie auf das Symbol des Programms doppelklicken. Folgen Sie den Anweisungen auf dem Bildschirm. Während der Installation können Sie festlegen, wo Sie InDesign Server installieren möchten, oder den Standardspeicherort verwenden. Unter Windows steht InDesign Server CS6 nur in einer 64-Bit-Version zur Verfügung. Unter Mac OS steht InDesign Server CS6 nur in einer 32-Bit-Version zur Verfügung. CJK-Funktionssatz InDesign Server führt den Textsatz auf der Grundlage des aktivierten Funktionssatzes durch: Latein (Englisch) oder Japanisch (CJK). Unter Windows wird der aktivierte Funktionssatz über die Registrierungseinstellungen festgelegt. Unter Mac OS gibt es für beide Funktionssätze jeweils eine separate Anwendung. Beim Installieren von InDesign Server auf einem englischen Windows-Betriebssystem wird standardmäßig der Funktionssatz Latein verwendet. Beim Installieren von InDesign Server beispielsweise auf einer chinesischen Version von Windows wird standardmäßig der Funktionssatz CJK verwendet. Wenn beim Installieren von InDesign Server auf einer englischen Version von Windows Chinesisch als Installationssprache gewählt wird, wird standardmäßig der Funktionssatz CJK verwendet. Sie können den Standard-Funktionssatz ändern, indem Sie regedit ausführen und die folgenden Schlüssel ändern. (Passen Sie die Versionsnummer entsprechend an.) 9

10 KAPITEL 2: Installieren und Ausführen von InDesign Server Installieren von InDesign Server 10 Firewalls 64-Bit-Anwendung unter 64-Bit-Windows: HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\InDesign Server\<version> Setzen Sie den Schlüssel für die Funktionssatz-Ländereinstellung auf 400 (Latein) bzw. 401 (CJK). Die Einstellung ist nach dem nächsten Start von InDesign Server aktiviert. Alle Firewalls, die zwischen dem Computer (Server) mit InDesign Server und den Clients des Servers bestehen, müssen entsprechend konfiguriert werden, damit die Clients Verbindungen zum Server herstellen können. Weitere Informationen finden Sie in der Dokumentation zu der Firewall. Sie können sich jedoch auch an Ihren Netzwerk-Systemadministrator wenden. Installieren des InDesign Server Windows-Dienstes (nur Windows) Der InDesign Server Windows-Dienst überwacht angegebene Instanzen von InDesign Server und startet sie neu, wenn sie beendet werden oder der Computer neu gestartet wird. Er leitet InDesign Server- Meldungen zum Windows-Ereignisprotokoll weiter und ermöglicht so ein lokales und externes Abrufen der Meldungen. Instanzen von InDesign Server können mit einem Benutzernamen und einem Kennwort, die sich von denen des aktuellen Computerbenutzers unterscheiden, konfiguriert werden. Der InDesign Server Windows-Dienst kann entweder mit dem InDesign Server-Installationsprogramm oder über die Befehlszeile installiert werden. Wenn Sie das Installationsprogramm verwenden, führen Sie einfach das InDesign Server-Installationsprogramm aus und wählen Sie die entsprechende Option, um die Dienst-Dateien für InDesign Server zu installieren. Bei einer Installation über die Befehlszeile wechseln Sie zu dem Ordner, in dem Sie InDesign Server installiert haben, und führen Sie folgenden Befehl aus: InDesignServerService /install Um den InDesign Server Windows-Dienst über die Befehlszeile zu deinstallieren, wechseln Sie zum Ordner von InDesign Server und führen Sie folgenden Befehl aus: InDesignServerService /install /u Die zweite Komponente des InDesign Server Windows-Dienstes ist das InDesign Server-Service Management Console-Snap-In. Bei der Installation des Dienstes über das InDesign Server-Installationsprogramm wird das Snap-In automatisch installiert. Bei der Installation des Dienstes über die Befehlszeile muss das Snap-In manuell installiert werden. Gehen Sie dazu wie nachfolgend beschrieben vor. Um das Snap-In auf einem 64-Bit-Computer zu installieren, führen Sie folgenden Befehl aus: regsvr64 InDesignServerMMC64.dll Die Deinstallation des InDesignServerMMC-Snap-In entspricht im Wesentlichen der Installation, jedoch ist ein zusätzliches Befehlszeilenargument erforderlich: regsvr64 InDesignServerMMC64.dll /u Informationen zur Konfiguration des Snap-Ins finden Sie unter Konfigurieren des InDesign Server Windows-Dienstes auf Seite 17. Installieren des InDesign Server-SDK Das InDesign Server-SDK enthält Beispiele, Skripte und Dokumentation für InDesign Server. Das InDesign Server-SDK kann von adobe.com heruntergeladen werden. Sie können den Ordner mit dem SDK nach dessen Einrichtung verschieben.

11 KAPITEL 2: Installieren und Ausführen von InDesign Server Ausführen von InDesign Server 11 Ausführen von InDesign Server Sie können InDesign Server von der Befehlszeile oder von einem anderen Programm oder Skript aus starten. Bei allen Methoden können Sie Befehlszeilenargumente verwenden, die steuern, wie InDesign Server ausgeführt und konfiguriert wird. Befehlszeilenargumente für InDesign Server Mit den InDesign Server-Befehlszeilenargumenten lassen sich verschiedene Aspekte von InDesign Server konfigurieren. Die Befehlszeile hat folgende Syntax (die Argumente werden in der nachfolgenden Tabelle beschrieben): InDesignServer [argumente]

12 KAPITEL 2: Installieren und Ausführen von InDesign Server Ausführen von InDesign Server 12 Argument -configuration name Beschreibung Optional. Legt den Konfigurationsnamen für diese Instanz von InDesign Server fest. name muss ein im aktuellen System gültiger Ordnername sein. Dieser wird von InDesign Server verwendet, um den Konfigurationsordner zu erstellen, in dem private Daten, Cache- und Konfigurationsdateien abgelegt werden. Der Standardname lautet configuration_noport oder configuration_n, wobei n der Anschlussnummer (bei angegebenem Argument -port ) entspricht. Der Konfigurationsordner wird an folgendem Speicherort erstellt: Unter Windows: C:\Dokumente und Einstellungen\<benutzername>\ Anwendungsdaten\ Adobe\InDesign Server\<version>\ <sprache>\ Unter Windows Vista und Windows Server 2008: C:\Users\<benutzername>\AppData\Roaming\Adobe\InDesign Server\<version>\<sprache>\ Unter Windows mit dem Windows-Dienst: C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\ Adobe\InDesign Server\<version>\<sprache>\ Unter Windows Vista und Windows Server 2008 mit dem Windows- Dienst: C:\ProgramData\Adobe\InDesign Server\<version>\<sprache>\ -[no]console -[no]errorlist -help Unter Mac OS: /Users/<benutzername>/Library/Preferences/Adobe InDesign Server/<version>/<sprache>/ Optional. Nur Windows. Dies erstellt ein neues Konsolenfenster (eine Befehls-Shell) und leitet stderr und stdout dorthin um. Wenn -noconsole angegeben ist, werden stdout und stderr an das Terminal (bzw. Fenster) gesendet, in dem InDesign Server gestartet wurde. Dieses Argument ist nützlich, wenn der Microsoft Visual Studio-Debugger verwendet wird, um ein InDesign Server-Zusatzmodul, das Sie entwickeln, zu debuggen, weil der Debugger standardmäßig Daten, die in stderr und stdout ausgegeben werden, verwirft. Dies kann auch nützlich sein, wenn InDesign Server aus einer anderen Anwendung, wie z. B. einem Anwendungsserver, gestartet wird. Dieses Argument kann nur mit InDesignServer.exe verwendet werden, nicht mit InDesignServer.com. Die Standardeinstellung ist -noconsole. Optional. Steuert, ob InDesign Server Skriptfehler aus SOAP-Aufrufen im Speicher speichern soll. Die Fehlerliste wird nicht automatisch gelöscht. Wenn die zulässige Anzahl Fehler überschritten ist, gehen neue Fehler verloren. Die Standardeinstellung ist -noerrorlist. Optional. Zeigt kurze Beschreibungen aller Argumente an.

13 KAPITEL 2: Installieren und Ausführen von InDesign Server Ausführen von InDesign Server 13 Argument -iorfile filepath -LogToApplicationEventLog -maxerrors number -pluginpath path[,path] -port number -[no]previews -[no]seh -[no]sendcrashlogs -serialnumber number Beschreibung Für CORBA erforderlich. Das Add-In für Lastverteilung und Warteschlangenbildung für InDesign benötigt CORBA, ansonsten optional. Weist InDesign Server an, in welchen Ordner die Datei geschrieben werden soll, die die IOR des Anwendungsobjekts enthält. Die IOR in dieser Datei wird von einem Client verwendet, um einen Verweis auf das Anwendungsobjekt von InDesign Server zu erstellen. Sie können sich dies als Cookie vorstellen, den der Client-Code verwendet, um auf das Anwendungsobjekt von InDesign Server zuzugreifen. Alle Serverinstanzen benötigen eine eindeutige IOR-Datei. Mehrere Clients greifen auf einen bestimmten Server zu, indem sie die IOR-Datei für diesen Server verwenden. Die IOR wurde in die angegebene Datei geschrieben, wenn InDesign Server folgende Meldung ausgibt: [server] Writing IOR to... Optional. Unter Windows wird hiermit die Konsolenausgabe von InDesign Server in das Anwendungsprotokoll der Windows-Ereignisanzeige umgeleitet. Die Ausgabe kann in der Ereignisanzeige der Computerverwaltung angezeigt werden. Unter Mac OS sollte dieses Argument verwendet werden, wenn InDesign Server als launchd-daemon genutzt wird. Die Ausgabe kann mit dem Dienstprogramm Konsole angezeigt werden. Optional. number legt die maximale Anzahl von Skriptfehlern aus SOAP- Aufrufen fest, die InDesign Server im Speicher speichern soll. Der Standardwert ist Für CORBA erforderlich. Das Add-In für Lastverteilung und Warteschlangenbildung für InDesign benötigt CORBA, ansonsten optional. Weist den Server an, sämtliche Zusatzmodule im angegebenen Ordner und den entsprechenden Unterordnern zu laden. Durch Angabe des installierten Unterverzeichnisses server/corba wird das CORBA-Zusatzmodul für InDesign Server geladen und aktiviert. path bezeichnet einen relativen Pfad zum InDesign Server-Installationsordner (z. B. verweist Server/Corba auf den Ordner C:\Programme\Adobe\Adobe InDesign CS6.0 Server\Server\Corba ). Verwenden Sie keinen absoluten Pfad. Das CORBA-Zusatzmodul wurde geladen, wenn InDesign Server folgende Meldung ausgibt: [server] ApplicationIOR:... Für SOAP erforderlich, ansonsten optional. Dies ist die Anschlussnummer, die InDesign Server verwendet, um SOAP-Anforderungen von Client- Anwendungen zu bearbeiten. Wenn keine Nummer festgelegt ist, wird kein Anschluss verwendet und SOAP-Anforderungen können nicht verarbeitet werden. Allen Instanzen von InDesign Server, die auf dem gleichen System ausgeführt werden, muss jeweils eine eindeutige Anschlussnummer zugewiesen sein, wenn SOAP aktiviert wird. Die Anschlussnummer muss eine positive ganze Zahl sein. Optional. Legt fest, ob beim Import von Bildern Vorschaubilder erstellt werden sollen. Die Standardeinstellung ist -nopreviews. Optional. Nur Windows. Legt fest, ob SEH (Structured Exception Handling, strukturierte Handhabung von Ausnahmen) verwendet werden soll. Die Standardeinstellung ist -seh. Nur Mac OS. Sendet automatisch Absturzprotokolle an Adobe. Die Standardeinstellung ist -nosendcrashlogs. Gibt die Seriennummer für die Anwendung ein. Dieses Argument muss nur ein Mal zum Freigeben der Anwendung verwendet werden.

14 KAPITEL 2: Installieren und Ausführen von InDesign Server Ausführen von InDesign Server 14 Starten von InDesign Server von der Befehlszeile aus 1. Öffnen Sie in dem System, auf dem InDesign Server installiert ist, ein neues Shell-Fenster. Verwenden Sie unter Windows die Eingabeaufforderung und unter Mac OS das Dienstprogramm Terminal. 2. Wechseln Sie in den Ordner, in dem InDesign Server installiert ist. Unter Windows enthält der Ordner die Anwendung InDesignServer.com. Unter Mac OS enthält der Ordner das Anwendungspaket InDesignServer.app. Beispiel: 64-Bit-Windows: cd "C:\Program Files\Adobe\Adobe InDesign CS6 Server x64\" Mac OS: cd '/Applications/Adobe InDesign CS6 Server/' 3. Führen Sie den folgenden Befehl aus. (Unter Windows wird standardmäßig InDesignServer.com ausgeführt. Dabei werden Pfade eingerichtet und InDesignServer.exe ausgeführt.) InDesignServer 4. InDesign Server zeigt seine Startmeldungen im Shell-Fenster an. Wenn InDesign Server bereit ist, wird die Meldung [server] Server Running angezeigt. Während InDesign Server ausgeführt wird, werden Meldungen und Fehler im Shell-Fenster angezeigt, sodass Sie das Fenster verwenden können, um InDesign Server zu überwachen. Starten von InDesign Server für die Verwendung mit SOAP Wenn in Ihrem Workflow Skripte zur Kommunikation mit InDesign Server zum Einsatz kommen, umfasst der Workflow vermutlich auch das Übermitteln der Skripte an InDesign Server über SOAP. Damit die Kommunikation mit InDesign Server über SOAP möglich ist, müssen Sie beim Starten von InDesign Server das Argument -port angeben. Im folgenden Beispiel müssen Sie durch die tatsächliche Anschlussnummer ersetzen. InDesignServer -port Unter den Startmeldungen von InDesign Server sollte auch folgende Meldung angezeigt werden: "[soap] Servicing SOAP requests on port " Dies weist darauf hin, dass InDesign Server zum Empfangen von SOAP-Anforderungen bereit ist. Starten von InDesign Server für die Verwendung mit CORBA Wenn in Ihrem Workflow Lastverteilung und Warteschlangenbildung (LBQ) zur Kommunikation mit InDesign Server verwendet wird, müssen Sie InDesign Server für die Verwendung mit CORBA starten. Das InDesign Server-LBQ-Add-In verwendet das Corba Support-Zusatzmodul, um mit InDesign Server zu kommunizieren. Diese Kommunikation wird durch die Verwendung einer Textdatei erleichtert, die eine IOR-Zeichenfolge zur eindeutigen Identifizierung eines Objekts in CORBA enthält. Sobald die InDesign Server-Instanz initialisiert ist, schreibt sie die IOR für das Anwendungsobjekt in die angegebene Textdatei. Durch Verwenden der IOR in der IOR-Datei kann ein LBQ-Client ein Proxyobjekt für das Anwendungsobjekt von InDesign Server instanziieren.

15 KAPITEL 2: Installieren und Ausführen von InDesign Server Ausführen von InDesign Server 15 Um InDesign Server für die Verwendung mit CORBA zu starten, fügen Sie der Befehlszeile die Argumente -iorfile und -pluginpath hinzu. Der mit -pluginpath festgelegte Pfad ist relativ zum Installationsordner von InDesign Server. Beim Starten erstellt InDesign Server die angegebene Textdatei und schreibt die IOR seiner Anwendung in diese Datei. Für den Dateipfad müssen Zugriffsrechte zum Schreiben vorliegen. Ersetzen Sie im folgenden Beispiel c:\ior.txt (Windows) bzw. ~/ior.txt (Mac OS) durch den gewünschten Dateipfad. Windows: InDesignServer -iorfile c:\ior.txt -pluginpath Server\Corba Mac OS: InDesignServer -iorfile ~/ior.txt -pluginpath Server/Corba Unter den Startmeldungen von InDesign Server sollten auch folgende Meldungen angezeigt werden: "[server] ApplicationIOR:..." "[server] Writing IOR to..." Diese weisen darauf hin, dass InDesign Server zum Empfangen von CORBA-Befehlen bereit ist und dass Sie über die angegebene Datei auf die Anwendungs-IOR von InDesign Server zugreifen können. Starten von einem anderen Programm oder Skript aus InDesign Server kann als Prozess von einem anderen Programm oder Skript aus gestartet werden. Beachten Sie unter Windows, dass InDesign Server in der Regel über InDesignServer.com statt über InDesignServer.exe ausgeführt wird. Die.com-Version unterscheidet sich von der.exe-version darin, dass sie die erforderlichen Pfade zum omniorb-ordner einrichtet, der von der InDesign Server-CORBA-Implementierung benötigt wird. Die.exe-Version richtet diese Pfade nicht ein. Daher müssen Sie den omniorb-ordner u. U. manuell zur Umgebungsvariablen PATH hinzufügen, bevor Sie InDesignServer.exe starten. Ausführen mehrerer InDesign Server-Instanzen Wenn Ihre Site ein hohes Aufkommen an InDesign Server-Anforderungen hat, können Sie den Durchsatz erhöhen, indem Sie mehrere Instanzen von InDesign Server auf dem gleichen System ausführen. Als allgemeine Faustregel für die maximale Anzahl von InDesign Server-Instanzen auf einem Computer addieren Sie den Wert 1 zu der Anzahl von Prozessoren auf dem Computer. Weitere Informationen finden Sie unter InDesign Server Scalability and Performance im Dokument Adobe InDesign Server Solutions. Um mehrere Instanzen auszuführen, müssen Sie jeder Instanz einen eindeutigen Konfigurationsnamen geben. Verwenden Sie dazu das Argument -configuration und legen Sie für jede Instanz einen eindeutigen Namen fest. Wenn Sie InDesign Server von der Befehlszeile aus ausführen, müssen Sie jede Instanz in einem eigenen Fenster ausführen. 1. Starten Sie von einem Shell-Fenster aus die erste Instanz, indem Sie folgende Zeile ausführen: InDesignServer -configuration myids1 2. Öffnen Sie ein neues Shell-Fenster und führen Sie folgende Zeile für die zweite Instanz aus: InDesignServer -configuration myids2 Ausführen mehrerer Instanzen über SOAP Wenn Sie Anwendungen nutzen, die über SOAP mit InDesign Server kommunizieren, müssen Sie jeder Instanz von InDesign Server eine eindeutige Anschlussnummer zuweisen. In den folgenden Beispielen müssen Sie das Argument -configuration nicht festlegen, da InDesign Server einen Konfigurationsnamen auf der Grundlage des angegebenen Anschlusses erstellt (siehe Befehlszeilenargumente für InDesign Server auf Seite 11). Die folgenden Beispiele erstellen die Konfigurationsnamen Konfiguration_18383 und Konfiguration_18555.

16 KAPITEL 2: Installieren und Ausführen von InDesign Server Ausführen von InDesign Server 16 Die erste Instanz wird mit der folgenden Befehlszeile ausgeführt: InDesignServer -port Eine zweite Instanz wird mit der folgenden Befehlszeile ausgeführt: InDesignServer -port Optional können Sie jeder Instanz einen eindeutigen Konfigurationsnamen geben, allerdings ist für die Verwendung von SOAP immer noch eine eindeutige Anschlussnummer erforderlich. Beispiel: InDesignServer -configuration myids3 -port Ausführen mehrerer Instanzen über CORBA Wenn Sie das Add-In für Lastverteilung und Warteschlangenbildung für InDesign Server verwenden, müssen Sie jeder Instanz in InDesign Server eine eigene IOR-Textdatei und einen eigenen Konfigurationsnamen zuweisen. Die folgenden Beispiele erstellen eindeutige IOR-Textdateien und Konfigurationsnamen für jede Instanz. Unter Windows wird die erste Instanz mit der folgenden Befehlszeile ausgeführt: InDesignServer -configuration myids1 -iorfile c:\ids\ior_1.txt -pluginpath Server/Corba Eine zweite Instanz wird mit der folgenden Befehlszeile ausgeführt: InDesignServer -configuration myids2 -iorfile c:\ids\ior_2.txt -pluginpath Server/Corba Unter Mac OS wird die erste Instanz mit der folgenden Befehlszeile ausgeführt: InDesignServer -configuration myids1 -iorfile /IDS/ior_1.txt -pluginpath Server/Corba Eine zweite Instanz wird mit der folgenden Befehlszeile ausgeführt: InDesignServer -configuration myids2 -iorfile /IDS/ior_2.txt -pluginpath Server/Corba Beenden von InDesign Server Es gibt mehrere Möglichkeiten zum Beenden von InDesign Server: Drücken Sie im Fenster der Eingabeaufforderung (bzw. Terminal unter Mac OS), in dem InDesign Server gestartet wurde, die Tastenkombination Strg+C (Windows) bzw. Ctrl+C (Mac OS). Senden Sie ein Skript an InDesign Server, das InDesign Server über das quit-ereignis der Anwendung beendet. Im folgenden JavaScript-Beispiel wird InDesign Server beendet, ohne offene Dokumente zu speichern: app.quit(saveoptions.no); Wenn die InDesign Server-Instanz über den InDesign Server Windows-Dienst gestartet wurde, können Sie den Dienst anhalten und so sämtliche Instanzen von InDesign Server beenden, die über diesen Dienst gestartet wurden.

17 KAPITEL 2: Installieren und Ausführen von InDesign Server Ausführen von InDesign Server 17 Konfigurieren des InDesign Server Windows-Dienstes Der InDesign Server Windows-Dienst kann über die Kategorie Dienste der Windows-Computerverwaltung gestartet, angehalten und konfiguriert werden. Diese kann gestartet werden, indem Sie entweder mit der rechten Maustaste auf Arbeitsplatz > Verwalten klicken oder im Startmenü Verwaltung > Computerverwaltung wählen. Wählen Sie im Dialogfeld Computerverwaltung zunächst Dienste und Anwendungen und dann Dienste. Doppelklicken Sie in der Liste der Dienste auf InDesignServerService oder InDesignServerService x64. Dadurch wird ein Eigenschaften-Dialogfeld aufgerufen, in dem Sie den Dienst starten, beenden oder anhalten und die Anmeldung sowie die Startmethode des Dienstes ändern können. Microsoft empfiehlt, auf der Registerkarte Anmelden eine Einstellung mit möglichst eingeschränkten Rechten zu wählen, ohne dass die Funktionalität des Dienstes beeinträchtigt wird. Der Dienst muss mindestens über Lese- und Schreibzugriff auf den Ordner Dokumente und Einstellungen sowie auf den Pfad mit den Dokumenten verfügen, über die der Server gesteuert wird. Außerdem muss er in der Lage sein, einen Anschluss zu öffnen und Registrierungseinstellungen zu lesen. Lokales Systemkonto verfügt über weitreichendere Rechte als das Benutzerkonto LocalService. Daher sollten Sie zunächst versuchen, dieses Konto auf LocalService zu setzen (z. B. NT AUTHORITY\LocalService ). Auf der Registerkarte Wiederherstellen sollten Sie die Einstellung Keine Aktion durchführen beibehalten. So haben Sie auch weiterhin die Möglichkeit, den Dienst neu zu starten, falls er abstürzt. Wenn der Dienst ordnungsgemäß funktioniert, hat er bereits Instanzen von InDesign Server mit den angegebenen Anschlüssen/Konfigurationen gestartet. Wenn der Dienst dann abstürzt und die Instanzen von InDesign Server weiterhin aktiv sind, versucht die neue Instanz des Dienstes, neue Instanzen von InDesign Server zu starten. Dies schlägt aber fehl, da die Anschlüsse/Konfigurationen bereits verwendet werden. Diese Einstellungen haben keinen Einfluss darauf, wie der Dienst reagiert, wenn Instanzen von InDesign Server abstürzen. Dieses Verhalten wird über die Registrierungseinstellungen MaximumFailureCount, MaximumFailureIntervalInMinutes und TrackFailures unter HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\InDesignCS55ServerWinService konfiguriert. Einträge für diese drei Registrierungseinstellungen werden für jede neue Instanz erstellt, die dem Dienst hinzugefügt wird. Das Installationsprogramm fügt keine Instanzen automatisch hinzu. Wenn Sie dem Dienst eine Instanz hinzufügen, werden diese Registrierungseinträge erstellt. InDesign Server Console Management-Snap-In Die zweite Komponente des Windows-Dienstes ist das InDesign Server Console Management-Snap-In. Um das Snap-In einer Verwaltungskonsole hinzuzufügen, doppelklicken Sie im Installationsordner von InDesign Server auf die Datei InDesignServerService.msc. Sie können das Snap-In einer Verwaltungskonsole auch manuell hinzufügen. Führen Sie dazu die Windows-Anwendung mmc.exe aus und wählen Sie Datei > Snap-In hinzufügen/entfernen. Es wird eine Liste aller verfügbaren MMC-Snap-Ins angezeigt. Wenn keine Liste angezeigt wird, klicken Sie auf Hinzufügen. Wählen Sie InDesignServerService aus der Liste, um es der aktuellen Konsole hinzuzufügen. Schließen Sie das Dialogfeld Snap-In hinzufügen/entfernen. Um eine InDesign Server-Instanz der Konsole hinzuzufügen, klicken Sie im linken Bereich der Konsole mit der rechten Maustaste auf InDesignServerService und wählen Sie Neu > Neue InDesign Server-Instanz. Die neue Instanz übernimmt die Ausfallparameter aus der letzten Instanz. Ihr wird eine Anschlussnummer zugewiesen, die um 1 höher ist als der höchste InDesignServerService-Instanzanschluss. Die Standardbefehlszeile ist leer. Um die Konfiguration einer Instanz anzupassen (Anschlussnummer oder Befehlszeile), doppelklicken Sie im rechten Bereich auf die Instanz. Die Befehlszeile muss wie unter Starten von InDesign Server von der Befehlszeile aus auf Seite 14 beschrieben formatiert sein. Allerdings darf das Argument -port nicht angegeben werden, da es über den Anschlusseintrag definiert wird. Damit auf einem Rechner mehrere InDesign Server-Instanzen ausgeführt werden können, muss jede Instanz über einen eindeutigen Anschluss oder Konfigurationsnamen verfügen. Diese können über die Anschluss- und Befehlszeileneinstellungen für den Dienst angepasst werden. In der Regel müssen Sie nur die Anschluss- und Befehlszeileneinstellungen für den Dienst bearbeiten. Allerdings gibt es einige andere Einstellungen, die über die Registrierungseinstellungen für die Dienstinstanz geändert werden können:

18 KAPITEL 2: Installieren und Ausführen von InDesign Server Ausführen von InDesign Server 18 MaximumFailureCount Legt fest, wie oft der Dienst versucht, eine abgestürzte Instanz neu zu starten. MaximumFailureIntervalInMinutes Legt den Zeitraum für MaximumFailureCount fest. InDesign Server muss öfter als MaximumFailureCount Mal innerhalb von MaximumFailureIntervalInMinutes Minuten abstürzen, bevor der Dienst die Versuche zum Neustart einstellt. TrackFailures ein boolescher Wert. Bei einem Wert von 1 (Standardwert) versucht der Dienst, InDesign Server neu zu starten; bei einem Wert von 0 tut er dies nicht. Um diese Einstellungen zu bearbeiten, führen Sie regedit aus und rufen Sie die Schlüssel unter HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\InDesignCS55ServerWinService auf. Für jede Instanz, die über InDesignServerService.msc oder das Console Management-Snap-In konfiguriert wurde, ist jeweils ein Schlüsselsatz vorhanden (z. B. 065c361a-0cbe-4917-bf b ). Konfigurieren eines launchd-daemons für InDesign Server unter Mac OS InDesign Server kann unter Mac OS als Hintergrundprozess (Daemon) gestartet werden, ohne dass ein Benutzer unmittelbar eingreifen muss. Durch das Ausführen von InDesign Server als Daemon können Sie InDesign Server zeitgleich mit dem Betriebssystem starten und festlegen, wie bei einem Absturz reagiert werden soll. Um den Daemon zu konfigurieren, erstellen Sie eine Konfigurationsdatei (plist) mit den erforderlichen Einstellungen und installieren sie im gewünschten LaunchAgents- bzw. LaunchDaemons-Ordner. Die launchd-konfigurationsdatei Erstellen Sie die launchd-konfigurationsdatei mit einem beliebigen Editor für reinen Text und tragen Sie den XML-Inhalt wie unten beschrieben ein. Speichern Sie die Datei mit der Bezeichnung des Daemons als Dateiname und.plist als Erweiterung (z. B. com.adobe.ids.launchd plist ). Sie können plist- Dateien auch mit dem XCode-Dienstprogramm Property List Editor bearbeiten, das Sie unter Developer/Applications/Utilities finden. In der folgenden Tabelle sind die erforderlichen Einstellungen für einen InDesign Server launchd-daemon aufgelistet. Eine vollständige Liste der launchd-optionen finden Sie auf der man-seite für launchd. Option Label OnDemand ProgramArguments RunAtLoad Beschreibung Die eindeutige Kennung Ihres Daemons, z. B. com.adobe.ids.launchd Dieser Wert muss auf false gesetzt sein, damit InDesign Server nach dem Beenden oder nach einem Absturz wieder gestartet werden kann. Ein Array mit den beim Start der Anwendung angegebenen Argumenten als Zeichenfolgen. Das erste Element des Arrays enthält den vollständigen Pfad der Anwendung. Die übrigen Array-Elemente enthalten die Argumente, die beim Starten von InDesign Server über die Befehlszeile verwendet wurden. Um die Konsolenausgabe aus InDesign Server zu aktivieren, muss das Argument -LogToApplicationEventLog verwendet werden. Dieser Wert ist auf true gesetzt. InDesign Server wird gestartet, wenn der Daemon beim Systemstart oder manuell über launchctl geladen wird.

19 KAPITEL 2: Installieren und Ausführen von InDesign Server Ausführen von InDesign Server 19 Das folgende Beispiel zeigt den XML-Inhalt einer plist-konfigurationsdatei, die in InDesign Server über SOAP mit Anschluss ausgeführt wird: <?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.5 Server/InDesignServer</string> <string>-port</string> <string>12345</string> <string>-logtoapplicationeventlog</string> </array> <key>runatload</key> <true/> </dict> </plist> Installieren der Konfigurationsdatei Um eine launchd-konfigurationsdatei zu installieren, müssen Sie sie nur auf dem Rechner, auf dem InDesign Server ausgeführt werden soll, in den entsprechenden Ordner kopieren. Wenn Sie mehrere Instanzen von InDesign Server ausführen möchten, können Sie für jede Instanz eine separate Daemon- Konfigurationsdatei anlegen. Bei einer typischen InDesign Server-Installation wird Mac OS X Server ohne Benutzerkonten ausgeführt. Kopieren Sie in diesem Fall die Konfigurationsdatei in den folgenden Ordner: /Library/LauchDaemons Wenn Sie InDesign Server unter einem Benutzerkonto ausführen möchten, kopieren Sie die plist-datei in den LaunchAgents-Ordner im Library-Ordner des Systems oder des Benutzers (möglicherweise müssen Sie den LaunchAgents-Ordner für den Benutzer zunächst erstellen): /Library/LaunchAgents /Users/<username>/Library/LaunchAgents Laden des Daemons Führen Sie einen Neustart des Systems durch, nachdem Sie die plist-datei in den LaunchAgents-Ordner kopiert haben. Der Daemon wird dann automatisch geladen. Sobald der Daemon geladen ist, wird InDesign Server unter Verwendung der Einstellungen in der plist-datei gestartet. Geben Sie in einem Terminal-Fenster folgenden Befehl ein, um zu bestätigen, dass der Daemon geladen wurde: launchctl list Wenn die Bezeichnung Ihres Daemons aufgelistet ist, wurde er erfolgreich geladen. Um zu bestätigen, dass InDesign Server ausgeführt wurde, lassen Sie die Liste aller aktiven Prozesse mit der Aktivitäts-Anzeige auflisten. Sie können den Daemon mit Hilfe des Befehls launchctl manuell laden: launchctl load /Library/LaunchDaemons/com.adobe.ids.launchd plist

20 KAPITEL 2: Installieren und Ausführen von InDesign Server Ausführen von InDesign Server 20 Entladen des Daemons Sie können den Daemon mit Hilfe des Befehls launchctl manuell entladen. Beachten Sie jedoch, dass die InDesign Server-Instanz durch das Entladen des Daemons nicht ebenfalls beendet wird: launchctl unload /Library/LaunchDaemons/com.adobe.ids.launchd plist Um die InDesign Server-Instanz zu beenden, senden Sie ein entsprechendes Skript an InDesign Server oder beenden Sie den Prozess mit Hilfe der Aktivitäts-Anzeige.