xApp handover simple_rc_ho_xapp.py is not functionning

[Etincelle0608]

Hi everyone
I need your suggestions, I am trying to test oran-sc RIC handover using two X300
I am using the latest version of srsRAN_Project and oran-sc-ric
I have reading all discussions of this project about handover and mostly this one : 1256
This is my scenario which I have deploy in the same machine

This is my files

• cu.yml

gnb_id: 411                                                     #Optional UINT (411). Sets the numerical ID associated with the gNB.
gnb_id_bit_length: 32
ran_node_name: cu_cp_01


cu_cp:
  max_nof_dus: 4                      # Le CU-CP acceptera jusqu'à 2 DUs
  max_nof_cu_ups: 4                   # Le CU-CP acceptera jusqu'à 2 CU-UPs
  amf:
    addr: 10.53.1.2
    port: 38412                                            # The address or hostname of the AMF.
    bind_addr: 10.53.1.1                                        # A local IP that the gNB binds to for traffic from the AMF.
    supported_tracking_areas:                                   # Configure the TA associated with the CU-CP
      - tac: 7                        
        plmn_list:
          - plmn: "00101"
            tai_slice_support_list:
              - sst: 1
  inactivity_timer: 7200        

  f1ap:
    bind_addr: 127.0.10.1

  mobility:
    trigger_handover_from_measurements: true                    # Set the CU-CP to trigger handover when neighbor cell measurements arrive
    cells:                                                      # List of cells available for handover known to the cu-cp
      - 
        nr_cell_id: 0x2130                                        # Cell ID for cell 1
        periodic_report_cfg_id: 1                                 # Set the periodic report configuration ID for this cell
        gnb_id_bit_length: 32
        pci: 7
        band: 78
        ssb_arfcn: 632628
        ssb_scs: 30
        ssb_period: 20
        ssb_offset: 0
        ssb_duration: 5
        ncells:                                                   # Neighbor cell(s) available for handover
          - 
            nr_cell_id: 0x2131                                      # Cell ID of neighbor cell available for handover
            report_configs: [ 2 ]                                   # Report configurations to configure for this neighbor cell
      - 
        nr_cell_id: 0x2131                                        # Cell ID for cell 2
        periodic_report_cfg_id: 1                                 # Set the periodic report configuration ID for this cell
        gnb_id_bit_length: 32
        pci: 8
        band: 78
        ssb_arfcn: 632628
        ssb_scs: 30
        ssb_period: 20
        ssb_offset: 0
        ssb_duration: 5
        ncells:                                                   # Neighbor cell(s) available for handover
          - 
            nr_cell_id: 0x2130                                      # Cell ID of neighbor cell available for handover
            report_configs: [ 2 ]                                   # Report configurations to configure for this neighbor cell
    report_configs:                           
      - 
        report_cfg_id: 1                      
        report_type: periodical               
        report_interval_ms: 480                 
      - 
        report_cfg_id: 2                        
        report_type: event_triggered            
        event_triggered_report_type: a3                           # Sets the event triggered report type as A3
        meas_trigger_quantity: rsrp                               # Sets the measurement trigger quantity as rsrp
        meas_trigger_quantity_offset_db: 6                         # Sets the measurement trigger quantity offset to 3dB
        hysteresis_db: 3                                          # Sets the hysteresis to 0dB
        time_to_trigger_ms: 320                                   # Sets the time to trigger to 100ms
        
cu_up:
  f1u:
    socket:                               # Define UDP/IP socket(s) for F1-U interface.
      -                                     # Socket 1
        bind_addr: 127.0.10.1                  # Sets the address that the F1-U socket will bind to.
        udp:
          max_rx_msgs: 256 
e2:
  enable_cu_cp_e2: true                # Optional BOOLEAN (false). Enables the CU-CP E2 agent. Supported: [false, true]. 
  enable_cu_up_e2: true                # Optional BOOLEAN (false). Enables the CU-UP E2 agent. Supported: [false, true]. 
  e2sm_kpm_enabled: true            # Enable KPM service module
  e2sm_rc_enabled: true             # Enable RC service module
  addr: 10.0.2.10                   # RIC IP address
  bind_addr: 10.0.2.1               # A local IP that the E2 agent binds to for traffic from the RIC. ONLY required if running the RIC on a separate machine. 
  port: 36421                       # RIC port

