F5 Extension UCS Config Explorer: TypeError: Cannot read properties of undefined (reading 'replace')

[danner26]

Hello,

We are attempting to use the F5 extension to view a BIG-IP VE running BIG-IP 17.1.0.1 0.0.4. When attempting to load the UCS, we are seeing the following error stack:

1 [2025-03-27T16:36:27.464Z] [INFO]: ------ Environment Variables ------
2 [2025-03-27T16:36:27.464Z] [INFO]: F5_CONX_CORE_REJECT_UNAUTORIZED=false
3 [2025-03-27T16:36:27.464Z] [INFO]: F5_VSCODE_LOG_LEVEL=INFO
4 [2025-03-27T16:36:27.464Z] [INFO]: F5_VSCODE_TEEM=true
5 [2025-03-27T16:36:27.750Z] [INFO]: Extension/Host details:  {
  name: 'vscode-f5',
  displayName: 'The F5 Extension',
  publisher: 'F5DevCentral',
  description: 'Supercharge your F5 automation development',
  version: '3.18.2',
  license: 'Apache-2.0',
  repository: 'https://github.com/f5devcentral/vscode-f5.git',
  host: '{"hostOS":"Linux","platform":"linux","release":"4.18.0-513.24.1.el8_9.x86_64"}',
  userInfo: '{"uid":1000,"gid":1000,"username":"ansible","homedir":"/home/ansible","shell":"/bin/bash"}'
}
6 [2025-03-27T16:36:27.785Z] [INFO]: atc release version already checked today, returning cache from /home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/cache/atcVersions.json
7 [2025-03-27T16:36:27.830Z] [INFO]: ------ Environment Variables ------
8 [2025-03-27T16:36:27.830Z] [INFO]: F5_CONX_CORE_REJECT_UNAUTORIZED=false
9 [2025-03-27T16:36:27.830Z] [INFO]: F5_VSCODE_LOG_LEVEL=INFO
10 [2025-03-27T16:36:27.830Z] [INFO]: F5_VSCODE_TEEM=true
11 [2025-03-27T16:36:27.830Z] [INFO]: F5_TELEMETRY_DEBUG=yes
12 [2025-03-27T16:36:27.830Z] [INFO]: F5_CONX_CORE_EXT_HTTP_AGENT=vscode-f5/3.18.2
13 [2025-03-27T16:36:27.830Z] [INFO]: F5_CONX_CORE_CACHE=/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/cache
14 [2025-03-27T16:36:28.134Z] [INFO]: loading tmos -> xc rules file
15 [2025-03-27T16:36:45.105Z] [INFO]: f5.cfgExplore path revieved: /home/ansible/projects/as3_testing/AS3_Backup_Testing.ucs
16 [2025-03-27T16:36:45.105Z] [INFO]: f5.cfgExplore: exploding config @ /home/ansible/projects/as3_testing/AS3_Backup_Testing.ucs
17 [2025-03-27T16:36:45.106Z] [INFO]: f5.cfgExplore, opening archive
18 [2025-03-27T16:36:45.136Z] [INFO]: f5.cfgExplore, parsing file -> config/user_alert.conf
19 [2025-03-27T16:36:45.138Z] [ERROR]: --- unhandledRejection --- TypeError: Cannot read properties of undefined (reading 'replace')
    at removeVersionDecimals (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/regex.js:239:25)
    at RegExTree.update (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/regex.js:175:19)
    at new RegExTree (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/regex.js:166:14)
    at BigipConfig.<anonymous> (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:286:27)
    at Generator.next (<anonymous>)
    at /home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:8:71
    at new Promise (<anonymous>)
    at __awaiter (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:4:12)
    at BigipConfig.setTmosVersion (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:272:16)
    at BigipConfig.<anonymous> (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:145:28)
    at Generator.next (<anonymous>)
    at /home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:8:71
    at new Promise (<anonymous>)
    at __awaiter (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:4:12)
    at BigipConfig.parseConf (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:126:16)
    at UnPacker.<anonymous> (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:82:45)
    at UnPacker.emit (node:events:518:28)
    at Source.<anonymous> (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/unPackerStream.js:130:42)
    at Source.emit (node:events:518:28)
    at ReadableState.updateNonPrimary (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/streamx/index.js:368:14)
    at ReadableState.update (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/streamx/index.js:357:71)
    at ReadableState.updateReadNT (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/streamx/index.js:525:10)
    at processTicksAndRejections (node:internal/process/task_queues:77:11)
