• ’













































































fl fi











fi fi

“ ”





• fi

















• ’




































































































fi fi fi fi




fl fi











fi fi















“ ”





• fi












fi fi fi









fi fi
’ ’ ’ ’



























































































page 1-4. For other platforms or to deploy on an existing application server you need to install manually. Continue under Database Configuration. This information is also stored in the /xmlpserver/setupinfo.sh file in the ORACLE HOME directory (typical $ORACLE_HOME or /oraclehomes).txt file under the Oracle Home directory. Important: Please change the admin password under Preferences > Accounts.and Linux x86. You can start XML Publisher server using the /xmlpserver/xmlpserverstart. 2. Windows Installation 1. Linux Conguration 1. 4. 5. Typically. Log in with user admin and password admin. The installer will provide you with the server URL on the last dialog of the installation. please follow the steps in the Manual Installation Readme. 3. Important: Please change the admin password on the Account tab under Preferences. This information is also stored in the /xmlpserver/setupinfo.exe executable to start the installer and follow the instructions. 3. Start XML Publisher server using the /xmlpserver/xmlpserverstart. 2 . The installer uses the first free port between 15101-15110 for XML Publisher Enterprise. Manual Installation If you need to deploy XML Publisher Enterprise manually. 2. Run the runInstaller script to start the installer and follow the instructions. Typically. Run the install\setup. the URL looks like: http://localhost:15101/xmlpserver Open a compatible browser pointing to this URL. 5.txt file under the Oracle Home directory. The installer will provide you with the server URL on the last dialog of the installation.bat file in the ORACLE HOME directory (typical C:\OraHome_1). Log in with user admin and password admin to set up your system. page 1-3. the URL looks like: http://localhost:15101/xmlpserver Open a compatible browser pointing to this URL. page 1-3. 4. The installer uses the first free port between 15101-15110 for XML Publisher Enterprise. Continue under Database Configuration.

