Enabling multi-threaded file conversions

PDF Generator provides the ability to enable multi-threaded file conversions for certain types of files. Multi-threaded file conversion improves the performance of PDF Generator by allowing it to perform multiple conversions at the same time.

    Enabling multi-threaded file conversions for OpenOffice, Word, and PowerPoint documents

    By default, PDF Generator can convert only one OpenOffice, Microsoft Word, or PowerPoint document at a time. If you enable multi-threaded conversions, PDF Generator can convert more than one of the documents concurrently. PDF Generator will launch multiple instances of OpenOffice or PDFMaker (used to perform the Word and PowerPoint conversions).

    Note: Multi-threaded file conversions are not supported with Microsoft Word 2003 and PowerPoint 2003. To enable multi-threaded file conversions, upgrade to Microsoft Word 2007 and PowerPoint 2007 or Microsoft Word 2010 and PowerPoint 2010.
    Note: Multi-threaded file conversions are not supported with Microsoft Excel, Microsoft Visio, Microsoft Project, or Microsoft Publisher.

    Each instance of OpenOffice or PDFMaker is launched using a separate user account. Each user account that you add must be a valid user with administrative privileges on the LiveCycle server computer. In a clustered environment, the same set of users must be valid for all nodes of the cluster.

    On the User Accounts page in Administration Console, you can specify which user accounts to use for multi-threaded file conversions. You can add accounts, delete them, or change account passwords. If you are running PDF Generator on Windows Server 2003 or Windows Server 2008, add at least three user accounts that have administrator privileges.

    When adding users for OpenOffice, Microsoft Word, or Microsoft PowerPoint on Windows Server 2003 or 2008, or for OpenOffice on Linux or Sun™ Solaris™, dismiss the initial activation dialogs for all users.

    Add the right to replace the process-level token

    On a Windows Operating system, the administrator user accounts that are used for PDF conversion (PDFG users) will need replace process level token privileges. You can add this right by using the Group Policy Editor:

    1. In the Windows Start menu, click Run and then enter gpedit.msc.

    2. Click Local Computer Policy > Computer Configuration > Windows Settings > Security Settings > Local Policies > User Rights Assignment. Edit the Replace a process level token policy to include the Administrators group.

    3. Add the user to the Replace a Process Level Token entry.

    Additional configuration required for OpenOffice, Microsoft Word, and Microsoft PowerPoint on Windows Server 2008

    If you are running OpenOffice, Microsoft Word, or Microsoft PowerPoint on Windows Server 2008, disable UAC for each user added.

    1. Click Control Panel > User Accounts > Turn User Account Control on or off.

    2. Deselect the box “Use User Account Control (UAC) to help protect your computer” and click OK.

    3. Restart the computer for settings to take effect.

    Additional configuration required for OpenOffice on Linux or Solaris

    1. Add user accounts. (See Add a user account.)

    2. Next, you will make changes to the /etc/sudoers file. The default permission for this file is 440. Change the permission for this file to writable.

    3. Add entries for additional users (other than the administrator who runs the LiveCycle server) in the /etc/sudoers file. For example, if you are running LiveCycle as a user named lcadm and a server named myhost, and you want to impersonate user1 and user2, add the following entries to /etc/sudoers:

      lcadm myhost=(user1) NOPASSWD: ALL 
lcadm myhost=(user2) NOPASSWD: ALL

      This configuration enables lcadm to run any command on host ‘myhost’ as ‘user1’ or ‘user2’ without prompting for password.

      Note: Ensure that you have assigned system user and PDFG user roles to ‘user1’ and ‘user2’ . To assign PDFG role to a user, see Add a user account

    4. Also in the /etc/sudoers file, locate and comment out this line by adding a number sign (#) at the beginning of the line:

      Defaults requiretty

      This enables you to add Linux users.

    5. Change the permission for the etc/sudoers file back to 440.

    6. Allow all the users that you added via Add a user account to make connections to the LiveCycle server. For example, to allow a local user named user1 the permission of making the connection to the LiveCycle server, use the following command

      xhost +local:user1@

      For more details, refer to xhost command documentation.

    7. Restart the server.

    Note: OpenOffice must be installed in a directory location that all PDFG users can access. You can verify this by logging in as the PDFG user and checking whether you can launch OpenOffice without issues.

    Add a user account

    1. In Administration Console, click Services > PDF Generator > User Accounts.

    2. Click Add and enter the user name and password of a user who has administrative privileges on the LiveCycle server. If you are configuring users for OpenOffice, dismiss the initial OpenOffice activation dialogs.

      Note: If you are configuring users for OpenOffice, the number of instances of OpenOffice cannot be greater than number of user accounts specified in this step.

    3. Restart the LiveCycle server.

    Remove a user from the list used for multi-threaded file conversions

    1. In Administration Console, click Services > PDF Generator > User Accounts.

    2. Click the check box next to the user who you want to remove and click Delete.

    3. On the confirmation page, click Delete.

    4. Restart the LiveCycle server.

    Change the password for an account

    1. In Administration Console, click Services > PDF Generator > User Accounts.

    2. Click the user name, and enter and confirm the new password. This password must match the user’s system password.

    // Ethnio survey code removed