Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

configuration-database

Syntax

Hierarchy Level

Description

Define parameters for the configuration databases.

Configure the virtual-memory-mapping statement hierarchy to increase the memory space available for the configuration database size per process, as needed, by using virtual memory mapping and page-pooling.

Configure the ephemeral statement hierarchy to specify options for the ephemeral configuration database.

Configure the resize statement hierarchy when it is necessary to resize the configuration database.

Options

extend-size

Increase the maximum memory space available for the configuration database.

Table 1 and Table 2 outline the initial releases in which the extend-size value changed and the approximate values. The extended size is based on the default maximum database size, which varies by release and OS. For example, starting in Junos OS Release 24.2R1, you can extend the configuration database's maximum size to 2.2 GB on devices that have a default maximum database size of approximately 659 MB.

Note:

The combined size of the default configuration database and the schema database is fixed. As new features are added to releases, the schema database size increases causing the configuration database default size to decrease and thus vary in size from one release to the next.
Table 1: extend-size Values for Junos OS
Default Maximum Database Size Junos OS Release 23.4 and earlier Junos OS Release 24.2R1

390-410 MB

1 GB

2 GB

649-669 MB

1.3 GB

2.2 GB
Table 2: extend-size Values for Junos OS Evolved
Default Maximum Database Size Junos OS Evolved Release 22.1R1 Junos OS Evolved Release 24.4R1

673-693 MB

1.3 GB

4 GB

Any operation on the extend-size configuration statement such as, deactivate, delete, or set requires that you reboot the device to make the change effective. The device generates the following warning message:

   Change in 'system configuration-database extend-size' will be effective at next reboot only.

The extend-size and max-db-size statements are mutually exclusive.

Note:

The extend-size statement is supported for Junos OS Evolved starting in release 22.1R1. You should remove the extend-size statement before performing a rollback from Junos OS Evolved Release 22.1 or later to any release prior to 22.1.
optimize-db-size

(Junos OS Evolved only) Optimize memory allocation for storing configuration objects, which helps reduce database file space usage by minimizing fragmentation. By reducing database file space usage, you can configure a more scaled configuration for the same database size. To configure very high scaled configurations, configure the optimize-db-size statement in addition to the extend-size statement.

When you configure this statement, you must reboot the device to make the change effective.
resize

Resize the configuration database. The database will be resized automatically during the commit based on the values specified in the database-size-diff and database-size-on-disk attributes. The system displays Database resize completed when the configuration database is successfully resized.
virtual-memory-mapping

(Junos OS only) Define parameters for using virtual memory mapping for the configuration database on a per-process basis. The process statement sets the process name. For each process, you can define the following options:

  • fixed-size—Size in kilobytes to directly map for the initial portion of the configuration database for the specified process.

    • Range: 512 KB through 696,320 KB

  • page-pooling-size—Size in kilobytes to use for page-pooling the remaining data in the database.

    • Range: 512 KB through 696,320 KB

Note:

Junos OS Evolved does not support the virtual-memory-mapping option.

The remaining statements are explained separately. See CLI Explorer.

Required Privilege Level

admin—To view this statement in the configuration.

admin-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Release 13.2.

extend-size statement added in Junos OS Evolved Release 22.1R1.

optimize-db-size statement added in Junos OS Evolved Release 24.4R1.

Related Documentation