def test_count_plmns_more_defined(self) -> None:
"""
Tests the Cavium provisioning up to GetObjectParameters.
In particular tests when the eNB has more PLMNs than is
currently defined in our data model (NUM_PLMNS_IN_CONFIG)
"""
acs_state_machine = \
EnodebAcsStateMachineBuilder \
.build_acs_state_machine(EnodebDeviceName.CAVIUM)
# Send an Inform message
inform_msg = Tr069MessageBuilder.get_inform('000FB7', 'OC-LTE',
'120200002618AGP0003',
['1 BOOT'])
resp = acs_state_machine.handle_tr069_message(inform_msg)
self.assertTrue(isinstance(resp, models.InformResponse),
'Should respond with an InformResponse')
# Send an empty http request to kick off the rest of provisioning
req = models.DummyInput()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values: %s' % resp)
# Transient config response and request for parameter values
req = Tr069MessageBuilder.get_read_only_param_values_response()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values: %s' % resp)
# Send back regular parameters, and some absurd number of PLMNS
req = Tr069MessageBuilder.get_cavium_param_values_response(
num_plmns=100)
resp = acs_state_machine.handle_tr069_message(req)
# SM will be requesting object parameter values
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting object param vals')
# Send back some object parameters with an absurd number of PLMNs
req = Tr069MessageBuilder.get_cavium_object_param_values_response(
num_plmns=100)
resp = acs_state_machine.handle_tr069_message(req)
# In this scenario, the ACS and thus state machine will not need
# to delete or add objects to the eNB configuration.
# SM should then just be attempting to set parameter values
self.assertTrue(isinstance(resp, models.SetParameterValues),
'State machine should be setting param values')
# Number of PLMNs should reflect data model
num_plmns_cur = \
acs_state_machine \
.device_cfg.get_parameter(ParameterName.NUM_PLMNS)
self.assertEqual(num_plmns_cur, 6)
def test_missing_param_during_provisioning(self, _mock_func) -> None:
"""
Test the scenario where:
- enodebd is configuring the eNodeB
- eNB does not send all parameters due to bug
"""
acs_state_machine = \
EnodebAcsStateMachineBuilder \
.build_acs_state_machine(EnodebDeviceName.BAICELLS)
# Send an Inform message, wait for an InformResponse
inform_msg = Tr069MessageBuilder.get_inform()
resp = acs_state_machine.handle_tr069_message(inform_msg)
self.assertTrue(isinstance(resp, models.InformResponse),
'Should respond with an InformResponse')
# Send an empty http request to kick off the rest of provisioning
req = models.DummyInput()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for an optional parameter, three times
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for read-only params
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_read_only_param_values_response()
# Send back some typical values
# And then SM should request regular parameter values
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
# Send back typical values for the regular parameters
# Pretend that here the NumPLMNs was not sent because of a Baicells bug
req = Tr069MessageBuilder.\
get_regular_param_values_response(admin_state=False,
earfcndl=39150,
exclude_num_plmns=True)
resp = acs_state_machine.handle_tr069_message(req)
# The state machine will fail and go into an error state.
# It will send an empty http response to end the session.
# Regularly, the SM should be using info on the number
# of PLMNs to figure out which object parameter values
# to fetch.
self.assertTrue(isinstance(resp, models.DummyInput),
'State machine should be ending session')
def test_count_plmns_less(self) -> None:
"""
Tests the Cavium provisioning up to GetObjectParameters.
In particular tests when the eNB reports NUM_PLMNS less
than actually listed. The eNB says there are no PLMNs
defined when actually there are two.
Verifies that the number of PLMNs is correctly accounted.
"""
acs_state_machine = \
EnodebAcsStateMachineBuilder \
.build_acs_state_machine(EnodebDeviceName.CAVIUM)
# Send an Inform message
inform_msg = Tr069MessageBuilder.get_inform('000FB7',
'OC-LTE',
'120200002618AGP0003',
['1 BOOT'])
resp = acs_state_machine.handle_tr069_message(inform_msg)
self.assertTrue(isinstance(resp, models.InformResponse),
'Should respond with an InformResponse')
# Send an empty http request to kick off the rest of provisioning
req = models.DummyInput()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values: %s' % resp)
# Transient config response and request for parameter values
req = Tr069MessageBuilder.get_read_only_param_values_response()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values: %s' % resp)
# Send back typical values for the regular parameters
req = Tr069MessageBuilder.get_cavium_param_values_response(num_plmns=0)
resp = acs_state_machine.handle_tr069_message(req)
# SM will be requesting object parameter values
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting object param vals')
# Send back some object parameters with TWO plmns
req = Tr069MessageBuilder.get_cavium_object_param_values_response(
num_plmns=2)
resp = acs_state_machine.handle_tr069_message(req)
# In this scenario, the ACS and thus state machine will not need
# to delete or add objects to the eNB configuration.
# SM should then just be attempting to set parameter values
self.assertTrue(isinstance(resp, models.SetParameterValues),
'State machine should be setting param values')
# Number of PLMNs should reflect object count
num_plmns_cur = \
acs_state_machine \
.device_cfg.get_parameter(ParameterName.NUM_PLMNS)
self.assertEqual(num_plmns_cur, 2)
def test_reboot_after_invasive_changes(self) -> None:
"""
Test the scenario where:
- eNodeB has already been powered for 10 minutes without configuration
- Setting parameters which are 'invasive' on the eNodeB
- Simulate the scenario up until reboot, and test that enodebd does
not try to complete configuration after reboot, because it is
waiting for REM process to finish running
- This test does not wait the ten minutes to simulate REM process
finishing on the Baicells eNodeB
'Invasive' parameters are those which require special behavior to apply
the changes for the eNodeB.
In the case of the Baicells eNodeB, properly applying changes to
invasive parameters requires rebooting the device.
"""
acs_state_machine = \
EnodebAcsStateMachineBuilder\
.build_acs_state_machine(EnodebDeviceName.BAICELLS_OLD)
# Send an Inform message, wait for an InformResponse
inform_msg = \
Tr069MessageBuilder.get_inform('48BF74',
'BaiStation_V100R001C00B110SPC002',
'120200002618AGP0003',
['2 PERIODIC'])
resp = acs_state_machine.handle_tr069_message(inform_msg)
self.assertTrue(isinstance(resp, models.InformResponse),
'Should respond with an InformResponse')
# Send an empty http request to kick off the rest of provisioning
req = models.DummyInput()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for an optional parameter, five times
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for read-only params
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_read_only_param_values_response()
# Send back some typical values
# And then SM should request regular parameter values
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
# Send back typical values for the regular parameters
req = Tr069MessageBuilder.get_regular_param_values_response()
resp = acs_state_machine.handle_tr069_message(req)
# SM will be requesting object parameter values
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting object param vals')
# Send back some typical values for object parameters
req = Tr069MessageBuilder.get_object_param_values_response()
resp = acs_state_machine.handle_tr069_message(req)
# In this scenario, the ACS and thus state machine will not need
# to delete or add objects to the eNB configuration.
# SM should then just be attempting to set parameter values
self.assertTrue(isinstance(resp, models.SetParameterValues),
'State machine should be setting param values')
# Send back confirmation that the parameters were successfully set
req = models.SetParameterValuesResponse()
req.Status = 0
resp = acs_state_machine.handle_tr069_message(req)
# Since invasive parameters have been set, then to apply the changes
# to the Baicells eNodeB, we need to reboot the device
self.assertTrue(isinstance(resp, models.Reboot))
req = Tr069MessageBuilder.get_reboot_response()
resp = acs_state_machine.handle_tr069_message(req)
# After the reboot has been received, enodebd should end the
# provisioning session
self.assertTrue(
isinstance(resp, models.DummyInput),
'After sending command to reboot the Baicells eNodeB, '
'enodeb should end the TR-069 session.')
# At this point, sometime after the eNodeB reboots, we expect it to
# send an Inform indicating reboot. Since it should be in REM process,
# we hold off on finishing configuration, and end TR-069 sessions.
req = \
Tr069MessageBuilder.get_inform('48BF74',
'BaiStation_V100R001C00B110SPC002',
'120200002618AGP0003',
['1 BOOT', 'M Reboot'])
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(
isinstance(resp, models.DummyInput),
'After receiving a post-reboot Inform, enodebd '
'should end TR-069 sessions for 10 minutes to wait '
'for REM process to finish.')
# Pretend that we have waited, and now we are in normal operation again
acs_state_machine.transition('wait_inform_post_reboot')
req = \
Tr069MessageBuilder.get_inform('48BF74',
'BaiStation_V100R001C00B110SPC002',
'120200002618AGP0003',
['2 PERIODIC'])
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(
isinstance(resp, models.InformResponse),
'After receiving a post-reboot Inform, enodebd '
'should end TR-069 sessions for 10 minutes to wait '
'for REM process to finish.')
req = models.DummyInput()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'enodebd should be requesting params')
self.assertTrue(
len(resp.ParameterNames.string) > 1,
'Should be requesting transient params.')
def test_provision_without_invasive_changes(self) -> None:
"""
Test the scenario where:
- eNodeB has already been powered for 10 minutes without configuration
- Setting parameters which are 'non-invasive' on the eNodeB
'Invasive' parameters are those which require special behavior to apply
the changes for the eNodeB.
"""
acs_state_machine = \
EnodebAcsStateMachineBuilder \
.build_acs_state_machine(EnodebDeviceName.BAICELLS_OLD)
# Send an Inform message, wait for an InformResponse
inform_msg = \
Tr069MessageBuilder.get_inform('48BF74',
'BaiStation_V100R001C00B110SPC001',
'120200002618AGP0003',
['2 PERIODIC'])
resp = acs_state_machine.handle_tr069_message(inform_msg)
self.assertTrue(isinstance(resp, models.InformResponse),
'Should respond with an InformResponse')
# Send an empty http request to kick off the rest of provisioning
req = models.DummyInput()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for an optional parameter, five times
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for read-only params
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_read_only_param_values_response()
# Send back some typical values
# And then SM should request regular parameter values
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
# Send back typical values for the regular parameters
req = Tr069MessageBuilder.\
get_regular_param_values_response(admin_state=False,
earfcndl=39150)
resp = acs_state_machine.handle_tr069_message(req)
# SM will be requesting object parameter values
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting object param vals')
# Send back some typical values for object parameters
req = Tr069MessageBuilder.get_object_param_values_response()
resp = acs_state_machine.handle_tr069_message(req)
# In this scenario, the ACS and thus state machine will not need
# to delete or add objects to the eNB configuration.
# SM should then just be attempting to set parameter values
self.assertTrue(isinstance(resp, models.SetParameterValues),
'State machine should be setting param values')
# Send back confirmation that the parameters were successfully set
req = models.SetParameterValuesResponse()
req.Status = 0
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for read-only params
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
req = Tr069MessageBuilder.get_read_only_param_values_response()
# Send back some typical values
# And then SM should continue polling the read-only params
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(isinstance(resp, models.DummyInput),
'State machine should be ending session')
# If a different eNB is suddenly plugged in, or the same eNB sends a
# new Inform, enodebd should be able to handle it.
# Send an Inform message, wait for an InformResponse
inform_msg = \
Tr069MessageBuilder.get_inform('48BF74',
'BaiStation_V100R001C00B110SPC002',
'120200002618AGP0003',
['2 PERIODIC'])
resp = acs_state_machine.handle_tr069_message(inform_msg)
self.assertTrue(isinstance(resp, models.InformResponse),
'Should respond with an InformResponse')
# Send an empty http request to kick off the rest of provisioning
req = models.DummyInput()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for an optional parameter, three times
self.assertTrue(isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values')
def test_fault_after_set_parameters(self) -> None:
acs_state_machine = \
EnodebAcsStateMachineBuilder \
.build_acs_state_machine(EnodebDeviceName.BAICELLS)
# Send an Inform message, wait for an InformResponse
inform_msg = Tr069MessageBuilder.get_inform(
'48BF74',
'BaiBS_RTS_3.1.6',
'120200002618AGP0003',
['2 PERIODIC'],
)
resp = acs_state_machine.handle_tr069_message(inform_msg)
self.assertTrue(
isinstance(resp, models.InformResponse),
'Should respond with an InformResponse',
)
# Send an empty http request to kick off the rest of provisioning
req = models.DummyInput()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for an optional parameter, three times
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values',
)
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values',
)
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values',
)
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for read-only params
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values',
)
req = Tr069MessageBuilder.get_read_only_param_values_response()
# Send back some typical values
# And then SM should request regular parameter values
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values',
)
# Send back typical values for the regular parameters
req = Tr069MessageBuilder.get_regular_param_values_response()
resp = acs_state_machine.handle_tr069_message(req)
# SM will be requesting object parameter values
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting object param vals',
)
# Send back some typical values for object parameters
req = Tr069MessageBuilder.get_object_param_values_response()
resp = acs_state_machine.handle_tr069_message(req)
# In this scenario, the ACS and thus state machine will not need
# to delete or add objects to the eNB configuration.
# SM should then just be attempting to set parameter values
self.assertTrue(
isinstance(resp, models.SetParameterValues),
'State machine should be setting param values',
)
req = models.Fault()
req.FaultCode = 12345
req.FaultString = 'Test FaultString'
acs_state_machine.handle_tr069_message(req)
self.assertTrue(
'Error' in acs_state_machine.get_state(),
'Should be in error state',
)
def test_provision_multi_without_invasive_changes(self) -> None:
"""
Test the scenario where:
- eNodeB has already been powered for 10 minutes without configuration
- Setting parameters which are 'non-invasive' on the eNodeB
- Using enodebd mconfig which has old style config with addition
of eNodeB config tied to a serial number
'Invasive' parameters are those which require special behavior to apply
the changes for the eNodeB.
"""
acs_state_machine = \
EnodebAcsStateMachineBuilder \
.build_multi_enb_acs_state_machine(EnodebDeviceName.BAICELLS)
# Send an Inform message, wait for an InformResponse
inform_msg = Tr069MessageBuilder.get_inform()
resp = acs_state_machine.handle_tr069_message(inform_msg)
self.assertTrue(
isinstance(resp, models.InformResponse),
'Should respond with an InformResponse',
)
# Send an empty http request to kick off the rest of provisioning
req = models.DummyInput()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for an optional parameter, three times
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values',
)
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values',
)
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values',
)
req = Tr069MessageBuilder.get_fault()
resp = acs_state_machine.handle_tr069_message(req)
# Expect a request for read-only params
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values',
)
req = Tr069MessageBuilder.get_read_only_param_values_response()
# Send back some typical values
# And then SM should request regular parameter values
resp = acs_state_machine.handle_tr069_message(req)
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting param values',
)
# Send back typical values for the regular parameters
req = Tr069MessageBuilder.\
get_regular_param_values_response(
admin_state=False,
earfcndl=39150,
)
resp = acs_state_machine.handle_tr069_message(req)
# SM will be requesting object parameter values
self.assertTrue(
isinstance(resp, models.GetParameterValues),
'State machine should be requesting object param vals',
)
# Send back some typical values for object parameters
req = Tr069MessageBuilder.get_object_param_values_response()
resp = acs_state_machine.handle_tr069_message(req)
# In this scenario, the ACS and thus state machine will not need
# to delete or add objects to the eNB configuration.
# SM should then just be attempting to set parameter values
self.assertTrue(
isinstance(resp, models.SetParameterValues),
'State machine should be setting param values',
)
isEnablingAdminState = False
param = 'Device.Services.FAPService.1.FAPControl.LTE.AdminState'
for name_value in resp.ParameterList.ParameterValueStruct:
if name_value.Name == param:
isEnablingAdminState = True
self.assertTrue(
isEnablingAdminState,
'eNB config is set to enable transmit, '
'while old enodebd config does not '
'enable transmit. Use eNB config.',
)
