Rational® Publishing Engine comes
with a sample application that demonstrates executing pre-configured
document specifications locally or remotely with the API.
About this task
The application can be found in RPE_HOME/lib/api/example.
The home folder from your project is used at build time if no value
for the -home option is provided. When deploying
the application, you must provide the home folder in the same folder
as the .jar file for the application to find
the home folder.
Procedure
Open RPE_HOME/lib/api/example.
Extract the com.ibm.rational.rpe.examples.zip archive.
Provide your application access to the necessary .dll and
.so files in the Rational Publishing Engine library.
Important: The .dll and .so files provided in
the root directory of the example archive might not be applicable to your environment.
32-bit applications:
RPE_HOME/lib/rcl_telelogic.dll
RPE_HOME/lib/librcl_telelogic.so
64-bit applications:
RPE_HOME/lib/64/rcl_telelogic.dll
RPE_HOME/lib/64/librcl_telelogic.so
To provide the application access to these files, you can either:
Add the filepaths to the application startup script. This option ensures that your
application is self-contained no matter where it runs.
Add the filepaths to the PATH system variable. If you choose this option,
you must complete this step on every computer that uses the application.
Copy the plug-ins in the lib directory
in the Rational Publishing Engine installation
files.
To build 32-bit applications, copy the plug-ins in the RPE_HOME/lib directory.
To build 64-bit applications, copy the plug-ins in the RPE_HOME/lib/64 directory.
Paste the plug-ins in the lib directory
of the extracted example archive. Do not copy the .dll or .so files. Example: project/lib
Open the RPE_HOME/config directory.
Copy the rpeconfig.xml and RPEElementsDefinitions.xml files.
Paste the rpeconfig.xml and RPEElementsDefinitions.xml files
into the home/config folder of your example. The example is designed to use the log4j.properties file
from the root of the src folder and cannot use
the file from the home/config folder, even if
provided.
Optional: To generate documents from Rational
DOORS®, copy the RPE_HOME/source/DOORS
and RPE_HOME/source/DB Structure folders.
Optional: Paste the DOORS and DB
Structure folders in the home/source folder
of your project.
Copy the RPE_HOME/utils/Word and %RPE_HOME%/utils/HTML folders.
Paste the Word and HTML folders
into the home/utils of your project.
Update the class paths with the paths to the plug-ins in
the project.