How To
Summary
This document outlines the steps required to upgrade IBM Publishing Document Builder (PUB) from version 7.0.3 to 7.1 SR1. The upgrade process involves:
Performing a fresh installation of IBM PUB 7.1 SR1.
Migrating configuration files from the existing 7.0.3 installation to the new 7.1 SR1 setup.
This approach ensures a clean environment while preserving essential configurations from the previous version.
Steps
Before Performing pub_upgrade to 7.1 SR1
Java Requirements
- PUB 7.1 SR1 requires Java 17.
- This means you cannot upgrade using the usual method of copying .war files method.
- Ensure that JAVA_HOME is correctly set to point to the correct JRE.
Key Configuration Files to Merge
Important: Do not copy configuration files directly from the existing installation (e.g., PUB 7.0.3).
Always merge them carefully to retain customizations and avoid compatibility issues.
The key configuration files to merge from the existing installation PUB 7.0.3 to the new PUB 7.1 SR1 installation:
Files to Merge:
- server.xml
- server.startup.bat (or server.startup.sh for Unix/Linux)
- server.env
- jvm.options
- liberty.server
- Any other custom configuration files relevant to your setup, like:
- log4j.properties
- SSL-related files
Tips for Merging
- Use tools like Notepad++ or any file comparison tool to view existing and new files side-by-side.
- Carefully merge customizations line by line.
- Always keep backups of both the old and new configuration files before making changes.
Start PUB Server
Start the server from 7.1 SR1 installation,
cd /server ./server.startup
Document Location
Worldwide
Was this topic helpful?
Document Information
Modified date:
24 October 2025
UID
ibm17248938