1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
= Troubleshooting unknown issues
Resolve most issues by restarting {prod} with a clean state.
This involves stopping the instance, deleting it, reverting changes made by the [command]`{bin} setup` command, reapplying those changes, and restarting the instance.
.Prerequisites
* You set up the host machine with the [command]`{bin} setup` command.
For more information, see link:{crc-gsg-url}#setting-up_gsg[Setting up {prod}].
* You started {prod} with the [command]`{bin} start` command.
For more information, see link:{crc-gsg-url}#starting-the-instance_gsg[Starting the instance].
* You are using the latest {prod} release.
Using a version earlier than {prod} 1.2.0 might result in errors related to expired x509 certificates.
For more information, see link:{crc-gsg-url}#troubleshooting-expired-certificates_gsg[Troubleshooting expired certificates].
.Procedure
To troubleshoot {prod}, perform the following steps:
. Stop the {prod} instance:
+
[subs="+quotes,attributes"]
----
$ {bin} stop
----
. Delete the {prod} instance:
+
include::partial$snip_crc-delete.adoc[]
. Clean up remaining changes from the [command]`{bin} setup` command:
+
[subs="+quotes,attributes"]
----
$ {bin} cleanup
----
+
[NOTE]
====
The [command]`{bin} cleanup` command removes an existing {prod} instance and reverts changes to DNS entries created by the [command]`{bin} setup` command.
====
. Set up your host machine to reapply the changes:
+
[subs="+quotes,attributes"]
----
$ {bin} setup
----
. Start the {prod} instance:
+
[subs="+quotes,attributes"]
----
$ {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:
. link:https://github.com/crc-org/crc/issues[Search open issues] for the issue that you are encountering.
. If no existing issue addresses the encountered issue, link:https://github.com/crc-org/crc/issues/new[create an issue] and link:https://help.github.com/en/articles/file-attachments-on-issues-and-pull-requests[attach the [filename]*_~/.crc/crc.log_* file] to the created issue.
The [filename]*_~/.crc/crc.log_* file has detailed debugging and troubleshooting information which can help diagnose the problem that you are experiencing.
|
