Switch BES Client 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 >= 710/17/2012 1:15:12 PM
2Switch BES Client Action Site Masthead (Windows)8/9/2013 1:52:20 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 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://localhost:52311/Uploads/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

    ID2552
    StatusProduction - Fully Tested and Ready for Production
    TitleSwitch BES Client 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 TABLE
    Is TaskTrue
    Added by on 8/9/2013 1:52:20 PM
    Last Modified by on 8/9/2013 1:52:20 PM
    Counters 15863 Views / 115 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

    Used in 221 fixlets   * Results in a true/false
    Show indented relevance
    (if exists property "in proxy agent context" then ( not in proxy agent context ) else true )
    Used in 24 fixlets   * Results in a true/false
    Show indented relevance
    ((if (version of client >= "8.0") then (windows of it) else (name of it starts with "Win")) AND platform id of it != 3) of operating system
    Used in 22 fixlets   * Results in a true/false
    Show indented relevance
    version of client >= "7.2"
    Used in 2 fixlets   * Results in a true/false
    Show indented relevance
    name of operating system does not contain "Win9" AND name of operating system != "WinME"
    Used in 5 fixlets and 1 analsis   * Results in a true/false
    Show indented relevance
    not exists relay service AND not exists main gather service

    Actions

    Action 1

    Action Link Click here to switch the action site masthead using a network share. You will be prompted for the full pathname to the network location of the new action site masthead file.
    Script Type BigFix Action Script 
    setting "__RelayServer1"="" on "{parameter "action issue date" of action}"  for client
    setting "__RelayServer2"="" 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
    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"
    delete __appendfile
    appendfile @echo off
    appendfile echo Your administrator is restarting the BES Client... Please Wait...
    appendfile net stop BESClient
    appendfile net start BESClient
    delete clientRestart.bat
    copy __appendfile clientRestart.bat
    runhidden 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 
    setting "__RelayServer1"="" on "{parameter "action issue date" of action}"  for client
    setting "__RelayServer2"="" 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
    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"
    delete __appendfile
    appendfile @echo off
    appendfile echo Your administrator is restarting the BES Client... Please Wait...
    appendfile net stop BESClient
    appendfile net start BESClient
    delete clientRestart.bat
    copy __appendfile clientRestart.bat
    runhidden 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!
    jgstew -
    Should "_BESClient_Register_Affiliation_SeekList" be set to "*" instead of ""?
    danielheth -
    Modified to work with any client version >= 7.2
     

    Content

    Search
    Share
    Learn
    Projects

    Utilities

    View SCM Scripts
    Base64 Converter
    Shell to Action Script

    About

    About Us
    Tour
    FAQ
    Terms
    Contact Us

    BigFix Resources

    Download BigFix
    Support
    Forum
    Github/Bigfix
    bigfix.me All Content
    Hosted on bigfixme-as