Frequently Asked Questions (FAQ)

  1. Logs are cut off or missing

    This could be due to concurrency issues in the terminal when refreshing the progress bar and displaying logs. Try running with job option --progress log.

  2. Unknown options: '--keyspace', '--key'

    You must specify one or more Redis commands for *-import (file-import, faker, db-import).

  3. ERR DUMP payload version or checksum are wrong

    Redis 7 DUMP format is not backwards compatible with previous versions. To replicate between different Redis versions, use Type-Based Replication.

  4. ERR Unsupported Type 0

    The target database is most likely CRDB in which case you need to use type-based replication (--struct option).

  5. Process gets stuck during replication and eventually times out

    This could be due to big keys clogging the replication pipes. In these cases it might be hard to catch the offending key(s). Try running the same command with --info and --progress log so that all errors are reported. Check the database with redis-cli Big keys and/or use reader options to filter these keys out.

  6. NOAUTH Authentication required

    This issue occurs when you fail to supply the --pass <password> parameter.

  7. ERR The ID argument cannot be a complete ID because xadd-id-uniqueness-mode is strict

    This usually happens in Active/Active (CRDB) setups where stream message IDs cannot be copied over to the target database. Use the --no-stream-id option to disable ID propagation.

  8. ERR Error running script…​ This Redis command is not allowed from scripts

    This can happen with Active/Active (CRDB) databases because the MEMORY USAGE command is not allowed to be run from a LUA script. Use the --mem-limit -1 option to disable memory usage.

  9. java.lang.OutOfMemoryError: Java heap space

    The RIOT-X JVM ran out of memory. If you are running db-import this could be due to a large resultset being loaded upfront. Use the --fetch option to set a fixed fetch size (e.g. --fetch 1000). Otherwise increase max JVM heap size (export JAVA_OPTS="-Xmx8g") or reduce RIOT-X memory usage by lowering threads, batch, and read-batch values.