XF Ultrascale Server 2010 for Linux HOWTO

Installation

To install XF Ultrascale Server for Linux run (as root):

rpm -i XFUltrascale-3.6.0-xxxx.i386.rpm

where xxxxstands for current release number.

XF Ultrascale Server is automatically started and added to runlevels 3 and 5.
The server will listen for rendering requests on port 1099. Incoming connections on this port must be allowed.
An suitable iptables rule for this is:

iptables -A INPUT -p tcp --dport 1099 -j ACCEPT

Uninstall

To uninstall XF Ultrascale Server for Linux run:

rpm -e XFUltrascale

What Is Included

The default installation folder is /opt/Ecrion/XFUltrascale/.
The following tools and programs are installed and accessible from the default path:

UDaemon - The XF Ultrascale 2009 Daemon.
URender - Console application that can process documents from the command line.
JURender - Console socket-based client for the Ultrascale server; needs Java Runtime Environment.
ULicUtil - License management tool for installing and activating licenses.
UCertManager - Certificate management tool for installing and uninstalling digital identities for PDF signing.

Server Commands

To manually start XF Ultrascale Server run (as root)

/etc/init.d/ultrascaled start

To stop XF Ultrascale Server run

/etc/init.d/ultrascaled stop

Using URender

URender is the CLI-tool used for local rendering of files (without using the server).
It can be used to convert XSL-FO, DOCX and other input formats to PDF, Postscript, AFP and more:

URender Input_File

You can also use it to covert XML data files to the supported output formats by applying on-the-fly a XFD template. The command line is:

URender XML_Data_File.xml -parameters:template=XFD_Template_File

Run URender without parameters for more information about the command line. A man page for URender is also available:

man URender

Using JURender

JURender is the CLI-tool used for remote rendering of files (using the Ultrascale server).
The default remote address is 127.0.0.1 (localhost) and the default port 1099. These can be overridden by the -address Server_IP and -port Server_Port switches.
Here is a sample command line with address and ports overrides:

JURender -in input_file.fo -address Server_IP -port Server_Port

The command line format is very similar with that of URender. Run JURender without parameters for more information.

Using the License Tool

ULicUtil is the license management tool used to install and activate licenses.
A man page for ULicUtil is also available.

Here is a brief list of commands:

• List keys: ULicUtil list - The command will list all the keys from the container and their states.
• Install key: ULicUtil install key - If the key is valid, the activation request string will be printed to standard output. The activation request string can be later retrieved using ULicUtil get-request index, where index is the index listed by the ULicUtil list command.
• Activate key: ULicUtill activate activation-response - The activation response is obtained from the Ecrion website (customers area) using the activation request string.
• Uninstall key: ULicUtil uninstall index - The uninstall request string will be printed to standard output and used on the Ecrion website (customers area) for deactivating the license offline.

Using the Certificate Manager Tool

UCertManager is the certificate management tool used to install / uninstall public certificate / private key pairs (digital identities).

Here is a brief list of commands:

• List identities: UCertManager list - The command will list all the identities from the container (index in container, issuer and subject).
• Import PKCS#12identity: UCertManager import pkcs12_file- the digital identity information is added to the container.
• Import certificate / private key pair (PEM format): UCertManager mport -incert cert_file -inkey privkey_file - the digital identity information (the private key and its ownership certificate) is added to the container.
• Delete the digital identity with the given index in the container: UCertManager delete -entry index.
• Export the digital identity with the given index in the container into a PKCS#12file: UCertManager export -entry index -out out_file.