Mr. XML Publisher Administration Guide (v 1.3)

  Steve Whitlatch
  PO Box 32841
  Phoenix, Arizona
  85064
  USA
  <steve at swhitlat dot phxcoxmail dot com>
  602-956-2966

Table of Contents

Introduction

Contained in this Manual
Not Contained in this Manual

Overview of the Default Mr. XML Publisher: Mr. XML Publisher for DocBook

User Interface

Browser Support
Optional User Interface Elements
Required User Interface Elements

XML Tools and External Subprocesses

Command Arrays: Special web.xml <context-param> Elements

XSL Customization Layers

XML Catalog Systems

XIncludes

IncludeMap.xml: XML from Native and/or Relational Databases

Deployment

Required Java Versions

External Applications

XML Tools
XML Catalog Systems

Deploying to Tomcat

Deploying to a JEE Application Server

JBoss
IBM WebSphere Application Server (WAS)
BEA WebLogic Server
GlassFish / Sun Java System Application Server
Geronimo

Hardware and System Optimizations

CPUs
Memory
Networking

Server Administration

COMMAND Arrays

Command Keywords
Default Formats

Shell Scripts, Ant Scripts, Makefiles, and XProc

Shell Script
Ant Script
Makefile
XProc and Calabash

XSL and Customization Layers

XSL in Uploaded Projects
XSL on the Server

ENVIRONMENTs

web.xml <context-param>s

General Server Management
Security and File Policies
Object Caching
XML Data Pulls and Connection Pooling

XML from a Data Store

IncludeMap.xml Files in User Projects
PULL_XXX_ON_STARTUP[…] <context-param>s in the web.xml File
Data Stores
XIncludes
IncludeMap.xml

Security

Control of Process Ownership
Security Features Provided by Mr. XML Publisher
Security Features Provided by Software External to Mr. XML Publisher

Logging

Logging Defaults
Rename or Relocate the Mr. XML Publisher Log File
Change the Log Level

User Interface Customization

JSP
JavaScript
Plain HTML Files
Java Applets
Buttons

A. Example IncludeMap.xml

B. IncludeMap.xml Schema

C. Example Startup Log Messages

D. Example Request Servicing Log Messages

E. Example System.out Log Messages

F. Example Command Arrays Using Saxon

Saxon on Linux/Unix
Saxon on Windows

G. Example Command Arrays Using Xalan

Xalan on Linux/Unix
Xalan on Windows

Index

List of Figures

1. Default User Interface: Mr. XML Publisher for DocBook
2. Progress Popup
3. Server Processing Messages

List of Tables

1. General Server Management <context-param>'s
2. Security and File Check <context-param>'s
3. Object Caching <context-param>'s
4. XML Data Pulls and Connection Pooling <context-param>'s
C.1. Example Starup Log Messages in XML_Publisher.html
D.1. Example Request Servicing Log Messages

List of Examples

