You can install the adapters for IBM® Rational® Publishing Engine data
service on an existing instance of IBM WebSphere Application Server
version 6.0. If you have more than one machine for the data sources,
you need to repeat these steps for each machine.
Before you begin
Deploying on IBM WebSphere Application Server: Make sure
that you have chosen the recommended machines for installing IBM IBM Rational Publishing Engine data
service.
Deploying the data source adapters: You must first
install the data service and then deploy the plug-in files for the
adapters on the web application server.
Procedure
Deploy the data services war file on WebSphere Application
Server.
- Start the IBM WebSphere Application Server profile management
tool. To launch the profile management tool select Start > All
Programs > IBM WebSphere > Application
Server [version] > Profile
Management Tool.
- Create a new profile named DataServices.
To create a new profile in the tool:
- Click Next. Select Advanced
profile creation, click Next.
- Select to Deploy the administrative console and
click Next. Do not select Deploy
the default application.
- Specify the profile name DataServices,
click Next. Do not enable administrative security
(you can do this later), click Next.
- Select Run the application server process
as a Windows service, click Next and
click Create.
- Start the WebSphere Application Server.
- Start the administrative console for the DataServices profile.
- On the Map modules to servers page, click Next.
- On the Map virtual hosts for Web modules page, click Next.
- On the Summary page, click Finish and Save.
- If you are using the RequisitePro Adaptor, configure generic
JVM arguments. If you are using any other adaptor, continue to the
next step.
- Login to the Admin console.
- Click .
- Set the Generic JVM arguments value to: -DRJCB_IN_MTA_ONLY='RJCB'
-Xquickstart
- Restart the WebSphere Application Server.
- In the administrative console, click Enterprise
Applications.
- Select DataServices.war and click Start.
- Add the adapter plug-ins to the web application by copying
the adapter archive files to library directory of the web application.
- Locate the plug-ins for the adapters. By default, the plug-ins
are installed in a subdirectory of the C:\Program Files\IBM\Rational\Rational
Publishing Engine\RPEn.n\web services\data services directory.
For example, the default location for the ReqPro plug-in is C:\Program
Files\IBM\Rational\Publishing Engine\1.1.2\web services\data services\eclipse\plugins.
- Locate the features for the adapters. By default, the features
are installed in a subdirectory of the C:\Program Files\IBM\Rational\Rational
Publishing Engine\RPEn.n\web services\data services directory.
For example, the default location for the ReqPro feature is located
at C:\Program Files\IBM\Rational\Publishing Engine\1.1.2\web
services\data services\eclipse\features.
- Locate the file system directory of the web application. By default
the eclipse directories of web applications are located at below directory C:\Program
Files\IBM\WebSphere\AppServer1\profiles\profile name\installedApps\Node
Name\DataServices_war.ear\DataServices.war\WEB-INF\eclipse.
The
location depends on your deployed instance of WebSphere Application
Server. To find the location for your installation, you can search
the profiles directory of your WebSphere Application Server application
server for a folder named DataServices.war.
- Copy the contents of the eclipse directory of substep a. and b.
to the directory of substep c. Make sure that the contents of the eclipse/features and eclipse/plugins directories
are copied to the target location. Do not to delete any files in the
deployed web application. The features and plug-ins for each adapter
must be merged with the features and plug-ins of the web application.
- Restart the web application server.