Getting Started with PrizmDoc > Installation > Self-Hosted > Installing PrizmDoc Server > Single-Server > Installing on Linux > Linux Installation |
PrizmDoc installation is designed to be very straightforward for Linux environments. Follow the steps provided in this section.
PrizmDoc v12 requires a clean installation when migrating from an earlier version than 12. You must first uninstall any previous versions of PrizmDoc and reboot your system. Only then should you install PrizmDoc v12. |
Some steps may be specific to a particular Linux distribution; these steps will be labeled as being specific to one of the following:
Make sure you log in as root to the machine. |
Example Copy Code locale
Example Copy Codeexport LC_ALL="en_US.UTF-8" sudo locale-gen
Before you download PrizmDoc, note that packages are only available for 64-bit systems. |
Before downloading PrizmDoc, you will need to purchase a license key or request a Trial Evaluation by filling out the following form: www.accusoft.com/products/prizm-content-connect-pcc/get-self-hosted/.
Once you have purchased a license key or filled out the form for a Trial Evaluation, you can download PrizmDoc by:
OR
You must substitute the version of the package you are using in the code examples below. For example, if you are using v11.0, then specify "11.0" instead of "<version>". If the version is a hot fix, you will need to also specify the hot fix number, for example, "11.0.1".
Red Hat Enterprise Linux, CentOS (prior to v7) and Similar Older Linux Distributions
Example Copy Codewget http://products.accusoft.com/PrizmDoc/<version>/prizmdoc_server_<version>.x86_64.rpm.tar.gz
Red Hat Enterprise Linux and CentOS v7 (and later)
Example Copy Codewget http://products.accusoft.com/PrizmDoc/<version>/prizmdoc_server_<version>_RHEL7.x86_64.rpm.tar.gz
Debian and Ubuntu Linux Distributions
Example Copy Codewget http://products.accusoft.com/PrizmDoc/<version>/prizmdoc_server_<version>.amd64.deb.tar.gz
Generic .tar.gz Distribution
Example Copy Codewget http://products.accusoft.com/PrizmDoc/<version>/prizmdoc_server_<version>.x86_64.tar.gz
For license questions, fill out the form at http://www.accusoft.com/contact/.
Open a command line and change to the location where you downloaded the tarball. Use the following command line examples appropriate for your distribution to:
Red Hat, Fedora, CentOS, and Older Linux Distributions
The following example is for Red Hat, Fedora, CentOS, and older Linux distributions:
Example Copy Code tar -xzvf prizmdoc_server_*.rpm.tar.gz cd prizmdoc_server_*.rpm yum install --nogpgcheck *.rpm
Note: For CentOS 5.x, the following additional dependencies must be installed prior to PrizmDoc RPM installation:
- openjpeg-libs-1.3-7.el5.x86_64.rpm
- pixman-0.22.0-2.2.el5_10.x86_64.rpm
The Prizm installer does not install them automatically. Please manually download these packages and then install them using --nogpgcheck flag as follows:
Example Copy Code yum install --nogpgcheck ./openjpeg-libs-1.3-7.el5.x86_64.rpm yum install --nogpgcheck ./pixman-0.22.0-2.2.el5_10.x86_64.rpm
Debian (Ubuntu) Linux Distributions
The following example is for Debian (Ubuntu) Linux distributions:
Example Copy Code tar -xzvf prizmdoc_server_*.deb.tar.gz cd prizmdoc_server_*.deb sudo dpkg -i *.deb # 'dpkg' does not resolve dependencies automatically, so please ignore possible errors, if there are errors about missing dependencies, invoke next command to install dependencies and complete configuration of the packages. sudo apt-get -f install
Generic .tar.gz Distribution
We also provide a generic .tar.gz package. Please review the System Requirements and Supported Environments topic to ensure compatibility. You will also 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:
Example Copy Code tar -xzvf prizmdoc_server_*.tar.gz cd prizmdoc_server_* ls prizm-*.tar.gz | xargs -n1 tar zxf cp -R prizm /usr/share/
Add symbolic links to the fonts directory and update system fonts cache to enable the usage of installed fonts by PrizmDoc services.
Example Copy Code ln -s /usr/share/prizm/modules/poppler/fonts/accusoft_prizm_fonts.conf /etc/fonts/conf.d/99-accusoft_prizm_fonts.conf fc-cache -f
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.
Example Copy Code ./setup.sh Select the type of license you want to acquire: 1) Evaluation [e] 2) Deployment [d] Choose 1 or 2: d Select the type of deployment license you have: 1) Node Locked [n] 2) OEM [o] Choose 1 or 2: o Provide the solution name: <MySolutionName> Provide the OEM license key provided to you: 2.0... Your deployment license was acquired successfully. ./scripts/pccis.sh start Starting Prizm Content Connect Information Services... Starting PCCIS Watchdog process... PCCIS Watchdog has been started correctly.
Sample code is included to demonstrate how PrizmDoc can be integrated into your Content Management solution. Sample applications using different languages are packaged with the product to demonstrate using a particular language. All of the product samples are located in the "Samples" folder within the installation directory. For more information, refer to the Code Samples topic.
The following commands should all be run as root. Additionally, if prompted for addition/removal permission, then yes/no should be entered as the response.
Example Copy Code /usr/share/prizm/mono/64/bin/mozroots --machine --import --ask-remove
Example Copy Code/usr/share/prizm/mono/64/bin/certmgr -ssl -m https://servertoadd/
As long as the server includes the entire chain to root, this will allow the certificate to authenticate. This will generally be the case for self-signed test certificates. For more complex situations, any required items from the chain will need to be added manually.
Example Copy Code /usr/share/prizm/mono/64/bin/certmgr -add -c -m /path/to/certificatefile
The certificate stores the certificates at: /usr/share/.mono/certs/.