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了。