Upgrade of YSoft SafeQ 5 single server installation without ORS servers

Summary

This document describes how to upgrade single-server environment of YSoft SafeQ 5 without cluster and ORS servers through Server Installer (for manual upgrade see this article).

See general summary of upgrade to see more information.

If there are ORS servers or the YSoft SafeQ 5 installation running in the cluster, see Upgrading a YSoft SafeQ 5 Cluster Server Installation with a Non-trivial Environment Setup.

Prerequisites

See General prerequisites.

Please note that in case the embedded PostgreSQL database is used in a time zone other than GMT, the following workaround to the known limitation must be applied.

Configuring the PostgreSQL Time Zone for Correct Print Job and Report Data

Upgrade of the first server in cluster

  1. Check that all prerequisites are fulfilled.

  2. Install the Dispatcher Paragon last build with server installer on the same server where older YSoft SafeQ 5 CML is installed.

    1. The installer will stop and set for manual start these old services.

    2. YSoft SafeQ Terminal Server service is renamed to Dispatcher Paragon Terminal Server 5.

    3. The installer will install new Dispatcher Paragon Management Service and Spooler Controller into the new directory. Local Spooler Controller must be installed (it is part of server installer) if the original YSoft SafeQ 5 installation does not have any ORS group set up.

    4. The installer runs automatically the Upgrade Tool

      1. If there is an error in the upgrade, the installer displays the error message with detailed information about the error.

      2. If there is a warning in the upgrade, the installer displays the warning message with information that it is strongly recommended to review the changes to adjust them to match business requirements.

    5. The installer will start newly registered services and Dispatcher Paragon is up and running.

  3. See upgrade tool logs and report if all steps were a success.

    1. If the Upgrade Tool succeeds, ensure that all Common after successful upgrade steps are done.

    2. Otherwise, the errors must be investigated according to The YSoft SafeQ 5 to Dispatcher Paragon Upgrade Tool documentation.

  4. After the upgrade there is still previous version of the YSoft SafeQ 5 in the system. It's possible to uninstall it manually (later) running appropriate YSoft SafeQ 5 installer.

Common steps after successful upgrade

  • Because of upgrade does not solve licensing of migrated devices and entities in general, there can be the notification that re-licensing of the product is necessary for Management Service notifications (after administrator signs in). Reactivation must be done within 10 days after upgrade otherwise the devices can be removed from the system. Also, devices will not work until reactivation because of technical limitations. See how to activate new license after upgrade.

  • Check in general that migrated data are as expected.

  • If Dispatcher Paragon manages printing devices, all device terminals must be reinstalled (use Devices > Printers > select all devices > Actions > Reinstall terminal). After re-installation check that devices working properly.

    • All Konica Minolta Embedded Terminals requires setting of " Terminal mode ".

  • System configuration properties which should be reverted to default values:

    • mpsJobSendFailed

    • mpsMailAuthenticationFailed

    • mpsMailDuplicateAddress

    • mpsMailFooter

    • mpsMailHeader

    • mpsMailSendFailed

    • mpsMailSendOk

    • rejected-email-text

    • ruleBasedEngineConfigurationProblemsEmailBody

    • ruleBasedEngineConfigurationProblemsEmailSubject

    • sslPortInfo

    • welcome-to-safeq-text

See A Detailed Description of the Upgrade Steps for more information about particular upgrade steps.