Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 1 | # osmo_gsm_tester: specifics for running an SRS EPC process |
| 2 | # |
| 3 | # Copyright (C) 2020 by sysmocom - s.f.m.c. GmbH |
| 4 | # |
| 5 | # Author: Pau Espin Pedrol <pespin@sysmocom.de> |
| 6 | # |
| 7 | # This program is free software: you can redistribute it and/or modify |
| 8 | # it under the terms of the GNU General Public License as |
| 9 | # published by the Free Software Foundation, either version 3 of the |
| 10 | # License, or (at your option) any later version. |
| 11 | # |
| 12 | # This program is distributed in the hope that it will be useful, |
| 13 | # but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 14 | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 15 | # GNU General Public License for more details. |
| 16 | # |
| 17 | # You should have received a copy of the GNU General Public License |
| 18 | # along with this program. If not, see <http://www.gnu.org/licenses/>. |
| 19 | |
| 20 | import os |
| 21 | import pprint |
| 22 | |
Pau Espin Pedrol | e1a58bd | 2020-04-10 20:46:07 +0200 | [diff] [blame] | 23 | from ..core import log, util, config, template, process, remote |
Pau Espin Pedrol | ea8c3d4 | 2020-05-04 12:05:05 +0200 | [diff] [blame] | 24 | from ..core import schema |
Pau Espin Pedrol | da2e31f | 2020-03-31 13:45:01 +0200 | [diff] [blame] | 25 | from . import epc |
Andre Puschmann | 99fb78b | 2020-09-14 18:14:15 +0200 | [diff] [blame] | 26 | from .srslte_common import srslte_common |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 27 | |
Pau Espin Pedrol | ea8c3d4 | 2020-05-04 12:05:05 +0200 | [diff] [blame] | 28 | def on_register_schemas(): |
| 29 | config_schema = { |
| 30 | 'enable_pcap': schema.BOOL_STR, |
Andre Puschmann | 82ced3f | 2020-06-18 14:52:39 +0200 | [diff] [blame] | 31 | 'log_all_level': schema.STR, |
Pau Espin Pedrol | ea8c3d4 | 2020-05-04 12:05:05 +0200 | [diff] [blame] | 32 | } |
| 33 | schema.register_config_schema('epc', config_schema) |
| 34 | |
Andre Puschmann | 99fb78b | 2020-09-14 18:14:15 +0200 | [diff] [blame] | 35 | class srsEPC(epc.EPC, srslte_common): |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 36 | |
| 37 | REMOTE_DIR = '/osmo-gsm-tester-srsepc' |
| 38 | BINFILE = 'srsepc' |
| 39 | CFGFILE = 'srsepc.conf' |
| 40 | DBFILE = 'srsepc_user_db.csv' |
| 41 | PCAPFILE = 'srsepc.pcap' |
| 42 | LOGFILE = 'srsepc.log' |
| 43 | |
Pau Espin Pedrol | a442cb8 | 2020-05-05 12:54:37 +0200 | [diff] [blame] | 44 | def __init__(self, testenv, run_node): |
| 45 | super().__init__(testenv, run_node, 'srsepc') |
Andre Puschmann | 99fb78b | 2020-09-14 18:14:15 +0200 | [diff] [blame] | 46 | srslte_common.__init__(self) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 47 | self.run_dir = None |
| 48 | self.config_file = None |
| 49 | self.db_file = None |
| 50 | self.log_file = None |
| 51 | self.pcap_file = None |
| 52 | self.process = None |
| 53 | self.rem_host = None |
Pau Espin Pedrol | 3373703 | 2020-04-16 13:55:57 +0200 | [diff] [blame] | 54 | self.remote_inst = None |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 55 | self.remote_config_file = None |
| 56 | self.remote_db_file = None |
| 57 | self.remote_log_file = None |
| 58 | self.remote_pcap_file = None |
Pau Espin Pedrol | 1e81b5a | 2020-03-16 12:42:17 +0100 | [diff] [blame] | 59 | self.enable_pcap = False |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 60 | self.subscriber_list = [] |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 61 | |
| 62 | def cleanup(self): |
| 63 | if self.process is None: |
| 64 | return |
| 65 | if self._run_node.is_local(): |
| 66 | return |
| 67 | # copy back files (may not exist, for instance if there was an early error of process): |
| 68 | try: |
| 69 | self.rem_host.scpfrom('scp-back-log', self.remote_log_file, self.log_file) |
| 70 | except Exception as e: |
| 71 | self.log(repr(e)) |
Pau Espin Pedrol | 1e81b5a | 2020-03-16 12:42:17 +0100 | [diff] [blame] | 72 | if self.enable_pcap: |
| 73 | try: |
| 74 | self.rem_host.scpfrom('scp-back-pcap', self.remote_pcap_file, self.pcap_file) |
| 75 | except Exception as e: |
| 76 | self.log(repr(e)) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 77 | |
| 78 | def start(self): |
| 79 | self.log('Starting srsepc') |
Pau Espin Pedrol | 2a2d846 | 2020-05-11 10:56:52 +0200 | [diff] [blame] | 80 | self.run_dir = util.Dir(self.testenv.test().get_run_dir().new_dir(self.name())) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 81 | self.configure() |
| 82 | if self._run_node.is_local(): |
| 83 | self.start_locally() |
| 84 | else: |
| 85 | self.start_remotely() |
| 86 | |
| 87 | def start_remotely(self): |
Pau Espin Pedrol | 3373703 | 2020-04-16 13:55:57 +0200 | [diff] [blame] | 88 | remote_lib = self.remote_inst.child('lib') |
| 89 | remote_binary = self.remote_inst.child('bin', srsEPC.BINFILE) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 90 | |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 91 | # setting capabilities will later disable use of LD_LIBRARY_PATH from ELF loader -> modify RPATH instead. |
| 92 | self.log('Setting RPATH for srsepc') |
| 93 | self.rem_host.change_elf_rpath(remote_binary, remote_lib) |
| 94 | # srsepc requires CAP_NET_ADMIN to create tunnel devices: ioctl(TUNSETIFF): |
| 95 | self.log('Applying CAP_NET_ADMIN capability to srsepc') |
| 96 | self.rem_host.setcap_net_admin(remote_binary) |
| 97 | |
Pau Espin Pedrol | 3373703 | 2020-04-16 13:55:57 +0200 | [diff] [blame] | 98 | args = (remote_binary, self.remote_config_file) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 99 | |
| 100 | self.process = self.rem_host.RemoteProcess(srsEPC.BINFILE, args) |
Pau Espin Pedrol | a442cb8 | 2020-05-05 12:54:37 +0200 | [diff] [blame] | 101 | self.testenv.remember_to_stop(self.process) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 102 | self.process.launch() |
| 103 | |
| 104 | def start_locally(self): |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 105 | binary = inst.child('bin', BINFILE) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 106 | lib = inst.child('lib') |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 107 | env = {} |
Pau Espin Pedrol | 3373703 | 2020-04-16 13:55:57 +0200 | [diff] [blame] | 108 | |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 109 | # setting capabilities will later disable use of LD_LIBRARY_PATH from ELF loader -> modify RPATH instead. |
| 110 | self.log('Setting RPATH for srsepc') |
| 111 | # srsepc binary needs patchelf <= 0.9 (0.10 and current master fail) to avoid failing during patch. OS#4389, patchelf-GH#192. |
| 112 | util.change_elf_rpath(binary, util.prepend_library_path(lib), self.run_dir.new_dir('patchelf')) |
| 113 | # srsepc requires CAP_NET_ADMIN to create tunnel devices: ioctl(TUNSETIFF): |
| 114 | self.log('Applying CAP_NET_ADMIN capability to srsepc') |
| 115 | util.setcap_net_admin(binary, self.run_dir.new_dir('setcap_net_admin')) |
| 116 | |
Pau Espin Pedrol | 3373703 | 2020-04-16 13:55:57 +0200 | [diff] [blame] | 117 | args = (binary, os.path.abspath(self.config_file)) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 118 | |
| 119 | self.process = process.Process(self.name(), self.run_dir, args, env=env) |
Pau Espin Pedrol | a442cb8 | 2020-05-05 12:54:37 +0200 | [diff] [blame] | 120 | self.testenv.remember_to_stop(self.process) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 121 | self.process.launch() |
| 122 | |
| 123 | def configure(self): |
Pau Espin Pedrol | e921995 | 2020-05-25 20:04:52 +0200 | [diff] [blame] | 124 | self.inst = util.Dir(os.path.abspath(self.testenv.suite().trial().get_inst('srslte', self._run_node.run_label()))) |
Pau Espin Pedrol | 3373703 | 2020-04-16 13:55:57 +0200 | [diff] [blame] | 125 | if not os.path.isdir(self.inst.child('lib')): |
| 126 | raise log.Error('No lib/ in', self.inst) |
| 127 | if not self.inst.isfile('bin', srsEPC.BINFILE): |
| 128 | raise log.Error('No %s binary in' % srsEPC.BINFILE, self.inst) |
| 129 | |
Pau Espin Pedrol | 1e81b5a | 2020-03-16 12:42:17 +0100 | [diff] [blame] | 130 | self.config_file = self.run_dir.child(srsEPC.CFGFILE) |
| 131 | self.db_file = self.run_dir.child(srsEPC.DBFILE) |
| 132 | self.log_file = self.run_dir.child(srsEPC.LOGFILE) |
| 133 | self.pcap_file = self.run_dir.child(srsEPC.PCAPFILE) |
Pau Espin Pedrol | 3373703 | 2020-04-16 13:55:57 +0200 | [diff] [blame] | 134 | |
| 135 | if not self._run_node.is_local(): |
| 136 | self.rem_host = remote.RemoteHost(self.run_dir, self._run_node.ssh_user(), self._run_node.ssh_addr()) |
| 137 | remote_prefix_dir = util.Dir(srsEPC.REMOTE_DIR) |
| 138 | self.remote_inst = util.Dir(remote_prefix_dir.child(os.path.basename(str(self.inst)))) |
| 139 | remote_run_dir = util.Dir(remote_prefix_dir.child(srsEPC.BINFILE)) |
| 140 | |
| 141 | self.remote_config_file = remote_run_dir.child(srsEPC.CFGFILE) |
| 142 | self.remote_db_file = remote_run_dir.child(srsEPC.DBFILE) |
| 143 | self.remote_log_file = remote_run_dir.child(srsEPC.LOGFILE) |
| 144 | self.remote_pcap_file = remote_run_dir.child(srsEPC.PCAPFILE) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 145 | |
Pau Espin Pedrol | c04528c | 2020-04-01 13:55:51 +0200 | [diff] [blame] | 146 | values = super().configure(['srsepc']) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 147 | |
Pau Espin Pedrol | 3373703 | 2020-04-16 13:55:57 +0200 | [diff] [blame] | 148 | dbfile = self.db_file if self._run_node.is_local() else self.remote_db_file |
| 149 | logfile = self.log_file if self._run_node.is_local() else self.remote_log_file |
| 150 | pcapfile = self.pcap_file if self._run_node.is_local() else self.remote_pcap_file |
| 151 | config.overlay(values, dict(epc=dict(db_filename=dbfile, |
| 152 | log_filename=logfile, |
| 153 | pcap_filename=pcapfile))) |
| 154 | |
Pau Espin Pedrol | 1e81b5a | 2020-03-16 12:42:17 +0100 | [diff] [blame] | 155 | # Convert parsed boolean string to Python boolean: |
| 156 | self.enable_pcap = util.str2bool(values['epc'].get('enable_pcap', 'false')) |
| 157 | config.overlay(values, dict(epc={'enable_pcap': self.enable_pcap})) |
| 158 | |
Pau Espin Pedrol | b693771 | 2020-02-27 18:02:20 +0100 | [diff] [blame] | 159 | # Set qci for each subscriber: |
Pau Espin Pedrol | 04ad3b5 | 2020-04-06 12:25:22 +0200 | [diff] [blame] | 160 | qci = values['epc'].get('qci', None) |
| 161 | assert qci is not None |
Pau Espin Pedrol | b693771 | 2020-02-27 18:02:20 +0100 | [diff] [blame] | 162 | for i in range(len(self.subscriber_list)): |
Pau Espin Pedrol | 04ad3b5 | 2020-04-06 12:25:22 +0200 | [diff] [blame] | 163 | self.subscriber_list[i]['qci'] = qci |
Pau Espin Pedrol | b693771 | 2020-02-27 18:02:20 +0100 | [diff] [blame] | 164 | config.overlay(values, dict(epc=dict(hss=dict(subscribers=self.subscriber_list)))) |
| 165 | |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 166 | self.dbg('SRSEPC CONFIG:\n' + pprint.pformat(values)) |
| 167 | |
| 168 | with open(self.config_file, 'w') as f: |
| 169 | r = template.render(srsEPC.CFGFILE, values) |
| 170 | self.dbg(r) |
| 171 | f.write(r) |
| 172 | with open(self.db_file, 'w') as f: |
| 173 | r = template.render(srsEPC.DBFILE, values) |
| 174 | self.dbg(r) |
| 175 | f.write(r) |
| 176 | |
Pau Espin Pedrol | 3373703 | 2020-04-16 13:55:57 +0200 | [diff] [blame] | 177 | if not self._run_node.is_local(): |
| 178 | self.rem_host.recreate_remote_dir(self.remote_inst) |
| 179 | self.rem_host.scp('scp-inst-to-remote', str(self.inst), remote_prefix_dir) |
| 180 | self.rem_host.recreate_remote_dir(remote_run_dir) |
| 181 | self.rem_host.scp('scp-cfg-to-remote', self.config_file, self.remote_config_file) |
| 182 | self.rem_host.scp('scp-db-to-remote', self.db_file, self.remote_db_file) |
| 183 | |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 184 | def subscriber_add(self, modem, msisdn=None, algo_str=None): |
| 185 | if msisdn is None: |
Pau Espin Pedrol | a442cb8 | 2020-05-05 12:54:37 +0200 | [diff] [blame] | 186 | msisdn = self.testenv.msisdn() |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 187 | modem.set_msisdn(msisdn) |
| 188 | |
| 189 | if algo_str is None: |
| 190 | algo_str = modem.auth_algo() or util.OSMO_AUTH_ALGO_NONE |
| 191 | |
| 192 | if algo_str != util.OSMO_AUTH_ALGO_NONE and not modem.ki(): |
| 193 | raise log.Error("Auth algo %r selected but no KI specified" % algo_str) |
| 194 | |
Pau Espin Pedrol | 0f7f265 | 2020-07-13 12:01:10 +0200 | [diff] [blame] | 195 | if algo_str == 'milenage': |
| 196 | if not modem.opc(): |
| 197 | raise log.Error("Auth algo milenage selected but no OPC specified") |
| 198 | # srsepc's used_db uses token 'mil' for milenage: |
| 199 | algo_str = 'mil' |
| 200 | |
| 201 | opc = (modem.opc() or '') |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 202 | subscriber_id = len(self.subscriber_list) # list index |
Pau Espin Pedrol | 0f7f265 | 2020-07-13 12:01:10 +0200 | [diff] [blame] | 203 | self.subscriber_list.append({'id': subscriber_id, 'imsi': modem.imsi(), 'msisdn': msisdn, 'auth_algo': algo_str, 'ki': modem.ki(), 'opc': opc, 'apn_ipaddr': modem.apn_ipaddr()}) |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 204 | |
| 205 | self.log('Add subscriber', msisdn=msisdn, imsi=modem.imsi(), subscriber_id=subscriber_id, |
| 206 | algo_str=algo_str) |
| 207 | return subscriber_id |
| 208 | |
| 209 | def enb_is_connected(self, enb): |
Pau Espin Pedrol | 491f77c | 2020-04-20 14:20:43 +0200 | [diff] [blame] | 210 | # Match against sample line: "S1 Setup Request - eNB Name: srsenb01, eNB id: 0x19" |
| 211 | stdout_lines = (self.process.get_stdout() or '').splitlines() |
| 212 | for l in stdout_lines: |
| 213 | if l.startswith('S1 Setup Request') and l.endswith('eNB id: %s' % hex(enb.id()).lower()): |
| 214 | return True |
| 215 | return False |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 216 | |
| 217 | def running(self): |
| 218 | return not self.process.terminated() |
| 219 | |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 220 | def tun_addr(self): |
| 221 | return '172.16.0.1' |
| 222 | |
Pau Espin Pedrol | c8b0f93 | 2020-02-11 17:45:26 +0100 | [diff] [blame] | 223 | # vim: expandtab tabstop=4 shiftwidth=4 |