Steps
Upgrade your Edge Processor to the enhanced version by performing the following steps:
- Download the migration script:
- Navigate to your Edge Processor instance, and log in using SSH.
- Navigate to the directory where the initial Edge Processor installation occurred. The directory should contain the splunk-edge folder.
- In your deployment's Command Line Interface (CLI), download the migration script onto your instance:
curl -O https://beam.scs.splunk.com/edge-processor/migration/enhance-ep.sh
- Execute the migration script:
- Modify the script to be executable by running the following command in your terminal:
chmod +x enhance-ep.sh - Create the migration command:
- Review the following CLI command:
./enhance-ep.sh "<AUTH_TOKEN>" - Perform the following steps to replace the placeholder "<AUTH_TOKEN>" parameter in the command.
- Navigate into the Edge Processor that you want to migrate.
- Navigate to the Instances tab, click on the Install/uninstall button, and navigate to the Enhanced install script tab.
- In the Enhanced install script tab, copy the token (the long string in quotation marks) from the command that looks similar to the following command:
# Create an authentication token file used to connect the Edge Processor instance to your Splunk platform deployment echo "eyJhb..." > splunk-edge/var/token - Verify that you have copied only the token.
- Replace "<AUTH_TOKEN>" in the command line with your copied token, wrapped in quotation marks. Note: Your token can be reused to migrate all instances in the same Edge Processor.
- Execute the migration command. It should look similar to the following CLI command:
./enhance-ep.sh "eyJhbGci...."
- Review the following CLI command:
- Modify the script to be executable by running the following command in your terminal:
- Verify the migration script:
- Wait for the EP instance to initialize:
- The new Edge Processor will now start and connect to the Data Management UI. This process usually takes a few minutes:
- Review the Data Management UI, and wait for the new Edge Processor instance to appear with a healthy status.
- Final verification (optional):
- Once the Edge Processor instance is displayed as healthy in the Data Management UI, run the following command in your terminal to confirm all processes are running correctly
ps -ef | grep edge | grep -v grep | awk '{print $8}' - Expected Result: You should see three lines of output like below, which represent the core processes of the new Enhanced EP instance.
Your migration to the enhanced Edge Processor is complete.$ ps -ef | grep edge | grep -v grep | awk '{print $8}' ./splunk-edge/bin/splunk-edge /home/splunker/splunk-edge/var/sup-run/pkg-splunksup1333137856/splunksup /home/splunker/splunk-edge/var/run/pkg-edge2881476095/edge_linux_amd64
- Once the Edge Processor instance is displayed as healthy in the Data Management UI, run the following command in your terminal to confirm all processes are running correctly
- Wait for the EP instance to initialize: