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

Training Resources

Important Notices

Search for ‘Deploy Changes’ on APARs

IJ15527: DEPLOY FUNCTION CAN TIMEOUT WHEN A REQUIRED PROCESS IS UNABLE TO CONNECT TO QRADAR APPS

It has been identified that when QRadar Apps do not respond to a required process during a Deploy function, the Deploy can timeout.

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”.

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

Common error messages that administrators can encounter in the user interface or in qradar.log:

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 for the Console and any hosts experiencing deploy issues.

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 WinCollect 7 and 10

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

Find your regional support contact

Give Feedback