--- title: "Zetaly Installation - Linux" slug: "zetaly-installation-linux" updated: 2025-01-20T15:48:23Z published: 2025-01-20T15:48:23Z canonical: "docs.zetaly.io/zetaly-installation-linux" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.zetaly.io/llms.txt > Use this file to discover all available pages before exploring further. # 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 - psql package (since 5.0.0) - 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 ```shell 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 A backup is highly recommended ! ! !Having a back-up of the clean state of any machine is invaluable when dealing with machine-breaking issues. Although rare, the cost of possibly having to rebuild it from scratch far outweighs that of taking a snapshot once. 1. Untar the package: ```shell 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 Properties](/v1/docs/configuration-global)article. 3. If necessary, add additional lines to the configuration file `zetalyinstall.cnf` to customize your installation. For more information see the [Linux Configuration Properties](/v1/docs/configuration-linux) article. 4. Launch the `run.sh `script: ```shell 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. Note:The `run.sh` script is pre-prepared by Zetaly and typically does not need editing. If you experience installation issues you may need to edit the `run.sh` script. For more information see the [Editing the run.sh Script](/v1/docs/configuration-linux#editing-the-runsh-script) section in the the [Linux Configuration Properties](/v1/docs/configuration-linux) article. ## 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. The CNF file format can change between versions ! Always compare the content of your previous `zetalyinstall.cnf` file with the new one before replacing eveything. Never replace the file or overwrite its content before doing so. Many tools can help you do this automatically rather than comparing line by line by hand. 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 ```shell 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](/v1/docs/mainframe-installation) in doubt.