Possible Issues

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

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 impossibles 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"