Wednesday, June 20, 2012

hornetQ high available cluster, step by step

well, unlike jboss cluster, hornetq cluster work on shared/common storage space that could be a SAN shared disc or even NFS mount, though best option is SAN disc, you must keep in mind that both cluster members will not write simultaneously on shared disc as oracle RAC do, but they will use it to validate master/live server health, soon master/live server die, slave/backup server will replace it and from passive started state will move to active started state and all persistent messages of queues will be served from slave/backup server. This failover process is automatic, even when master/live server will come back online, the slave/backup server will again set itself automatically to passive started mode and will leave master/slave to take the control of queues and client requests/responses.

hornetQ offer two type of cluster solution i.e. load-balance plus failover and just failover not load-balance, in our case we is used just failover not load-balance. i have little edited the official hornetq cluster diagram, below, because for no good reason they made shared storage in two separate places and then the storage show no link among each other, while actually it must be single storage with link to both Live and Backup server.

for more details you must consult official guide or check below my step by step for hornetQ cluster installation.

the startup script was made by our development team as they like to pass JVM arguments inside script, though yo can use default which is more easy to understand.

find below step by step for hornetQ high available cluster.



Tuesday, June 12, 2012

ETPM, Documaker, JMS, LDAP, Database, Conceptual and abstract workflow diagram

ladies, if you are unable to understand how ORACLE ETPM, ORACLE Documaker, JMS/HornetQ, LDAP/OpenDS and Database/Exadata should work together, here is the lazy drawn diagram, i hope you will get an idea about what i have been implementing recently :)

you may consider it as ETPM application data center conceptual design as well;


Thursday, June 7, 2012

step by step ORACLE Documaker 12.0 installation & configuration on Linux 64x

believe me or not, but this one is gem, it is almost impossible to understand installation steps from ORACLE's bleeding ass Documaker installation manuals, i took the courage to prepare it, you must contact me if you get confused at some step!

here we go:

step 01: download V29335-01 & V29336-01 from

step 02: download jre1.6_0_32 from

step 03: copy all downloads to /u01/app/documaker/documaker-source

step 04: install JRE 32bit

[cissys@documaker-host documaker-source]$ cd /u01/app/documaker/documaker-source
[cissys@documaker-host documaker-source]$ chmod +x jre-6u32-linux-i586.bin
[cissys@documaker-host documaker-source]$ ./jre-6u32-linux-i586.bin
[cissys@documaker-host documaker-source]$ mv jre1.6.0_32/ ../

step 05: install Documaker engine

[cissys@documaker-host documaker]$ mkdir rel120p01
[cissys@documaker-host documaker]$ mkdir dm-env
[cissys@documaker-host documaker]$ cd documaker-source
[cissys@documaker-host V29335-01]$ chmod +x * -R
[cissys@documaker-host V29335-01]$ ./setuprterp120p01b15380.lnx

* * * Documaker RP 12.0 (Turnover Level p01b15380) (Type RTE) Installation/Update * * *
Loading, Please Wait ...

Please select an Installation/Update Directory:
Press to accept default:

Install Documaker RP 12.0 (RTE) to ?
{y or n}?>y

Updated Base Components ...

RTE Installation Complete.

[cissys@documaker-host documaker-source]$ cd V29336-01
[cissys@documaker-host V29336-01]$ chmod +x *
[cissys@documaker-host V29336-01]$ ./setuprteids023p00b713.lnx

* * * Docupresentment 2.3 (Patch Level p00b713) (Type RTE) Installation/Update * * *
Loading, Please Wait ...

Please select an Installation/Update Directory:
Press to accept default:

Install Docupresentment 2.3 (RTE) to ?
{y or n}?>y

Install/Upgrade in progress.  Please wait...
Updated Base Components ...

Install/Upgrade Base Components Complete.

Where is your 32-bit Java Run-time (JRE) Location?
 ( Example:  /opt/jdk1.6.0_24_x86/jre )
