Jeffrey's Sky

在 使用 PE WorkFlow 的过程中， 总会遇到流程中的一些异常情况。 如果，某些节点执行出现异常，Hang住等等。 因此，此时使用一些 PE下的工具尤为重要。

（1） vwtool 
 
      a. 启动
          vwtool -r <region number> -Y <admin user>+<pwd>

      b. 常用命令
          count *     : 列出所有系统 queue
          wobquery <Queue name>   : 在这里，可以列出队列里的内容，以及某个wobnum下的参数值等等，以便debug.

 (2) elog

      elog 记录了PE在启动运行过程中的事件, 包括 PE的system default locale. 
      elog 所在的位置在 \fnsw\local\logs\elogs folder (the same folder where you installed the Process Service software).
 

前几天，有机会自己实战了将刻好的AIX6.1系统（里面还有一些FileNet相关软件）盘恢复到一个IBM P570 Server 上。 其中，使用了HMC，设置引导程序。
现将过程记录如下：

     摘要: 在 WebSphere中 配置 Oracle Datasource 问题记录  阅读全文

     摘要:   阅读全文

CE 和 PE都有自己的客户端安装包。 这些安装包有助于CE，PE， AE间在相互通讯时不会因为某些小版本的改动而使得相互不匹配。

因此，注意，一定要， CE，PE间相互的Client端相互打好Patch.
还要将CE，PE的Client 端都给AE打一遍。

在Install & Config 完 IBM FileNet之后，一个重要的事情就是check所安装的AE，PE，CE是否安装正确、能够正常启动。 这里，简要列出一些check方法。

1. 启动 CE DB .
    与CE有关的一般有两个 DB。 一个 是 FNGCDDB用于记录 CE Domain的一些配置信息。 主要有以FNGCD为 prefix 的四个表（FNGCD, FNGCD_ADDON, FNGCD_CESERVERS, FNGCD_OSCBROWNERS)。 当你有需要想重新建立CE Domain的时候，最好将这四个表删掉，然后重新建。
     再一个DB就是 Object Store所在的DB，比如FNOS1DB. 在这个DB中，在建完Domain之后共有179张表。
 
      值得注意的是，CE App Server是通过 DataSource来连接CE的DB的。所以，如果，有任何CE DB的改变，也同时需要更改DataSource。 显而易见，因为有两个 CE DB，所以也有两套CE DataSource， 一个是用于连接 FNGCDDB（还有个以XA结尾的，这个在运行时经常被用到），一个是用于连接FNOSDB，即Object Store DB。CE 就是靠这两个Source来取得CE 信息的。

      Check CE 状态的方法：
      http://localhost:9080/FileNet/Engine.

2.  启动 AE。
由于 AE是一个 WebApp 程序，所以只需要启动 AE所在的 Server即可。
     
      Check AE 状态的方法：
     http://localhost:9080/Workplace

3. 启动 PE
PE 核心是一个 C++程序。在运行时， AE会尝试连接 PE，CE，而PE和CE之间也有连接关系。

Windows based 的PE server需要注意有两个系统 Service（通过 Service.msc）是需要起来的。 一个 叫 PE Service Manager,一个是Img ControlService；需要检查；

再有一个 重要的命令是 initfnsw,可以通过这个命令来起停 PE server。

① initfnsw start     //-启动PE
② initfnsw stop      //-停止PE
     killfnsw -y          //-停止PE
③ initfnsw status    //-查看PE状态
④ initfnsw restart   //-重启PE

另外， 检查 PE的状态，可以用这个URL 来 check，

http://localhost:32776/IOR/ping.

另外，有关 PE 和 CE间连接性的检查方法：

在 PE所在 Server上，用如下URL check，

http://localhost:32776/IOR/FileNet.CE.PEDirectoryServer

A "good" sample response from the PEDirectoryServer looks something like this:
IOR:000000000000002049444c3a46696c654e65745f63656d707270632f63656d707270633a312e300000000001000000000000007e000102000000000c31302e31352e372e31303800071d000000000031afabcb000000002084240cba00000001000000000000000100000008526f6f74504f41000000000800000001000000001400000000000002000000010000001800000000050100010000000000010109000000010001010000000026000000020002
 
此外，quick test are (on PE  server):

If you’re having trouble with the PE to CE communications, there may be something wrong with the java environment. Try the following tests in a command prompt window on the PE Server (Substituting appropriate host names, ports, user names, group names, and passwords as appropriate for your configuration):

