Installation

Obtaining Installation Logs

Windows

The default location of the Windows installation log files is C:\zetalySuite\zetalylogs, but can can vary according to your installation base folder.

Custom Log Files Directory

Log files are located in the directory path defined by the value of the INSTALLER.logDirPath property in the zetalyinstall.cnf file. For more information, see the Zetaly Installer User Manual.

Linux/Docker

There is no specific log file created during a zetaly installation. Please, send us a file with your console logs.

You can launch the script and redirect the output to a file with:

bash run.sh > install.logs

Troubleshooting

Problem	Actions
After launching the script `zetalyinstall.ps1`, the following error appears in console : "File zetalyinstall.ps1 cannot be loaded. The file zetalyinstall.ps1 is not digitally signed. You cannot run this script on the current system."	Run as administrator, the following PowerShell command `Set-ExecutionPolicy -Scope Process -ExecutionPolicy Unrestricted`
Upon database creation, the following error appears in the console : " ERROR: Exception calling "InitializeDatabase" with "0" argument(s): "Exception calling "ExecuteScalar" with "0" argument(s): "Named Pipes Provider: Could not open a connection to SQL Server [53]. "".Exception.Message "	Single SQL command : `EXEC sp_dropserver 'local', 'droplogins';` OR With a database manager, access the server and delete the linked server named 'local'
Only for Linux installation, KeyCloak doesn't start and this type of error is logged "SELinux is preventing /usr/lib/systemd/systemd from execute the file kc.sh"	Change the file control value of SELinux in the file /etc/selinux/config, if it's in enforcing change it to permissive and reboot. OR Change the location of Keycloak installation to a folder inside /usr/bin. Edit zetalyinstall.cnf, add the line `Installation.Directory=KEYCLOAK_FOLDER`. Warning, this folder will be completely cleaned. Edit run.sh and change all values `=1` to `=0` except the line `KEYCLOAK_INSTALLATION=1` Run the installation (bash run.sh), you will probably need to run the command with sudo since the usr/bin is more protected Run the following commands `sudo semanage fcontext -a -t bin_t "KEYCLOAK_FOLDER/keycloak/bin/kc.sh"` `sudo restorecon -v "KEYCLOAK_FOLDER/keycloak/bin/kc.sh"` For both solutions you will have to rerun the installation (at least with KeyCloak, ZHB and Front installation in run.sh) to allow the setup of default properties
Unable to install Zetaly suite as root user	As the root user has no home folder, the /home/root/zetaly folder cannot be created. Defining a home folder for the root user

Problem

Actions

After launching the script zetalyinstall.ps1, the following error appears in console :
"File zetalyinstall.ps1 cannot be loaded. The file zetalyinstall.ps1 is not digitally signed. You cannot run this script on the current system."

Run as administrator, the following PowerShell command
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Unrestricted

Upon database creation, the following error appears in the console :
"
ERROR: Exception calling "InitializeDatabase" with "0" argument(s): "Exception calling "ExecuteScalar" with "0" argument(s): "Named Pipes Provider: Could not open a connection to SQL Server [53]. "".Exception.Message
"

Single SQL command :
EXEC sp_dropserver 'local', 'droplogins';

OR

With a database manager, access the server and delete the linked server named 'local'

Only for Linux installation, KeyCloak doesn't start and this type of error is logged "SELinux is preventing /usr/lib/systemd/systemd from execute the file kc.sh"

Change the file control value of SELinux in the file /etc/selinux/config, if it's in enforcing change it to permissive and reboot.
OR

Change the location of Keycloak installation to a folder inside /usr/bin. Edit zetalyinstall.cnf, add the line Installation.Directory=KEYCLOAK_FOLDER. Warning, this folder will be completely cleaned.
Edit run.sh and change all values =1 to =0 except the line KEYCLOAK_INSTALLATION=1
Run the installation (bash run.sh), you will probably need to run the command with sudo since the usr/bin is more protected
Run the following commands
- sudo semanage fcontext -a -t bin_t "KEYCLOAK_FOLDER/keycloak/bin/kc.sh"
- sudo restorecon -v "KEYCLOAK_FOLDER/keycloak/bin/kc.sh"

For both solutions you will have to rerun the installation (at least with KeyCloak, ZHB and Front installation in run.sh) to allow the setup of default properties

Unable to install Zetaly suite as root user

As the root user has no home folder, the /home/root/zetaly folder cannot be created.
Defining a home folder for the root user

Installation

Obtaining Installation Logs

Windows

Linux/Docker

Troubleshooting

What's Next