proc_basic-troubleshooting.adoc

Basic troubleshooting

Resolve most issues by stopping the {prod} virtual machine, deleting it, and starting a new instance.

Prerequisites

• You set up the host machine via the {bin} setup command. For more information, see [setting-up-codeready-containers_{context}].

• You started {prod} via the {bin} start command. For more information, see [starting-the-virtual-machine_{context}].

• You are using the latest {prod} release. Using a version earlier than {prod} 1.2.0 may result in errors related to expired x509 certificates. For more information, see [troubleshooting-expired-certificates_{context}].

Procedure

To troubleshoot {prod}, perform the following steps:

1. Stop the {prod} virtual machine:

   $ {bin} stop

2. Delete the {prod} virtual machine:

   $ {bin} delete

3. Start the {prod} virtual machine:

   $ {bin} start

   Note	The cluster takes a minimum of four minutes to start the necessary containers and Operators before serving a request.

If your issue is not resolved by this procedure, perform the following steps:

1. Search open issues for the issue that you are encountering.

2. If no existing issue addresses the encountered issue, create an issue and attach the ~/.crc/crc.log file to the created issue. The ~/.crc/crc.log file has detailed debugging and troubleshooting information which can help diagnose the problem that you are experiencing.