Cisco Crosswork Network Controller 7.2.x Administration Guide

Global settings and resource allocation

Updated: August 14, 2026

Want to summarize with AI?

Details how to configure global settings for Crosswork Data Gateway, including the resource allocation and system-wide options that control its overall operation.

This section describes how to configure global settings for Crosswork Data Gateway. These settings include:

Configure the global Data Gateway settings

You can update global parameters on all Crosswork Data Gateways in the network using Crosswork Data Gateway.

Before you begin

nsure that you are aware of these points:

Only an admin user can access these settings.
Familiarize with the parameters that you would be configuring. See Data Gateway global parameters.
Confirm that you are aware of the guidelines to update the ports. See Guidelines for updating port values.

Procedure

	1.	Go to Administration > Data Collector(s) Global Settings > Global parameters.
	2.	Change the required global parameters. For information about the parameters, see Data Gateway global parameters.
	3.	Select Yes in the Global parameters window if you're updating ports. For information on port update guidance, see Guidelines for updating port values.
	4.	Click Save to apply your changes.

A window appears indicating if the parameters update on Crosswork Data Gateways in the network was successful or not.

If all the Crosswork Data Gateways were updated successfully, a success message appears in the UI indicating that the update was successful.
If any of the Crosswork Data Gateways in the network could not be updated, an Error window appears in the UI. Crosswork Data Gateway will automatically try to update the parameters on the failed Crosswork Data Gateway during recovery. Some of the collectors may get restarted as part of the recovery.

What to do next

If you have updated any of the ports, navigate to the Administration > Data Gateway Management > Data gateways tab and verify that all Crosswork Data Gateways have the Operational state as Up.

Guidelines for updating port values

To properly update port values, you must:

Confirm that the port values you want to update are valid ports.
Check that the new port values don’t conflict with existing ones on the Crosswork Data Gateway.
Configure the same port values on the device.
Restart the collectors and pause any in-progress collection jobs to update ports.
After the restart is complete, collection jobs will resume automatically.

Data Gateway global parameters

This table lists and describes the parameters required for configuring the Data Gateway.

Table 1. Parameters and descriptions
Parameter name	Description	Default value for cluster VM deployment
Number of CLI sessions	Maximum number of CLI sessions between a Crosswork Data Gateway and devices. Note This value overrides any internal configuration set for the same parameter.	3 Accepted range is 1–50
SSH session timeout	The session timeout (in seconds) is the duration for which a CLI connection can remain idle in the CLI and SNMP collectors.	120 Accepted range is 5–900 seconds
SNMP trap port	Adjust the value according to your deployment environment and configuration requirements.	1062 Accepted range is 1–65535
Syslog UDP port	Adjust the value according to your deployment environment and configuration requirements.	9514 Accepted range is 1–65535
Syslog TCP port	-	9898 Accepted range is 1–65535
Syslog TLS port	-	6514 Accepted range is 1–65535
Re-Sync SNMPv3 details	The USM details change whenever a device is rebooted or reimaged. SNMPv3 collections stop working whenever there is a change in any of the USM details.	Disable By default, this option is disabled for security reasons. Automatic synchronization of updated User Security Model (USM) information is not permitted to prevent unintended data collection from an incorrect source. When enabled, the system automatically updates USM information after changes, such as hardware updates or device reboots. This ensures that data collection continues without user intervention. If the option remains disabled, manually intervene to re-establish USM communication. This can be done by either detaching and reattaching the device to the Crosswork Data Gateway pool or toggling the device's admin state as Down and then Up.

Allocate the Data Gateway resources

Crosswork Data Gateway allows you to dynamically configure and allocate memory at runtime for collector services.

You can allocate more memory to a heavily used collector or adjust the balance of resources from the UI.

Before you begin

Ensure that you are aware of these points.

The Resource configuration page displays the memory currently configured for collector services. Changes to the memory values apply to both currently enrolled and future Crosswork Data Gateways.
The list of collectors displayed on this page is dynamic; it is specific to the deployment.
Update resource allocation for collectors only if you are working with the Cisco Customer Experience team.
When you update the values for a collector, the collector restarts and pauses any collection jobs that are running.
The NETCONF data collection support is deprecated starting from the Crosswork Network Controller 6.0 release.

Use these steps to dynamically configure and allocate memory at run time for collector services.

Procedure

	1.	Figure 1. Resource configuration
	2.	Enter the updated values in the Memory field for the collectors you want to update. We recommend a minimum memory size of 2,000 MB for the CLI and SNMP collectors.
	3.	Select the Enable collector check box to enable the data collection for the corresponding collector.
	4.	Click Save.

Enable or disable collectors

Manage collector services to optimize resource usage or resolve collector-related issues.

Crosswork Data Gateway uses configured collectors to gather device data. You may need to enable or disable collectors to optimize resource allocation or when troubleshooting collector-related problems.

Before you begin

Review this information before enabling or disabling a collector:

SNMP and CLI collectors cannot be disabled, as they are required for device reachability.
By default, all collectors are enabled.
Disable collectors only during Day 0 or Day 1 configuration. If you want to disable a collector after Day 1, the administrator must manually clear the associated collection jobs.
The NETCONF data collection support is deprecated starting from the Crosswork Network Controller 6.0 release.

Collectors should be disabled only during Day 0 or Day 1 configuration. If you plan on disabling a collector post Day 1, the administrator must manually clear the associated collection jobs.

Procedure

	1.	Go to Administration > Data Collector(s) Global Settings > Resource configuration. The list of collectors and the resource limits is displayed.
	2.	Review the list of collectors and their resource limits.
	3.	For each applicable collector, select the Enable collector check box to enable data collection, or clear the check box to disable it.
	4.	Click Save.

Your selections determine whether collector services are enabled or disabled. Set memory utilization for each collector as needed. To learn more about resource allocation, see Allocate the Data Gateway resources.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.