Prizm Content Connect installation is designed to be very straightforward for Linux environments. Follow the steps provided in this section.
Some steps may be specific to a particular Linux distribution; these steps will be labeled as being specific to one of the following:
- “Red Hat / Fedora (CentOS) Linux Distributions”
- “Debian (Ubuntu) Linux Distributions”
- “SUSE Linux Distributions”
The hash sign (#) is used to represent the command prompt. Do not include it when entering the commands. |
Make sure you log in as root to the machine. |
1. Install LibreOffice
Install the latest stable version of LibreOffice for your OS. Download and install it from this location:
http://www.libreoffice.org/download
Follow LibreOffice Installation instructions from this location:
http://www.libreoffice.org/get-help/installation/linux/
LibreOffice Desktop Integration for Linux is not needed; you do not need to complete those steps. |
The LibreOffice installation might fail if you have LibreOffice or any other application already listening on any of the following ports: 18580, 18584, 18585, 18586, 18590, 18591, 18592, 18593, 18680. By default, Prizm Content Connect installs the proxy service on port 18680 and uses 3 of the following ports for conversion purposes: 18580, 18584, 18585, 18586, 18591, 18592, 18593. You can add more ports as your traffic increases. |
2. Install Inkscape
Install the latest stable version of Inkscape for your OS. Download and install it from this location:
If you run into issues when installing Inkscape, please refer to the FAQ section on the Accusoft website. |
An easier way to install Inkscape is using package manager such as: yum, apt-get, or zypper, as shown below; however, this may not work on all versions of all Linux flavors listed below.
Make sure your package manager installs at least Inkscape version 0.47-6 or higher.
Red Hat / Fedora (CentOS) Linux Distributions | Copy Code |
---|---|
# yum install inkscape In case of missing libraries or any other issues with the installation, please follow the instructions here: http://wiki.inkscape.org/wiki/index.php/CompilingFedora |
Debian (Ubuntu) Linux Distributions | Copy Code |
---|---|
# sudo apt-get update # sudo apt-get install inkscape In case of missing libraries or any other issues with the installation, please follow the instructions here: http://wiki.inkscape.org/wiki/index.php/CompilingUbuntu |
SUSE Linux Distributions | Copy Code |
---|---|
# zypper install inkscape In case of missing libraries or any other issues with the installation, please follow the instructions here: http://wiki.inkscape.org/wiki/index.php/CompilingSuse |
3. Install OpenOffice.org 3 (optional)
Prizm Content Connect still supports OpenOffice.org 3 as Office document converter. If you want to use OpenOffice.org 3 with Prizm, please follow the installation instructions here:
http://www.openoffice.org/download/common/instructions.html#linux
The instructions are specific for each Linux flavor. You need to configure OpenOffice.org 3 after your Prizm service is running by following the instructions shown later in this document.
4. Download & Install Prizm Content Connect
Download the proper package for your distribution and architecture and install as root.
- Red Hat, Fedora, CentOS, and older Linux Distributions
32-bit: prizmcc_<version>.i686.rpm
64-bit: prizmcc_<version>.x86_64.rpmCopy Code # yum install –-nogpgcheck prizmcc_<version>.x86_64.rpm
- SUSE Linux Distributions
32-bit: prizmcc_sles_.i686.rpm
64-bit: prizmcc_sles_.x86_64.rpmCopy Code # zypper install prizmcc_sles_<version>.x86_64.rpm
- Debian (Ubuntu) Linux Distributions
32-bit: prizmcc_<version>.i386.deb
64-bit: prizmcc_<version>.amd64.debCopy Code # sudo apt-get install gdebi
# sudo gdebi prizmcc_<version>.amd64.deb - Generic .tar.gz Distribution
We also provide a generic .tar.gz package. You will need to install the dependencies described in the Requirements section.
Once the dependencies are installed, you can install the .tar.gz with the following commands as root:
Copy Code # tar –xzvf prizmcc_<version>.x86_64.tar.gz
# cp –R prizm /usr/share
# cd /usr/share/prizm
5. Configure
Continuing as root, change to the installation location, /usr/share/prizm and run setup.sh. This will confirm your LibreOffice installation location. Run the Prizm Licensing Utility (PLU), and configure the proxyserver for its first run.
setup.sh launches the Prizm License Utility (PLU), which is a GUI application. Depending on how you have X11 configured, you might need to run ‘xhost +’ as the logged in user to allow the PLU launched by the root user to access X11. You can disable X11 access for root by executing ‘xhost –‘ when you are done. |
Copy Code | |
---|---|
# ./setup.sh |
If you see output similar to this, your proxyserver is NOT running:
Copy Code | |
---|---|
java.net.ConnectException: Connection refused at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method) : Caused by: java.net.ConnectException: Connection refused at java.net.PlainSocketImpl.socketConnect(Native Method) at java.net.PlainSocketImpl.doConnect(Unknown Source) : at sun.net.www.protocol.http.HttpURLConnection.connect(Unknown Source) at sun.net.www.protocol.http.HttpURLConnection.getInputStream(Unknown Source) ... 4 more |
6. Verify that the Installation was Successful
Go to /usr/share/prizm/logs directory, and open the “proxyserver.log” file. Scroll down to the very end and verify that you the see the following:
Copy Code | |
---|---|
INFO | jvm 1 | 2011/12/16 22:02:57 | [ info ] [2 / 2] All worker instances has been started |
You can also verify the installation by browsing to:
http://localhost:18680/
or
http://<http_host>:<http_port>/
where http_host and http_port are the property values from /usr/share/prizm /conf/proxyserver_jar.properties
The url above should show text similar to this in a browser:
Copy Code | |
---|---|
Accusoft Prizm Service is running. |
7. Setting OpenOffice.org as Office Document converter
If you see your Prizm installation is successful you may still configure OpenOffice.org as Office document converter. Make sure you have installed OpenOffice.org 3 as described earlier in this document.
At first, you need to locate the root folder of your OpenOffice.org 3 installation. The OpenOffice.org 3 application is on the supported Linux flavors usually located in one of the following directories:
/opt/openoffice.org3
/usr/bin/openoffice.org
/usr/lib/openoffice.org3
/usr/lib64/openoffice.org3
Now, edit <prizm-install>/conf/proxyserver_jar.properties and change following parameter to fit the root location of OpenOffice.org 3, e.g.:
Copy Code | |
---|---|
# Office Document converter installation base directory
odc_installation=/opt/openoffice.org3
|
Save proxyserver_jar.properties and restart Prizm service.
You can see the OpenOffice.org application location noted in <prizm-install>/logs/proxyserver.log similar to this:
INFO | jvm 1 | 2013/02/15 22:11:38 | Office Document converter : /opt/openoffice.org3/program
If you want to get back to LibreOffice, you need to specify LibreOffice root folder in <prizm-install>/ conf/proxyserver_jar.properties again, such as:
Copy Code | |
---|---|
# Office Document converter installation base directory
odc_installation=/opt/libreoffice4.0
|
Save the proxyserver_jar.properties, restart Prizm service and check proxyserver.log to make sure Prizm uses the desired Office document converter.