On your PE Server:

cd \fnsw\bin

Try a basic "little pipe" ping:
\fnsw\java\jre\bin\java -classpath pe.jar;pe3pt.jar filenet.pe.ceorb.test.PEDirectoryClientTest /port=32776 /rpc=ping

Set the little pipe’s CE connection configuration:
\fnsw\java\jre\bin\java -classpath pe.jar;pe3pt.jar filenet.pe.ceorb.test.PEDirectoryClientTest /port=32776 /rpc=setConfig /uri=http://hqbpm34:7001/wsi/FNCEWS40DIME/ /user=PEAdmin /password=secret

Get a list of all realm names:
\fnsw\java\jre\bin\java -classpath pe.jar;pe3pt.jar filenet.pe.ceorb.test.PEDirectoryClientTest /port=32776 /rpc=getRealmNames

Get info about a user named PEAdmin:
\fnsw\java\jre\bin\java -classpath pe.jar;pe3pt.jar filenet.pe.ceorb.test.PEDirectoryClientTest /port=32776 /rpc=getUserInfo /user=PEAdmin

Get info about a user named PEAdmin in a specific realm:
\fnsw\java\jre\bin\java -classpath pe.jar;pe3pt.jar filenet.pe.ceorb.test.PEDirectoryClientTest /port=32776 /rpc=getUserInfo /user=PEAdmin /realm= dc=epbdc,dc=eng,dc=filenet,dc=com

Get info about a group named PEAdministrators:
\fnsw\java\jre\bin\java -classpath pe.jar;pe3pt.jar filenet.pe.ceorb.test.PEDirectoryClientTest /port=32776 /rpc=getUserInfo /user=PEAdministrators

Get “group expansion info” for a group named PEAdministrators:
\fnsw\java\jre\bin\java -classpath pe.jar;pe3pt.jar filenet.pe.ceorb.test.PEDirectoryClientTest /port=32776 /rpc=expandGroup /group=PEAdministrators

The above runs should produce output of some sort that might shed light on a CE configuration or connection problem…

取得 PE run 的 LOG：
Get some detailed information about the PE to CE communications

If the PE still can not get connected to the CE, we need to enable some of the java tracing to see what’s happening when the PEDirectoryServer communicates with the CE.

For PE 4.0.2 and newer, including PE 4.5

To enable the tracing, we need an fnlog4j.properties file in the \fnsw\java\jre\lib directory on the PE Server. The fnlog4j.properties file needs to include a line something like this:

log4j.logger.filenet.pe.ceorb.server=DEBUG, TXT

The easiest way to do this is to copy the \fnsw_loc\sd\fnlog4j.properties.sample file as \fnsw\jre\lib\fnlog4j.properties (without the “.sample”). Then, using a simple text editor (e.g., notepad), add the “, TXT” to the above line of text in the fnlog4j.properties file.

The PEDirectoryServer will see the fnlog4j.properties file and that will trigger additional tracing and logging to occur. After putting the fnlog4j.properties file in the \fnsw\java\jre\lib directory, click the Apply button in the Process Task Manager’s Security tab again.

After it fails, check the java trace file. The location of the java trace file is defined in the fnlog4j.properties file itself. By default, it's c:\PE.txt.

3. 检查 connection to PE from AE.

在登录到 AE 之后，可以点击 AE Site Preference中 Task Pages页面，看是否能打开。以及PCC， Process Designer是否都能够打开以及 Transfer Workflow.

     摘要: 配置 （Configure) Application Engine (AE)  阅读全文

     摘要: 开源软件问题记录系列 之一 在 Tomcat 中设置 Datasource  阅读全文

