Parameter Names Cache (ACS)

Parameter Names Cache manages caching rules for TR-069 parameter names, controlling which parameter patterns are cached to improve ACS performance.

When to use it

Use Parameter Names Cache when you need to:

  • configure the global instance limit,

  • manage parameter name patterns for caching,

  • enable or disable specific cache rules,

  • export cache configuration before changes,

  • import updated configuration with a dry-run preview.

Prerequisites

Before working with Parameter Names Cache:

  • Confirm you are logged into the correct environment.

  • Confirm your permissions:

    • VIEWER — browse configuration and Export.

    • EDITOR / ADMIN — edit settings, manage rules, and Import.

VIEWER accounts run in read-only mode. Write actions (Edit/Import/Create/Delete/Toggle) are blocked.

Fields

Configuration fields

Field Type Required Validation

Global Instance Limit

Number

Yes

Minimum value of 0

Rule fields

Field Type Required Validation

Rule Type

Enum

Yes

blacklist, whitelist, or instance-limits

Pattern

String (regex)

Yes

Valid regular expression; must be unique

Enabled

Boolean

Yes

Toggle to activate/deactivate the rule

Instance Limits

Array of position/maxValue pairs

Conditional

Required when Rule Type is instance-limits; each pair defines a position and maximum value

Available operations

  • Update configuration — change the global instance limit.

  • Create rule — add a new caching rule with type, pattern, and enabled status.

  • Edit rule — update the pattern, type, or enabled status of an existing rule.

  • Enable/disable rule — toggle a rule on or off without deleting it.

  • Delete rule — remove a caching rule (cannot be restored).

  • Filter rules — narrow the list by rule type and/or enabled status.

  • Import — upload a .yml file (dry-run required before apply).

  • Export — download configuration and all rules as a .yml file.

Configure cache settings

The cache configuration contains a single global parameter:

Global Instance Limit

The maximum number of parameter name instances to cache. Must be a non-negative integer (minimum 0).

Edit configuration (EDITOR/ADMIN)

  1. Click Configure or the settings button in the configuration section.

  2. Update the Global Instance Limit value.

  3. Click Save.

Expected outcomes:

  • On success, the configuration updates and a notification appears.

  • Changes take effect immediately.

Manage cache rules

Cache rules define parameter name patterns that should be cached. Each rule contains:

Pattern

Regular expression pattern for matching parameter names. Example: Device\.WiFi\..*

Rule Type

Type of rule (blacklist, whitelist, or instance-limits).

Enabled

Toggle to enable or disable the rule without deleting it.

Browse rules

  1. Review the rules table:

    • Pattern — regex pattern.

    • Type — rule type badge.

    • Enabled — toggle switch.

    • Actions — view, edit, delete buttons.

At the top, a summary displays:

  • Total number of rules.

  • Number of enabled rules.

Filter rules

Use the filter controls to narrow down the list:

Rule Type Filter

Filter by specific rule type (blacklist, whitelist, instance-limits) or show all.

Status Filter

  • All — show all rules.

  • Enabled only — show only active rules.

  • Disabled only — show only inactive rules.

Search rules

Use the search field to filter rules by pattern or type:

  1. Enter text in the search field.

  2. The list automatically filters as you type.

Create a new rule (EDITOR/ADMIN)

  1. Click New Rule.

  2. Enter Pattern (regex pattern).

  3. Select Rule Type.

  4. Set Enabled status.

  5. Click Create.

Expected outcomes:

  • The rule is added to the list.

  • Duplicate patterns are not allowed.

Edit a rule (EDITOR/ADMIN)

  1. Click the edit button on a rule row or open the rule view dialog.

  2. Update the pattern, type, or enabled status.

  3. Click Save.

Enable/disable a rule (EDITOR/ADMIN)

  1. Use the Enabled toggle on the rule row.

  2. Changes take effect immediately.

The toggle is unavailable during update (loading indicator is shown).

Delete a rule (EDITOR/ADMIN)

  1. Click the delete button on the rule row.

  2. Confirm deletion in the dialog.

Deleted rules cannot be restored.

Export configuration

Export downloads a .yml file with cache settings and all rules.

  1. Click Export.

  2. Save the downloaded file.

What is exported:

  • Cache configuration (global instance limit).

  • All cache rules (patterns, types, statuses).

  • Format: .yml.

Import with dry-run (mandatory)

Import requires a mandatory preview before applying changes.

  1. Click Import.

  2. Select or drag-and-drop a .yml file.

  3. Wait for the dry-run analysis.

  4. Review the diff table and the change details panel:

    • Summary counts (to add / update / delete / skip).

    • Details per rule, grouped by status.

    • Errors and warnings.

  5. If warnings exist, check Apply despite warnings.

  6. Click Apply import.

Expected outcomes:

  • Dry-run runs automatically after file selection.

  • Warnings require explicit confirmation before apply.

  • Errors block apply until resolved.

Refresh snapshot

  1. Click Refresh to reload the current configuration snapshot.

  2. Use refresh after imports or after changes by other operators.

Typical workflow

  1. Navigate to the ACS dashboard and select Parameter Names Cache.

  2. Review the global cache configuration (global instance limit).

  3. Click Configure to update the global instance limit if needed.

  4. Browse the rules table; use filters to narrow by rule type (blacklist/whitelist/instance-limits) or status (enabled/disabled).

  5. Click New Rule to add a caching rule with a regex pattern, rule type, and enabled status.

  6. Use the Enabled toggle on any rule row to activate or deactivate it immediately.

  7. To edit a rule, click the edit button, update fields, and click Save.

  8. Export the configuration as .yml before making bulk changes.

Troubleshooting

Edit actions are disabled

Confirm your role is EDITOR or ADMIN.

Invalid pattern

Ensure the pattern is a valid regular expression.

Global instance limit rejected

Check that the value is a non-negative integer (0 or greater).

Import apply is blocked

Review dry-run warnings/errors and resolve issues in the .yml file.

Configuration not found

Click Refresh or import a properties file to create a snapshot.

Related pages