Replay tasks and vault settings

A few scenarios exist that prevent the Replay from operating correctly.

Certain combinations of the following IBM Cloud® Object Storage vault settings prevent the Replay from running a full scan:
  • Vault versioning
  • Name index
  • Recover listing

Figure 1 shows settings for the first three items on the vault configuration page in the DsNet Manager user interface.

Figure 1. Settings for three items on the vault configuration page in the net Manager user interface
Settings for three items on the vault configuration page in the net Manager user interface
The scenarios that are invalid are reported at startup.
Remember: You must correct the scenarios before you can run the Replay.

If a scan does not complete successfully, make sure that you check the log file for errors and warnings. In some cases, you must modify the settings file as detailed in the errors and warning messages. The settings file is located at: /opt/ibm/metaocean/data/connections/cos/scan/scanner-settings.json

Table 1 shows the behavior for the Replay for different combinations of the four variables.

Table 1. Behaviors for Replay for four variables
ID Name index Recovery listing Versioned Cloud Object Storage Replay behavior
0 ✗ ✗ ✗ ❎ Stop start-up and report error in config file:

Error: Objects cannot be listed because Name Index and Recovery Index are both disabled. You might enable Recovery Listing on the vault or add this vault to the "exclude_vaults" list in the configuration file.

For example: 
"exclude-vaults": ["vault-name"]"
1 ✗ ✗ ✓ ❎ Stop start-up and report error in config file:

Error: Objects cannot be listed because Name Index and Recovery Index are both unavailable. You might enable Recovery Listing on the vault or add this vault to the "exclude_vaults" list in the configuration file.

For example: 
"exclude-vaults": ["vault-name"]"
2 ✗ ✓ ✗ ☑ Object Listing is run.
3 ✗ ✓ ✓ ☑ Object Listing runs. Only the most recent version of each object is listed. A warning is logged:

Warning: Versions cannot be listed as Name Index is unavailable. An object scan is run and only the most recent version of each object is listed. You must add override_warnings: true in the configuration file to ignore this warning.

Switching Name Index on does not enable scanning of a full version history. Objects created while Name Index is off is not present when it is enabled.
4 ✓ ✗ ✗ ☑ Object Listing is run.
5 ✓ ✗ ✓ ☑ Object Listing is run.
6 ✓ ✓ ✗ ☑ Object Listing is run.
7 ✓ ✓ ✓ ! Stop start-up and report warning:

This is a versioned vault but version scanning is not possible as Recovery Listing is enabled. You might either disable Recovery Listing on the vault to allow version scanning, or rerun the Replay with the argument override-warnings: true to allow object scanning.
Important: You might receive system errors about records not being scanned to the database if you scan a IBM Cloud Object Storage vault with Name Index disabled and Recovery Listing enabled. You cannot specify a prefix listing on a vault that has Recovery Listing enabled (you cannot specify a blank prefix either).