20 [2025-03-27T16:36:45.170Z] [INFO]: f5.cfgExplore, parsing file -> config/bigip_script.conf
21 [2025-03-27T16:36:45.171Z] [INFO]: f5.cfgExplore, parsing file -> config/bigip_base.conf
22 [2025-03-27T16:36:45.179Z] [INFO]: f5.cfgExplore, parsing file -> config/bigip.conf
23 [2025-03-27T16:36:45.179Z] [INFO]: f5.cfgExplore, parsing file -> config/bigip_gtm.conf
24 [2025-03-27T16:36:45.179Z] [INFO]: f5.cfgExplore, parsing file -> config/bigip_user.conf
25 [2025-03-27T16:36:45.341Z] [ERROR]: makeExplosion TypeError: Cannot read properties of undefined (reading 'replace')
    at removeVersionDecimals (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/regex.js:239:25)
    at RegExTree.update (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/regex.js:175:19)
    at new RegExTree (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/regex.js:166:14)
    at BigipConfig.<anonymous> (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:286:27)
    at Generator.next (<anonymous>)
    at /home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:8:71
    at new Promise (<anonymous>)
    at __awaiter (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:4:12)
    at BigipConfig.setTmosVersion (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:272:16)
    at BigipConfig.<anonymous> (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:145:28)
    at Generator.next (<anonymous>)
    at /home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:8:71
    at new Promise (<anonymous>)
    at __awaiter (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:4:12)
    at BigipConfig.parseConf (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:126:16)
    at UnPacker.<anonymous> (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/ltm.js:82:45)
    at UnPacker.emit (node:events:518:28)
    at Source.<anonymous> (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/f5-corkscrew/dist/unPackerStream.js:130:42)
    at Source.emit (node:events:518:28)
    at ReadableState.updateNonPrimary (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/streamx/index.js:368:14)
    at ReadableState.update (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/streamx/index.js:357:71)
    at ReadableState.updateReadNT (/home/ansible/.vscode-server/extensions/f5devcentral.vscode-f5-3.18.2/node_modules/streamx/index.js:525:10)
    at processTicksAndRejections (node:internal/process/task_queues:77:11) {
  vslsStack: [
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}
  ]
}

If I can provide anymore information please let me know. I have tried also disabling and switching to a pre-release version of the remote SSH extension, as well as enabling Remote Server Listen On Socket, which I found in a few Google searches for other issues. None of those have worked so far.

[DumpySquare]

Thanks for opening this issue. Aside from the stack trace, is anything happening in the UI? Is the config explorer showing up at all?

Please upload a qkview to iHealth and email me at b dot gordon at f5 dot com

[DumpySquare]

I think I can add some error handling to ignore parsing errors from the config/bigip_user.conf and config/user_alert.conf files. While they are nice to have, not strictly required for most use cases.

[j-zehnder]

Are there any updates to this issue? I am experiencing the issue as well

[alietss]

Hello,

Same issue here, release OS version 17.5.1.2, new clean install guest, Backup UCS, got same parse error.

Do you have any updates?

Best regards.

[DumpySquare]

please upload a fresh qkview of the system to iHealth, then email me at b dot gordon at f5 dot com

[alietss]

Hello,

I was able to import the UCS by doing this:

1- Edited the UCS following https://my.f5.com/manage/s/article/K13830181
2- Removed from the ucs config/bigip_user.conf and config/user_alert.conf files
3-Compressed back the ucs following the KB instructions

Nothing special about those to files, both are the default included in a new 17.5.1.3 clean install, I tried to add the files to this post but gitbub is blocking them, find the content bellow:

config/bigip_user.conf
#TMSH-VERSION: 17.5.1.3

auth user admin {
description "Admin User"
partition-access {
all-partitions {
role admin
}
}
session-limit -1
shell none
}
auth user f5hubblelcdadmin {
description f5hubblelcdadmin
partition-access {
all-partitions {
role admin
}
}
session-limit -1
shell none
}
auth user root {
description root
session-limit -1
shell bash
}

config/user_alert.conf (Empty file)

Best regards,
PD: My initial goal is to convert existing systems configurations to AS3/JSON, is the VS Code/F5 Extension the recommended path?