This topic explains how to set up deployment clients to receive content from a deployment server. In most cases, you just need to specify the deployment server that you want the client to connect to.
The universal box setup are set up by professionals who strive hard to add glamor to the party and can be placed both indoors as well as outdoors. Alibaba.com offers a broad category of universal box setup that fits perfectly within your budget with amazing savings. These products are offered with custom packaging and you can place OEM orders too. How to Set up and Use: Universal Control 1.5.3.1 - SL Remote 1.2 - Cue Mix 1.0; Installation Issues with Universal Control on High Sierra Mac OSX 10.13; How do I uninstall and reinstall my AudioBox drivers in Windows 7 or Vista? Installing AudioBox VSL Over Universal Control 1.8 Fails, Prevents Universal Control 1.8 From Seeing AudioBox.
Even though this step occurs on the deployment clients, not the deployment server itself, it is an essential part of the overall configuration of the deployment server system.
Important: The deployment server cannot be a deployment client of itself. If it is, the following error will appear in splunkd.log: 'This DC shares a Splunk instance with its DS: unsupported configuration'. This has the potential to lead to situations where the deployment clients lose their ability to contact the deployment server.
Specify the deployment server
On each client, you must specify the deployment server it will connect to. You do this by configuring the client's deploymentclient.conf file. Each deployment client must have a unique network hostname.
There are three ways to configure this file:
- Use the CLI. See 'Use the CLI', later in this topic.
- Edit the file directly. See 'Edit deploymentclient.conf', later in this topic.
- For Windows universal forwarders only: Configure a Windows forwarder as a deployment client during the installation process. See the following Universal Forwarder manual topics:
Important: Do not use the deployment server to push deploymentclient.conf updates to the deployment clients. Doing so can potentially lead to situations where the deployment clients lose their ability to contact the deployment server.
Use the CLI
On the deployment client, run these CLI commands:
Use the IP_address/hostname and management_port of the deployment server you want the client to connect with.
For example:
Edit deploymentclient.conf
You can also directly create and edit a deploymentclient.conf file in $SPLUNK_HOME/etc/system/local.
Syntax
The deploymentclient.conf file requires two stanzas:
| Stanza | What it's for |
|---|---|
[deployment-client] | Configures a number of attributes, including where to find new or updated content. You do not usually need to change the default values for this stanza. |
[target-broker:deploymentServer] | Specifies the location of this client's deployment server. deploymentServer is the default name for a deployment server. You must specify the deployment server under this stanza. |
This file has a large number of optional attributes, but for most deployments, you only need to set the targetUri attribute under the [target-broker:deploymentServer] stanza. This attribute specifies the client's deployment server. Here's the attribute's syntax:
| Attribute | What it's for | Default |
|---|---|---|
targetUri | Specifies the deployment server connection information. Set to | n/a |
For a complete list of deploymentclient.conf attributes, see the deploymentclient.conf specification file in the Admin manual.
Important: You must restart the deployment client for the change to take effect.
Example
9.2 Surround Setup
Here is a typical client configuration:
As is usually the case, this example accepts the default values for nearly all attributes. The one attribute that you must set, the location of the deployment server, has a value of deploymentserver.splunk.mycompany.com:8089.
Set a client name
You can assign each deployment client a client name. The deployment server can filter on client names, as described in 'Set up client filters'.
By default, the client name is set to the deployment client's GUID. If you plan to use the client name in filtering, it's recommended that you explicitly set it to some reasonable and readable name.
Important: Client names should be unique.
To configure a client name, set the clientName attribute in deploymentclient.conf to the chosen name. For example:
Restart the deployment client for the configuration change to take effect.
Get deployment client information
You can find information about the deployment client from two locations:
- On the deployment client itself
- On the deployment server
View status from the deployment client
You can view the status of a deployment client from Splunk Web:
1. Click the Settings link at the top of Splunk Web. A window pops up with links to the set of system interfaces.
2. Select Server settings in the System section.
3. Choose Deployment client settings. This takes you to a read-only screen that provides some information about the client:
- Its deployment server.
- Its server classes and apps.
- Its status.
View clients from the deployment server
Once you configure and restart the client, it will initiate a handshake process with the specified deployment server. The deployment server adds it to its list of clients under the Clients tab of the forwarder management interface. For example:
Disable a deployment client
9.2 Speaker Setup
To disable a deployment client, run this CLI command on the deployment client:
Upgrade a deployment client
You upgrade a client in the usual way, according to whether the client is a universal forwarder or a full Splunk Enterprise instance. The fact that an instance is a deployment client does not make any difference in how you perform the upgrade.
However, after you upgrade the client, the client will appear twice in the client list that the deployment server maintains and presents through the forwarder management interface. To eliminate the duplicate listing, you must restart the deployment server after a client upgrade.