A Detailed Description of the Upgrade Steps
Overview
The entire upgrade process consists mainly of data migration, which is divided into particular steps to ensure the flexibility and failover of the upgrade. This document describes the current steps in detail, see the general description of Upgrading from YSoft SafeQ 5 to YSoft SafeQ 6 and The YSoft SafeQ 5 to YSoft SafeQ 6 Upgrade Tool to see how upgrading and data migration in steps work in general.
Particular upgrade steps are divided into schemes according to the migration areas:
CLUSTER – the scheme for cluster management steps which is loaded automatically for tenant_1 a database scheme
TENANT – the scheme for upgrading a tenant database
DWH – the scheme for upgrading a tenant's warehouse database
Step Overview
CLUSTER.INITIALIZE
Creates database entities for migration and cleans logging tables.
CLUSTER.COMMON
Prepares common data for migration (especially identifiers).
CLUSTER.CONFIGURATIONS
Migrates the appropriate configuration of YSoft SafeQ 5 into the cluster management scheme (the common configuration for all tenants).
This step is run only for the default first tenant, i.e., it is not run for additional tenant schemes.
CLUSTER.POOL
Migrates data about the file pool to be deleted.
TENANT.INITIALIZE
Creates database entities for migration and cleans logging tables.
TENANT.COMMON
Prepares common data for migration (especially identificators).
TENANT.CONFIGURATIONS
Migrates the appropriate configuration of YSoft SafeQ 5 into the tenants scheme (the configuration for each tenant).
TENANT.USERS
Migrates users' data about users, user roles, rights, etc.
TENANT.DEVICES
Migrates device data, including terminals, Spooler Controllers, and device groups.
Migration of ORS servers
All valid and active ORS servers are migrated as Spooler Controllers while the upgrade mechanism expects there must be at least one Spooler Controller in the destination YSoft SafeQ 6. It means YSoft SafeQ 6 must be installed with a local Spooler Controller or there must exist at least one ORS server in YSoft SafeQ 5. If the condition is not fulfilled, the migration ends with a FAILED status.
Device assignment to Spooler Controller is migrated according to the following rules:
The device from a non-ORS device group is assigned
to local Spooler Controller if it exists, or
to the first migrated Spooler Controller (i.e., the first ORS group or local Spooler Controller installed with YSoft SafeQ 6).
The device from the ORS device group is assigned to Spooler Controller created from that ORS group.
During the migration, the Spooler Controllers migrated from ORS groups are only created in the database, it is necessary to install them manually at the same IP address with the same GUID.
Migration of device accounting
Because there is a slightly different accounting setting in YSoft SafeQ 6, it is possible that migrated devices will have different accounting than the original devices. See accounting translation details. If the accounting was changed for a device during the migration, there is an appropriate message in the upgrade report, and the Upgrade tool returns WARNING status or a warning message is displayed in the case of the Server installer.
Migration of hardware terminals
The hardware terminal type "Hardware terminal professional version 3.5" is not supported in YSoft SafeQ 6, so in the case of this terminal migration, the appropriate device is migrated as "device without terminal", and a WARNING status or a warning message is displayed in the case of the Server installer.
TENANT.DEVICE_TEMPLATES
Migrates device templates data.
TENANT.QUEUES
Migrates device direct and user shared queues data.
TENANT.PRICELISTS
Migrates price list data.
TENANT.PROJECTS
Migrates the billing code data.
TENANT.JOBS
Migrates jobs metadata mainly because of reports and statistics.
All jobs with any possible statuses are migrated as DELETED with no previews because it is not possible to migrate spooled job data due to the radically different architecture of YSoft SafeQ 6. Users have to send their jobs again after a successful upgrade to be able to print any previously spooled jobs again (even the favorite ones). Also, there a situation can occur when jobs are accounted in YSoft SafeQ 5 but are not part of statistics yet.
TENANT.STATS
Migrates the metadata of statistics reports (Web reports, Management reports, scheduled reports to email, file, etc.).
TENANT.RBE_RULES
Migrates the RBE data file from YSoft SafeQ 5 file format into the YSoft SafeQ 6 database.
TENANT.SCAN_WORKFLOWS
Migrates scanning workflows and related data (scan parameters, scan accesses).
Scan to email
For the workflows type Scan to email in YSoft SafeQ 5, you need to define two parameters – from and to – which are used for specifying the sender and recipient email addresses. If either one of them happens to be empty after migration into YSoft SafeQ 6, you will have defined user inputs %senderEmail% and %recipientEmail% respectively.
From Build 60, there is an issue that causes email workflows to fail (" Unsupported account type [0] ." error message in YSoft SafeQ Workflow Processing Server ). The issue can be fixed manually by opening the connector for edition, making some changes so the Save button appears, and saving the connector.
Scan to script
For the workflows type Scan to script in YSoft SafeQ 5, you need to define the parameter targetDir. After the migration is done in YSoft SafeQ 6, the value of this parameter will populate the field Target folder in the workflow definition for this workflow.
The administrator must verify that this field contains the only absolute path.
The relevant message will be written in the Upgrade report file generated during the migration process.
DWH.INITIALIZE
Creates database entities for migration and cleans logging tables.
DWH.COMMON
Prepares common data used by the migration process (mainly, ID conversion tables).
DWH.REPORTS
Migrates the data of reports.
DWH.STATS
Migrates the metadata of statistics reports (Web reports, Management reports, etc.).