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 followed the installation properly and you can see the logs running, the application may not have finished the installation yet. Please wait until the log outputs the message below indicating that installation has finished.
****************************
Zephyr Started
****************************
Elasticsearch is not running
You can check the status of Elasticsearch on the following page: http://localhost:9200/.
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
Uninstall Zephyr.
Docker Compose is not installed
On Windows and Mac, Docker Compose is automatically installed along with Docker. On Linux, you need to Docker Compose.
Ensure that Docker Compose has been installed 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 unless it does not have the itcc and dversion schemas. If the schemas already exist, please contact Zephyr support for help.
The required port is not available
If the required ports are not available on the host machine (see Prerequisites), you can specify ports manually by updating the docker compose file (docker-compose.yaml).
Please look for the port mappings as shown below. The values on the left (in bold) should be modified for your host machine:
#dockercompose
services: