Upgrade from YSoft SafeQ 4 to YSoft SafeQ 5 - PostgreSQL External database
Please, read Upgrade from YSoft SafeQ 4 to YSoft SafeQ 5 notes before migration.
Overview
This page describes step-by-step migration process to upgrade existing YSoft SafeQ 4 installation to YSoft SafeQ 5.
Before upgrade
Stop all YSoft SafeQ services on ORSs.
Backup existing YSoft SafeQ 4 configuration and databases.
Uninstall all YSoft SafeQ 4 CML server(s) except the first (master node).
All nodes of the CML cluster have to be in the same timezone.
Postgre SQL 9.2 installation
Please follow the instructions and install external PostgreSQL 9.2 database.
Restore SafeQ databases from SafeQ 4
1 | Backup existing PostgreSQL 8.4 SafeQ 4 databases.
|
2 | Create new PostgreSQL 9.2 databases SafeQ5 and SafeQ5_SQDW.
|
3 | Restore databases from SafeQ 4 to SafeQ 5:
|
4 | Create new database user called "sync" with the identical password as in SafeQ 4 (PostgreSQL 8.4).
|
Migration steps for master CML node
Perform the following steps on the server where the master node of YSoft SafeQ 4 CML is installed
1 | Download the installation file ysf-sq5-install.exe from the Y Soft Partner Portal. Once you have the file and the server is ready for installation, start the installation in order to begin YSoft SafeQ migration.
|
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.
|
3 | 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 whether the server meets all necessary requirements for YSoft SafeQ installation. If any of these requirements are not met, they will be displayed in either the Show warnings or Show problems area, depending on their severity. If there are warnings, installation can continue. If there are problems, installation cannot continue. If any warnings or problems are indicated, review the warnings and resolve the problems, then continue. The requirement that are being checked by the installer are:
|
6 | The installer now displays YSoft SafeQ installation settings.
To use values other than the default ones:
|
7 | Configure the connection to your external PostgreSQL 9.2 databases.
|
8 | Enter the YSoft SafeQ 5 databases names for (where the existing YSoft SafeQ 4 databases were migrated). |
9 | The installer begins to copy all the files required files to the selected destination folder on the server. |
10 | The last page of the wizard informs you about the results of the installation process and gives you the option to display the YSoft SafeQ Web Interface. Click Finish when you are ready to close the installation wizard.
|
11 | Installation is now complete.
|
Troubleshooting the installation process
In case any error occurs during the installation process, the best way to troubleshoot it is to check the log files that created during the process. All log files created during installation are located in the YSoft SafeQ installation folder.
sqinstall.log - contains information about the entire YSoft SafeQ installation process.
Custom installation
1 | Download the installation file ysf-sq5-install.exe from the Y Soft Partner Portal. Once you have the file and the server is ready for installation, start the installation in order to begin YSoft SafeQ migration.
|
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.
|
3 | 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 whether the server meets all necessary requirements for YSoft SafeQ installation. If any of these requirements are not met, they will be displayed in either the Show warnings or Show problems area, depending on their severity. If there are warnings, installation can continue. If there are problems, installation cannot continue. If any warnings or problems are indicated, review the warnings and resolve the problems, then continue. The requirement that are being checked by the installer are:
|
6 | The installer now displays YSoft SafeQ installation settings. Check I want to customize my YSoft SafeQ installation
|
7 | Select the Upgrade from YSoft SafeQ 4.0.34.2 option. Name of this option may differ, it depends on version of SafeQ that was installed before upgrade.
|
8 | Enter the folder where YSoft SafeQ 5 will be installed. |
9 | Configure the connection to your external PostgreSQL databases 9.2. |
10 | Enter the databases names for YSoft SafeQ 5 (where the existing YSoft SafeQ 4 databases were migrated). |
11 | Change the additional settings if necessary. |
12 | The installer begins to copy all the files required files to the selected destination folder on the server. |
13 | The last page of the wizard informs you about the results of the installation process and gives you the option to display the YSoft SafeQ Web Interface. Click Finish when you are ready to close the installation wizard.
|
14 | Installation is now complete.
|
Troubleshooting the installation process
If an error occurred during the installation process, the best way to troubleshoot it is to check the several log files that were created during the process. All installation log files are located in the YSoft SafeQ installation folder.
sqinstall.log - contains information about the entire YSoft SafeQ installation process.
Migration steps for second and every other node of CML
Perform the following steps on every server where the additional YSoft SafeQ 4 node was installed.
Installation requires the exactly the same IP addresses used with YSoft SafeQ 4 (second node of YSoft SafeQ 5 has to have the same IP address that was used used for YSoft SafeQ 4).
Installation requires the installed PostgreSQL database server.
1 | Download the installation file ysf-sq5-install.exe from the Y Soft Partner Portal. Once you have the file and the server is ready for installation, start the installation in order to begin YSoft SafeQ migration.
|
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.
|
3 | 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 whether the server meets all necessary requirements for YSoft SafeQ installation. If any of these requirements are not met, they will be displayed in either the Show warnings or Show problems area, depending on their severity. If there are warnings, installation can continue. If there are problems, installation cannot continue. If any warnings or problems are indicated, review the warnings and resolve the problems, then continue. The requirement that are being checked by the installer are:
|
6 | Select I want to customize my YSoft SafeQ installation and continue to next step.
|
7 | Select Add or replace a node in existing YSoft SafeQ cluster and continue to next step.
|
8 | Enter the IP address of the current master node (1st node) and click Retreive node list. Then select the IP address of the node that you want to replace and continue to next step.
|
9 | You now have the option to select your own installation location. You can install YSoft SafeQ anywhere other than a UNC path or the root folder of the drive.
|
10 | Select Use an existing external database server.
|
11 | Configure the connection to the external database server.
|
12 | Enter the name of the YSoft SafeQ databases.
|
13 | The last page of the wizard allows you to change the following settings:
IIS web server is required to use embedded hostable web core (HWC) web server inside Terminal Server. HWC web server is suitable for environments with a lot of devices on one node (e.g. up to 400) or for customers that experience problems with the legacy web server mainly for stability reasons (unexpected crashes). It provides best performance and stability, that is not achievable with any other embedded web server solution.
|
14 | The installer begins to copy all the files required by YSoft SafeQ and the database system you chose to the selected destination folder on the server.
|
15 | Installation will be paused. Follow the displayed steps and restore SQDB5 database from the master node to slave node. |
16 | Installation is now complete.
|
17 | If required, repeat this procedure for other node.
|
Troubleshooting the installation process
In case an error occurred during the installation process, the best way to troubleshoot it is to check the several log files that were created during the process. All installation log files are located in the YSoft SafeQ installation folder.
sqinstall.log - contains information about the entire YSoft SafeQ installation process.
Additional steps
Reinstall all embedded devices.
Upgrade Terminal Professional FW if necessary.
Run LDAPReplicator (optional).