1. HTML Single COMMAND Array for Windows
2. HTML Single COMMAND Array for Linux/Unix
3. FO (PDF) COMMAND Array for Linux/Unix
4. FO (PDF) COMMAND Array for Windows
5. HTML Chunked COMMAND Array for Linux/Unix
6. HTML Chunked COMMAND Array for Windows
7. HTML Help COMMAND Array for Linux/Unix
8. HTML Help COMMAND Array for Windows
9. JavaHelp COMMAND Array for Linux/Unix
10. JavaHelp COMMAND Array for Windows
11. Eclipse Platform Help COMMAND Array for Linux/Unix
12. Eclipse Platform Help COMMAND Array for Windows
13. Man Pages COMMAND Array for Linux/Unix
14. XHTML Chunked COMMAND Array for Linux/Unix
15. XHTML Chunked COMMAND Array for Windows
16. XHTML Single COMMAND Array for Linux/Unix
17. XHTML Single COMMAND Array for Windows
18. HTML Chunked COMMAND Array for Linux/Unix
19. Plain Text COMMAND Array for Windows
20. COMMAND Array Calling a Shell Script
21. COMMAND Array Calling Ant with a build.xml File
22. COMMAND Array Executing a Makefile
23. COMMAND Array Executing a Shell Script that Calls Calabash
24. An ENVIRONMENT <context-param> for Windows
25. PULL_JDBC_ON_STARTUP[…] for SQL Server
26. PULL_JDBC_ON_STARTUP[…] for DB2
27. PULL_JDBC_ON_STARTUP[…] for mySQL
28. PULL_JDBC_ON_STARTUP[…] for Sybase
29. PULL_XMLDB_ON_STARTUP[…] for eXist
30. PULL_XMLDB_ON_STARTUP[…] for xindice
31. PULL_TGL_ON_STARTUP[…]
32. PULL_ORACLE_ON_STARTUP[…]
33. PULL_MKL_ON_STARTUP[…]
34. PULL_XHIVE_ON_STARTUP[…]
35. PULL_TAMINO_ON_STARTUP[…]
36. PULL_SEDNA_ON_STARTUP[…]
37. PULL_XSTREAMDB_ON_STARTUP[…]
38. IncludeMap.xml Outer Elements
39. <JDBC_Pull> Element in IncludeMap.xml for SQL Server
40. <JDBC_Pull> Element in IncludeMap.xml for DB2
41. <JDBC_Pull> Element in IncludeMap.xml for mySQL
42. <JDBC_Pull> Element in IncludeMap.xml for Sybase
43. <XMLDB_Pull> Element in IncludeMap.xml for eXist
44. <XMLDB_Pull> Element in IncludeMap.xml for xindice
45. <TGL_Pull> Element in IncludeMap.xml
46. <Oracle_Pull> Element in IncludeMap.xml
47. <MKL_Pull> Element in IncludeMap.xml
48. <XHive_Pull> Element in IncludeMap.xml
49. <Tamino_Pull> Element in IncludeMap.xml
50. <Sedna_Pull> Element in IncludeMap.xml
51. <XStreamDB_Pull> Element in IncludeMap.xml
F.1. HTML Single COMMAND Array Using Saxon on Linux/Unix
F.2. HTML Chunked COMMAND Array Using Saxon on Linux/Unix
F.3. FO PDF COMMAND Array Using Saxon on Linux/Unix
F.4. HTML Help COMMAND Array Using Saxon on Linux/Unix
F.5. Java Help COMMAND Array Using Saxon on Linux/Unix
F.6. Eclipse Platform help COMMAND Array Using Saxon on Linux/Unix
F.7. HTML Single COMMAND Array Using Saxon on Windows
F.8. HTML Chunked COMMAND Array Using Saxon on Windows
F.9. FO PDF COMMAND Array Using Saxon on Windows
F.10. HTML Help COMMAND Array Using Saxon on Windows
F.11. Java Help COMMAND Array Using Saxon on Windows
F.12. Eclipse Platform Help COMMAND Array Using Saxon on Windows
G.1. HTML Single COMMAND Array Using Xalan on Linux/Unix
G.2. HTML Chunked COMMAND Array Using Xalan on Linux/Unix
G.3. FO PDF COMMAND Array Using Xalan on Linux/Unix
G.4. HTML Help COMMAND Array Using Xalan on Linux/Unix
G.5. Java Help COMMAND Array Using Xalan on Linux/Unix
G.6. Eclipse Platform help COMMAND Array Using Xalan on Linux/Unix
G.7. HTML Single COMMAND Array Using Xalan on Windows
G.8. HTML Chunked COMMAND Array Using Xalan on Windows
G.9. FO PDF COMMAND Array Using Xalan on Windows
G.10. HTML Help COMMAND Array Using Xalan on Windows
G.11. Java Help COMMAND Array Using Xalan on Windows
G.12. Eclipse Platform help COMMAND Array Using Xalan on Windows


		Introduction