From the SQL script directory: \manual\SQL_Scripts. run the oracle_tables. 3 .sql script with sqlplus: sqlplus user/password @tables_oracles. Open the file \xmlpserver\xmlpserver\WEB-INF\xmlp-server-config. For example.Database Conguration The database configuration is required to send or schedule reports. Open your browser. see the Administration chapter of the Oracle XML Publisher Enterprise User’s Guide found under (/doc/5_6_2_Users. For example: http://localhost:8888/xmlpserver Note: Your xmlpserver.1/tables_oracles. Create a new user/schema (for example: "XMLP" with password "welcome").com:1525:ora10g</url> <username>XMLP</username> <password>welcome</password> <driver>oracle.sql where user/password are replaced with correct values. 2. For example: sqlplus XMLP/welcome @tables_oracles. Application Conguration Follow the steps below to configure XML Publisher Enterprise: 1.ear file should now be unpacked.sql that sets up the database for the Quartz scheduler.war or xmlpsever. for XMLP schema with password welcome on Oracle 10g database db.OracleDriver</driver> </connection> </scheduler> For more information on setting up the server configuration file. Change the database information in the scheduler section under /xmlpConfig/resource to reflect the database and schema that you configured for XML Publisher.5. only Oracle Database deployment is supported: Oracle Database 10g Deployment Follow the steps below to configure Oracle Database 10g for XML Publisher: 1. http://hostname:port/xmlpserver to see the welcome page. In this release.company. 2.driver.pdf).sql Note: This script includes the script quartz-1.company.com:1525:ora10g you would update the file as follows: <scheduler> <connection> <connectionType>jdbc</connectionType> <url>jdbc:oracle:thin:@db.jdbc.0\webapps 3. Typically for OC4J this will be: C:\oc4j1012\j2ee\home\applications Typically For Apache Tomcat this will be: C:\Program Files\Apache Software Foundation\Tomcat 5.xml where your application server unpacked the war/ear file.

pdf) for additional information. Manual Installation Readme Introduction Oracle XML Publisher offers you the most efficient. scalable reporting solution available for complex. This distribution contains: • • • • XML Publisher Enterprise server application XML Publisher runtime libraries XML Publisher fonts Documentation: User’s Guide. This CD contains the XML Publisher Server. Important: Please change the admin password on the Account tab under Preferences. See the Oracle XML Publisher Enterprise User’s Guide (found under \doc\5_6_2_Users. 5. and suppliers—both securely and in the right format. Navigate to the Reports tab and view the demo reports. Select Apply to save your changes. distributed environments. and samples 4 . demos. Oracle XML Publisher reduces the high costs associated with the development. Open your browser http://hostname:port/xmlpserver to see the welcome page. For example: http://localhost:8888/xmlpserver 6. customization and maintenance of business documents. For example: http://localhost:8888/xmlpserver 2. Select the Test Connection button to confirm that XML Publisher can access your database. The sample reports require that the data source “xmlpdemo” is set up correctly. while increasing the efficiency of reports management. Change the URL to point to an Oracle 10g database with unlocked oe user. Select the Admin tab Select JDBC Database Connection in the Data Sources section. customers. Log in using the user/password: admin/admin. It provides a central architecture for generating and delivering information to employees. Restart the application server. Javadocs. Open your browser. Select the connection with the name xmlpdemo. Perform the following actions: • • • • • • 3. Running the XML Publisher Enterprise Demo Reports You can test your application installation as follows: 1. http://hostname:port/xmlpserver to see the welcome page.4.

Select the Applications tab and select the Deploy button.0 or Mozilla Firefox 1. 5. 3.4 or later A J2EE-based application server Oracle OC4J 10. You must perform the following steps as described in this document to deploy Oracle XML Publisher manually: 1. 5 .html XML Publisher Forum: http://forums.1.3\xmlpserver.oracle.com/technology/products/applications/publishing/index.1.0. manage and schedule reports. Change any other deployment settings if required and select the Deploy button. 3.org/licenses/LICENSE-2.1.ear on the CD for the Archive Location and select the Next button.0 OC4J 10. Browse for the \manual\OAS10. Application Server Deployment XML Publisher is a pure J2EE application and has been extensively tested on: • • Oracle OC4J 10.oracle.1./2/10.jspa?forumID=245 System Requirements You need the following to run Oracle XML Publisher Enterprise: • • • • Java Runtime Environment (JRE) / Java Development Kit (JDK) version 1. Deploy XML Publisher on the application server. Create the XML Publisher schema on the database server.1. 6. 2.1. but required for the scheduler database) Microsoft Internet Explorer 6.3 with the Enterprise Manager: 1.3 Deployment Follow the steps below to deploy XML Publisher on Oracle OC4J 10. Open the Application Server Control (typically: http://localhost:8888/em) in your browser and log in as oc4jadmin. Copy the fonts in the \manual\fonts directory on the CD to the fonts directory of your Java Runtime Environment (JAVA_HOME\lib\fonts).2 / 10.com/forums/forum.3 Apache Tomcat 5.0 or later XDO Server Application Installation The server application allows you to create. Configure the XML Publisher Application.0 Oracle Database 9i or 10g (optional.txt and can also be obtained from http://www. 4. For the most current information please check: XML Publisher Web Page: http://www. Choose xmlpserver as the Application Name and select the Next button.1.Note: The application uses Apache Axis and the OpenSymphony Quartz Scheduler open-source software packages.3 or Apache Tomcat 5. The Apache license agreement for Axis is included on the CD under \doc\ApacheLicense. 2.apache.

enter xmlpserver as the Application name. Add an entry to the server. 6.4. Copy the fonts in the \manual\fonts directory on the CD to the \manual\fonts directory of your Java Runtime Environment (JAVA_HOME\lib\fonts).2 Deployment Follow the steps below to deploy XML Publisher on Oracle OC4J 10. If you see the login page.1. Note that in the following steps we assume that OC4J is installed under C:\oc4j1012 and that you copied the ear file to C:\oc4j1012\j2ee\home\applications. Open the Application Server Control (typically: http://localhost:18100) in your browser and log in as ias_admin. For example: http://localhost:8888/xmlpserver 9.1. on Windows the directory name may be: C:\OraHome_1\jdk\jre\lib\fonts Start or restart OC4J.2_08\lib\fonts 3. continue under Database Configuration. Choose xmlpserver as the URL Mapping and select Next.ear: <application name="xmlpserver" path=".2 Deployment Follow the steps below to deploy XML Publisher on Oracle Application Server 10. 8.5. Add an entry to the http-web-site. Click the Deploy EAR file button.For example: C:\Program Files\Java\jdk1. 8.1. OC4J 10. 7. 9. 5. 3.2 with the Enterprise Manager: 1. ear" auto-start="true" /> using the correct path to the xmlpserver. Copy \manual\xmlpserver. Oracle Application Server 10. Open your browser http://hostname:port/xmlpserver to see the login page. Keep the Use JAZN XML User Manager selected and select Next button. Browse for the \manual\xmlpserver. 10. 2. Open your browser http://hostname:port/xmlpserver to see the login page./applications/xmlpserver.ear on the CD for the J2EE Application.xml file (under J2EE_HOME\config): <web-app application="xmlpserver" name="xmlpserver" root="/ xmlpserver" /> 6 . For example. page 1-7. 4. Copy the fonts in the \manual\fonts directory on the CD to the fonts directory of your Java Runtime Environment (JAVA_HOME\lib\fonts).ear file.xml file (under J2EE_HOME\config) for the xmlpserver. Select Deploy.0_06\jre\lib\fonts 7.1. page 1-7. If you see the login page.. continue under Database Configuration.2: 1. then select Continue. Start or restart OC4J. For example: C:\Program Files\Java\j2re1. For example: http://localhost:7777/xmlpserver 11. 4. 2. Select the System Component home on the Home tab and then select the Applications tab.ear from the CD to a directory that can be accessed by OC4J.

Continue under Application Configuration.0 Deployment Follow the steps below to deploy XML Publisher on Apache Tomcat 5.sql script with sqlplus: sqlplus user/password @tables_oracles. page 1-7. The following steps assume that you copied XMLP to C:\. For example: C:\Program Files\Java\j2re1.0: 1.sql where user/password are replaced with correct values.sql Note: This script includes the script quartz-1. 4.0 (typically from services). page 1-7. If you see the login page. 2. Application Conguration Follow the steps below to configure XML Publisher Enterprise: 1. continue under Database Configuration.sql that sets up the database for the Quartz scheduler.4. Apache Tomcat 5. Create a new user/schema (for example: "XMLP" with password "welcome"). Copy the fonts from \manual\fonts on the CD to the fonts directory of your Java Runtime Environment (JAVA_HOME\lib\fonts).1/tables_oracles. 3. page 1-7. For example: sqlplus XMLP/welcome @tables_oracles. Open your browser http://hostname:port/xmlpserver to see the login page. 3. In this release.0\webapps on Windows). Start or restart OC4J.2_08\lib\fonts Start or restart Tomcat 5. continue under Database Configuration. Open your browser. http://hostname:port/xmlpserver to see the welcome page.war from the CD to the webapps directory under your Tomcat home directory (typically C:\Program Files\Apache Software Foundation\Tomcat 5. From the SQL script directory: \manual\SQL_Scripts. For example: http://localhost:8888/xmlpserver 7 . Copy \manual\xmlpserver. For example: http://localhost:8080/xmlpserver 5. only Oracle Database deployment is supported: Oracle Database 10g Deployment Follow the steps below to configure Oracle Database 10g for XML Publisher: 1.5. http://hostname:port/xmlpserver to see the demo page. 6. run the oracle_tables. Open your browser. If you see the login page. For example: http://localhost:8888/xmlpserver 7. Database Conguration The database configuration is required to send or schedule reports.5. Copy the \manual\XMLP directory to your server. 2. 2.

com:1525:ora10g</url> <username>XMLP</username> <password>welcome</password> <driver>oracle. Important: Please change the admin password on the Account tab under Preferences.OracleDriver</driver> </connection> </scheduler> For more information on setting up the server configuration file. For example.war or xmlpsever. http://localhost:8888/xmlpserver Log in using the user/password: admin/admin.company.Note: Your xmlpserver.com:1525:ora10g you would update the file as follows: <scheduler> <connection> <connectionType>jdbc</connectionType> <url>jdbc:oracle:thin:@db. Open your browser http://hostname:port/xmlpserver to see the welcome page. Important: It is strongly recommended that you set a temporary directory. The original entry is <file path="%s_Reports_Path%"/>. Open the file \xmlpserver\xmlpserver\WEB-INF\xmlp-server-config. 6. "Setting Runtime Properties" for information on defining a temporary directory and setting other runtime properties. For example: 9. 8. Change the database information in the scheduler section under /xmlpConfig/resource to reflect the database and schema that you configured for XML Publisher. If you copied the XML directory to C: change it to: <file path="C:\XMLP"/>. 5. Consult the Oracle XML Publisher Enterprise User’s Guide. http://hostname:port/xmlpserver to see the welcome page.jdbc.xml where your application server unpacked the war/ear file.company.driver.ear file should now be unpacked. 3.pdf). for XMLP schema with password welcome on Oracle 10g database db. The file element is found under /xmlpConfig/resource. For example: http://localhost:8888/xmlpserver 8 . Open your browser. see the Administration chapter of the Oracle XML Publisher Enterprise User’s Guide found under (/doc/5_6_2_Users. Change the file path in the configuration file to point to the XMLP directory. Typically for OC4J this will be: C:\oc4j1012\j2ee\home\applications Typically for Apache Tomcat this will be: C:\Program Files\Apache Software Foundation\Tomcat 5. Restart the application server.0\webapps 4. 7. Running the XML Publisher Enterprise Demo Reports You can test your application installation as follows: 1.

Select the connection with the name xmlpdemo. As a result.pdf) for additional information. Also consult the XML Publisher Javadocs (found under \doc\JavaDocs\index. Select the Test Connection button to confirm that XML Publisher can access your database.pdf) regarding the configuration file.0’ encoding = ’windows-1252’?> <orion-web-app> <web-app-class-loader search-local-classes-first="true" /> </orion-web-app> Known Issues The following issues are known about Oracle XML Publisher Enterprise 5. Please define the temporary directory! Please read "Using the Java APIs" in the Oracle XML Publisher Enterprise User’s Guide (found under \doc\5_6_2_Users.xml configuration file with the following content: <?xml version = ’1. 9 . Copy the XML Publisher Java libraries (\manual\lib) on the Server CD to the library directory of your J2EE project or Java Runtime Environment. Navigate to the Reports tab and view the demo reports. The sample reports require that the data source “xmlpdemo” is set up correctly. You can resolve the issue by copying properties. Select Apply to save your changes. See the Oracle XML Publisher Enterprise User’s Guide (found under \doc\5_6_2_Users. The installer does not copy the properties.2: 1.xml file into the \Admin\Delivery folder. 3. Creating XML Publisher Applications Perform the following steps to add XML Publisher to your own application: 1. e-mail confirmations fail. Change the URL to point to an Oracle 10g database with unlocked oe user.2.pdf) on how to develop applications that use XML Publisher.html) for a complete reference of the XML Publisher API). Oracle OC4J Deployment Notes The version of the XML Parser shipped with Oracle OC4J is incompatible with XML Publisher.6. 2.xml from the \manual\XMLP\Admin\Delivery directory on the CD to the ORACLE_HOME\xmlpserver\manual\XMLP\Admin\Delivery directory of your installation. 3. Copy the fonts in the fonts directory (\manual\fonts) on the Server CD to the fonts directory of your Java Runtime Environment. Consult "Setting Runtime Properties" in the Oracle XML Publisher Enterprise User’s Guide (found under \doc\XMLPublisher562. Perform the following actions: • • • • • • Select the Admin tab Select JDBC Database Connection in the Data Sources section. When you create an XML Publisher application for OC4J you need to configure the system to use the XML Publisher version of the XML Parser. This can be accomplished by setting an orion-web.

If you perform a Manual Installation. For TTY support. call 800. our documentation includes features that make information available to users of assistive technology. and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. however. to the disabled community.. seven days a week. 10 . and supporting documentation accessible. with good usability. The JDBC connection passwords are stored in clear text in the datasources. You can obtain the files by running the Oracle Universal Installer on a Linux or Windows instance. It is recommended that you use a JNDI connection for added security.. 4. For more information. some screen readers may not always read a line of text that consists solely of a bracket or brace.xml file as shown: • • URIEncoding="UTF-8" BodyEncodingForURI="true" For example: <Connector port="8080" . If you are using the delivery options FTP or WebDAV and your file name contains non-ASCII characters. The Query Builder is only supported for the Oracle database. Documentation Accessibility Our goal is to make Oracle products. visit the Oracle Accessibility Program Web site at http://www. To that end. services. 7.446.2398. Accessibility standards will continue to evolve over time. set the following attributes of the Connector element in the <tomcat home>/conf/server. TTY Access to Oracle Support Services Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day. 5. URIEncoding="UTF-8" useBodyEncodingForURI="true" /> 3. The Query Builder is a feature of the report definition interface that allows you to build SQL queries without coding. If your data source is a non-Oracle database you must manually enter your query in the SQL Query text box. If XML Publisher is deployed on Apache Tomcat using the default configuration. your FTP server must support UTF-8. folder and filenames are limited to the use of ASCII characters. This documentation is available in HTML format. the translations are not included in the /XMLP folder.2. The scheduler is limited to sending e-mail using UTF-8. Copy the translations from the installed /XMLP/Admin/Translation/ directory to the /XMLP folder. 6. Accessibility of Code Examples in Documentation Screen readers may not always correctly read the code examples in this document.xml.oracle.com/accessibility/ . To correct this issue. The conventions for writing code require that closing braces should appear on an otherwise empty line. and contains markup to facilitate access by the disabled community.

227-19. disclosure. electronic or mechanical. third-party Web sites. CA 94065. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. please report them to us in writing. The Programs may provide links to Web sites and access to content. The information contained in this document is subject to change without notice. Except as may be expressly permitted in your license agreement for these Programs. and services from third parties. mass transit. the following notice is applicable: U. including documentation and technical data. is prohibited. and. modification. or (b) fulfilling any of the terms of the agreement with the third party. GOVERNMENT RIGHTS Programs. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party. or decompilation of the Programs. and other intellectual and industrial property laws. disassembly. for any purpose. patent. 11 . Reverse engineering. except to the extent required to obtain interoperability with other independently created software or as specified by law. and related documentation and technical data delivered to U. including delivery of products or services and warranty obligations related to purchased products or services. and adaptation of the Programs. databases. the additional rights set forth in FAR 52. medical. The Programs are not intended for use in any nuclear. or any content provided on. they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright. backup. If you choose to purchase any products or services from a third party. software. no part of these Programs may be reproduced or transmitted in any form or by any means. products.S. and we disclaim liability for any damages caused by such use of the Programs. Oracle is not responsible for: (a) the quality of third-party products or services. As such. Redwood City. If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government. to the extent applicable. redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes. If you find any problems in the documentation. the relationship is directly between you and the third party. It shall be the licensee's responsibility to take all appropriate fail-safe. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites. duplication. You bear all risks associated with the use of such content. 500 Oracle Parkway. or other inherently dangerous applications.Accessibility of Links to External Web Sites in Documentation This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control.S. shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Commercial Computer Software–Restricted Rights (June 1987). Oracle Corporation. This document is not warranted to be error-free. use. Legal Notices The Programs (which include both the software and documentation) contain proprietary information. Oracle is not responsible for the availability of. aviation.

Sign up to vote on this title
UsefulNot useful