QConnector

{{toc}}

h1. Administration

Describes how to administrate the common tasks, for instance, update properties files, change logging level and etc.

h2. Monitor Log Files

All of the log files can be found in :

<pre>

{jboss folder}/server/{profile name}/log/qconnector/info.log

{jboss folder}/server/{profile name}/log/qconnector/error.log

{jboss folder}/server/{profile name}/log/qconnector/debug.log

</pre>

The log file rotates *daily* or every *10MB* for maximum *100 files*.

h2. Change Logging Level

The available logging level:

* *INFO* - default level

* *DEBUG* - should not set to this level unless necessary

* *ERROR*

* *WARN*

_JBoss 4.0.x_

> {jboss folder}/server/{profile name}/conf/log4j.xml

_Jboss 4.2.x / Jboss 5.1.x_

> {jboss folder}/server/{profile name}/conf/jboss-log4j.xml

h2. Update Properties Files

All of the properties files can be found in:

<pre>

/data/qconnector

</pre>

h3. ws-mimic

List of the properties files:

* /data/qconnector/application.properties

* /data/qconnector/jndi-factory.properties

* *application.properties*

|_.Property name|_.Description|

|ws.url|The URL of the web service which process the request|

|status.callback.url|the callback URL of the caller to update the status, e.g. Dot Com mall |

* *jndi-factory.properties*

|_.Property name|_.Description|

|jndi.initial|the initial context of the JNDI|

|jndi.url|the URL of the JNDI provider (JMS)|

|jndi.url.pkgs|the naming packages of the JNDI|

|jndi.connection.factory|the JNDI name of the JMS connection factory|

|session.cache.size|the number of JMS session to be cached|

|request.queue.name|the name of the JMS queue which keeps the web service request|

|response.queue.name|the name of the JMS queue which keeps the web service response|

h3. ws-status

List of the properties files:

* /data/qconnector/ws-status/database.properties

* database.properties

|_.Property name|_.Description|

|jndi.datasource|the JNDI name of the data source|

|db.dialect|the database dialect, e.g. DB2|

|db.show.sql|indicates whether to show the SQL used|

|db.sql.comment|indicates whether to show the comment of the SQL used|

h3. ecosway-adaptor

List of the properties file:

* /data/qconnector/ecosway-adaptor/application.properties

* /data/qconnector/ecosway-adaptor/database.properties

* /data/qconnector/ecosway-adaptor/registration/template.properties

* *application.properties*

|_.Property name|_.Description|

|ws.url|the URL of the web service. Currently this is the URL of the mimic of the actual web service|

* *database.properties*

|_.Property name|_.Description|

|jndi.datasource|the JNDI name of the data source|

|db.dialect|the database dialect, e.g. DB2|

|db.show.sql|indicates whether to show the SQL used|

|db.sql.comment|indicates whether to show the comment of the SQL used|

* *registration/template.properties*

|_.Property name|_.Description|

|registration.template|the template of the web service request|