Installing PDF Rendering Service

To enable PDF rendering of checked-in documents via the Adlib PDF Enterprise server, the Business Administrator must install and run the PDF Rendering Monitoring Service to ensure that submitted PDF rendering jobs are completing successfully. The PDF Rendering Monitoring Service can run on the same server as 3DSpace, 3DPassport, and other services, or it can run on a different physical or virtual server. You can use the following steps to install the PDF Rendering Service.

See Also
Starting the PDFRendering Monitor Service
  1. Unzip the PDF Rendering Monitoring Service HF media tarkit for 3DEXPERIENCE R2022x for the required FD.
  2. Browse to select the installation directory to upgrade.
  3. Click Enter to accept the default for using a pre-existing JDK/JRE installation. The embedded JRE is available, but not supported for production purposes.
  4. After accepting the default JDK/JRE installation, enter the path to the pre-existing JDK/JRE. For example, enter <ServerInstall>/jdk and click Enter.
  5. Click Enter to accept the pre-existing TomEE installation, which is typically the same TomEE that is used for 3DSpace deployment.

    Note: For testing purposes only, you can install the embedded TomEE.

  6. Enter the directory of the pre-existing TomEE installation, <ServerInstall>/apache-tomcat.

    Important: If an embedded JRE and TomEE are specified, enter the certificates directory used on the 3DSpace server and a port number for TomEE.

  7. Enter the 3DPassport and 3DSpace URLs.

    For example,

    • 3DPassport URL: https://vdevpril999am.ux.dsone.3ds.com:453/iam. Confirm the port used.
    • 3DSpace URL: https://vdevpril999am.ux.dsone.3ds.com/3DSpace

    Important: Retain the port 453 specification for the Passport server.

  8. Ensure that both URLs are correct to avoid any connectivity issues.
  9. Review your installation inputs and click Enter.

    A series of output statements confirm the installation.

  10. The installation should be successful, but if it is not and the problem is not clear, be sure to capture the issue being reported for a potential Service Request.

    Note: Avoid installing the PDF Rendering Monitor Service as a root user, and instead use the credentials of an Administrator user.

  11. Click Enter to acknowledge the installation is complete.
  12. Important: Install the PDF Rendering Monitoring Service directly under the same directory as all the other 3DEXPERIENCE installations for ease of configuration. If you choose to install it on a different physical server, be sure to retrieve the public certificates of the 3DSpace server and add them to the keystore of the JDK/JRE that you have specified during installation. The scripts that you will need to start the monitoring service will be startup_pdfr.sh or startup_pdfr.bat. These should have been updated automatically during installation to reflect the library paths needed. These library paths include JAVA_JRE_HOME,TOMCAT_HOME, PDFR_ JAVASERVER, and PDFR_JAVACOMMON. JAVA_JRE_HOME is updated to the pre-existing JDK/JRE path and TOMCAT_HOME is updated to the location of the pre-existing Tomcat.
  13. Enable PDF rendering and configure automatic PDF generation. For more information, see Configuring Automatic PDF Generation.