JRE Version=java version "1.6.0_32"

Option for WatchDog Error SMTP Email Notifications:
Do you want to configure this option now?
  (Note: You can manually configure it later in the log4j logconf.xml file)
{y or n}?>n
Installing Setup Files ...
Please Wait ...
New Installation Components Installed ...

RTE Installation Complete.

[cissys@documaker-host V29336-01]$ ./sharedobjs120p01b15380.lnx

* * * Documaker RP Shared Objects Bridge 12.0 (Turnover Level p01b15380) Installation/Update * * *
Loading, Please Wait ...

Please identify your Docupresentment Installation/Update Directory:
Note: Docupresentment directory must already exist.
Press to accept default:

Install Docupresentment Documaker RP Shared Objects Bridge 12.0 (Turnover Level p01b15380) to ?
{y or n}?>y

Installation/Update in progress.  Please wait...
Updated Base Components ...

Installing Setup Files ...
Setup files detected (docserv.ini|docserv.xml)
Overwrite setup files?{y or n}?>y
Overwrite in progress...
Please Wait ...
New Documaker RP Shared Objects Bridge Installation Components Installed ...

Setting up docserv.xml to use jre located at ...

Installation Complete.
step 06: start/stop documaker

[cissys@documaker-host docserv]$ cd /u01/app/documaker/dm-env/docserv
[cissys@documaker-host docserv]$ ./ status/start/stop

step 07: configuration of Documaker environment.

[cissys@documaker-host docserv]$ cd /u01/app/documaker/dm-env/docserv
[cissys@documaker-host docserv]$ cp ../../documaker-source/dm-env_orig/dm-env/docserv/docserv.xml 
[cissys@documaker-host docserv]$ cp ../../documaker-source/dm-env_orig/dm-env/docserv/logconf.xml 
[cissys@documaker-host docserv]$ cp ../../documaker-source/uat_orig/dm-env/docserv/dap.ini .
[cissys@documaker-host docserv]$ cp ../../documaker-source/uat_orig/dm-env/docserv/app.ini .
[cissys@documaker-host uat]$ vi /u01/app/documaker/dm-env/mstrres/appdir/app.ini


Wednesday, June 6, 2012

step by step ROCKEYE configuration to test JMS (HornetQ) and sending message to Documaker

yumm yumm, after installing JMS/HornetQ and ORACLE's Documaker you would like to test the queues and want to see if messaging between Documaker and HornetQ is working?

Chris introduce me to ROCKEYE tool which is pretty cool tiny desktop application, it helps you to validate your HornetQ and Documaker configuration...though on Documaker part the JMS queues are not properly implemented so you might get some strange harmless warnings and errors :) but you can keep your eyes close on them!

you can check below step by step how to configure ROCKEYE on your desktop.


Friday, June 1, 2012

step by step tomcat on ETPM App Server

ok, i know it has been overwritten, but i had to dump it somewhere and blog is the best place to leave my ETPM snail wax! :)

step 01: [amadm@etpm-hostname ~]$ cd /opt/tomapp  --- tomcat installation base directory

step 02: download latest tomcat release from

step 03: copy apache-tomcat-7.0.27.tar.gz to /opt/tomapp

step 04: verify if downloaded file is correct.

[amadm@etpm-hostname  ~]$ md5sum apache-tomcat-7.0.27.tar.gz
486769ec1094fb45f000d30f237b3643  apache-tomcat-7.0.27.tar.gz

now compare the value with
if both values are same, it mean download is correct.

step 05: [amadm@etpm-hostname  ~]$ tar xvf apache-tomcat-7.0.27.tar.gz

step 06: create link:

[amadm@etpm-hostname  ~]$ ln -s apache-tomcat-7.0.27 apache-tomcat

step 07: start & stop tomcat

[amadm@etpm-hostname bin]$ cd /opt/tomapp/apache-tomcat/bin/
[amadm@etpm-hostname bin]$ ./
[amadm@etpm-hostname bin]$ ./