Deployment Architecture

Multi-Layer Deployment Server: Backend Functional, GUI Error on Main DS

Wohamed_wakkad
Path Finder

I configured a multi-layer Deployment Server (DS) setup with the following architecture:

  1. Main DS Management: The main DS manages its local Universal Forwarders (UFs) and acts as the parent controller for branch Intermediate Forwarders (IFs), which register as clients to the main DS.

  2. Branch DS Configuration & Target Repository: The branch Intermediate Forwarders act as local Deployment Servers for their respective branch UFs. To manage branch UF configurations from the main DS, I configured custom targetRepositoryLocation settings on the IFs so that deployment apps pushed from the main DS land directly in the intermediate deployment apps directory (/opt/splunk/etc/deployment-apps).

  3. Dynamic Server Class Mapping: To ensure deployed apps map to the correct server classes and target agents, I pushed an app from the main DS to the intermediate DS to handle the mapping logic.

Current Issue: Although the configuration works correctly on the backend, the main DS GUI displays an error and provides error status information.

 

Main deployment server issues bellow :

 

Wohamed_wakkad_0-1790189924568.png

 

Wohamed_wakkad_1-1790189947528.png

 

 

The branches intermediate forwarder are ok :

 

Wohamed_wakkad_2-1790189991712.png

 

Wohamed_wakkad_3-1790190013564.png

 

and verification from search head the branch universal forwarder conf work well

 

Wohamed_wakkad_4-1790190109002.png

 

 

 

 

Labels (1)
Tags (1)
0 Karma
1 Solution

Wohamed_wakkad
Path Finder

@gcusello  The solution is to set stateOnClient = noop either under the server class related to branches or under apps. For more details about this solution, visit the threads below:"

Why is my Deployment Server showing an error pushi... - Splunk Community

 

Deploying apps to a Cluster Manager "Manager-Apps" directory may cause ERRORS or a Cluster Master Re...

 

the output as 

 

Wohamed_wakkad_0-1790267647050.pngWohamed_wakkad_1-1790267697726.png

For guide to how implement this design from scratch visit the link bellow:

 

Multi-layer Deployment Server (DS) architecture(Cascading DS) | by Mohamedmamdouhwakkad | Sep, 2026 ...

 

 

View solution in original post

Wohamed_wakkad
Path Finder

For guide to how implement this design from scratch visit the link bellow:

Multi-layer Deployment Server (DS) architecture(Cascading DS) | by Mohamedmamdouhwakkad | Sep, 2026 ...

0 Karma

Wohamed_wakkad
Path Finder

@gcusello  The solution is to set stateOnClient = noop either under the server class related to branches or under apps. For more details about this solution, visit the threads below:"

Why is my Deployment Server showing an error pushi... - Splunk Community

 

Deploying apps to a Cluster Manager "Manager-Apps" directory may cause ERRORS or a Cluster Master Re...

 

the output as 

 

Wohamed_wakkad_0-1790267647050.pngWohamed_wakkad_1-1790267697726.png

For guide to how implement this design from scratch visit the link bellow:

 

Multi-layer Deployment Server (DS) architecture(Cascading DS) | by Mohamedmamdouhwakkad | Sep, 2026 ...

 

 

gcusello
SplunkTrust
SplunkTrust

Hi @Wohamed_wakkad ,

this is a recognized by Splunk Professional Services architecture, so you can open a ticket to Splunk Support.

Ciao.

Giuseppe

0 Karma
Got questions? Get answers!

Join the Splunk Community Slack to learn, troubleshoot, and make connections with fellow Splunk practitioners in real time!

Meet up IRL or virtually!

Join Splunk User Groups to connect and learn in-person by region or remotely by topic or industry.

Get Updates on the Splunk Community!

Painting a Clearer Picture: Unifying Your Investigations with Cisco AI Canvas

Painting a Clearer Picture: Unifying Your Investigations with Cisco AI Canvas  We’ve all been there. You’re ...

Hello POJO, meet nocode

What's the Challenge? Instrumentation agents are highly advanced bits of software that manipulate bytecode, ...

Announcing Modern Navigation: A New Era of Splunk User Experience

We are excited to introduce the Modern Navigation feature in the Splunk Platform, available to both cloud and ...