Updating YSoft SafeQ CML

This page describes how to use the YSoft SafeQ Setup Wizard to perform a basic YSoft SafeQ server update.

Due to a Java platform change, a direct update from YSoft SafeQ 5 MU48 and lower to YSoft SafeQ 5 MU70 and higher is NOT supported. Installations with YSoft SafeQ 5 MU48 and lower should be updated to YSoft SafeQ 5 MU69 first. Then an update to MU70 can proceed.

You can use the wizard to update all version of YSoft SafeQ 5 that was previously installed via any installer (GUI or script).

When updating to a new release, all installed components (YSoft SafeQ CML/ORS/CRS servers, Mobile Print Server, YSoft Payment System and YSoft Payment System plugins) have to be updated.

In case one or more YSoft SafeQ services has been disabled, enable them before you start.

Minimum free space required for update is 600MB.

If you want to update YSoft SafeQ installed via enterprise (script) installer - Be sure that safeq_home property is already exists in environment variables. Create this variable (safeq_home=<SafeQ_dir>) if it does not exist already.

If you want to enable JDBC connection pool feature when updating from YSoft SafeQ 5 SR 5 or 6, you should set configuration property enableDBPool in configuration file startup.conf to true.

Upgrade from Service Release 8 and earlier requires re-installation of the YSoft SafeQ Embedded Terminals for Konica Minolta. In case the terminals are not re-installed, users might not be able to authenticate.

1	a. Download the installation package ysf-sq5-install.exe from the YSoft Partner Portal. Once you have the package and the server is ready for installation, you can begin the YSoft SafeQ installation. NOTE: In order to install YSoft SafeQ, this file is required. It contains everything required to install a fully functional YSoft SafeQ server. b. Run the file ysf-sq5-install.exe.
2	Select the language that will be used for the installation process. This language will also be used as the default language for the YSoft SafeQ system. NOTE: You can change the language later at any time.
3	Continue to next page from Welcome screen. NOTE: Close all other applications to avoid issues with updating the relevant system files.
4	If you agree to all the license terms and conditions, click I Agree to continue. If you do not agree, click Cancel to quit the installation.
5	After you accept the license agreement, the installer runs a preinstallation check. This procedure checks several conditions and determines if the server meets all requirements for YSoft SafeQ installation.
6	To use the displayed settings: Click Install. or To configure custom settings: Check the I want to customize my SafeQ installation checkbox and proceed to step 7.
7	Choose the database that will be used by YSoft SafeQ: the default embedded PostgreSQL 9.2.x the bundled Microsoft SQL Server 2008 Express Edition (if Windows Installer version 4.5 or higher is present) Use an existing external database server which you can choose if you already have MS SQL 2008 or 2012 or PostgreSQL 9.2.x database with enough capacity to hold the YSoft SafeQ database. NOTE: For database synchronization, a user named sync must exist. Click Next.
8	Enter names for YSoft SafeQ databases and click Next.
9	The last page of the wizard indicates that the update is complete. Click Finish.