log:
  filename: /tmp/cu.log                                          # Path of the log file.
  all_level: debug                                                 # Logging level applied to all layers. 

metrics: 
  addr: 127.0.0.1                       # Optional TEXT:IPV4 (127.0.0.1). Sets the metrics address. Supported: IPV4 address.
  port: 55555                           # Optional UINT. Sets the metrics UPD port. Supported: [0 - 65535].
  enable_json: true                    # Optional BOOLEAN (false). Enable JSON metrics reporting
  enable_log: true                     # Optional BOOLEAN (false). Enable log metrics reporting
  enable_verbose: true                 # Optional BOOLEAN (false). Enable extended detail metrics reporting
  layers:
    enable_app_usage: true               # Optional BOOLEAN (false). Enable application usage metrics
    enable_e1ap: true                    # Optional BOOLEAN (false). Enable E1AP metrics
    enable_pdcp: true                    # Optional BOOLEAN (false). Enable PDCP metrics
    enable_cu_up_executor: true          # Optional BOOLEAN (false). Whether to log CU-UP executor metrics

• du1.yml

gnb_id: 411                                                     #Optional UINT (411). Sets the numerical ID associated with the gNB.
gnb_id_bit_length: 32
gnb_du_id: 0
  
f1ap:
  cu_cp_addr: 127.0.10.1                    # The address of CU-CP
  bind_addr: 127.0.10.2             

f1u:
  socket:
    -
      bind_addr: 127.0.10.2 

ru_sdr:
  device_driver: uhd                                            # The RF driver name.
  device_args: type=x300,addr=192.168.40.2,master_clock_rate=184320000,clock_source=external,time_source=external,num_recv_frames=64,num_send_frames=64  # Optionally pass arguments to the selected RF driver
  srate: 30.72                                                  # RF sample rate might need to be adjusted according to selected bandwidth..
  tx_gain: 12                                                  # Transmit gain of the RF might need to adjusted to the given situation.
  rx_gain: 10                                                 # Receive gain of the RF might need to adjusted to the given situation.
  sync: external
  clock: external

cell_cfg:
  dl_arfcn: 632628                                                # ARFCN of the downlink carrier (center frequency).
  #dl_arfcn: 640010
  band: 78                                                        # The NR band.
  channel_bandwidth_MHz: 20                                       # Bandwith in MHz. Number of PRBs will be automatically derived.
  common_scs: 30                                                  # Subcarrier spacing in kHz used for data.
  plmn: "00101"                                                   # PLMN broadcasted by the gNB.
  tac: 7                                                          # Tracking area code (needs to match the core configuration).
  pci: 7
  sector_id: 0                                                           #Physical cell ID.
  nof_antennas_dl: 1
  nof_antennas_ul: 1
  prach:
    prach_root_sequence_index: 0        # Set the PRACH root sequence index
  pusch: 
    p0_nominal_with_grant: -76              # Optional INT (-76). Sets the P0 value for PUSCH grant (except MSG3), in dBm. Supported: multiples of 2 within the range [-202, 24].
    max_ue_mcs: 28            #Sets a maximum PUSCH MCS value to be used for all UEs. Supported [0 - 28].
    min_k2: 4
  pdsch:
    mcs_table: qam256       # Sets the MCS table to use for PDSCH. Supported [qam64, qam256]
    max_ue_mcs: 28            #Sets a maximum PDSCH MCS value to be used for all UEs. Supported [0 - 28].
  ssb:
    ssb_block_power_dbm: 0   # Optional INT (-16). Sets the SS PBCH block power in dBm. Supported: [-60 - +50].
    # ssb_block_power_dbm: 0 when ALC on PA is set to 10, P0 = -84
    ssb_period: 20       # Optional UINT (10). Sets the period of SSB scheduling in milliseconds. Supported: [5, 10, 20]
  tdd_ul_dl_cfg: 
    dl_ul_tx_period: 10                     # Optional INT (10). Sets the TDD pattern periodicity in slots. The combination of this value and the chosen numerology must lead to a TDD periodicity of 0.5, 0.625, 1, 1.25, 2, 2.5, 3, 4, 5 or 10 milliseconds. Supported: [2 - 80].
    nof_dl_slots: 6                         # Optional INT (6). Number of consecutive full Downlink slots. Supported: [0-80].
    nof_dl_symbols: 8                      # Optional INT (8). Number of Downlink symbols at the beginning of the slot following full Downlink slots. Supported: [0-13].
    nof_ul_slots: 3                         # Optional INT (3). Number of consecutive full Uplink slots. Supported: [0 - 80].
    nof_ul_symbols: 0                       # Optional INT (0). Number of Uplink symbols at the end of the slot preceding the first full Uplink slot. Supported: [0-13].
    #pattern2: 

