Getting Started with Quark Publishing Platform 2015 - December 2019 Update (v15.0)

Upgrading to Quark Publishing Platform 2015

Each enterprise software release often includes third-party library software updates, configuration and API changes which may impact your implemented solution and system extensions. As part of every upgrade process, Quark recommends a thorough review of the full documentation set, including related third-party documentation. While we make every effort to help simplify this process for all our customers, it’s critical to review all related information including deprecation announcements. This analysis and adequate testing will help ensure a smooth enterprise software upgrade as you make the transition from development and staging systems to production. Please reach out to Enterprise Support for any urgent questions, and we will be happy to assist you.

A recommended best practice for upgrading includes these high-level steps:

  1. Analyze all Quark and related technical information

  2. Make custom solutions compatible with Java 8 and related 3rd-party library changes

  3. Make custom solutions to adapt to API changes

  4. Merge configuration files (customer-specific changes must be brought into the new files)

  5. Check in all checked out assets

  6. Upgrade Platform database

  7. Upgrade Platform Server

The Smart Content schema change from 3 to 4 happens automatically as Quark Author Web Edition users check-out/ check in content into the upgraded system. Publishing-related activities which deal with smart content XML must be migrated to the 4.0 namespace.

 

If you manage Quark software with Quark License Administrator (QLA), check in your licenses before upgrading.

Upgrading Quark Publishing Platform Server (Windows)

If you are upgrading from Quark Publishing Platform 10.5.1, 10.5.1.1, or 10.5.1.2 to Quark Publishing Platform 15.0 you must first upgrade to Quark Publishing Platform Server 11.0 (including updating the database). See the original Quark Publishing Platform 2015 ReadMe published in July 2015 (https://quark.app.box.com/folder/5045696165).

 

If you are upgrading from Quark Publishing Platform 11.0, 11.2.1, 11.2.x, 12.x, 13.0, 13.1, 13.2, 14.0 or 14.2, 14.3 and 14.3.1 to Quark Publishing Platform 15.0, you can upgrade directly to 15.0.

If you installed Microsoft SQL Server or Oracle when you installed Quark Publishing Platform, you must run a separate Quark Publishing Platform Database upgrader to upgrade the database. For more information, see "Upgrading Quark Publishing Platform database (Windows): MS SQL Server or Oracle."
The upgrade process should not be canceled halfway through.

To upgrade to Quark Publishing Platform Server 14.3, perform the following steps:

  1. Close any open Platform server files.

  2. Stop the Quark Publishing Platform Server and make a backup of the folders on the Server.

  3. Close Quark Publishing Platform Server Console.

  4. Double-click the "Quark Publishing Platform Server.exe" file in the Installer folder and then choose Install QPP Server, or double-click the "setup.exe" file in the Installer/Quark Publishing Platform Server folder. The installer automatically detects your Quark Publishing Platform installation and switches to upgrade mode.

  5. Enter your valcode.

  6. Click Next.

  7. Follow instructions on-screen.

  8. Click Finish when the process concludes.

  9. Upgrade the related database according to the following section before starting the Quark Publishing Platform Server.

During the upgrade process, your custom changes are saved to the following folders:

  • ext_backup

  • Conf_old

  • Publishing_old

  • Webapps_backup

Ensure that ‘Server’ directory and all its contents (sub directories and files inside them) has read and write permission for the USER who is going to run Server with any user other than who has installed the Quark Publishing Platform Server.

Upgrading the Quark Publishing Platform database

The topics below explain how to upgrade the Quark Publishing Platform database.

You must upgrade the Quark Publishing Platform database before you start the Quark Publishing Platform server.
The Java 1.8 (JRE or JDK) should be installed on the machine on which the database upgrade is being executed.

Upgrading Quark Publishing Platform database (Windows): MS SQL Server or Oracle

If you use MS SQL Server or Oracle on Windows for your Quark Publishing Platform database, perform the manual steps described below.

  1. Shut down Quark Publishing Platform Server.

  2. Navigate to the Updater/Database directory.

    The updater can be run from any Windows computer on which MS SQL Server Management Studio for MS SQL server and Oracle Client for oracle is installed. The machine must have JRE 1.8 installed and defined in the path variable.

  3. Double-click the "Update.exe" file and follow the instructions on the screen.

  4. Choose Oracle/SQL from the drop-down menu.

  5. Follow the instructions on the screen.

  6. Supply the path of the Job Jackets file used in the current Quark Publishing Platform system. By default, this file is located in the Quark Publishing Platform Server application folder.

  7. Supply the path of any scripts in the current Quark Publishing Platform system. By default, these are located at C:\Program Files\Quark\Quark Publishing Platform\Server\Scripts.

    If a legacy Platform database is created on a SQL server which has Windows/domain authentication enabled, then use the "UpdateUsingSSO.bat" script to update the database.
    If you are updating from Quark Publishing Platform 10.1.x or 10.5.x to Quark Publishing Platform 14.0, the folder for Job Jackets and scripts can be any blank folder. If you have a base installation of Quark Publishing Platform 9.5 server, there will not be a folder for Job Jackets and scripts in the Quark Publishing Platform server installation. While updating the database, the database updater needs these folders, so we can supply any blank folder to update the database.

     

Upgrading Quark Publishing Platform database (Linux): Oracle

If you use Oracle on Linux for your Quark Publishing Platform database, perform the manual steps described below to upgrade the Quark Publishing Platform database. The Linux machine should have JRE 1.8 installed.

  1. Shut down Quark Publishing Platform Server.

  2. Navigate to the Upgrader/QPP Server/Database/Oracle directory.

  3. Copy the oracle folder to the local hard drive on the computer where you installed Oracle. This folder contains the database update scripts.

  4. Display a command prompt and navigate to the Update folder on the local hard drive.

  5. To execute the "Update.sh" script, enter sh Update.sh followed by these arguments:

    • SysPwd: The password of the SYS user in the database.

    • QPPUser: The name of the Quark Publishing Platform schema.

    • QPPPwd: The password for the Quark Publishing Platform schema.

    • ServiceName: The Oracle service name.

    • JobJacketsPath: The path to the default Job Jackets file.

    • Scripts: The path to the directory that contains any custom scripts.

    If you are updating from Quark Publishing Platform 10.1.x, 10.5.x or 11.2.2 to Quark Publishing Platform 14.0, the folder for Job Jackets and Scripts can be any blank folder.

Upgrading Quark Publishing Platform XTensions software for QuarkXPress Server

To upgrade your Quark Publishing Platform XTensions software for QuarkXPress Server:

  1. On Windows, use the Windows uninstaller to uninstall the existing Quark Publishing Platform XTensions software for QuarkXPress Server.

  2. On Windows, use the Windows uninstaller to uninstall the existing instance of QuarkXPress Server. On macOS, drag the existing QuarkXPress Server application folder to the trash.

  3. Install QuarkXPress Server 14.3.2 For more information, see the Getting Started with QuarkXPress Server.

  4. Upgrade Quark Publishing Platform Server as described in "Upgrading Quark Publishing Platform Server (Windows)."

© 2020 Quark Software Inc. All rights reserved.