Home
Installation Guide
Learn the system requirements, licensing and installation instructions, and how to configure and maintain BigFix.
Setting up a proxy connection
If your enterprise uses a proxy to access the Internet, your BigFix environment can use that communication path to gather content from sites.
Troubleshooting proxy connection
Common problems you might find with a proxy connection.
New site version cannot be gathered
Errors in gathering site version.

Installation Guide
Learn the system requirements, licensing and installation instructions, and how to configure and maintain BigFix.
- Introduction
  BigFix aims to solve the increasingly complex problem of keeping your critical systems updated, compatible, and free of security issues. It uses patented Fixlet technology to identify vulnerable computers in your enterprise. With just a few mouse-clicks you can remediate them across your entire network from a central console.
- BigFix Platform Unicode Support Overview
  BigFix Platform V9.5 gathers data from BigFix clients deployed with different code pages and languages, encode the data into UTF-8 format, and report it back to the BigFix server.
- Sample deployment scenarios
  The following deployment scenarios illustrate some basic configurations taken from actual case studies. Your organization might look similar to one of the examples below, depending on the size of your network, the various bandwidth restrictions between clusters and the number of relays and servers. The main constraint is not CPU power, but bandwidth.
- Requirements and assumptions
  BigFix runs efficiently using minimal server, network, and client resources.
- Types of installation
  Before you install the product, decide if you want to do an evaluation or production installation.
- Managing licenses
  You must obtain a license key before you can install and use BigFix.
- Before installing
  Before running the installation make sure that you read the following topics and run the requested activities if needed.
- Installing on Windows systems
  Now that you understand the terms and the administrative roles, you are ready to get authorized and install the programs.
- Installing on Linux systems
  After understanding the terms and the administrative roles, you are ready to actually get authorized and install the programs.
- Installing the clients
  Install the BigFix client on every computer in your network that you want to administer, including the computer that is running the console.
- BigFix Administration Tool
  The BigFix Administration Tool, also called BESAdmin, is the tool we use to perform configuration changes and maintenance operations.
- Post-installation configuration steps
  After having run the installation, make sure that you read the following topics and run the requested activities if needed.
- Managing relays
  Relays can significantly improve the performance of your installation.
- Introduction to Tiny Core Linux - BigFix Virtual Relay
  Follow the step-by-step sequence of operations needed to build the virtual machine, from the downloading of the ISO image to the complete setup and configuration of the BigFix Virtual Relay.
- Setting up a proxy connection
  If your enterprise uses a proxy to access the Internet, your BigFix environment can use that communication path to gather content from sites.
  - Enabling client polling
    If an HTTP proxy exists between a parent relay and a client or child relay, or between the server and a child node, apply this workaround to bypass a limitation, that is caused by the proxy and that affects downstream communications.
  - Connecting the console to the server through a proxy
    If the BigFix console is installed on the same system as the BigFix server and if a proxy configuration is set in Internet Explorer, then ensure that, in that configuration, the Bypass proxy server for local addresses and the Exceptions settings are correctly specified.
  - Setting a proxy connection on the server
    When you install BigFix V9.5, you are asked if you want to set up communication with a proxy.
  - Setting up a proxy connection on a relay
    Complete the following steps to allow the relay to communicate with its parent components:
  - Setting up a proxy connection on a client
    To set the proxy connection on the client, complete the following steps:
  - Best practices to consider when defining a proxy connection
  - Troubleshooting proxy connection
    Common problems you might find with a proxy connection.
    - Error Unable to get site content (failed to pass sha1 hash value checks in BESRelay.log
      Error in getting site content.
    - Error Unexpected HTTP response: 503 Service Unavailable in GatherDB.log
      Error for service unavailability.
    - How to check if the proxy configuration is correct
      Checks for proxy configuration.
    - New site version cannot be gathered
      Errors in gathering site version.
- Running backup and restore
  You can schedule periodic backups (typically nightly) of the BigFix server and database files, to reduce the risk of losing productivity or data when a problem occurs by restoring the latest backup.
- Upgrading on Windows systems
- Upgrading on Linux systems
- Known limitations and workarounds
  This section describes the known limitations and possible workarounds.
- Logging
  This section describes the log files associated with the BigFix components.
- Uninstalling the BigFix client

New site version cannot be gathered

Errors in gathering site version.

If you get the following errors when running the BigFix diagnostic tool:

Test failed: The Client Plug-in registration
Reason: Unexpected HTTP response: 504 Proxy Error: Unable to connect to
remote host "127.0.0.1:52311" or host not responding - URL
"http://127.0.0.1:52311/cgi-bin/bfenterprise/clientregister.exe?RequestType = 
version"(http://127.0.0.1:52311/cgi-bin/bfenterprise/clientregister.exe
?RequestTy pe=version%27),
errno: 111 HTTP request failed with an error.

Test failed: Plug-post results
Reason: Unexpected HTTP response: 504 Proxy Error: Unable to connect to remote 
host "127.0.0.1:52311" or host not responding - URL
"http://127.0.0.1:52311/cgi-bin/bfenterprise/PostResults.exe"
(http://127.0.0.1:52311/cgi-bin/bfenterprise/PostResults.exe%27),
errno: 111 HTTP request failed with an error.

Test failed: BESGatherMirror plug-in
Reason: Unexpected HTTP response: 504 Proxy Error: Unable to connect to
remote host "127.0.0.1:52311" or host not responding - URL
"http://127.0.0.1:52311/cgi-bin/bfenterprise/BESGatherMirror.exe/-version] 
"([http://127.0.0.1:52311/cgi-bin/bfenterprise/BESGatherMirror.exe/-version%27),
errno: 111 HTTP request failed with an error.

you do not gather the new site version. To solve the problem, complete the following steps:

Perform the steps needed to set up a proxy connection on the server, as described in Setting a proxy connection on the server, and be sure to add the following values in the exception list: localhost, 127.0.0.1, <server_IP>, <server_hostname>.
Check that the environment variable http_proxy is not configured. If it is, remove it and restart your operating system.