AppSuite:DocumentConverterUpdate782: Difference between revisions

From Open-Xchange
No edit summary
No edit summary
 
(3 intermediate revisions by one other user not shown)
Line 8: Line 8:


=== OX Documentconverter Service ===  
=== OX Documentconverter Service ===  
After an upgrade the new package '''<tt>open-xchange-documentconverter-server</tt>''' replaces '''<tt>open-xchange-documentconverter-webservice</tt>'''. If <tt>open-xchange-documentconverter-server</tt> is not automatically installed (e.g. in a single node deployment) it has to be be added manually.


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  
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  
Line 23: Line 25:
  /opt/open-xchange/documentconverter/etc/logback.xml
  /opt/open-xchange/documentconverter/etc/logback.xml
</pre>
</pre>
And don't forget to enable / (re)start open-xchange-documentconverter-server.service in addition to the OX App Suite middleware.


Most notable changes are the listening ports (http 8008, https 8011 and JMX 9998) which have to be different from those reserved for the middleware. Apache and monitoring configurations have to be adapted accordingly.
Most notable changes are the listening ports (http 8008, https 8011 and JMX 9998) which have to be different from those reserved for the middleware. Apache and monitoring configurations have to be adapted accordingly.


<!--
<!--
Line 33: Line 32:
Adapt /etc/munin/plugin-conf.d
Adapt /etc/munin/plugin-conf.d
-->
-->
'''Note:''' Don't forget to enable / (re)start open-xchange-documentconverter-server.service in addition to the OX App Suite middleware.


=== OX App Suite Middleware (aka Backend or Documentconverter Client) ===
=== OX App Suite Middleware (aka Backend or Documentconverter Client) ===
Line 53: Line 55:
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"
In addition, the package <tt>open-xchange-documentconverter-server</tt> must be installed.


[[Category:AppSuite]]
[[Category:AppSuite]]
[[Category:Administrator]]
[[Category:Administrator]]

Latest revision as of 12:28, 8 September 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.

Further details are available from the Installation Guide.

OX Documentconverter Service

After an upgrade the new package open-xchange-documentconverter-server replaces open-xchange-documentconverter-webservice. If open-xchange-documentconverter-server is not automatically installed (e.g. in a single node deployment) it has to be be added manually.

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

Most notable changes are the listening ports (http 8008, https 8011 and JMX 9998) which have to be different from those reserved for the middleware. Apache and monitoring configurations have to be adapted accordingly.


Note: Don't forget to enable / (re)start open-xchange-documentconverter-server.service in addition to the OX App Suite middleware.


OX App Suite 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.properties: 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"