Deploy Changes 101

Deploy Changes 101 QRadar Support’s technical resolutions and suggested troubleshooting for common Deploy Changes problems and error messages.

Ask in our Forums

Trainig Resources

Important Technotes

Search for ‘Deploy Changes’ on APARs

IJ25798: DEPLOY FUNCTION CAN FAIL DUE TO AN INCONSISTENT INDEX FROM THE CONSOLE VS MANAGED HOST(S)

A QRadar deploy function can fail when there is inconsistency in an index (reference_data_element_data1) from what is on the Console vs what is on a Managed Host.

IJ11784: DEPLOY FULL CONFIGURATION FUNCTION DOES NOT PROGRESS PAST “PREPARING FOR DEPLOYMENT” MESSAGE

It has been identified that a Deploy Full Configuration function (Admin -> Advanced drop down) can sometimes stall at the message “Preparing for deployment”.

IJ11784: DEPLOY FULL CONFIGURATION FUNCTION DOES NOT PROGRESS PAST “PREPARING FOR DEPLOYMENT” MESSAGE

It has been identified that a Deploy Full Configuration function (Admin -> Advanced drop down) can sometimes stall at the message “Preparing for deployment”.

IJ22083: ‘DEPLOY’ BUTTON DOES NOT FUNCTION FOM THE’ADMIN TAB -> DATA SOURCES -> EVENTS’ WINDOW

When in the Admin tab -> Data Sources > Events view, the Deploy changes button does not function.

Troubleshooting Checklist

These articles provide common troubleshooting steps support representatives review with administrators when a Deploy Changes does not complete.

Step 1

Verify SSH connectivity works from the Console to the Managed Host.

Step 2

Confirm the Console and the Managed Host system QRadar versions match.

Step 3

Check the hostcontext service is running on the Managed Host system.

Step 4

Investigate possible disk space issues if the hostcontext service keeps stopping.

Step 5

Confirm there is no .NODOWNLOAD file present.

Step 6

Verify the tokens match between systems

Step 7

For encrypted managed host connections, check if tunnels are starting.

Step 8

Network bandwidth can be a cause for frequent deploy changes failures.

Common Questions

This section includes useful information for admins to understand how the Console deploys user changes to managed hosts:

Deploy Changes Documentation

What is the difference between Deploy Changes and Deploy Full Configuration?

How to audit which administrator completed a Deploy Changes or Full Deploy

What is the impact of Deploy Full Configuration on events, flows, and offenses?

How to monitor Deploy Changes progress.

Common Error Messages

This section includes useful information for admins to understand how the Console deploys user changes to managed hosts:

There is another deployment currently in progress, please try again later.

/opt/qradar/conf/nva.conf: Permission denied.

Deploy fails on all of the managed hosts after backup is restored.

Setup process setuptunnel.x has failed to start for n intervals.

Unable to deploy, could not retrieve undeployed change list — the request timed out.

Still Experiencing an Issue?

To receive help from QRadar Support, ensure that you include the following information:

Step 1

Collect logs from your WinCollect agent experiencing an issue.

Step 2

Collect logs from your QRadar Console.

Step 3

Open a case with QRadar Support.

Step 4

Describe your issue and any troubleshooting steps you attempted.

Step 5

If possible, describe any recent administrator actions, such as a configuration restore or upgrade.

Step 6

Ensure that your case includes contact information, such as your email or phone number.

Explore QRadar 101

QRadar home

Return to the QRadar 101 homepage

Applications

Learn about QRadar apps

Wincollect

Learn about deploying changes to QRadar

Disk Space

Learn about managing QRadar disk space

Software

Download software for QRadar

Support Assistance

Read our support policies

Support tools

Browse CLI tools to help with troubleshooting

Technotes

Browse a directory of our technical notes

Installs and Upgrades

Learn about installing and upgrading QRadar

Known issues

See current and fixed issues with QRadar

“IBM prides itself on delivering world class software support with highly skilled, customer-focused people. ”

Return to 101 home

Contact Support