Docker Trial Troubleshooting

Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-installation-and-upgrade-guides/zephyr-enterprise-trial/docker-trial-troubleshooting.html

Below is a list of possible issues you may encounter when working with the product and information on how to resolve them:

Issues with Zephyr Installation via docker

If you are stuck or having issues with Zephyr installation through docker, you need to remove the Zephyr docker images manually before performing the fresh installation. This will eliminate any potential conflicts or issues that might have occurred during the previous installation.

To remove the Zephyr docker images manually,

Open the Docker desktop and go to the Images section.
Select the zsdockerbuild/zsdockerimage, mysql, and elasticsearch images.
Click Delete. This ensures a clean starting point for the fresh installation.
Proceed with a fresh installation of Zephyr via Docker to ensure a clean and stable setup.

Zephyr doesn’t start.

If you face this issue after completing the installation steps, this means the application may not have been installed yet. Please wait until the log outputs the message below indicating that the installation has finished:

**************************

^{Zephyr Started}

**************************

Elasticsearch is not running.

If you face this issue, please check the status of Elasticsearch on one of the following pages on the computer where it is installed:

http://localhost:9200/

http://localhost:9300/

On Windows: No option to adjust Docker advanced settings.

Depending on some settings chosen during the Docker installation on Windows, the Advanced settings may not be available. Make sure the Enable Linux containers on Windows check box is selected in the Docker settings.

Installation failed because Zephyr Trial is already installed.

If you face this issue, you need to uninstall the currently installed Zephyr Trial, because it is impossible to have two trials on the same computer.

Docker Compose is not installed.

On Windows and Mac, Docker Compose is installed automatically along with Docker. On Linux, you need to install it.

Install Docker Compose, ensure it has been installed successfully, and try again.

A MySQL database already exists.

If your machine already has a MySQL database installed, you should be able to install Zephyr properly as long as the machine does not have the itcc and dversion schemas. If the schemas already exist, please contact Zephyr support for help.

The required ports are not available.

If the required ports are not available on the host machine (see Prerequisites), you can map other ports to them. You specify mapping settings in the docker compose file (docker-compose.yaml).

In the example below, the port values on the left should be modified for your host machine:

#dockercompose 
services: 
  mysql: 
    ... 
    ports: 
      - "3306:3306" 
  elasticsearch: 
    ... 
    ports: 
      - 9200:9200 
      - 9300:9300 
  zephyr: 
    ... 
    ports: 
     - "80:80" 
     - "8080:8080"

Poor performance of the whole system.

If you experience performance issues, please make sure the number of CPUs is set to at least 4, and the amount of the available memory is set to at least 6 GB in the Docker Settings.

Docker Desktop doesn’t start.

Docker Desktop will not start if virtualization is disabled on your machine. To make sure it is enabled, open the Task Manager and switch to the Performance tab: