Error: F_JR090A: Redshift Location Requires Staging Directory
Issue
While converting an HVR 5 configuration to HVR 6 using hvrconvert5to6activate -f hvr5.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 HVR 5 configuration are defined on channel *
(all channels).
Environment
- HVR 5
- Conversion to HVR 6 using
hvrconvert5to6
- Command:
hvr hvrconvert5to6activate /path/to/hvr6/hvr_home_script/hvrconvert5to6 -f hvr5.xml
Resolution
To resolve this issue, choose one of the following methods:
Method 1: Modify HVR 5 actions (recommended)
- Modify the HVR 5 configuration to assign actions to specific channels instead of the
*
wildcard. - Export the updated configuration to a new XML file.
- Run the conversion command using the new XML file:
hvrconvert5to6 -f hvr5.xml
Method 2: Specify channel during conversion
Run the following command, specifying the channel directly:
hvrconvert5to6 -c <channel_name> <hvr5_hub_name> <json_file>
- Replace
<channel_name>
with the name of the channel you want to convert. - Replace
<hvr5_hub_name>
with the name of the HVR 5 hub. For more information on formatting the hub name, see our Calling HVR on the Command Line documentation. - Replace
<json_file>
with the conversion's output location.
Cause
This issue occurs when actions are configured in HVR 5 on the wildcard channel*
instead of on a specific channel. When this happens, those actions are not correctly included in the exported hvr5.xml
file during conversion. For Redshift locations, this issue may result in the /StagingDirectory
property not being defined in LocationProperties
.