由于使用了 TDS 作为 FileNet 的 LDAP 系统，所以一定要在 WAS中将Admin Security enable。 这时，需要注意的是如果没有在 WAS 的 Global security 中将 Application Security Enable,那么在配置 Content Engine (CE) Domain 的时候，就会出现 Annoymous user cannot access to CE 的错误。 所以，一定要同时 Enable Application Security.

     摘要: 安装配置 IBM Filenet 所遇问题记录系列  阅读全文

   Java 提供了远程debug的功能，这确实是一件很好的事。它能够帮助我们在一些没有虚机的OS（比如HP,AIX，等等）下调试我们的程序。

   1.建立Remote debug的准备工作。
    a.可以将这些在java命令行中的设置放到一个script中去。例子如下所示：
 
    java -Xdebug -Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=y  -classpath
    其中，“-Xdebug -Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=y”是必须的。suspend=y---表明是在程序启动后hang在那个端口处并监听（如果设为n，则不会hang）；address=8787---表明是在远端机器上的端口号。除此之外，在java后也可以添加java的系统环境变量，如-D等等。   
    b.在eclipse中可以通过设立一个remote debug的方式来建立这种连接。  
   2.远程调试时，局部变量的值无法Watch/Inspect问题的解决
    这实际上是由eclipse在build的时候，没有将javac后的option -g加上去。只有当加上 -g这个参数时，所有的调试信息才会被build到class文件中去。
    但ecipse没有提供这样在build时设置参数的user interface。所以，最好的方式就是写一个Ant脚本。
    例子如下，

     <?xml version="1.0" encoding="UTF-8" standalone="no"?>
    <project basedir="." default="build" name="ssdv">
    <property name="build.location" value="../ssdv_build"/>
    <property name="debuglevel" value="source,lines,vars"/><!--必须的-->
    <property name="target" value="1.5"/>
    <property name="source" value="1.5"/>
    
    <target name="init">
        <mkdir dir="bin"/>
    </target>
    
    
    <target name="clean">
        <delete dir="bin"/>
    </target>
   
    <target depends="init" name="build-project">
        <echo message="${ant.project.name}: ${ant.file}"/>

        <javac debug="true" debuglevel="${debuglevel}" destdir="bin" source="${source}" target="${target}">  <!--必须的-->
            <src path="."/>
            <classpath refid="ssdv.classpath"/>
        </javac>

    </target>
    
</project>
   
     这样，将生成的build工程拷贝到要测试的远程OS。启动脚本，然后就可以看到local variables了。

    前一段时间在开发了一个做文本分析的项目。在项目技术选型的过程中，尝试使用了Drools规则引擎。让它来作为项目中有关模式分析和关键词匹配的任务。但后来，因为某种原因，还是撇开了Drools。现将这个过程中使用Drools的一些经验和心得记录下来。
（一）什么时候应该使用规则引擎
    这实际是一个技术选型的问题。但这个问题又似乎是一个很关键的问题（一旦返工的话，你就知道这个问题是多么重要了）。不知大家有没有过这样的经验和体会。往往在项目开始的时候，总会遇到应该选用什么技术？是不是应该使用最新的技术？或者应该选用什么技术呢（PS：现在计算机软件中的各种技术层出不穷，具有类似功能的技术很多）？
    不管怎么样，这些问题总会困扰着我。比如，这次的这个项目。项目要求是要在一些log文件中（这些log文件都是很大的应用系统所产生的，但由于legacy的原因，log本身的维护和规范工作一直没有得到改善，所以想借助于一些外部应用对这些log做以分析和清洗）抽取出有用的信息。
    于是，第一个想到的就是，这是一个文本挖掘类的项目。但又想，要抽取有用信息，必须得建立一些规则或pattern（模式）。所以，我第一个想到了规则引擎。因为这里面要建立好多规则，而这些规则可以独立于代码级别（放到一个单独的drl文件里）并可以用规则引擎去解析和执行。另一个重要的原因是，我原来用过，比较熟悉。这样，也可以节省开发时间吧。于是，好不犹豫的就开始做了Demo....
    但事实上，在经历了一个多星期的编码、测试后，我发现运用规则引擎实在是太笨拙了。
    （1）首先必须建立一些数据模型。通过这些模型来refer规则文件中的LHS和Action。
    （2）还要考虑规则的conflict。如果有一些规则同时被触发，就要考虑设定规则的优先级或者是设定activiation-group来保证在一个group中的规则只有一个规则可以被触发。
    （3）对于‘流’规则group ruleflow-group的使用。如果要控制在workingmemory中的规则被触发的顺序，则可以将这些规则分组。然后，通过规则建模的方式来实现。但这也添加了一定的effort。修改或者更新不大方便。
    所以，基于上述体会，我更认为规则引擎更适用于那些对非流程性规则匹配的应用。当然，Drools也支持对流程性规则的建模过程。但，这也许不是最好的方式。
