Switch BES Relay Action Site Masthead (Windows)
Log In or Register to download the BES file, and more.

0 Votes

Collections (part of 1 collection)

BigFix Client Settings

Versioning - This is the latest version.

1Switch BES Client Action Site Masthead - BES Relay10/17/2012 1:15:12 PM
2Switch BES Relay Action Site Masthead (Windows)8/9/2013 1:56:26 PM

Description

Sometimes it is necessary to switch the BES Client's action site masthead. The action site masthead serves the following functions:
  • Acts as a configuration file with parameters such as BES Server IP address, port number, locking behavior, etc.
  • Contains information necessary for the digital signature security scheme that BES uses (the masthead contains the public key information)
  • Contains the licensing information that allow BES users to operate BES with a specified number of users for a specified length of time

A common use for this task is to switch BES Clients and Relays from one BES Server to another. There are two methods of switching the BES Client action site masthead depending on how you would like to provide the new action site masthead.

Download the new masthead from a web server - This action will download the file from the url http://127.0.0.1:52311/masthead/masthead.afxm and use it as the new masthead. Please put the file at that location or use a custom action to change the download url.

  • Copy the new masthead from a network share - You will be prompted for the full pathname to the network location of the new action site masthead file. You may need to create a network null session share for the BES Client to access the masthead file. (example pathname: \\server_name\share_name\masthead.afxm)

    Note: The actions below will remove manual BES Relay settings from the BES Client prior to switching the BES Client masthead.

    Important Note: Please make sure the new action site masthead is valid and points to a working BES Server. Once the masthead is switched, the BES Client may not be able to report the final status of the action because they may be pointing to a different BES Server.  Due to the complexity of this action, please fully test this action before use in a production environment.


  • Property Details

    ID2553
    StatusProduction - Fully Tested and Ready for Production
    TitleSwitch BES Relay Action Site Masthead (Windows)
    DomainBESC
    CategorySupport
    Download Size0
    Sourcedanielheth@bigfix.me
    Source ID<Unspecified>
    Source SeverityLow
    Source Release Date8/9/2013 12:00:00 AM
    KeywordsBES masthead Client file Relay
    Is TaskTrue
    Added by on 8/9/2013 1:56:26 PM
    Last Modified by on 8/9/2013 2:01:39 PM
    Counters 14123 Views / 98 Downloads
    User Rating 1 star 2 star 3 star 4 star 5 star * Average over 0 ratings. ** Log In or Register to add your rating.

    Relevance

    isWindows (Relevance 274)
    Used in 593 fixlets and 3 analyses   * Results in a true/false
    Show indented relevance
    name of operating system starts with "Win"
    Used in 30 fixlets   * Results in a true/false
    Show indented relevance
    NOT exists main gather service
    Used in 85 fixlets and 10 analyses   * Results in a true/false
    Show indented relevance
    exists relay service OR exists main gather service
    Used in 16 fixlets   * Results in a true/false
    Show indented relevance
    version of client >= "7"

    Actions

    Action 1

    Action Link Click here to switch the action site masthead using a network share.
    Script Type BigFix Action Script
    action parameter query "SwitchMastheadPath" with description "Please Enter a Full Network Path to the New Action Site Masthead:" with default value "\\server_name\share_name\masthead.afxm"
    copy "{parameter "SwitchMastheadPath" of action}" "{following text of last "\" of parameter "SwitchMastheadPath" of action}"
    delete "{pathname of parent folder of regapp "besclient.exe"}\ActionSite.afxm"
    copy "{following text of last "\" of parameter "SwitchMastheadPath" of action}" "{pathname of parent folder of regapp "besclient.exe"}\ActionSite.afxm"
    setting "__RelayServer1"="" on "{parameter "action issue date" of action}" for client
    setting "__RelayServer2"="" on "{parameter "action issue date" of action}" for client
    setting "_BESRelay_GatherMirror_ClientActionSiteFolder"="{pathname of parent folder of regapp "BESClient.exe" & "\__BESData\__Global"}" on "{parameter "action issue date" of action}" for client
    setting "_BESClient_RelaySelect_FailoverRelay"="" on "{parameter "action issue date" of action}" for client
    setting "_BESClient_Register_Affiliation_SeekList"="" on "{parameter "action issue date" of action}" for client
    setting "_BESClient_RelaySelect_TertiaryRelayList"="" on "{parameter "action issue date" of action}" for client
    delete __appendfile
    appendfile @echo off
    appendfile echo Your administrator is restarting the BES Client... Please Wait...
    appendfile net stop BESRelay
    appendfile net stop BESClient
    appendfile net start BESClient
    appendfile net start BESRelay
    delete clientRestart.bat
    copy __appendfile clientRestart.bat
    run clientRestart.bat
    Success Criteria

    This action will be considered successful when the applicability relevance evaluates to false.

    Action 2

    Action Link Click here to switch the action site masthead using a URL.
    Script Type BigFix Action Script
    download "http://lab.bigfix.me:52311/masthead/masthead.afxm"
    delete "{pathname of parent folder of regapp "besclient.exe"}\ActionSite.afxm"
    copy "__Download\masthead.afxm" "{pathname of parent folder of regapp "besclient.exe"}\ActionSite.afxm"
    setting "__RelayServer1"="" on "{parameter "action issue date" of action}" for client
    setting "__RelayServer2"="" on "{parameter "action issue date" of action}" for client
    setting "_BESRelay_GatherMirror_ClientActionSiteFolder"="{pathname of parent folder of regapp "BESClient.exe" & "\__BESData\__Global"}" on "{parameter "action issue date" of action}" for client
    setting "_BESClient_RelaySelect_FailoverRelay"="" on "{parameter "action issue date" of action}" for client
    setting "_BESClient_Register_Affiliation_SeekList"="" on "{parameter "action issue date" of action}" for client
    setting "_BESClient_RelaySelect_TertiaryRelayList"="" on "{parameter "action issue date" of action}" for client
    delete __appendfile
    appendfile @echo off
    appendfile echo Your administrator is restarting the BES Client... Please Wait...
    appendfile net stop BESRelay
    appendfile net stop BESClient
    appendfile net start BESClient
    appendfile net start BESRelay
    delete clientRestart.bat
    copy __appendfile clientRestart.bat
    run clientRestart.bat
    Success Criteria

    This action will be considered successful when the applicability relevance evaluates to false.


    Sharing

    Social Media:
    Share this page on Yammer

    Comments

    Log In or Register to leave comments!