Troubleshooting Java ARS application with Premium Encryption enabled. Encounter 'ERROR (9010): The encryption library was not found and cannot be loaded; Need to install the encryption on the client'

Version 24
    Share:|

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    PRODUCT:

    Remedy AR System Server


    COMPONENT:

    Remedy AR System Server



    PROBLEM:

     

    Home grown Java ARS application fails to create Incidents with Premium Encryption enabled.

    LP: BMC Remedy AR System Server 8.1.00
    DR: AR System 8.1.00


    We have a home grown application that uses the ARS Java API to create Incidents. This application lives on a Windows 2008 64-bit server. At this time we are upgrading Remedy 8.1 and the application is unable to create Remedy Incidents against 8.1 with Premium Encryption enabled.


    We ran the premiium encruption installer on the Windows 2008 server, however the installer does not install correctly for third party applications that don't house
    AR system compoenents. At this time I need to better understand the files/libraries needed in order for Premium Encryption to work correctly with any third party application?

    Below is the ARERR error message that we get when we attempt to create Incidents:

    2014-01-16 09:33:08,426 ERROR [STDERR] ERROR (9010): The encryption library was not found and cannot be loaded; Need to install the encryption on the client
    2014-01-16 09:33:08,426 ERROR [STDERR] at com.bmc.arsys.api.ProxyJRpc.getRpcClient(Unknown Source)

    Server Platform: Linux Red Hat EL 4.x
    Client Platform: Windows XP Professional
    Database: Oracle 10g
    Web Server: Apache Tomcat

    Issue Summary: Home grown Java ARS application fails to create Incidents with Premium Encryption enabled.

     

     


    SOLUTION:

     

    Legacy ID:KA409337

      

    On the client side check the following jar files are installed in the respective Java JRE installation.

      

    These jar files should be under the lib/ext folder in the java installation.

      

    jsafeJCEFIPS.jar
    bcprov-jdk15-133.jar

      

    The JCE Unlimited Strength Jurisdiction policies within these jar files under the lib/security folders are modified:
    US_export_policy.jar
    local_policy.jar

      


    To confirm the modifications open the jar file using a  compression application like winzip, winrar and look at the Manifest.MF file in both jar files.  Confirm there are similiar entries as shown below.  Note the 'Crypto-Strength: unlimited' entry below.

      

    Manifest-Version: 1.0
    Crypto-Strength: unlimited
    Created-By: 1.6.0_14 (Sun Microsystems Inc.)

      

    Name: default_local.policy
    SHA1-Digest: +beVknwz6yLU+e2+9gIi2MjowbM=

      

    You can also test the Java directory has the needed files by connecting to the remedy server using the JavaDriver utility located in the ARSystem\api\lib folder. On the Windows platform execute the javadriver.bat file residing in this same folder.  On Linux/Unix platforms you can drop the attached javadriver.sh.gz file to the same directory.  Uncompress the file and modify the file making the needed changes to reflect the correct path your api/lib directory and the Java JRE directory.  If the utility connects successfully this confirms the java has the needed encryption files.

    Attached are files jdriver_ARS81.tar.gz and jdriver_ARS81.zip. Both have the same java driver utility from ARS 8.1 that can be used on remote client systems to test the remote client encryption connections where there remedy server is not installed.

      

    ==========================
    Referenced material:

      

    BMC Remedy Encryption Security modifications to the JRE
    https://docs.bmc.com/docs/display/public/ars81/BMC+Remedy+Encryption+Security+modifications+to+the+JRE

      

    Using C driver tool that can be used as guidance to also run the JavaDriver utility

      

    https://docs.bmc.com/docs/display/public/ars81/Using+the+driver+program?src=search&src=search

      
    Related Products:  
       
    1. BMC Remedy AR System Server

     


    Article Number:

    000107872


    Article Type:

    Solutions to a Product Problem



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles