#!/bin/bash
#==============================================================================
# Copyright and license info is available in the LICENSE file included with
# the Server Deployment Package (SDP), and also available online:
# https://swarm.workshop.perforce.com/projects/perforce-software-sdp/view/main/LICENSE
#------------------------------------------------------------------------------
# This script automates a connectivity test for Perforce Helix Swarm triggers.
# This should be run on the Helix Core (p4d) server machine where Swarm
# triggers are installed. It tests settings in the swarm-trigger.config
# file including the host and trigger token, as well as testing connectivity
# from the Helix Core to the Helix Swarm server. It exercises things such as
# DNS names, HTTPS certificates (if used), current availability of the Swarm
# server/service, and network firewall rules for port 80 (HTTP) or 443 (HTTPS).
#------------------------------------------------------------------------------
# The core of the test was extracted from a Perforce Support article.
# See the 'Trigger Problems' section of the Knowledge Base article
# Troubleshooting Helix Swarm: https://community.perforce.com/s/article/3696
#------------------------------------------------------------------------------
set -u
declare ThisScript=${0##*/}
declare ThisUser=
declare Version=1.1.0
declare -i ErrorCount=0
declare Cmd=
declare TmpFile=
declare SwarmTriggerConf="${1:-/opt/perforce/etc/swarm-trigger.conf}"
function msg () { echo -e "$*"; }
function errmsg () { msg "\\nError: ${1:-Unknown Error}\\n"; ErrorCount+=1; }
function bail () { errmsg "${1:-Unknown Error}"; exit "${2:-1}"; }
TmpFile=$(mktemp)
ThisUser=$(id -n -u)
msg "\\nStarting $ThisScript v$Version as $ThisUser@${HOSTNAME%%.*} at $(date)."
# shellcheck disable=SC1090
source "$SwarmTriggerConf" || bail "Could not read Swarm Trigger conf file: $SwarmTriggerConf\\nTry: $ThisScript /path/to/swarm-trigger.conf"
Cmd="wget --timeout 10 --post-data shelve,1234 ${SWARM_HOST}/queue/add/${SWARM_TOKEN}"
msg "Testing Swarm access with:\\n\\t$Cmd"
$Cmd > "$TmpFile" 2>&1
cat "$TmpFile"
if grep -q "200 OK" "$TmpFile"; then
msg "\\nVerified: Access to Swarm was successful using settings in: $SwarmTriggerConf"
else
errmsg "\\nDid not get expected '200 OK' output accessing Swarm using settings in: $SwarmTriggerConf"
fi
exit "$ErrorCount"
| # | Change | User | Description | Committed | |
|---|---|---|---|---|---|
| #5 | 30107 | C. Thomas Tyler | Enhanced swarm_triggers_test.sh to handle VERIFY_SSL=0 setting in Swarm trigger conf. | ||
| #4 | 29923 | C. Thomas Tyler |
Updated HTML hyperlinks to use 'portal.perforce.com'. This replaces currently broken links to 'answers.perforce.com' and currently redirected links to 'community.perforce.com'. #review-29924 |
||
| #3 | 29013 | C. Thomas Tyler | chmod +x | ||
| #2 | 28787 | C. Thomas Tyler |
Enhanced Swarm triggers test to help ensure self-signed https certs work with Swarm triggers. |
||
| #1 | 28614 | C. Thomas Tyler | Added sample utility to test Swarm triggers. |