Introduction

PrizmDoc Viewer provides Microsoft Office Conversion connectivity for PrizmDoc Servers running on Linux. While the Microsoft Office Conversion add-on requires PrizmDoc Server running on Windows, it is possible to configure PrizmDoc Servers running on Linux to utilize the Microsoft Office Conversion service to have native rendering of Microsoft documents in PrizmDoc Viewer.

Please see Windows Requirements and Windows Installation sections for information regarding installation of PrizmDoc Viewer with the Microsoft Office Conversion service.

The following steps describe how to enable Microsoft Office connectivity on the Linux server.

Single Server Mode

Linux Server Configuration

1. An MSO enabled license is required for the Microsoft Office Conversion connectivity for PrizmDoc Servers running on Linux.

2. Configure the following two parameters in the prizm-services-config.yml:

   fidelity.msOfficeCluster.host

   Set this value on a PrizmDoc Server running on Linux to the hostname or the IP of a single PrizmDoc Server running on Windows. By setting this value, you can use the Microsoft Office Conversion service running on Windows to have native rendering of Microsoft documents in PrizmDoc Viewer.

   fidelity.msOfficeCluster.port

   Set this value on a PrizmDoc Server running on Linux to the public port of a single PrizmDoc Server running on Windows specified by the network.publicPort parameter of the remote server. By setting this value, you can use the Microsoft Office Conversion service running on Windows to have native rendering of Microsoft documents in PrizmDoc Viewer.

3. Restart PrizmDoc Viewer.

   Note that if the /etc/hosts file of the Linux machine is either empty, or contains only localhost entry, such as:

   127.0.0.1 localhost

   the Linux server might not be able to connect to the Windows server. Make sure that the network of the Linux machine is configured properly. For instance, the /etc/hosts file should contain at least 2 entries:

   127.0.0.1 localhost 127.0.0.1 <hostname-of-your-machine>

Cluster Mode

Linux Server Configuration

1. An MSO enabled license is required for the Microsoft Office Conversion connectivity for PrizmDoc Servers running on Linux.

2. Please configure following two parameters in the prizm-services-config.yml:

   fidelity.msOfficeCluster.host

   Set this value on a PrizmDoc Server running on Linux to the hostname or the IP of a load balancer of a cluster running on Windows to utilize the Microsoft Office Conversion service running on Windows to have native rendering of Microsoft documents in PrizmDoc Viewer.

   fidelity.msOfficeCluster.port

   Set this value on a PrizmDoc Server running on Linux to the public port of a load balancer of a cluster running on Windows specified by 'network.clustering.clusterPort' parameter of the cluster to utilize the Microsoft Office Conversion service running on Windows to have native rendering of Microsoft documents in PrizmDoc Viewer.

3. Restart PrizmDoc Viewer.

   Note that if the /etc/hosts file of the linux machine is either empty, or contains only localhost entry, such as:

   127.0.0.1 localhost

   the Linux server might not be able to connect to the Windows cluster. Please make sure, that the network of the linux machine is configured properly. For instance, the /etc/hosts file should contain at least 2 entries:

   127.0.0.1 localhost 127.0.0.1 <hostname-of-your-machine>

HTTPS Protocol Support

If you need your Linux instance (cluster) to communicate to the Windows MSO instance (cluster) over an untrusted network, or if you need additional security within your local network, you may want to set them up to support the HTTPS protocol. See Security Guidance for details.

File Formats

After performing the configuration steps above, a PrizmDoc Server running on Linux will convert all Microsoft Office documents through the Microsoft Office Conversion renderer from the PrizmDoc Server running on Windows.

Please refer to the Supported File Formats section for the information on the exact file formats supported by the Microsoft Office Conversion renderer.