2.2 System requirements

On supported Windows and UNIX -like environments, LiveCycle supports Intel and AMD64 compatible chipsets running either 32-bit or 64-bit supported operating systems.

For a small production environment:

Intel environments: Pentium 4, 2.8 GHz or greater. Using a dual core processor will further enhance performance.

Sun SPARC environments: UltraSPARC V or later.

IBM AIX environments: Power4 or later

Adobe® LiveCycle® Workbench 11

• Disk space for installation:

  1.5 GB for Workbench only1.7 GB on a single drive for a full installation of Workbench, Adobe® LiveCycle® Designer 11, and the samples assembly400 MB for temporary install directories - 200 MB in the user temp directory and 200 MB in the Windows temporary directory

  Note: If all of these locations reside on a single drive, there must be 1.5 GB of space available during installation. The files copied to the temporary directories are deleted when installation is complete.

• Memory for running Workbench: 2 GB of RAM

• Hardware requirement: Intel® Pentium® 4 or AMD equivalent, 1 GHz processor

• Minimum 1024 X 768 pixels or greater monitor resolution with 16-bit color or higher

• TCP/IPv4 or TCP/IPv6 network connection to the LiveCycle server

Adobe® LiveCycle® Designer 11

• A minimum of Adobe® Acrobat® 9 Professional, Acrobat 9 Standard, or Adobe Reader® 9. To benefit from the new features in Designer 11, you must have Acrobat XI Professional, Acrobat XI Standard, or Reader XI.

• Adobe® Flash® Player 11.1 or later.

• (Optional) Adobe® Flash® Builder® 4.5 or later.

• (Optional) Adobe® Flex® SDK 4.1 (required for customizing form guide components that are shipped with Designer).

End-user hardware requirements

• Adobe® LiveCycle® Workspace 11: 1 GB of RAM (includes requirements for Adobe Flash and Adobe Reader)

• Adobe Flash Player 11.1 and later: 512 MB of RAM (1 GB recommended)

• Adobe Reader 9 and later: 128 MB of RAM (256 MB recommended)

When installing LiveCycle on AIX, Linux, or Solaris operating systems, you must install and configure the US English version of UTF-8 locale if it is not already installed. You will need the install media (CDs or DVDs) for the operating system to perform this task.

On Linux operating systems, ensure the following:

• All Linux distributions: Ensure that X Window libraries are installed on your operating system. This is required for PDF Generator and Forms. See documentation for your operating system for more information.

• SUSE Linux: You must install the glibc-locale-32bit library that ships with SUSE Linux Enterprise Server; otherwise, LiveCycle will not generate PDF files. This library file is not installed by default, you must use YaST to install it. (See the SUSE Linux Enterprise Server documentation for details.)

  If you plan to install LiveCycle on SUSE Linux 11, you must also install the libstdc++- libc6.2-2.so.3 libraries. SUSE Linux 11 does not include these libraries by default. For more information, see this Novell Web page. These libraries are required for running Adobe Central Pro Output Server

To avoid StuckThread issues on a Solaris or Linux environment, add or increase the rlim values in the /etc/system file.

1. (Linux) Locate and open the /etc/security/limits.conf file.

   (Solaris) Locate and open the /etc/system file.

2. (Linux) Add the following lines to the /etc/security/limits.conf file:

   <app_group> soft nofile 8192 
   <app_group> hard nofile 8192

   Replace <app_group> with the user group who will run the application server. You may also replace <app_group> with an asterisk (*) to match all users and user groups.

   (Solaris) Locate and modify the rlim values in the /etc/system file as follows:

   set rlim_fd_cur: The initial (soft) maximum number of file descriptors per process. Set this value to 8192 or more.

   set rlim_fd_max: The hard maximum number of file descriptors per process. Set this value to 8192 or more. (This modification is required only if the default value is lower than 8192). You must have super user privileges to change this value.

   Note: The rlim_fd_max value must be equal to or greater than the rlim_fd_cur value.

3. Save and close the file.

4. Restart your computer.

1. To access the System Configuration Utility, go to Start > Run and then enter MSCONFIG.

2. Click the Tools tab and scroll down and select Disable UAC.

3. Click Launch to run the command in a new window.

4. When finished, close the command window and close the System Configuration window.

5. Restart your computer.

To enable the UAC again, repeat the steps above and select Enable UAC before clicking Launch.

1. To access the System Configuration Utility, go to Start > Run and then enter MSCONFIG.

2. Click the Tools tab and scroll down and select Change UAC Settings.

