Deploying Document Builder on WebSphere Application Server
You can deploy the Rational® Publishing Engine Document
Builder on WebSphere® Application Server version
8.x or later with IBM® DB2® or
Oracle.
Before you begin
You must
have access to the following Document Builder files
available in the RPE_HOME\document-builder directory:
- com.ibm.rpe.web.app.ear (or the rpeng.war and dgaas.war files)
Remember: The com.ibm.rpe.web.app.ear enterprise
application is a bundle of the two web applications: rpeng.war and
dgaas.war. You have one of the following deployment options:
- Deploy the single com.ibm.rpe.web.app.ear enterprise application
- Deploy both the rpeng.war and dgaas.war web applications together
Procedure
- Set global security.
- Set JVM.
- Set session management.
- Set the environment variable.
- Restart the server.
- For DB2: Configuring WebSphere Application Server with DB2 as a data source.
- For Oracle: Configuring WebSphere Application Server with Oracle as a data source.
- Deploy the Document Builder on the server.
- Create a shared library for the dgaas application.
- Configure users for the Document Builder on WebSphere Application Server.
- Associate shared libraries with applications.
- Configure the licensing variable.
Setting global security on WebSphere Application Server
Procedure
Results

Setting JVM
About this task
- com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine=true
- org.eclipse.emf.common.util.URI.archiveSchemes=wsjar wszip jar zip
Procedure
Results

Setting session management
About this task
- InvalidateOnUnauthorizedSessionRequestException=true
Procedure
Results

Setting the environment variable
Procedure
Restart the WebSphere Application Server
About this task
Procedure
Configuring WebSphere Application Server with DB2 as a data source
You must set up a DB2 database and configure the
connection with Document Builder on WebSphere Application Server
Before you begin
db2 CREATE DATABASE rpedb1 AUTOMATIC STORAGE Yes USING CODESET UTF-8
TERRITORY US COLLATE USING SYSTEM PAGESIZE 16384;
In
this example, the database is named rpedb1. See the DB2 product documentation for
information about creating a database.About this task
Creating a JDBC provider
Procedure
Creating a data source for the rpeng application
Procedure
Creating a data source for the dgaas application
Procedure
Repeat the steps in Creating a data source for the rpeng application,
setting DGAAS as the Data source
name and DGAAS_DB as the JNDI
name.

Creating an authentication data entry
Procedure
Configuring WebSphere Application Server with Oracle as a data source
You must set up a Oracle database and configure the connection with Document Builder on WebSphere Application Server
Before you begin
- To create and set up an Oracle database, the user who is preparing the database must have database administration authority over the database and that the database, tablespace storage, and appropriate storage configuration is created by a user with system administration authority.
- Depending on the version of Oracle that you use, the required Java Database Connectivity (JDBC) driver is ojdbc7.jar .
- To generate a list of supported database versions and JDBC drivers, see http://www.ibm.com/software/reports/compatibility/clarity/softwareReqsForProduct.html.
- The configuration parameters and tablespace options used in this topic are examples and might not entirely apply to your environment. For example, if you cannot use the AUTOEXTEND setting, then the files must be large enough to allow for growth. Or if you cannot use the UNLIMITED size quota for your database user, then make sure to allow enough space for rapid growth.
- The database that you create for the Document Builder application must be formatted to use UTF-8 as the character set. By default, Oracle does not create a database with the UTF-8 character set. When you create a new database, ensure that you select AL32UTF8 in the Oracle DB setup.
About this task
Create a database and table space
Procedure
Creating a JDBC provider
Procedure
Creating a data source for the rpeng application
Procedure
Creating a data source for the dgaas application
Procedure
Repeat the steps in Creating a data source for the rpeng application, setting
DGAAS as the Data source name and
DGAAS_DB as the JNDI name.

Creating an authentication data entry
Procedure
Deploying Document Builder on WebSphere Application Server
Before you begin
- A database for Rational Publishing Engine in DB2 or Oracle
- A rpeng data source with the JNDI name: RPENG_DB
- A DGAAS data source with the JNDI name: DGAAS_DB
Procedure
Configure users for Document Builder on WebSphere Application Server
About this task
Associating shared libraries with applications
Procedure
- Click to
access the Shared library references page.

- On the Shared library references page, select an application to which you want to associate a shared library, in this case com.ibm.rpe.web.app.
- Click Reference shared libraries.

- On the Shared library mapping page, select the dgaas.ear shared library that the application or modules use.
- Click >> to move the libraries from the Available
list to the Selected list.

- On the Shared library references page, click OK.
- Save the changes to the master configuration.
Configuring the licensing variable
Procedure
- Verify the TELELOGIC_LICENSE_FILE environment variable. For example, you can create an environment variable for the license file in WebSphere Application Server on the
Environment Entries page:For Linux, the registry is found in $HOME/.flexlmrc for TELELOGIC_LICENSE_FILE.

- Restart WebSphere Application Server.
Results
Tip: You might encounter the following error message in the web
browser:
Error 500: com.ibm.websphere.servlet.session.UnauthorizedSessionRequestException:
SESN0008E: A user authenticated as anonymous has attempted to access a session owned by
user:defaultWIMFileBasedRealm/uid=rpe_designer,o=defaultWIMFileBasedRealm.
To
resolve this error message, verify that you set the
InvalidateOnUnauthorizedSessionRequestException session management property to
true in the custom properties for WebSphere Application Server. For more
details, see the Setting session management section of this
topic.You can log in by providing the user name and password of the appropriate user, such as rpe_admin, rpe_designer or rpe_user and click Log in.

The following Document Builder for Rational Publishing Engine should display in your browser:

You can verify the status of the document generation service by entering http://server:port/dgaas/debug in a browser.

What to do next
Optionally, you can deploy and run the Newskeeper sample application that uses document generation service technology for generating documents, and provides a storage interface for document generation service assets and documents. For more details, see Running the Newskeeper sample.
Configure the Rational Publishing Engine Document Builder listed on the http://server:port/rpeng/ page. See Document Builder URLs for an explanation of how each URL is used and tasks for configuring each of the features.





































