Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Troubleshooting a Software Upgrade Failure Due to Insufficient Free Disk Space on a Routing Matrix with a TX Matrix Plus Router

 

Problem:

Description: In a routing matrix with a TX Matrix Plus router, a successful upgrade of the Junos OS requires sufficient free disk space on all Routing Engines of the TX Matrix Plus router and connected T1600 or T4000 routers.

Symptoms: If the amount of free disk space on a Routing Engine is insufficient to install the Junos OS, you might receive a warning that the /var filesystem is low on free disk space, similar to the following message:

Cause

The amount of free disk space necessary to upgrade a Routing Engine with a new version of the Junos OS can vary from one release to another. Check the Junos OS Release Notes for the software version you are installing.

To determine the amount of free disk space on each Routing Engine in the routing matrix, issue the show system storage command on the master Routing Engine and also on the backup Routing Engine on the TX Matrix Plus router.

Note

When you issue the show system storage command on a master Routing Engine of a TX Matrix Plus router, the command is broadcast to the master Routing Engines (only) on all T1600 or T4000 routers in the routing matrix. Similarly, when you issue the show system storage command on a backup Routing Engine of a TX Matrix Plus router, the command is broadcast to the backup Routing Engines (only) on all T1600 or T4000 routers in the routing matrix.

The following example shows sample output for the show system storage command when it is issued on the master Routing Engine in slot 0 on the TX Matrix Plus router:

Solution

To resolve the issue of insufficient free disk space on a Routing Engine to perform a Junos OS upgrade on that router, perform the following steps:

  1. To free up space in the file system, you can log in to a particular Routing Engine and then issue the request system storage cleanup command. This command deletes rotating log files in /var/log that are not current, temporary files in /var/tmp that have not been modified within the last two days, and all crash files in /var/crash. The command output first lists the files proposed for deletion and then prompts you to proceed to delete these storage cleanup candidates. Note

    Although the command prompts you before deleting files, you can issue the command with the dry-run option, which causes the command to only list the cleanup candidates without offering to remove them.

    The following example shows sample output for the request system storage cleanup command with the dry-run option included:

    root@sfc0> request system storage cleanup dry-run
  2. You can use the following file management operational commands to display information about the directories and files on a Routing Engine, but you must include the chassis and Routing Engine specifiers in the pathname:

    • To display detailed information about a file or directory contents, issue the file list command with the detail option.

    • To display the contents of a file, issue the file show command.

    • To compare the contents of two files, issue the file compare command.

  3. In addition to or instead of using the request system storage cleanup command to delete unnecessary files, you can use the following file management commands to delete or move files on a Routing Engine, but you must include the chassis and Routing Engine specifiers in the pathname:

    If you elect to use the request system storage cleanup command to automatically delete files, issue the command without the dry-run option, and then type yes when the CLI prompts to proceed with deleting the candidate files. The following truncated example shows sample output for the request system storage cleanup command:
  4. After sufficient free disk space is available on the Routing Engines on which you are upgrading the Junos OS, attempt the upgrade procedure again.