3. Click Launch to run the command in a new window.

4. Adjust the slider to the Never notify level.

5. When finished, close the command window and close the System Configuration window.

6. Restart your computer.

To enable the UAC again, repeat the steps above and adjust the slider to a desired level before restarting your computer.

You must use a user account with administrator privileges for the following tasks:

• Installing Microsoft Office

• Installing PDF Generator

• Installing Acrobat for PDF Generator

• Running the application server process

You must use a user account with administrator privileges for the following tasks:

• Installing PDF Generator

• Running the application server process

• Running the sudo command

If you are using a 64-bit application server on a system with PDF Generator, ensure that a 32-bit Java 6 JDK is installed in addition to the 64-bit one the application server uses. Set the environment variable JAVA_HOME_32. This variable is required to point to a 32-bit JDK on systems where a 64-bit application server is in use. The specific path varies based on the installation directory you specified and the operating system you are installing on.

Before you install PDF Generator, install the software that supports the file formats for which PDF conversion support is required and manually activate the licenses for the software using the user account that is used for running the application server process.

Refer to the individual licensing agreement for each native application that your LiveCycle deployment will support, and ensure that your LiveCycle deployment meets the licensing requirements specified. Typically, each LiveCycle user who will use native application support must also have an activated license on their own computer for the native application.

PDF Generator can be extended to convert these additional file types to PDF files by using the following applications:

• Microsoft Office 2007, 2010 (DOC,DOCX XLS,XLSX PPT,PPTX, RTF, TXT)

• Microsoft Office Visio 2007, 2010 (VSD)

• Microsoft Publisher 2007, 2010 (PUB)

• Microsoft Project 2007, 2010 (MPP)

• AutoCAD files (DWG, DWF) converted through Acrobat

• Corel WordPerfect X4 (WPD)(English only)

• Adobe FrameMaker® 8.0 (FM)

• Adobe PageMaker® 7.0 (PMD, PM6, P65, PM)

• OpenOffice 3.3 (ODT, ODP, ODS, ODG, ODF, SXW, SXI, SXC, SXD, SXM)

• Paper Specification document (XPS) converted through Acrobat

You do not need to install a native software application to convert the following native file formats:

• Print files (PS, PRN, EPS)

• Web files (HTML)

• Image files (JPEG, GIF, BMP, TIFF, PNG)

• Flash videos (SWF, FLV)XML

However, if LiveCycle is installed and Acrobat XI Pro is not installed, install Acrobat XI Pro and then run the Acrobat_for_PDFG_Configuration.bat script, located in the folder [LiveCycle root]\pdfg_config. Otherwise, PDF conversions will fail.

The Configuration Manager sets the Acrobat_PATH (case-sensitive) environment variable automatically. You can also choose to set it manually, see 2.2.6.8 Setting environment variables. Restart your application server after setting the environment variable.

1. Open Acrobat.

2. Select Edit > Configurations.

3. Select Convert to PDF > Autodesk AutoCAD.

4. Click Edit Settings.

5. Click Configuration Preferences.

6. Click Browse next to the SHX Font File Search Path and specify the path to the SHX font file.

7. Click OK on each opened dialog.

PDF Generator requires that QuickTime 7 (Player or Pro) be installed if you want to convert video embedded in files, such as PowerPoint presentations to PDF multimedia files. This application is available from the Apple Downloads site.

You must set the environment variables in Windows if you plan to create PDF documents from applications such as FrameMaker, Photoshop, PageMaker, and WordPerfect.

The names of these environment variables are listed here:

• FrameMaker_PATH

• Notepad_PATH

• OpenOffice_PATH

• PageMaker_PATH

• WordPerfect_PATH

• Acrobat_PATH

These environment variables are optional and need to be set only if you plan to use the corresponding application to convert PDF files through PDF Generator. The value of the environment variable should contain the absolute path of the executable that is used to start the corresponding application.

For example, the variable FrameMaker_PATH may contain the value C:\Program Files\Adobe\ FrameMaker7.2\FrameMaker.exe. However, OpenOffice_PATH is different from others. This variable must be set to the OpenOffice installation folder (instead of the path to the executable). A typical value of OpenOffice_PATH on Windows would be C:\Program Files (x86)\OpenOffice.org 3.

Paths for Microsoft Office applications such as Word, PowerPoint, Excel, Visio, Publisher, and Project or for AutoCAD are not required. The Generate PDF service starts these applications automatically if they are installed on the server.

In case of a cluster, LiveCycle is installed only on one machine. Perform the following steps to configure PDF Generator on other machines in the cluster:

