Documentation Center

Packaging content for delivery

Complete these steps in the LiveContent S1000D Publish tool to build a package of one or more IETPs for distribution. The package, which includes the content, required libraries, program files, and a publication launcher, is stored in a target directory in zipped and unzipped versions.

Before you begin

  • The LiveContent S1000D Publishing Server must be installed.
  • One or more publications must have been generated using the LiveContent S1000D Publish tool.
  • The user must have sufficient read-write permissions to create and modify configuration, data, and status log files in their respective directories.

About this task

When you build a package, you give it a unique identifier, which can be used in the field to identify collections that should be updated.

For example, you might name a package containing only the Bike publication BIKE2020. After adding new content, if you package the collection with the same identifier, users who installed the earlier version of the collection will have their content updated.

Procedure

  1. Launch the LiveContent S1000D Publish tool.
    1. In Windows File Explorer, navigate to folder containing the LiveContentS1000DPublish.exe executable (by default LiveContent/PublishUI).
    2. Right-click the executable and select Run as Administrator.
    The Publish tool launches in a browser window.
  2. From the LiveContent S1000D Publish home screen, click Packages.
    The Package List displays a list of the available packages.
  3. Click Add.
    The Package Builder appears.
  4. Make entries to the following fields.
    FieldDescription
    NameRequired.

    Name of the package.

    This value must be unique and can be up to 60 characters in length. It cannot contain special characters.

    DescriptionRequired.

    Description of the Package.

    This value can be up to 256 characters in length and cannot contain special characters.

    DateRequired.

    Date of the package. This field defaults to the current date. Use the calendar widget to select a different date.

  5. From the Publication Selector list, select one or more publications to include in the package.
  6. Click Next.
    The tool displays a summary of the values you entered.
  7. Click Build to launch the build process using these values, or Cancel to return to the Package Builder to make changes.
    The Status window displays information about the progress of the process, including running tallies of warnings and fatal errors encountered.

    When the process completes, the status of the package in the Package List changes to Complete, which appears as a link with an icon indicating success or failure. Click this link to view the process log.

  8. When the process is finished, click the View Package Location link to open the file directory to the folder containing the generated package.
  9. Click Finish.
    The Package List appears, including the new publication in the list.

Results

The LiveContent S1000D Publish tool does the following.
  • Saves the package in the LiveContentData/cdimages directory in zipped and unzipped versions.
  • Creates a collection in the LiveContentData/collections directory.
  • Updates the PackageData.xml file in the LiveContentData/publishData directory, or creates it if does not exist.
  • Creates an applicability folder named LiveContent/templates/FullSupport/httpdocs/book_data/PACKAGE_NAME/PUBLICATION_NAME for any publication in the package with applicability configured.
  • Updates the package_PACKAGE-NAME.txt status log file in the LiveContentData/publishData/logs directory, or creates it if does not exist.