Description:
Description:
=====================
Configuration changes required in TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces 2.0 to work with ActiveSpaces  2.1.1 security features

Environment:
==================

Applicable in all the BW-AS plugin running environments ,  ActiveSpaces Standalone  

Symptoms:
==========
BW-AS plugin 2.0 is tested with ActiveSpaces 2.1.1 security features.  In order run plugin without any issues some configuration
changes are required in the designer and BW engines. With latest GA  ActiveSpaces 2.1.1 and BW-AS plugin 2.0  you may see below error

Error loading as-common dynamic loadable library. Check that your PATH (or LD_LIBRARY_PATH) environment variables are setup correctly and that you have the appropriate architecture installed

java.lang.ExceptionInInitializerError
    at com.tibco.as.space.impl.ASMetaspace.&ltinit>(ASMetaspace.java:148)
    at com.tibco.as.space.ASCommon.connectMetaspace(ASCommon.java:158)
    at com.tibco.as.space.Metaspace.connect(Metaspace.java:77)
    at com.tibco.plugin.as.service.ASMetaspaceConfiguration.getMetaspace(ASMetaspaceConfiguration.java:171)
    at com.tibco.plugin.as.metaspace.MetaspaceResource$ConnectingMetaspace.doWork(MetaspaceResource.java:117)
    at com.tibco.plugin.as.metaspace.MetaspaceResource$ConnectingMetaspace.doWork(MetaspaceResource.java:92)
    at com.tibco.plugin.ui.BusyWaitRunner$RunWorker.run(Unknown Source) Caused by: com.tibco.as.space.RuntimeASException: java.lang.UnsatisfiedLinkError: C:\tibco\as\2.1\lib\as-common.dll: The operating system cannot run %1
    at com.tibco.as.space.impl.NativeImpl.loadLibrary(NativeImpl.java:47)
    at com.tibco.as.space.impl.NativeImpl.init(NativeImpl.java:31)
    at com.tibco.as.space.impl.NativeImpl.&ltclinit>(NativeImpl.java:23)
    ... 7 more
Caused by: java.lang.UnsatisfiedLinkError: C:\tibco\as\2.1\lib\as-common.dll: The operating system cannot run %1
    at java.lang.ClassLoader$NativeLibrary.load(Native Method)
    at java.lang.ClassLoader.loadLibrary1(Unknown Source)
    at java.lang.ClassLoader.loadLibrary0(Unknown Source)
    at java.lang.ClassLoader.loadLibrary(Unknown Source)
    at java.lang.Runtime.loadLibrary0(Unknown Source)
    at java.lang.System.loadLibrary(Unknown Source)
    at com.tibco.as.space.impl.NativeImpl.loadLibrary(NativeImpl.java:39)
    ... 9 more


Resolution:
==========

1) %AS_HOME%/lib; %AS_HOME%/bin need to be added in " PATH (or LD_LIBRARY_PATH)  environment variable " before RV_HOME

2) %AS_HOME%/lib; %AS_HOME%/bin  need to be added in " tibco.env.PATH " before RV_HOME in both  
designer and bwengine.tra.  Existing projects need to redeploy again.

Note :

1) Reading security you need to configure the location of security policy or token file in the BW-AS project. Also, if you use field level encryption on any space, you need to mark those fields encrypt-able (and enable data encryption for the corresponding domain in your policy. Refer AS admin guide chapter 5 on “Administering ActiveSpaces Security” , developer guide chapter 4 “Implementing ActiveSpaces Security” and examples on ActiveSpaces Security.

2) The designer provides location to configure security policy and token file but did not  provide configuration for authentication details like username and password.  You need to start BW process using BW engine (command line) and not through designer

3) libeay32.dll and ssleay32.dll files related to openssl may be exist in the  “C:\Windows\System32\” path.  Remove(or change the extension ) these files and so that AS security will pick libeay32.dll and ssleay32.dll from the AS_HOME\lib
Symptoms:

Cause:

Configuration changes required in TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces 2.0 to work with ActiveSpaces2.1.1 security features