e2:
  enable_du_e2: true                # Enable DU E2 agent (one for each DU instance)
  e2sm_kpm_enabled: true            # Enable KPM service module
  e2sm_rc_enabled: true             # Enable RC service module
  addr: 10.0.2.10                   # RIC IP address
  bind_addr: 10.0.2.1               # A local IP that the E2 agent binds to for traffic from the RIC. ONLY required if running the RIC on a separate machine. 
  port: 36421
    
metrics:
  enable_json: true       # Enable reporting metrics in JSON format
  addr: 127.0.0.1        # Metrics-server IP
  port: 55555             # Metrics-server Port
  layers:
    enable_app_usage: true      # Enable application usage metrics
    enable_sched: true          # Enable DU scheduler metrics
    enable_rlc: true            # Enable RLC metrics
    enable_mac: true            # Enable MAC metrics
    enable_executor: true       # Enable DU-high executor metrics
    enable_du_low: true         # Enable DU low metrics (upper physical layer)
    enable_ru: true             # Enable Radio Unit metrics
  periodicity: 
    app_usage_report_period: 1000         # Optional UINT (1000). Application resource usage metrics report period in milliseconds
    du_report_period: 1000                # Optional UINT:INT (1000). DU statistics report period in milliseconds. Format: [0 - 10485760].

log:
  filename: /tmp/du1.log                                          # Path of the log file.
  all_level: debug                                                 # Logging level applied to all layers. 

• du2.yml

gnb_id: 411                                                     #Optional UINT (411). Sets the numerical ID associated with the gNB.
gnb_id_bit_length: 32
gnb_du_id: 1
 
f1ap:
  cu_cp_addr: 127.0.10.1                   # The address of CU-CP
  bind_addr: 127.0.10.3             

f1u:
  socket:
    -
      bind_addr: 127.0.10.3

ru_sdr:
  device_driver: uhd                                            # The RF driver name.
  device_args: type=x300,addr=192.168.140.2,master_clock_rate=184320000,num_recv_frames=64,num_send_frames=64  # Optionally pass arguments to the selected RF driver
  srate: 30.72                                                  # RF sample rate might need to be adjusted according to selected bandwidth..
  tx_gain: 12                                                  # Transmit gain of the RF might need to adjusted to the given situation.
  rx_gain: 10                                                 # Receive gain of the RF might need to adjusted to the given situation.
  sync: external
  clock: external
  lo_offset: 45
  time_alignment_calibration: 0
  
