Difference between revisions of "AppSuite:DocumentConverterUpdate782"

(initial description of the update)
 
m (Update Documentconverter from earlier versions to 7.8.2)
Line 13: Line 13:
 
Starting with 7.8.2 it's new home is
 
Starting with 7.8.2 it's new home is
 
  /opt/open-xchange/documentconverter/etc/documentconverter.properties
 
  /opt/open-xchange/documentconverter/etc/documentconverter.properties
Note: If the file is moved from the old to the new location with all settings the entries
+
 
com.openexchange.documentconverter.blacklistFile and com.openexchange.documentconverter.whitelistFile have to be changed.
+
Note: If the file is moved from the old to the new location with all items the path settings in
 +
'com.openexchange.documentconverter.blacklistFile' and 'com.openexchange.documentconverter.whitelistFile' have to be changed.
  
 
Futhermore logging needs to be configured separately from the middleware setting. A logback.xml file dedicated to the document converter process can be found at
 
Futhermore logging needs to be configured separately from the middleware setting. A logback.xml file dedicated to the document converter process can be found at
 +
<pre>
 
  /opt/open-xchange/documentconverter/etc/logback.xml
 
  /opt/open-xchange/documentconverter/etc/logback.xml
 +
</pre>
 
And don't forget to enable / (re)start the documentconverter service in addition to the OX App Suite middleware.
 
And don't forget to enable / (re)start the documentconverter service in addition to the OX App Suite middleware.
  
For configuration of apache and munin monitoring see ...
+
For configuration of apache and munin monitoring see the Installation Guide.
 +
 
 +
<!--
 
apache conf (if used): separate balancer entry required, port changed
 
apache conf (if used): separate balancer entry required, port changed
 
Adapt /etc/munin/plugin-conf.d
 
Adapt /etc/munin/plugin-conf.d
 +
-->
  
 
=== Middleware (aka Backend or Documentconverter Client) ===
 
=== Middleware (aka Backend or Documentconverter Client) ===
  
The property pointing to the documentverter service has to be adjusted. It is now mandatory to set this entry – not only in the remote documentconverter setup but also if the documentconverter runs locally.
+
The property pointing to the documentconverter service has to be adjusted. It is now mandatory to set this entry – not only in the remote documentconverter setup but also if the documentconverter runs locally.
 
The property used changed from  
 
The property used changed from  
 +
<pre>
 
/opt/open-xchange/etc/documentconverter.properties:
 
/opt/open-xchange/etc/documentconverter.properties:
 
com.openexchange.documentconverter.RemoteBaseUrl=
 
com.openexchange.documentconverter.RemoteBaseUrl=
 +
</pre>
 
to  
 
to  
 +
<pre>
 
/opt/open-xchange/etc/documentconverter-client.props: com.openexchange.documentconverter.client.remoteDocumentConverterUrl=
 
/opt/open-xchange/etc/documentconverter-client.props: com.openexchange.documentconverter.client.remoteDocumentConverterUrl=
 +
</pre>
 +
 
For a single-node deployment this reads (in one line)
 
For a single-node deployment this reads (in one line)
 +
<pre>
 
com.openexchange.documentconverter.client.remoteDocumentConverterUrl=
 
com.openexchange.documentconverter.client.remoteDocumentConverterUrl=
 
http://localhost:8008/documentconverterws
 
http://localhost:8008/documentconverterws
 +
</pre>
 
Note:
 
Note:
 
If the logging configuration has been changed for documentconverter entries the logger needs a small change. The new class is name="com.openexchange.documentconverter"
 
If the logging configuration has been changed for documentconverter entries the logger needs a small change. The new class is name="com.openexchange.documentconverter"

Revision as of 16:23, 24 June 2016

This information is valid from 7.8.2

Update Documentconverter from earlier versions to 7.8.2

For a successful update to 7.8.2 some manual adjustments are necessary on the middleware node(s) as well as on the documentconverter node(s) after the package upgrade. For a single node deployment both sections have to be adhered to.

Documentconverter Service

Changes to the configuration file documentconverter.properties need to be applied to the new one. For versions up to (including) 7.8.1 it was located at

/opt/open-xchange/etc/documentconverter.properties

Starting with 7.8.2 it's new home is

/opt/open-xchange/documentconverter/etc/documentconverter.properties

Note: If the file is moved from the old to the new location with all items the path settings in 'com.openexchange.documentconverter.blacklistFile' and 'com.openexchange.documentconverter.whitelistFile' have to be changed.

Futhermore logging needs to be configured separately from the middleware setting. A logback.xml file dedicated to the document converter process can be found at

 /opt/open-xchange/documentconverter/etc/logback.xml

And don't forget to enable / (re)start the documentconverter service in addition to the OX App Suite middleware.

For configuration of apache and munin monitoring see the Installation Guide.


Middleware (aka Backend or Documentconverter Client)

The property pointing to the documentconverter service has to be adjusted. It is now mandatory to set this entry – not only in the remote documentconverter setup but also if the documentconverter runs locally. The property used changed from

/opt/open-xchange/etc/documentconverter.properties:
com.openexchange.documentconverter.RemoteBaseUrl=

to

/opt/open-xchange/etc/documentconverter-client.props: com.openexchange.documentconverter.client.remoteDocumentConverterUrl=

For a single-node deployment this reads (in one line)

com.openexchange.documentconverter.client.remoteDocumentConverterUrl=
http://localhost:8008/documentconverterws

Note: If the logging configuration has been changed for documentconverter entries the logger needs a small change. The new class is name="com.openexchange.documentconverter"