All KGS OSGi based products contain the KGS ProtocolWriter plugin inside its delivered packet (war):

• KGS Contentserver

• KGS Webservice

• KGS DocumentRouter

• KGS Scanserver

• KGS WriteCache

• KGS ReadCache

The plugin allows the using service to protocol several actions like create, put, get et cetera.

The protocol feature can be activated respective deactivated inside product specific configuration.

In case TiA core is used together with a CMIS conform repository, in addition to the ProtocolWriter plugin a TiA Core Module is recording. (e.g. via ElasticSearch)

The implementation is realized as OSGi service. The consuming components are acting as OSGi service consumers. The publish an protocol entry against the IProtocolWrite interface, defines in KGS Core bundle.

If there are several OSGi service listeners, every listener will receive the protocol entry and treat it accordingly.

Currently there are to such listeners existing:

• KGS ProtocolWriter plugin

• TiA Core

These services (listener) are independently of each other. This concepts empowers us to add or remove new listeners without influence the protocol entry sender nor other protocol listeners.

Remove protocol writer bundle

This section describes how to remove KGS ProtocolWriter bundle from delivered WAR.

It is also possible to remove the bundle during runtime.

In case that TiA Core is still recording, so it is possible to deactivate and remove KGS ProtocolWriter recording.

It is sufficient to remove the KGS ProtocolWriter plugin from WAR file, berfore installing the app into Tomcat.

Inside the WAR it is located in:

<WAR>\WEB-INF\eclipse\plugins\

Further adaptions are not required.

Optional:

OSGi starts bundles in a special pre-configured order.

This order is configured inside the WAR in:

<WAR>\WEB-INF\eclipse\configuration\config.ini

Open

The marked line can be removed but is not required since OSGi starts only bundle which are available. If the bundle is not found, OSGi just skips the start sequence for these bundle.

If these file is change, pay attention to the syntax. Every line with exception the last one is terminated by a comma, an space and a back slash as line feed.

Further information about this can be found here: https://kgs-software.atlassian.net/wiki/spaces/WIKI/pages/6750661

Configuration files

Is there is no configuration file during first start of ProtocolWriter plugin (even not inside WAR), it will create one in its config folder. The config file name will be Protocol Service.cfg. It is valid for all OSGi bundles.

<TomcatFolder>/webapps/<appname>/conf/protocol/Protocol Service.cfg

Was the WAR-Container pre-configured and the bundle removed, the config can be deleted as well. Otherwise it would be a zombie.

References in other configuration files

The ProtocolWriter is used by several KGS products. (list see above)

Every of these using KGS products have settings regarding protocol. e.g. :

../contentserver/ContentServer.cfg

Open

These keys has to be maintained. It is allowed to change it but the whole entry must continue to exist.

The parameters in the KGS products are controlling if the corresponding bundle (in this case KGS ContentServer) is publishing an protocol entry against the core interface. There may exist another listener like KGS TiA Core (AutoDigit) listening on protocol events.

A deletion would cause a rewriting of the config values with default values during restart.