Match agent version to running server (install_bigfix)

[atlauren]

I suggest a -match option that explicitly installs the agent version that matches the running server. The server version is available in the HTTP Server header.

Server: BigFixHTTPServer/9.2.7.53

Affected Files:

• https://github.com/jgstew/tools/blob/master/bash/install_bigfix.sh
• https://github.com/jgstew/tools/blob/master/CMD/install_bigfix.bat

[atlauren]

Whoops. I didn't attach this to the file. Will reopen.

[atlauren]

Reopening as I apparently misunderstand github.

Affected Files:

• https://github.com/jgstew/tools/blob/master/bash/install_bigfix.sh
• https://github.com/jgstew/tools/blob/master/CMD/install_bigfix.bat

[jgstew]

Is this version available in the header returned by relays as well? I've never actually looked.

This is not a bad idea, but there is absolutely no reason that the agent and server versions must match. Newer or older is generally fine. I typically install the newest version available to new clients, even if I have no plans to upgrade the server version in the near future.

[atlauren]

The relay install fixlets only apply for the agent version that matches the running server. Ergo, if you intend the machine to be a relay (as I am building in a kickstart), matching the server version is valuable.

[atlauren]

I just checked one of my relays, and the header is there as well.

[jgstew]

This is a good point about relays. Technically client versions don't have to match the relays or the servers, and that should include relays themselves, but it does make sense that the relay itself should have the same version client as it has relay.

Are you going to make your code public? I have been thinking of making a relay kickstart script like this client one, which would probably incorporate this client install code as well. The idea would be to provide the parent relay as the location for the masthead file, and it would then install the client and relay on the system, with the parent relay set as the primary relay automatically.

Actually, if you are making a relay kickstart, then you would just set the version variable to the version from the header and it would just do its thing automatically. The relay kickstart shouldn't run this code, it would incorporate it so you would only need 1 script instead of 2.

[atlauren]

Putting stuff here while I noodle on this:

SERVERVERSION=`curl -sD - http://$RELAYFQDN:52311 | grep Server | awk -F/ '{print $2}'`

[atlauren]

My adaptation is below. This adds/changes:

• required -fqdn switch
• optional -match switch
• handling of cmd line switches
• output usage instructions on invalid input
• test connection to FQDN, error out if unsuccessful.
• if -match is used, use server version from supplied fqdn

Start/end the replace with the first and last lines, inclusive.

command_exists () {
  type "$1" &> /dev/null ;
}

function do_usage {
    echo "Usage: -fqdn ROOTSERVERORRELAY [-match y]"
    echo "  -fqdn  - FQDN for BigFix root server, or relay. Required."
    echo "  -match - Installs the agent version running on the server/relay. Optional."
    echo "         Ignored without parameter 'y'."
    echo "         (Default behavior installs the script's stored URLVERSION.)"
    exit 1
}

if [[ $# = 0 ]] ; then
    do_usage
fi

# - http://stackoverflow.com/a/14203146
while [[ $# > 0 ]]
do
key="$1"

case $key in
    -fqdn)
    FQDN="$2"
    echo $FQDN
    shift # past argument
    ;;
    -match)
    MATCH="$2"
    echo $MATCH
    shift # past argument
    ;;
    *)
esac
shift
done

if [[ -n $FQDN ]] ; then
    CURLRESULT=`curl -s -S http://$FQDN:52311 -o /dev/null 2>&1`
        if [[ -n $CURLRESULT ]] ; then
            echo "CONNECTION ERROR: "$CURLRESULT
            exit 1
        fi
    RELAYFQDN=$FQDN
    echo "RELAYFQDN="$RELAYFQDN
    MASTHEADURL="http://$RELAYFQDN:52311/masthead/masthead.afxm"
    echo "MASTHEADURL="$MASTHEADURL
else
    do_usage
fi

# these variables are used to determine which version of the BigFix agent should be downloaded
# these variables are typically set to the latest version of the BigFix agent
# URLMAJORMINOR is the first two integers of URLVERSION
#  most recent version# found here under `Agent`:  http://support.bigfix.com/bes/release/
if [[ $MATCH = "y" ]] ; then
    URLVERSION=`curl -s -D - http://$RELAYFQDN:52311 -o /dev/null | awk -F/ '/Server/ {print $2}' | tr -d "\r"`
    else
    URLVERSION=9.5.2.56
fi
echo "URLVERSION="$URLVERSION
URLMAJORMINOR=`echo $URLVERSION | awk '/./ {gsub(/\./, " "); print $1 $2}'`
echo "URLMAJORMINOR"=$URLMAJORMINOR

# check for x32bit or x64bit OS

[atlauren]

Reference for the switch splitting:

# - http://stackoverflow.com/a/1420

[jgstew]

That doesn't appear to be the correct reference for switch splitting.

I was just going to ask if you had references for some of this, in particular the switch stuff.

The bummer about the lack of git history for this is that I can't see all the steps... where you started, what you tried, and how you eventually got there. This is an important part of being able to understand this stuff.

It is very useful that most of the complexity added is at the top of the file.

[atlauren]

Correct link:

# - http://stackoverflow.com/a/14203146