Write down GUID of the master CML node. You can obtain it from the web interface of YSoft SafeQ or from <SafeQ4>\conf\startup.conf (parameter localGUID) on the master node.

Stop all SafeQ4 services (both CML and ORS)

Backup SQDB4 and SQDB4_SQDW databases

Backup SafeQ4 files and folders:

1. c:\SafeQ4\conf

2. c:\SafeQ4\server\spool (if you want to keep jobs)

3. c:\SafeQ4\server\update (if you want to keep custom FW update files)

4. c:\SafeQ4\ds\Conf\config.ini

5. c:\SafeQ4\tomcat\conf\server.xml

Uninstall SafeQ4

Install SafeQ5 with the same GUID which was used for SafeQ4

Stop all SafeQ5 services

Delete SQDB5 and SQDB5_SQDW databases - check "Close existing connections" option before proceeding

Restore SQDB4, SQDB4_SQDW as SQDB5, SQDB5_SQDW from backup files

1. Databases -> Restore Database... -> To database: SQDB5 -> From device: choose backup file -> tick Restore and finish the wizard

2. Repeat similar procedure for SQDB5_SQDW

Run migration scripts on SQDB5 database (available in the YSoft SafeQ 5 installation package, folder "_support\Manual upgrade from SafeQ 4"):

1. 01_drop_columns.sql

2. 02_migrate_pricelists.sql

3. 03_update_terminals.sql

4. 04_migrate_users_8.sql

   1. If you use a different name for SQDB5_SQDW database, update the script correspondingly (all "update SQDB5_SQDW.dbo.*" records)

5. 05_migrate_globalauth.sql

Update table cluster_server if necessary

Restore configuration files regarding backup:

1. Copy rools.drl file from SafeQ4 backup into SafeQ5 (overwrite existing one)

2. If you want to keep jobs, copy content from SafeQ4 spool folder into SafeQ5

3. If you want to keep custom FW update files, copy content from SafeQ update folder into SafeQ5

4. Verify terminalserver configuration and update it regarding c:\SafeQ4\ds\Conf\config.ini if needed

   1. in c:\SafeQ5\terminalserver\\TerminalServer.exe.config - change "networkAddress" if needed

   2. in c:\SafeQ5\terminalserver\WebServer.config - change bindings if needed

5. Verify configuration of tomcat and update it regarding c:\SafeQ4\tomcat\conf\server.xml if needed

   1. in c:\SafeQ5\tomcat\conf\server.xml - change settings if needed

Start SafeQ5, check DB validation

Verify scan to script settings (paths might be wrong after upgrade to SafeQ5)

Verify global authentication properties in SafeQ5 system settings - make sure that the default administrator login/password suits your needs and change it if needed.

1. Go to System > System settings and search for global-authentication-

Reinstall SafeQ embedded terminals on all printers

1. Note: Support of embedded terminal types was unified in SafeQ5. Terminal type will be automatically migrated to proper type by migration scripts.

Write down GUID of the master CML node. You can obtain it from the web interface of YSoft SafeQ or from <SafeQ4>\conf\startup.conf (parameter localGUID) on the master node.

Stop all SafeQ4 services (both CML and ORS)

Backup SQDB4 and SQDB4_SQDW databases (choose Format TAR + appropriate file names, leave rest of options in default state)

Backup SafeQ4 files and folders:

1. c:\SafeQ4\conf

2. c:\SafeQ4\server\spool (if you want to keep jobs)

3. c:\SafeQ4\server\update (if you want to keep custom FW update files)

4. c:\SafeQ4\ds\Conf\config.ini

5. c:\SafeQ4\tomcat\conf\server.xml

Uninstall SafeQ4

Install SafeQ5 with the same GUID which was used for SafeQ4

Stop all SafeQ5 services

Drop SQDB5 and SQDB5_SQDW databases

Create new empty SQDB5 and SQDB5_SQDW databases

Restore SQDB4, SQDB4_SQDW as SQDB5, SQDB5_SQDW - ignore errors and returned exit code - close the dialog using X button

Run script on SQDB5_SQDW database (available in the YSoft SafeQ 5 installation package, folder "_support\Manual upgrade from SafeQ 4"):

1. 02_drop_dblink_func.sql

Run migration scripts on SQDB5 database:

1. 01_mig4_5_rmv_obj.sql

2. 02_drop_dblink_func.sql

3. 03_mig4_5_prc_lsts.sql

4. 04_mig4_5_trm_mng.sql

5. 05_mig4_5_usrs.sql

   1. this script must be run with following parameters in defined order:

      1. hostname: i.e. '127.0.0.1'

      2. port: i.e. '5433'

      3. name of DB with datawarehouse: i.e. 'SQDB5_SQDW'

      4. user: i.e. 'postgres'              

      5. password: i.e. 'your_password'

   2. or into the script body following lines must be placed:

      1. i_host = '127.0.0.1';               

      2. i_port = '5433';              

      3. i_dbname = 'SQDB5_SQDW';               

      4. i_user = 'postgres';               

      5. i_pwd = 'your_password';

6. 06_mig4_5_globalauth.sql

Update table cluster_server if necessary

Restore configuration files regarding backup:

1. Copy rools.drl file from SafeQ4 backup into SafeQ5 (overwrite existing one)

2. If you want to keep jobs, copy content from SafeQ4 spool folder into SafeQ5

3. If you want to keep custom FW update files, copy content from SafeQ update folder into SafeQ5

4. Verify terminalserver configuration and update it regarding c:\SafeQ4\ds\Conf\config.ini if needed

   1. in c:\SafeQ5\terminalserver\\TerminalServer.exe.config - change "networkAddress" if needed

   2. in c:\SafeQ5\terminalserver\WebServer.config - change bindings if needed

5. Verify configuration of tomcat and update it regarding c:\SafeQ4\tomcat\conf\server.xml if needed

   1. in c:\SafeQ5\tomcat\conf\server.xml - change settings if needed

Start SafeQ5, check DB validation

Verify scan to script settings (paths might be wrong after upgrade to SafeQ5)

Verify global authentication properties in SafeQ5 system settings - make sure that the default administrator login/password suits your needs and change it if needed.

1. Go to System > System settings and search for global-authentication-

Reinstall SafeQ embedded terminals on all printers

1. Note: Support of embedded terminal types was unified in SafeQ5. Terminal type will be automatically migrated to proper type by migration scripts.