cell_cfg:
  dl_arfcn: 632628                                                # ARFCN of the downlink carrier (center frequency).
  #dl_arfcn: 640010
  band: 78                                                        # The NR band.
  channel_bandwidth_MHz: 20                                       # Bandwith in MHz. Number of PRBs will be automatically derived.
  common_scs: 30                                                  # Subcarrier spacing in kHz used for data.
  plmn: "00101"                                                   # PLMN broadcasted by the gNB.
  tac: 7                                                          # Tracking area code (needs to match the core configuration).
  pci: 8
  sector_id: 1                                                           #Physical cell ID.
  nof_antennas_dl: 1
  nof_antennas_ul: 1
  pdsch:
    mcs_table: qam256  
  prach:
    prach_root_sequence_index: 64        # Set the PRACH root sequence index
  pusch: 
    p0_nominal_with_grant: -76              # Optional INT (-76). Sets the P0 value for PUSCH grant (except MSG3), in dBm. Supported: multiples of 2 within the range [-202, 24].
    max_ue_mcs: 28            #Sets a maximum PUSCH MCS value to be used for all UEs. Supported [0 - 28].
    min_k2: 4
  pdsch:
    mcs_table: qam256       # Sets the MCS table to use for PDSCH. Supported [qam64, qam256]
    max_ue_mcs: 28            #Sets a maximum PDSCH MCS value to be used for all UEs. Supported [0 - 28].
  ssb:
    ssb_block_power_dbm: -16   # Optional INT (-16). Sets the SS PBCH block power in dBm. Supported: [-60 - +50].
    # ssb_block_power_dbm: 0 when ALC on PA is set to 10, P0 = -84
    ssb_period: 20       # Optional UINT (10). Sets the period of SSB scheduling in milliseconds. Supported: [5, 10, 20]
  tdd_ul_dl_cfg: 
    dl_ul_tx_period: 10                     # Optional INT (10). Sets the TDD pattern periodicity in slots. The combination of this value and the chosen numerology must lead to a TDD periodicity of 0.5, 0.625, 1, 1.25, 2, 2.5, 3, 4, 5 or 10 milliseconds. Supported: [2 - 80].
    nof_dl_slots: 6                         # Optional INT (6). Number of consecutive full Downlink slots. Supported: [0-80].
    nof_dl_symbols: 8                      # Optional INT (8). Number of Downlink symbols at the beginning of the slot following full Downlink slots. Supported: [0-13].
    nof_ul_slots: 3                         # Optional INT (3). Number of consecutive full Uplink slots. Supported: [0 - 80].
    nof_ul_symbols: 0                       # Optional INT (0). Number of Uplink symbols at the end of the slot preceding the first full Uplink slot. Supported: [0-13].
    #pattern2: 

e2:
  enable_du_e2: true                # Enable DU E2 agent (one for each DU instance)
  e2sm_kpm_enabled: true            # Enable KPM service module
  e2sm_rc_enabled: true             # Enable RC service module
  addr: 10.0.2.10                   # RIC IP address
  bind_addr: 10.0.2.1               # A local IP that the E2 agent binds to for traffic from the RIC. ONLY required if running the RIC on a separate machine. 
  port: 36421                       # RIC port
    
metrics:
  enable_json: true       # Enable reporting metrics in JSON format
  addr: 127.0.0.1        # Metrics-server IP
  port: 55555             # Metrics-server Port
  layers:
    enable_app_usage: true      # Enable application usage metrics
    enable_sched: true          # Enable DU scheduler metrics
    enable_rlc: true            # Enable RLC metrics
    enable_mac: true            # Enable MAC metrics
    enable_executor: true       # Enable DU-high executor metrics
    enable_du_low: true         # Enable DU low metrics (upper physical layer)
    enable_ru: true             # Enable Radio Unit metrics
  periodicity: 
    app_usage_report_period: 1000         # Optional UINT (1000). Application resource usage metrics report period in milliseconds
    du_report_period: 1000                # Optional UINT:INT (1000). DU statistics report period in milliseconds. Format: [0 - 10485760].

log:
  filename: /tmp/du2.log                                          # Path of the log file.
  all_level: debug                                                 # Logging level applied to all layers. 

I verified that the handover can be done using ho command in CU.

When RIC is up I got the following

ric_submgr     | 1759717153185 1/RMR [INFO] ric message routing library on SI95 p=4560 mv=3 flg=00 id=a (f447e29 4.9.4 built: Dec 13 2023)
ric_submgr     | 2025/10/06 02:19:13 Serving xapp framework at http://[::]:8088
ric_rtmgr_sim  | 2025/10/06 02:19:14 POST /ric/v1/handles/e2t  body: {"E2TAddress":"10.0.2.10:38000"} elapsed: 14.209µs
ric_submgr     | RMR is ready now ...

