All KGS OSGi based productscontain the KGS ProtocolWriter plugin inside its delivered packet (war):
KGS Contentserver
KGS Webservice
KGS DocumentRouter (3.x & 4.x)
KGS Scanserver
KGS WriteCache
KGS ReadCache
The plugin allows the using service to protocol several actions like create, put, get et cetera.
...
| Note |
|---|
The config.ini is evaluated only once at deployment time. Therefore a change of config.ini required a complete redeployment of this WAR-File. Changing the file in already deployed applications does not have any effect. |
Zugehörige Konfigurationsdateien
Wird der ProtocolWriter gestartet und es ist noch keine Konfiguration im Vorfeld in dem WAR enthalten (Default-Auslieferung), so legt der ProtocolWriter selbstständig in seinem config-Ordner (…/protocol/) eine neue Konfiguration mit dem Namen “Protocol Service.cfg” an. Dies gilt für alle OSGi Bundles.
Wurde der WAR-Container aber bereits vorkonfiguriert (<WAR>\conf\protocol\Protocol Service.cfg), so kann dieser Ordner (ab inlusive “protocol”) entfernt werden. Diese Dateien sind ohne das Bundle / die JAR Datei verwaist.
Referenzen in anderen Konfigurationsdateien
...
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.
| Note |
|---|
For an Oracle database, please see the following article . |
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
z.B.
...
Diese Einträge (KEYs) müssen behalten werden. Es ist erlaubt die Werte (true und false) zu ändern, der gesamte <entry>-Zeile muss aber in der Konfiguration weiterhin existieren.
Die Parameter in den KGS Produkten steuert, ob das Bundle (hier: KGS Contentserver) ein Protokolleintrag an das OSGi weitergibt und welche Art von Protokolleinträgen es weitergibt. Insofern ein zweiter Service-Listener (wie KGS TiA Core [AutoDigit]) im Framework existiert, so wird dieser nur ausgelöst, wenn Protokolle an das OSGi Framework weitergegeben werden.
...
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.