Scope
The following installation guide describes the upgrade process from VERDE 8.2.8 to VERDE versions 8.3.4.0 and 8.3.4.1. It is expected that the person executing this installer has a working knowledge of Linux commands.
Overview
The VERDE Installer is designed to perform an upgrade from VERDE 8.2.8 to 8.3.4.n.
The Verde installer (VI) is a bash script with the embedded modules that allow the easy install, reinstall, configuration of Verde and Postgres DB.
The installer script file is named verde-installer.sh. The verde-installer.sh script must be in same folder as the unpacked Verde packages (RPMs or DEBs).
The installer’s UI it is a pseudo terminal UI that is used to display system output or messages from commands executed by the script. These are not necessarily errors but standard behavior of such application.
The installer should have access to the internet to download needed utilities from the host operating system (CentOS/Ubuntu) repositories as needed.
Executing the Installer
To execute the installer: (note: server is the computer system that VERDE is to be installed)
- Connect to the server using standard SSH connection or directly access the server. To avoid permission issues you should use a root level user.
- Unpack the VERDE distribution file. (VERDE distribution files are “.zip” files)
- Change the current directory to the folder created by the unpacking. You should see verde-installer.sh along with other files.
- You may need to add the executable flag to verde-installer.sh: e.g., chmod +x ./verde-installer.sh
- To start the installer: ./verde-installer.sh
- Complete all steps until the process has been completed.
- If any errors occurred, please contact NComputing support for assistance.
If Verde service is currently running the installer will issue a stop command. Please plan your update based on this short downtime.
If VERDE is running it asks to stop it or terminate upgrade process:
Stopping VERDE
The installer automatically detects the older version. The upgrade process uses only the automatic mode. Select Automatic:
Third party dependencies and libraries are downloaded from the appropriate repository and installed as needed.
Next step is to set the password for the postgres user for the newly installed database.
Important: the postgres user has full access to all DB components, databases, other users and objects. It is recommended to set a safe and secure password.
The migration process starts automatically.
All data from VERDE 8.2.8 HSQL database is copied to the Postgres DB.
After the data migration the installer can configure server setting in case changes are required. The recommended option is to select same options used for 8.2.8
Server role.
Next step is assignment of the Public IP address of the Verde server:
Important: for clustered server do not use the same FQDN name that will be selected for different cluster node (such as localhost, 127.0.0.1 and so on). Public IP address must be visible for all nodes in the cluster and unique in the configured cluster.
Next is final installation and configuration of the Verde server.
If installation completed without errors the following results are displayed:
Important: if you configured that cluster in the automatic mode do not change the DB settings and location of the DB files.
The DB folder for the cluster in the Automatic mode is: /home/vb-verde/pgsql/15/data
Installation is complete:
Verde is ready for use: