This documentation applies to the 8.1 version of Remedy Action Request System, which is in "End of Version Support."

To view the latest version, select the version from the Product version menu.

Configuring your system for BPCU

Make sure that your CLASS path and Oracle Java Runtime Engine (JRE) are correctly configured to support the Best Practice Conversion Utility (BPCU).

To configure your system to run the BPCU

  1. On UNIX, grant yourself execute permission to the BPCU by typing the following command:

    chmod +x
  2. Make sure the following files are in your CLASS path:
    • arutilversionNumber.jar
    • arcmnappversionNumber.jar
    • bpcu.jar
    • commons-jxpath-1.3.jar
    • jaxb-api.jar
    • jaxb-impl.jar
    • jsr173_1.0_api.jar
    • log4j-1.2.14.jar
  3. To produce the BPCU differences report in XLSX format, make sure that the following files are in your CLASS path:
    • dom4j-1.6.1.jar
    • ooxml-schemas-1.0.jar
    • poi-3.5-FINAL-20090928.jar
    • poi-ooxml-3.5-FINAL-20090928.jar
    • xmlbeans-2.3.0.jar
  4. To specify the JRE for the utility, add the following entry to the appropriate file:

    set JAVA_HOME=<fullPathToJRE>


    Run BPCU with a 64-bit JRE.

    The BPCU uses the JRE specified by the JAVA_HOME environment variable in the following files:

    • (Windows)  bpcu.bat
    • (UNIX)
  5. To avoid out-of-memory issues, set Max Heap Size option in the bpcu.bat file to 4 GB.
  6. If you plan to run the BPCU on an AR System server that enforces encryption in its API, add the following items to the JRE that BPCU will use.

Files and providers to add to BPCU JRE on encrypted servers

Add to this directory or file

On Oracle Solaris, UNIX, and Windows

On IBM AIX and DB2, UNIX, and Windows










These files should be from IBM. 



<n> can be the last number in the section.



n can be the last number in the section.


If you have installed a BMC Remedy Encryption Security product on a BMC Remedy Java client, such as BMC Remedy Developer Studio or BMC Remedy Data Import, you do not have to verify that your configuration matches the preceding specifications. Instead, use the same Oracle Java Developer's Kit (JDK) and JRE used by the client for BPCU.

Related topics

FIPS encryption options

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.


  1. Roger Justice

    The Tip Run BPCU with a 64-bit JRE needs to be more promonent and is a requirement. To install 64 Bit JRE also requires a 64 Bit OS

    Apr 25, 2013 09:54
  2. Vivek Patil

    Single page for hash file is

    Apr 14, 2015 03:53