3.3 Before you start

3.3.1 General considerations

Before you install, read through the following information to ensure that your installation runs smoothly:

  • To reduce the time of installation, install AEM forms on JEE either by using a local copy of the installation files or directly from the DVD. The installation could fail when AEM forms on JEE is installed from a network.

  • Ensure that the installation media that you received is not damaged. If you copy the installer media to the hard disk of your computer, ensure that you copy the entire DVD contents on to the hard disk.

  • If you downloaded the installer file set, verify its integrity using an MD5 check sum utility. Use this utility to check the MD5 check sum values with the value displayed on the Adobe download website. You can use a tool such as WinMD5.

  • To avoid installation errors, do not copy the DVD install image to a directory path which exceeds the maximum path length limitation. Typically, long network paths cause this error. See http://msdn.microsoft.com/en-us/library/aa365247.aspx for more information.

  • Download any patch updates for AEM forms on JEE available from Adobe Enterprise Support .

  • You may choose to disable any on-access virus scanning software for the duration of the installation, to improve the speed of installation on Windows.

  • The turnkey installation creates the following Windows services, which, by default, are set to run automatically on startup:

    • MySQL for Adobe Experience Manager forms

    • JBoss for Adobe Experience Manager forms

  • By default, the turnkey installation places AEM forms on JEE components in the C:\Adobe\Adobe_Experience_Manager_forms\ directory.

    Important: If you choose another directory, do not use the name test as your directory name (for example, C:\test) or the MySQL install process will fail.

  • By default, JBoss is installed to and runs from the [JBoss root] directory.

3.3.2 Disable the Windows UAC on Vista and Windows Server 2008 R2

  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.

You must disable UAC when installing and configuring AEM forms on JEE. To enable the UAC again, repeat the steps above and select Enable UAC before clicking Launch.

3.3.3 Disable the Windows UAC on Windows 7 and Windows Server 2008 R2

  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.

Important: The Windows User Account Control (UAC) must remain disabled for PDF Generator to work properly. You can run the installation and configuration process by turning on the UAC with the Elevate without prompting option enabled. However, disable UAC to run PDF Generator.

3.3.4 Reader Extensions credential

If you are installing Reader Extensions, ensure that you have a valid credential and password. If you do not have this information, contact your Adobe account representative. You can choose to skip importing the Reader Extensions credential when configuring and deploying AEM forms on JEE and install it later using the Trust Store component in Administration Console.

3.3.5 Preconfigurations for PDF Generator

With native application file support, PDF Generator can convert files from native formats such as Microsoft Word to Adobe PDFs. Before you install PDF Generator, complete the tasks listed below.

3.3.5.1 Installing software for native file conversions

Before you install PDF Generator, install the software that supports the native file types for which, PDF conversion support is required. Also, manually activate licenses for the software using the same user account used to run the application server.

Refer and conform to the individual licensing agreement for each native application used for conversions with AEM forms on JEE.

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

  • Microsoft Office 2007, 2010 (DOC, XLS, PPT, RTF, TXT, Microsoft Office open XML Formats)

  • Microsoft Office Visio 2007, 2010 (VSD)

  • Microsoft Publisher 2007, 2010 (PUB)

  • Microsoft Project 2007, 2010 (MPP)

  • Corel WordPerfect 12, X4 (WPD)

  • Adobe® FrameMaker® 7.2, 8.0 (FM)

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

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

Note: AEM forms on JEE supports only 32-bit editions of all the above mentioned software.
Note: Install OpenOffice 3.3 on the server to convert the documents created in version 3.3. On Linux platform, OpenOffice must be installed under /root user. If OpenOffice is installed for specific users, PDFG might not be able to convert OpenOffice documents.

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

  • Web files (HTML)

  • Print files (PS, PRN, EPS)

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

3.3.5.2 Installing Adobe Acrobat for PDF Generator

Install Adobe® Acrobat® XI Pro before running the AEM forms on JEE installer. Ensure that you launch Acrobat at least once after installing it to avoid PDF Generator configuration issues. Dismiss all modal dialog boxes that appear on launching Acrobat.

However, if AEM forms on JEE is installed and Acrobat is not installed, install Acrobat and then run the Acrobat_for_PDFG_Configuration.bat script, located in the folder [aem-forms root] \pdfg_config. Otherwise, PDF conversions may fail.

The AEM forms on JEE installer sets the Acrobat_PATH (case sensitive) environment variable automatically. You can also choose to set it manually, see 6.12.1 Setting environment variables . Restart your application server after setting the environment variable.

To use AES 256 encryption in AEM forms on JEE Encryption service to encrypt a PDF document, you must obtain and install the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy files. For Oracle JDK installed with turnkey installation, download JCE files from Java SE Downloads. After downloading the policy file, replace the existing local_policy.jar and US_export_policy.jar files under [Adobe_JAVA_HOME] /jre/lib/security folder with the downloaded JAR files.

3.3.5.3 Enabling multi-threaded file conversions and multiuser support for PDF Generator

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.
Note: Multi-threaded conversions are not supported for Microsoft Excel, Microsoft Visio, Microsoft Project, and Microsoft Publisher.
Note: Microsoft Excel and Microsoft Visio files are not converted simultaneously. During conversion, EXCEL.exe and VISIO.exe are watched in the task manager. The Visio file is processed only after processing on the Excel file is complete.

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 AEM forms on JEE server computer. On 64-bit Windows, disable Windows UAC. See 3.3.2 Disable the Windows UAC on Vista and Windows Server 2008 R2 or 3.3.3 Disable the Windows UAC on Windows 7 and Windows Server 2008 R2 , as applicable.

When adding users for OpenOffice, Microsoft Word, or Microsoft PowerPoint dismiss the initial activation dialogs for all users. After your AEM forms on JEE server is configured, add AEM forms on JEE user accounts in Administration Console. See the 6.12.7 User accounts for multi-threaded file conversions .

To enable multiuser support for native files and OpenOffice files on a Windows environment, add a minimum of three users with the following permissions.

Platform

User permissions

Windows 2008 Server

Users with administrative privileges

When you add users for PDF Generator native conversions, grant the user Logon as Service right. For more information, see 3.3.5.4 Granting the Logon as Service right

3.3.5.4 Granting the Logon as Service right

If you are installing PDF Generator on any Windows operating system, grant the Logon as Service right to the user that installs AEM forms on JEE.

  1. Select Start > Control Panel > Administrative Tools > Local Security Policy > Local Policies > User Rights Assignment .

  2. Double-click Log on as a service and click Add User or Group .

  3. Type the user name for the Microsoft Administrator and click OK .

// Ethnio survey code removed