Error - F_JR090A Redshift Location Requires Staging Directory

Documentation: Error - F_JR090A Redshift Location Requires Staging Directory

Error: F_JR090A: Redshift Location Requires Staging Directory

Issue

While converting an DSS 5 configuration to DSS 6 using dssconvert5to6activate -f dss5.xml, the process fails with the following error:

F_JR090A: Location '<location name>' with class 'redshift' requires defined action LocationProperties /StagingDirectory

This occurs when actions in the DSS 5 configuration are defined on channel * (all channels).

Environment

  • DSS 5
  • Conversion to DSS 6 using dssconvert5to6
  • Command: dss dssconvert5to6activate /path/to/dss6/dss_home_script/dssconvert5to6 -f dss5.xml

Resolution

To resolve this issue, choose one of the following methods:

Method 1: Modify DSS 5 actions (recommended)

  1. Modify the DSS 5 configuration to assign actions to specific channels instead of the * wildcard.
  2. Export the updated configuration to a new XML file.
  3. Run the conversion command using the new XML file:
    dssconvert5to6 -f dss5.xml
    

Method 2: Specify channel during conversion

Run the following command, specifying the channel directly:

dssconvert5to6 -c <channel_name> <dss5_hub_name> <json_file>
  • Replace <channel_name> with the name of the channel you want to convert.
  • Replace <dss5_hub_name> with the name of the DSS 5 hub. For more information on formatting the hub name, see our Calling DSS on the Command Line documentation.
  • Replace <json_file> with the conversion's output location.

Cause

This issue occurs when actions are configured in DSS 5 on the wildcard channel* instead of on a specific channel. When this happens, those actions are not correctly included in the exported dss5.xml file during conversion. For Redshift locations, this issue may result in the /StagingDirectory property not being defined in LocationProperties.