1. On the remote machine, if an earlier version of Acrobat is installed, uninstall it by using Add or Remove Programs in the Windows Control Panel.

2. Install Acrobat XI Pro by running the installer.

3. From the machine where LiveCycle is installed, copy pdfg_config and plugins folders to the remote machine under any directory.

4. On the remote machine, open /pdfg_config/ Acrobat_for_PDFG_Configuration.bat file for editing.

5. Locate and comment the goto locationerror line.

   Before

   goto locationerror

   After

   rem goto locationerror

6. Save and close the Acrobat_for_PDFG_Configuration.bat file.

7. Open the command prompt and run the following command:

   Acrobat_for_PDFG_Configuration.bat <Path of the pdfg_Configuration folder>

Before you complete an automatic installation of PDF Generator on Windows, ensure that the Service Control Manager command line tool, sc.exe, is installed in the Windows environment. Some Windows servers do not have this software preinstalled. By default, the sc.exe file is installed in the C:\Windows\system32 directory. Most OS installations have this tool installed. If you do not have the tool installed, it is available in the Windows Resource Kit for your specific version of Windows. To confirm that the tool is installed on your server, type sc.exe from a command prompt. The tools usage is returned.

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 by launching multiple instances of OpenOffice or PDFMaker (which is used to perform the Word and PowerPoint conversions).

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. For more information, see 2.2.5 Configuring Windows installation

After your LiveCycle Server is configured, add LiveCycle user accounts in Administration Console. See the User accounts for multi-threaded file conversions section in the LiveCycle installation guide for your application server. To enable multiuser support for native files and OpenOffice files on a Windows environment, add a minimum of three users with the following permissions.

When you add users for PDF Generator native conversions, grant the user running the application server with the Replace a process level token privilege.For more information, see 2.2.6.14 Granting the Replace a process level token privilege (Windows only)

To enable multi-user support for native files and OpenOffice files on a Windows environment, a minimum of three users with the following permissions must be added. On a Linux or Solaris platform, create at least one user.

When you add users for PDF Generator native conversions, you must grant the user running the application server with the Replace a process level token privilege. See 2.2.6.14 Granting the Replace a process level token privilege (Windows only).

User account that are used to start the application server should be part of the local administrators group and requires the Replace a process level token privilege. To provide Replace a process level token privilege:

1. Click Start > Run, and then type gpedit.msc.

2. On the Group Policy dialog box, select Computer Configuration > Windows Settings > Security Settings > Local Policies > User Rights Assignment, and double click Replace a process level token.

3. Click Add User or Group, add the Windows user account that is used to open the command prompt from which the application server is started.

4. Restart Windows, and then start the application server.

To substitute required fonts in a HTML-to-PDF conversion on the Linux platform, PDF Generator creates a symbolic link that point to the /usr/share/X11/fonts directory.

Sometimes the user running the application server might not possess permissions that are necessary to create a symbolic link. On such systems; create a symbolic link /usr/lib/X11/fonts that point to the /usr/share/X11/fonts directory.

In Solaris 11 some of the fonts required for HTML to PDF conversion are moved from /usr/openwin/lib/X11/fonts location to /usr/share/fonts location. To allow PDF Generator to access these fonts, create a symbolic link at /usr/openwin/lib/X11/fonts, referring to /usr/share/fonts location. To perform HTML-to-PDF conversion on Solaris 11 platform, do the following:

1. Open the Terminal Window

2. Run the following command:

   ln -s /usr/share/fonts /usr/openwin/lib/X11/fonts/usr_share_fonts

Install the hotfix for your Windows Server 2008 version as described in the following articles:

http://support.microsoft.com/kb/972616 for Windows Server 2008

http://support.microsoft.com/kb/2815716 for Windows Server 2008 R2

PDF Generator requires additional RPM packages and fonts to perform conversions on RHEL6. Perform the following steps to configure the PDF Generator on RHEL6:

1. Install the following RPM packages from RHEL6 installation media:

   • glibc-2.12-1.25.el6.i686.rpm

   • nss-softokn-freebl-3.12.9-3.el6.i686.rpm

   • libX11-1.3-2.el6.i686.rpm

   • libxcb-1.5-1.el6.i686.rpm

   • libXau-1.0.5-1.el6.i686.rpm

   • zlib-1.2.3-25.el6.i686.rpm

   • libXext-1.1-3.el6.i686.rpm

   • fontconfig-2.8.0-3.el6.i686.rpm

   • expat-2.0.1-9.1.el6.i686.rpm

   • freetype-2.3.11-6.el6_0.2.i686.rpm

   • libSM-1.1.0-7.1.el6.i686.rpm

   • libICE-1.0.6-1.el6.i686.rpm

   • libuuid-2.17.2-12.el6.i686.rpm

   • libXrandr-1.3.0-4.el6.i686.rpm

   • libXrender-0.9.5-1.el6.i686.rpm

   • libXinerama-1.1-1.el6.i686.rpm

