Zetaly Installation - Linux

Introduction

Zetaly provides a package for offline installation as a .tar.gz file, which contains the following:

• Some or all the Zetaly modules (depending on your contract).
• A zetalyinstall.cnf configuration file, which you must edit to define the necessary configuration properties.  
• A run.sh shell script to launch the installation.
• A zetalyinstall.sh shell script which contains all the default configuration properties. You must never modify this shell script.

Requirements

The Zetaly package supports installation on Linux.

The package must be uploaded directly on the host machine, which must have the following elements:

• RAM : 16 GB minimum 
• Storage : 2 To minimum
  Note: May vary according to your needs, see with your Zetaly commercial representative to get an estimation.
• Bash shell for .sh scripts execution
• tar package
• unzip package
• nodejs 16 installed

• PostgreSQL 11 (or above) server already installed
• Host machine with the database port open (usually 5432). This can be done by an admin user, using the following command:
  ShellShell

  iptables -A INPUT -p tcp --dport 5432 -j ACCEPT

• Connection to the Zetaly Portal must be done using HTTPS with TLS security. SSL certificates must be produced by your IT department to allow connection to Zetaly Portal.
• The port chosen for the Zetaly Portal (i.e. the value of the Frontal.Host.Port property in the zetalyinstall.sh shell script, which can be overridden by adding it into the zetalyinstall.cnf configuration file) must be open for outside access. By default, this port is 443. 
• For s390x : dotnet 6 needs to be installed and accessible in `/bin/dotnet6/dotnet`

Installation

1. Untar the package:

   tar -xf file_name.tar.gz

   Note:

   Make sure that the directory where you download, untar and execute the installer is owned by your user.
2. Edit the configuration file zetalyinstall.cnf to define the necessary configuration properties. For more information, see the Global Configuration Propertiesarticle.
3. If necessary, add additional lines to the configuration file zetalyinstall.cnf to customize your installation. For more information see the Linux Configuration Properties article.
4. Launch the run.sh script:

   bash run.sh

   The installer creates one directory per module at in the directory defined by the Installation.Directory property. By default the modules are installed within the ./zetaly directory.

Upgrading an Existing Installation

Upgrading occurs when you already have an installation and you install a newer version. Rollbacks are not supported by the Zetaly installer.

When upgrading from a version lower than S4.0.0 to a version S4.0.0 or higher, it is necessary to stop services Zxx before upgrading.  

To upgrade your existing installation, do the following:

1. Edit configuration file zetalyinstall.cnf from the new package to redefine the necessary configuration properties. 
2. Launch the run.sh script

   bash run.sh

The installer creates one directory per module at in the directory defined by the Installation.Directory property. By default the modules are installed within the ./zetaly directory. None of your data is modified, unless a specific warning is indicated in the release notes (they are referred as "breaking changes").  

Upgrading the ZSA Mainframe Part

The mainframe upgrade is similar to the first installation. You must do the following:

1. Upload the package to the mainframe (Binary).
2. Stop all the tasks that are using the current LOADLIB.
3. Rename the current loadlib to another name.
4. Rename the new loadlib to the current name.
5. Start again the tasks. 

Refer to the First installation guide in doubt.