and CU is up the RIC output is :

ric_rtmgr_sim  | 2025/10/06 02:19:22 POST /ric/v1/handles/associate-ran-to-e2t  body: [{"E2TAddress":"10.0.2.10:38000","ranNamelist":["gnb_001_001_0000019b"]}] elapsed: 36.618µs
ric_rtmgr_sim  | 2025/10/06 02:19:22 POST /ric/v1/handles/associate-ran-to-e2t  body: [{"E2TAddress":"10.0.2.10:38000","ranNamelist":["gnbc_001_001_0000019b_0"]}] elapsed: 7.991µs

when both DUs are up

• DU1

ric_rtmgr_sim  | 2025/10/06 02:19:43 POST /ric/v1/handles/associate-ran-to-e2t  body: [{"E2TAddress":"10.0.2.10:38000","ranNamelist":["gnbd_001_001_0000019b_0"]}] elapsed: 48.451µs

• DU2

ric_rtmgr_sim  | 2025/10/06 02:20:01 POST /ric/v1/handles/associate-ran-to-e2t  body: [{"E2TAddress":"10.0.2.10:38000","ranNamelist":["gnbd_001_001_0000019b_1"]}] elapsed: 11.439µs

Then I try handover xApp simple_rc_ho_xapp.py with this command :
test 1

sudo docker compose exec python_xapp_runner ./simple_rc_ho_xapp.py --e2_node_id gnb_001_001_00019b  --plmn 00101 --amf_ue_ngap_id 6 --target_nr_cell_id 0x2130

1759717390746 20/RMR [INFO] ric message routing library on SI95 p=4560 mv=3 flg=00 id=a (f447e29 4.9.4 built: Dec 13 2023)
02:23:11 Sending HO command to E2 node ID: gnb_001_001_00019b, PLMN: 00101, AMF UE NGAP ID: 6, UE F1AP ID: 1, Target NR Cell ID: 8496

There are problems :
the e2_node_id is different
what is the best number to use with amf_ue_ngap_id ?
when I go to the oran-sc-ric to see the details, this is the errors :

ric_e2term     | {"ts":1759717391860,"crit":"ERROR","id":"E2Terminator","mdc":{"PID":"140267088754432","POD_NAME":"e2term_pod","CONTAINER_NAME":"ric_e2term","SERVICE_NAME":"ric_e2term_service","HOST_NAME":"ric_e2term_host","SYSTEM_NAME":"oran_sc_ric"},"msg":"Failed to send message no CU entry gnb_001_001_00019b"}
ric_e2term     | {"ts":1759717391860,"crit":"ERROR","id":"E2Terminator","mdc":{"PID":"140267088754432","POD_NAME":"e2term_pod","CONTAINER_NAME":"ric_e2term","SERVICE_NAME":"ric_e2term_service","HOST_NAME":"ric_e2term_host","SYSTEM_NAME":"oran_sc_ric"},"msg":"Error handling Xapp message"}

test 2

sudo docker compose exec python_xapp_runner ./simple_rc_ho_xapp.py --e2_node_id gnb_001_001_0000019b  --plmn 00101 --amf_ue_ngap_id 6 --target_nr_cell_id 0x2130

1759717355795 7/RMR [INFO] ric message routing library on SI95 p=4560 mv=3 flg=00 id=a (f447e29 4.9.4 built: Dec 13 2023)
02:22:36 Sending HO command to E2 node ID: gnb_001_001_0000019b, PLMN: 00101, AMF UE NGAP ID: 6, UE F1AP ID: 1, Target NR Cell ID: 8496
Received RIC_CONTROL_FAILURE

How can I fixed these errors?
Is anyone that have done this experience, and the xApp is functionning very well ?

[fllay]

you may need to check AMF UE NGAP ID in cu.log so that you can use the correct one in --amf_ue_ngap_id