PrizmDoc v12.4 - Updated
Configure Microsoft Office Conversion Connectivity
Administrator Guide > System Configuration > Configure the PrizmDoc Server > Configure Microsoft Office Conversion Connectivity

PrizmDoc 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.

Please see Windows Requirements and Windows Installation sections for information regarding installation of PrizmDoc 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. MSO enabled license is required for the Microsoft Office Conversion connectivity for PrizmDoc Servers running on Linux.
  1. Configure following 2 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 to utilize the Microsoft Office Conversion service running on Windows to have native rendering of Microsoft documents in PrizmDoc.

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 'network.publicPort' parameter of the remote server to utilize the Microsoft Office Conversion service running on Windows to have native rendering of Microsoft documents in PrizmDoc.

  1. Restart PrizmDoc.

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>

Multi-Server (Cluster) Mode

Linux Server Configuration

  1. MSO enabled license is required for the Microsoft Office Conversion connectivity for PrizmDoc Servers running on Linux.
  1. Please configure following 2 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.

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.

  1. Restart PrizmDoc.

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>

File Formats

After performing the configuration steps above, 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 Supported File Formats section for the information on the exact file formats supported by the Microsoft Office Conversion renderer.