Documentation Center

Configuring an existing SDL XPP installation to publish PDFs

This task includes instructions for those who have previously installed and used SDL XPP and who plan to publish PDFs from SDL Contenta S1000D for the first time. This task covers how to configure your environment as required to publish PDFs from Contenta S1000D.

Before you begin

About this task

Procedure

  1. Do one of the following:
    • If you want to migrate XPP from your Contenta Web server to a different server, see Migrating SDL XPP and then return to this topic at step 2.
    • If you choose to leave XPP installed on your Contenta Web server, install the new license file.
  2. On the XPP server, install XPP RESTful Web Services.
    See XPP RESTful Web Services Installation and Release Notes Chapter 1: Installing XPP RESTful Web Services.
  3. On the XPP server, back up your existing std_jobz/alljobz/ subdirectory of your XPP_home directory.
  4. On the XPP Server, back up your existing XPP_home directory.
  5. On the XPP server, do the following:
    1. In XyAdmin, click File > Document Paths.
    2. In the Handle text box, type the name of the handle where you want S1000D jobs and divisions to go.
    3. In the Path text box, type the path to where the handle, jobs, and division files will be stored.
    4. Click OK.
    Windows XPP servers have a default handle called first and Unix XPP servers have a default handle called host-name1, for example, neptune1. You may choose to use these handles to store your S1000D jobs. The handle name is case sensitive and must match the value specified for xppHandle in the PublishConfiguration_Unix.xml file, which is located in the web/cw_common/custom/S1000D_Publish/ subdirectory of the Contenta_home directory on the Contenta Web server.
  6. On the XPP server, do the following:
    1. In XyAdmin, click File > Graphics Configuration.
    2. Add a rule.
    3. In the Library Name field, type a name for your graphics library. This name must match the xppImageLibrary setting in the PublishConfiguration.xml, located in the /web/cw_common/custom/S1000D_Publish/ subdirectory of the Contenta_home directory on the Contenta Web server, which is set to graphics by default.
    4. In the Library Path field, type ../graphics (or other name as needed to match your xppImageLibrary setting value)
    5. Optionally, in the Comment field, type Job-level graphics library for S1000D XPP Publish.
    6. Store and exit the spec.
  7. Copy the appropriate file for your XPP server from the Contenta/S1000D_samples/xpp directory on the Contenta Web server to the XPP_home directory on the XPP server, and then extract its contents.
    • For a Windows XPP server, copy and extract s1000dXppXz.zip.
    • For a Linux XPP server, copy and extract s1000dXppXz_Unix.zip.
    This extracts the xz/procs/citi/pgcnt.pl and xz/xpprest/user/modifytoc.pl files to existing directories, which already contain other files.
  8. Linux only: Set permissions on the extracted pgcnt.pl and modifytoc.pl files to make them executable as well as read and write.
  9. On the Contenta Web server, make sure the xppImageLibrary setting in PublishConfiguration.xml, located in the /web/cw_common/custom/S1000D_Publish/ subdirectory of the Contenta_home directory, matches the graphics library name in XyAdmin on the XPP server.
  10. If you are publishing multiple languages to XPP, do the following.
    1. Obtain all fonts you will be using in various languages.
    2. Use XPP's Font Copy and Build FAST utilities to add these fonts to XPP.
    3. Add the new FASTs to XPP's Font Variant spec that is used when publishing from Contenta S1000D, fv_sys, located in the Ls1kd_css XPP style library if using CSS styles.
  11. On the Contenta Web server, do the following:
    1. Navigate to the web/cw_common/custom/S1000D_Publish/ subdirectory of the Contenta_home directory.
    2. Open PublishConfiguration.xml for editing.
    3. Change the xppHost and xppPort settings to point to the XPP RESTful Web Services host and port.
    4. Edit the following line:
      <property name="xppHandle" value="name of handle"/>

      where name of handle is the name of the XPP handle where S1000D jobs and divisions will go. By default, the value is first. If XPP is installed on Windows, you will have a handle named first and do not need to modify this line if you want to use this handle. However, if XPP is installed on Unix, you must change first to another value.

    5. Edit the following line:
      <property name="xppServerOS" value="XPP server operating system"/>

      where XPP server operating system is WINDOWS or UNIX. If your XPP server is the same OS as your Contenta Web server, you do not need to edit this line.