KB Article #177116

API Gateway commands unable to run after Service Pack Upgrade

Problem

After upgrading an Appliance API Gateway installation with a Service Pack any command like nodemanager, managedomain or startinstance fails with the following error found in the terminal or trace file :-

ERROR 15/May/2015:11:49:41.038 [28e36f0] warning: failed to load crypto provider com.vordel.security.openssl.OSSLProvider

Note the API Gateway is using a non-root user "admin"

Resolution

The problem happens because the Service Pack will overwrite the file /opt/Axway/apigateway/system/conf/jvm.xml and Appliances or API Gateway software installs running from a non-root user require a special Java search path.

For the non root user the LD_LIBRARY_PATH will be nullified so the JVM needs this search path to find native libraries.

To restore the search path

Add the extra line below to the file system/conf/jvm.xml

It should be near the top of the file before this line

<JVMSettings classloader="com.vordel.boot.ServiceClassLoader">



For a 64 bit API Server installation add:

<VMArg name="-Djava.library.path=$VDISTDIR/$DISTRIBUTION/jre/lib/amd64/server:$VDISTDIR/$DISTRIBUTION/jre/lib/amd64:$VDISTDIR/$DISTRIBUTION/lib/engines:$VDISTDIR/ext/$DISTRIBUTION/lib:$VDISTDIR/ext/lib:$VDISTDIR/$DISTRIBUTION/jre/lib:system/lib:$VDISTDIR/$DISTRIBUTION/lib"/>



For a 32 bit API Server installation add:

<VMArg name="-Djava.library.path=$VDISTDIR/$DISTRIBUTION/jre/lib/i386/server:$VDISTDIR/$DISTRIBUTION/jre/lib/i386:$VDISTDIR/$DISTRIBUTION/lib/engines:$VDISTDIR/ext/$DISTRIBUTION/lib:$VDISTDIR/ext/lib:$VDISTDIR/$DISTRIBUTION/jre/lib:system/lib:$VDISTDIR/$DISTRIBUTION/lib"/>