（二）Drools规则引擎的使用杂记
    （1）Fact 的变更监听。在Drools里，如果一个Fact通过规则而改变，则需将这种改变通知给规则引擎。这里，一般有两种方式：显式和隐式。
         显式---在drl文件中通过 update、modify来通知；在程序中，通过Fact的引用调用modifyObject等方法来实现。
         隐式---通过在java bean实现property Listener Interface来让引擎自动监听到属性值的变化。我更习惯于这种方式。因为，一般看来凡是在规则引擎中添加到fact都是希望引擎来帮你进行管理的。所以，那它自己看到fact的变化是种很省事的办法。也很简单，就是用java bean property 监听的方式。
         通过StatefulSession来注册。
         调用StatefulSession的某个instance 的insert（Object，true）实现。而这个object是一个java bean。其中，要实现
      
         private final PropertyChangeSupport changes  = new PropertyChangeSupport( this );
    public void addPropertyChangeListener(final PropertyChangeListener l) {
        this.changes.addPropertyChangeListener( l );
    }

    public void removePropertyChangeListener(final PropertyChangeListener l) {
        this.changes.removePropertyChangeListener( l );
    }
  
        然后在set方法中调用
    this.changes.firePropertyChange( "temp",null,this.temp );
     （2）规则触发的优先级、组设置
    往往，在设计我们自己的规则时，要考虑规则的触发条件。这不仅限于LHS的条件部分，还有规则本身被触发的有些设置等等。这里，列出一些比较常用和有效的规则优先级设置方式，以及需要注意的地方。
         A.通过Salience方式。此值可正可负。越大优先级越高，也会被引擎首先执行。
         B.通过ruleflow-group 方式。实际上，使用这种方式也就是在使用建立规则流的方式。在Eclipse 3.3 中，Drools提供了建立规则流的插件。要在drl的同级目录中建立rf和rfm两个文件（当然，插件会帮助你建立这些）。
        
选择RuleFlow File。
      这里，需要注意的一点是要在启动规则引擎的时候，加入启动rule flow的代码。

     InputStreamReader source = new InputStreamReader(RuleManager.class
                    .getResourceAsStream(rule_path));
           PackageBuilder builder = new PackageBuilder();
            builder.addPackageFromDrl(source);
            builder.addRuleFlow(new InputStreamReader(RuleManager.class
                    .getResourceAsStream(rule_flow_path)));
           Package pkg = builder.getPackage();
            RuleBase ruleBase = RuleBaseFactory.newRuleBase();
            ruleBase.addPackage(pkg);
      然后，在每次启动规则引擎的时候，调用如下方法：

            StatefulSession ss;
            ss.startProcess(flowProgress)；
            ss.fireAllRules();

            flowProgress 是一个string类型。这个flow的名字。

这个rule flow图中，显示了一个简单的规则流。如RSA就是一个rule-flow的名字。在这个rule set中可以设定一组rules。这样，就可以分开规则执行的顺序。在于rf和rfm同名的另一个 drl文件中定义这些组的名字。通过关键字 ruleflow-group 来表明。
    C.通过activation-group的方式。通过这种方式，可以exclude一组rule中一旦有一个rule被invoke，而其它rule不会被execute。同时，可以搭配使用salience关键字来标明每个rule的优先级，这样就能够使得你想要的一般性概念的rule先被匹配执行。
    D.在使用ruleflow-group 的时候要注意使用lock-on-active true 关键字在每个rule。这样可以避免一旦有rule被触发，不会造成循环匹配执行。
    E.如果在LHS部分，需要调用某个方法来返回真、假值作为判断的一个条件，那么可以用eval函数。
    如，eval(pattern.matched(5,$line.getCurrLine()))
    其中，pattern是某个加入到workingmemory中的一个实例。matched是这个实例所代表类的一个方法。它返回boolean类型。
   
  (3)Drools规则引擎的使用感受
    总之，Drools还是一个很不错的开源规则引擎。现在v4.0以上的版本已经比以前的版本在速度上有了很大的提升。可以作为我们一般应用程序系统的中间件产品（那些规则不是很经常改变的系统，已经非流程类规则）。但是，这其中还是需要一些额外的effort来学习它的使用文档以及整体架构，有一定的学习曲线。
  
    最后，我想一个较好的对于技术使用的practice就是：首先知道它能为你做什么，它最好的应用领域，然后再去深入。
   
    （PS:如果谁有使用Drools的问题，可以联系我！一起讨论！）