Integrate a universal forwarder onto a system image
This topic discusses the procedure to integrate a Splunk universal forwarder into a Windows system image. For additional information about integrating Splunk Enterprise into images, see Integrate Splunk Enterprise into system images.
Install and configure Windows and applications
- On a reference computer, install and configure Windows the way that you want, including installing Windows features, service packs, and other components.
- Install and configure necessary applications, taking into account Splunk's system and hardware capacity requirements.
- Install and configure the universal forwarder from the command line. You must supply at least the
LAUNCHSPLUNK=0command line flag when you perform the installation. - Proceed through the graphical portion of the install, selecting the inputs, deployment servers, and/or forwarder destinations you want.
- After the installation has completed, open a command prompt or PowerShell window.
Edit configurations and run clone-prep-clear-config
- (Optional) Edit configuration files that were not configurable in the installer.
- Change to the universal forwarder
bindirectory. - Run
./splunk clone-prep-clear-config. - Exit the command prompt or PowerShell window.
- In the Services Control Panel, configure the
splunkdservice to start automatically by setting its startup type to 'Automatic'. - Prepare the system image for domain participation using a utility such as Windows System Image Manager (WSIM). Microsoft recommends using
SYSPREPor WSIM as the method to change machine Security Identifiers (SIDs) prior to cloning, as opposed to using third-party tools (such as Ghost Walker or NTSID.)
Clone and restore the image
- Restart the machine and clone it with your favorite imaging utility.
- After cloning the image, use the imaging utility to restore it into another physical or virtual machine.
- Run the cloned image. Splunk services start automatically.
- Use the CLI to restart Splunk Enterprise to remove the
cloneprepinformation:splunk restart
Note: You must restart Splunk Enterprise from the CLI to delete thecloneprepfile. Restarting the Splunk service does not perform the deletion. - Confirm that the
$SPLUNK_HOME\cloneprepfile has been deleted.
The image is now ready for deployment.