OLE convert script for Linux-Windows environment

NAME

oleconvert.sh - Shell script to convert OLE objects using a Linux-Windows® enviroments
Version 0.2 2015-02-12 12:42

SYNOPSIS

oleconvert.sh [output-image-format] [input-option]

DESCRIPTION

Prerequisites

• A computer or virtual machine running Microsoft Windows®, accessible as a network share to the Linux machine hosting Polarion.
• ImageMagick image converter installed on the Microsoft Windows® machine: http://www.imagemagick.org/script/binary-releases.php
• Winexe for Linux: http://www.aldeid.com/wiki/Winexe

Installation and Configuration

1. Install Winexe on your Linux machine. You must have administrator permissions on the target machine. For more information, see: http://serverfault.com/questions/72082/winexe-gives-error-error-failed-to-install-service-winexesvcnt-status-access
2. Install ImageMagick as a standard program on the Windows® computer or VM.
3. Make a Windows® share accessible from Linux. The polarion user must have write access to this share.
4. Copy the oleconvert.sh script-file to e.g. /opt/polarion/scripts and replace the following keywords with correct values of your system:
   LINUX_PATH_TO_WINDOWS_SHARE
   WINDOWS_PATH_TO_WINDOWS_SHARE
   PATH_TO_WINEXE_EXECUTABLE
   WINDOWS_USER
   WINDOWS_PASSWORD
   WINDOWS_HOSTNAME
   WINDOWS_IMAGEMAGICK_INSTALLATION_FOLDER
    
5. In the system configuration file polarion.properties, configure the OLE converter using the following example and replace PATH_TO_OLECONVERT_SH with a correct value of your system:
   com.polarion.oleconverter.app=PATH_TO_OLECONVERT_SH
   com.polarion.oleconverter.userfiles=false
   com.polarion.oleconverter.param1=png
   com.polarion.oleconverter.param2=-flatten
   com.polarion.oleconverter.convertedImageFormat=png
   
   Change com.polarion.oleconvert.param1 and com.polarion.oleconverter.convertedImageFormat to jpg to have thumbnails converted to JPEG format.
    
6. Restart the Polarion server
   
   If OLE thumbnails do not appear in imported documents, check the Polarion error log files to make sure there are no invalid path or other errors.

OPTIONS

The image-data from Polarion is received over the standard input (com.polarion.oleconverter.usefiles=false).
The converted image-data is sent back to Polarion over standard output.

The first parameter is used to set the output-image-format.
Accepted values are:
jpeg
jpg
png

If the first parameter is not png, jpg or jpeg, the output-image-format will be png by default.

All other input-option parameters will be passed through to ImageMagick convert. For more details of input-option parameters see manpage of ImageMagick convert.

SEE ALSO

convert(1), ImageMagick(1)

COPYRIGHT

Copyright© 2015 Küster Automotive GmbH, Christian Posluschni
For license information see LICENSE.txt