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