mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-06 15:46:57 +01:00
107 lines
3.1 KiB
Plaintext
107 lines
3.1 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// migration/migrating_3_4/troubleshooting.adoc
|
|
// migration/migrating_4_1_4/troubleshooting.adoc
|
|
// migration/migrating_4_2_4/troubleshooting.adoc
|
|
[id='migration-restic-errors_{context}']
|
|
= Error messages
|
|
|
|
[id='restic-timeout-error-velero-log_{context}']
|
|
== Restic timeout error message in the Velero Pod log
|
|
|
|
If a migration fails because Restic times out, the following error appears in the Velero Pod log:
|
|
|
|
----
|
|
level=error msg="Error backing up item" backup=velero/monitoring error="timed out waiting for all PodVolumeBackups to complete" error.file="/go/src/github.com/heptio/velero/pkg/restic/backupper.go:165" error.function="github.com/heptio/velero/pkg/restic.(*backupper).BackupPodVolumes" group=v1
|
|
----
|
|
|
|
The default value of `restic_timeout` is one hour. You can increase this parameter for large migrations, keeping in mind that a higher value may delay the return of error messages.
|
|
|
|
.Procedure
|
|
|
|
. In the {product-title} web console, navigate to *Operators* -> *Installed Operators*.
|
|
. Click *Cluster Application Migration Operator*.
|
|
. In the *MigrationController* tab, click *migration-controller*.
|
|
. In the *YAML* tab, update the following parameter value:
|
|
+
|
|
[source,yaml]
|
|
----
|
|
spec:
|
|
restic_timeout: 1h <1>
|
|
----
|
|
<1> Valid units are `h` (hours), `m` (minutes), and `s` (seconds), for example, `3h30m15s`.
|
|
|
|
. Click *Save*.
|
|
|
|
[id='restic-verification-error-migmigration_{context}']
|
|
== `ResticVerifyErrors` in the MigMigration Custom Resource
|
|
|
|
If data verification fails when migrating a PV with the filesystem data copy method, the following error appears in the MigMigration Custom Resource (CR):
|
|
|
|
----
|
|
status:
|
|
conditions:
|
|
- category: Warn
|
|
durable: true
|
|
lastTransitionTime: 2020-04-16T20:35:16Z
|
|
message: There were verify errors found in 1 Restic volume restores. See restore `<registry-example-migration-rvwcm>`
|
|
for details <1>
|
|
status: "True"
|
|
type: ResticVerifyErrors <2>
|
|
----
|
|
<1> The error message identifies the Restore CR name.
|
|
<2> `ResticErrors` also appears. `ResticErrors` is a general error warning that includes verification errors.
|
|
|
|
[NOTE]
|
|
====
|
|
A data verification error does not cause the migration process to fail.
|
|
====
|
|
|
|
You can check the target cluster's Restore CR to identify the source of the data verification error.
|
|
|
|
.Procedure
|
|
|
|
. Log in to the target cluster.
|
|
. View the Restore CR:
|
|
+
|
|
----
|
|
$ oc describe <registry-example-migration-rvwcm> -n openshift-migration
|
|
----
|
|
+
|
|
The output identifies the PV with `PodVolumeRestore` errors:
|
|
+
|
|
----
|
|
status:
|
|
phase: Completed
|
|
podVolumeRestoreErrors:
|
|
- kind: PodVolumeRestore
|
|
name: <registry-example-migration-rvwcm-98t49>
|
|
namespace: openshift-migration
|
|
podVolumeRestoreResticErrors:
|
|
- kind: PodVolumeRestore
|
|
name: <registry-example-migration-rvwcm-98t49>
|
|
namespace: openshift-migration
|
|
----
|
|
|
|
. View the `PodVolumeRestore` CR:
|
|
+
|
|
----
|
|
$ oc describe <migration-example-rvwcm-98t49>
|
|
----
|
|
+
|
|
The output identifies the Restic Pod that logged the errors:
|
|
+
|
|
----
|
|
completionTimestamp: 2020-05-01T20:49:12Z
|
|
errors: 1
|
|
resticErrors: 1
|
|
...
|
|
resticPod: <restic-nr2v5>
|
|
----
|
|
|
|
. View the Restic Pod log:
|
|
+
|
|
----
|
|
$ oc logs -f restic-nr2v5
|
|
----
|