2. In your browser, open website http://cgit.freedesktop.org/xorg/font/ibm-type1/

3. Download the compressed file font-ibm-type1-1.0.3.tar.gz or font-ibm-type1-1.0.3.zip.The compressed file contains required fonts.

4. Extract the downloaded zip file to the /usr/share/fonts directory.

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 by launching multiple instances of OpenOffice or PDFMaker (which is used to perform the Word and PowerPoint conversions).

If you need to enable multi-threaded file conversion, you must first perform the tasks outlined in the “Enabling multi-threaded file conversions” section of the Preparing to Install or Upgrade guide available on the LiveCycle documentation.

For Linux and Solaris users, you must create users and configure the system to remove the password prompts. The following section outlines the method to create a user and perform additional configurations.

1. Start the DB2 Configuration Assistant.

2. Click Selected > Add Database Using Wizard.

3. Select Manually Configure a Connection to a Database and click Next.

4. Select TCP/IP and click Next.

5. Specify the following TCP/IP communication options and then click Next:

   • In the Host Name box, type the host name of the server hosting DB2 Content Manager.

   • Leave the Service Name box empty.

   • In the Port Number box, type the port number. The default DB2 Content Manager port number is 50000.

6. In the Database Name box, type the IBM Content Manager datastore name and, in the Database Alias box, type the alias name for the datastore and then click Next.

7. Click Next to accept the default data source settings.

8. In the Operating System list, select the operating system you are using and then click Next.

9. Specify the following system options and then click Next:

   • In the System Name box, type the server name hosting DB2. If you click Discover, DB2 Content Manager searches for the system name you specified and, if the system is not found, all of the DB2 instances are listed.

   • In the Host Name box, type the name of the host, or click View Details to show the domain and IP address of the system you named in the previous step.

   • In the Operating System list, select the operating system (Windows, Linux, or AIX) on which you deployed DB2 Content Manager.

10. (Optional) To specify Security options, select Use Authentication Value in Server’s DBM Configuration and click Finish.

11. In the Test Connection dialog box, test the connection as required.

1. Configure the initial connection by following the steps in 2.2.8.1 Configure the connection for a single IBM Content Manager datastore.

2. Add additional database connections by modifying the cmbicmsrvs.ini file (the file that stores the datastore information) as follows:

   • From a command prompt window, change the directory to [II4C home]/bin (for example, C:\Program Files\db2cmv8\ on Windows or /opt/IBM/db2cmv8 on AIX, Linux, or Solaris).

   • Run the cmbenv81.bat (Windows) or cmbenv81.sh (AIX, Linux, or Solaris) file to set the environment and the classpath for the Java Utilities of II4C.

   • Change the directory to [II4C working directory]/cmgmt/connectors where [II4C working directory] is one of the following paths:

     (Windows) C:/Program Files/db2cmv8

     (Linux, AIX) /home/ibmcmadm

     (Solaris) /export/home/ibmcmadm

   • Run the command

     java com.ibm.mm.sdk.util.cmbsrvsicm -a add -s <library server database name> -sm <database schema name>

     where <library server database name> is the same as Database Alias configured in step 6 above.

   Note: The following procedure allows users without DB2 rights to share the connection credentials through the cmbicmenv.ini file.

1. From a command prompt window, change the directory to [II4C home]/bin (for example, C:\Program Files\db2cmv8\ on Windows or /opt/IBM/db2cmv8 on AIX, Linux, or Solaris).

2. Run the cmbenv81.bat (Windows) or cmbenv81.sh (AIX, Linux, or Solaris) file to set the environment and the classpath for the Java Utilities of II4C.

3. Change the directory to [II4C working directory]/cmgmt/connectors, where [II4C working directory] is one of the following paths:

   (Windows) C:/Program Files/db2cmv8

   (Linux, AIX) /home/ibmcmadm

   (Solaris) /export/home/ibmcmadm

4. Run the command

   java com.ibm.mm.sdk.util.cmbenvicm -a add -s <library server database name> -u <database user ID> -p <database password>

   where <library server database name> is the same as Database alias configured in step 6 above.