Bug ID 669288: Cannot run tmsh utils unix-* commands in Appliance mode when /shared/f5optics/images does not exist.

Last Modified: Apr 19, 2021

Bug Tracker

Affected Product:  See more info
BIG-IP LTM(all modules)

Known Affected Versions:
12.1.0, 12.1.0 HF1, 12.1.0 HF2, 12.1.1, 12.1.1 HF1, 12.1.1 HF2, 12.1.2, 12.1.2 HF1, 12.1.2 HF2, 12.1.3, 13.0.0, 13.0.0 HF1, 13.0.0 HF2, 13.0.0 HF3, 13.0.1, 13.1.0,,,,,,,,, 13.1.1,,,,, 13.1.3,,,,,,, 13.1.4

Fixed In:

Opened: Jun 14, 2017
Severity: 3-Major
Related AskF5 Article:


From tmsh, running util unix-ls /var/log fails with the following error: exception: (Failed to canonicalize "/shared/f5optics/images") (util/RealpathHelper.cpp, line 49), continuing... Data Input Error: /var/log is not an accessible directory for the current mode.


There is no shell access to the file system when the BIG-IP system is in Appliance mode. This is the intended purpose of Appliance mode. Therefore, unix-* commands are the only way to list directories, and perform other operations specific to the operating system.


-- A BIG-IP system configured for Appliance mode. -- Upgrading from a pre-v12.x to v12.x or later. -- Using a platform that does not have a /shared/f5optics/images directory. These include the following BIG-IP blades and appliances: B4400, i4x00, i10x00, i2x00, i7x00, i5x00


To work around this issue, create the /shared/f5optics/images directory. To do so, do the following: 1. Boot the BIG-IP system into single-user mode. 2. Create the directory /shared/f5optics/images with the following command: mkdir -m 777 -p /shared/f5optics/images. 3. Reboot the BIG-IP system, and allow it to start up normally.

Fix Information

The reported exception does not occur, and unix-* commands commands issued in Appliance mode run as expected.

Behavior Change