Lantronix welcomes Uplogix! Learn more here.

The Uplogix File System

Updated March 9, 2021. Written for LMS Version 6.2.

Overview

Each port resource on the Local Manager comes with its own file system for storing configuration files, OS images, output from Power On Self Tests (POST), and the output from a show tech command on a managed device.

Categories in the file system include:

  • Config - Running
  • Config - Startup
  • OS
  • Post
  • Tech

For each category type, multiple versions can be stored.

  • Candidate: Used for staging a new configuration or OS prior to update or upgrade
  • Current: The current version of file running on the managed device
  • Previous: The previous version running on the managed device before it was replaced by Current
  • Archive #: Previous versions that were running on the managed device. The file system will store up to 20 archived versions
  • Named: user-defined version names. The file system will store up to 5 named configuration versions and 6 named OS versions

The built-in version names will continue to cycle as new running configurations are detected.

Viewing files

Use the show directory -v command to view the files in the Lantronix file system for a managed device.

[admin@LantronixLM (port1/1)]# show dir -v
All times shown in UTC.

Type     Version    Size        Date          Name
-------  ---------  ----------  ------------  ------------
Config
    Running
         current    381         Feb 26 14:57  running-config
         previous   370         Feb 26 14:38  running-config

    Startup
         current    351         Feb 26 15:02  startup-config
         previous   370         Feb 26 14:38  startup-config

    Running-Undo
         candidate  53          Feb 26 14:57  running-config-undo74869521198334570.img

OS
         current    5569272     Feb 26 14:59  c2600-i-mz.122-26.bin

Tech
         current    24811       Feb 26 18:24  showTech

Post
         current    2393        Feb 26 18:27  readPost

User-defined file version names

The user-defined version names feature allows users to assign unique names to files stored in the Lantronix file system for managed devices, and to use those named files for the push, pull, copy, and delete file operations. The named file will remain untouched until it is deleted or overwritten. Up to five configuration files of each type may be named and up to six named OS files may be stored in the local file system. File names are limited to nine characters in length.

There are a few situations where the Local Manager automatically creates a named configuration and OS file. The advanced Cisco IOS driver will back up that VLAN database from a switch and store it as a named startup-config file called vlandata. The OS Policy feature will store a standard OS file that is referenced for the given make and model in an OS Policy on the Control Center as a named OS file with the name standard.

A user must have a role with the following permissions in order to complete the operations described for this feature:

  • show directory — Displays stored files on a port resource
  • copy — Copies a stored file
  • delete — Deletes a stored file

Copying and Naming Files

Use the copy command to rename a file or to move it. The syntax for the copy command is:

copy [options] {source} {destination}
Where each parameter is made up of the following choices:
Type = <os | running-config | startup-config | tech | post>
Version = <candidate | current | previous | <user ver> | archive #>
User versions can include A-Z, a-z, 0-9, and _,  1 to 9 characters.
Port = port #/#

Example of copying the current running-config to a user-named running-config with the name "golden":

[admin@LantronixLM (port1/3)]# copy running-config current golden
copy succeeded
[admin@LantronixLM (port1/3)]# show directory
Type        Version     Size            Date                Name
------- ----------      ------      ------------        ------------
Config
Running
Current     7592            17 Feb 12:52        running-config
golden      7592            17 Feb 12:51        running-config

Deleting Files

Use the delete command to remove a named file from the Lantronix file system.

Built-in versions (current, previous, archive) cannot be deleted.

The syntax for the delete command is:

delete <Type> <user-defined version>

An example of deleting a named file from the file system:

[admin@LantronixLM (port1/1)]# delete running-config golden
Really delete running-config, "golden"? (y/n): 

Not finding what you're looking for?

The LEVEL Technical Services team is standing by 24/7/365 to answer any questions you may have about the installation, configuration, and usage of our products.

© 2024 Lantronix, Inc. All Rights Reserved