Welcome
Installation Guide
Learn the system requirements, licensing and installation instructions, and how to configure and maintain BigFix.
Managing relays
Relays can significantly improve the performance of your installation.
Assigning relays to clients
When you have set up a relay you must direct BigFix clients on your network to gather from that relay, instead of from your server.
Assigning relay at client installation time
By default, the BigFix clients are configured to connect to the main BigFix server at installation time.
Mac Clients
You can optionally use the clientsettings.cfg file to create custom settings on a Mac Client, for example to assign the new Client to a specific parent relay.

BigFix Documentation Homepage
BigFix 11 Platform Documentation
Welcome to the BigFix Platform documentation, where you can find information about how to install, maintain, and use BigFix.
Detailed system requirements
The content of this page has moved to the HCL Support site. You will be redirected shortly. If the auto-redirect fails for some reason, use this link: https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0104120.
Platform guides in PDF format
Following is a list of links to the BigFix Platform user guides in PDF format:
Common Criteria Certification
BigFix 10.0.1.41 complies with the requirements of the standard ISO/IEC 15408 (Common Criteria) v. 3.1 for the assurance level: EAL2
Getting Started
Use this section to become familiar with BigFix infrastructure and key concepts necessary to understand how it works.
HTTPS across BigFix applications
This topic describes how the SSL/HTTPS communication works in BigFix applications and links the tasks on how to configure it.
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 V11 gathers data from BigFix clients deployed with different code pages and languages. It encodes all data into UTF-8 format, and reports it back to the BigFix server.
- Sample deployment scenarios
  The following deployment scenarios illustrate some basic configurations taken from actual case studies.
- 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.
  - Relay requirements and recommendations
    Generally, a relay uses minimal resources and does not have a noticeable impact on the performance of the computer running it.
  - Setting up a relay
    To set up a relay, you must designate a Windows, Red Hat Enterprise Linux, or Solaris computer that is running a client to act as the relay.
  - Installing and upgrading a relay from the command line
    You can install or upgrade a relay from the command line using the setup.exe installer command.
  - Assigning relays to clients
    When you have set up a relay you must direct BigFix clients on your network to gather from that relay, instead of from your server.
    - Assigning relay at client installation time
      By default, the BigFix clients are configured to connect to the main BigFix server at installation time.
      - Windows Clients
        To set a relay, create a file named clientsettings.cfg in the BigFix Client installation folder (setup.exe) with one of the following contents:
      - Mac Clients
        You can optionally use the clientsettings.cfg file to create custom settings on a Mac Client, for example to assign the new Client to a specific parent relay.
      - UNIX Clients
        To assign a relay to your UNIX client at installation time, perform the following steps:
      - Adding More Settings
        To add other client settings during the installation of the new client, include a line for each client setting to be set during client installation, for example, the file might look similar to:
    - Manually assigning relays to existing clients
      You might want to manually specify exactly which clients must connect to which relay.
    - Automatically assigning relays at client installation time
      As you install clients, you might want them to automatically discover the closest relay by default.
    - Automatically assigning relays to existing clients
      You can configure clients to automatically find the closest relay and point to that computer instead of the server.
    - Using relay affiliation
      Relay affiliation provides a more sophisticated control system for automatic relay selection.
    - Notes about automatic relay assignment
      The BigFix clients use a sophisticated algorithm to calculate which relay is the closest on the network.
  - Adjusting the BigFix Server and Relays
    To get the best performance from BigFix, you might need to adjust the server and the relays.
  - Assigning a relay when the server is unreachable
    After you install the client, it connects to and registers with the main BigFix server.
  - Viewing which relay is assigned to a client
    How to see which clients are selecting which relays.
  - Viewing the relay chain on the client
    Starting from Version 9.5 Patch 13, the capability to view the relay chain on a specific BigFix client was added to the product.
- 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.
- 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
  The steps to upgrade the BigFix Platform.
- SQL Server parallelism optimization
  The performance of an SQL Server database instance can often be improved by small tweaks. Performance might also be hindered by simple oversights. In fact, some SQL Server parallelism settings have suboptimal default values. Moreover, they have to be re-tuned after an hardware upgrade. Other issues might arise from inadvertent hardware configurations, especially when SQL Server is hosted on a virtual machine (VM).
- 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
  To uninstall the BigFix client installed on the various operating systems, see the following sections.
Configuration Guide
Learn how to configure BigFix according to your needs.
Console Operator's Guide
Learn how to work with the BigFix Console.
Asset Discovery User's Guide
Learn how BigFix Asset Discovery works.
Web Reports Guide
Learn how the Web Reports feature extends the power of BigFix.
BigFix Explorer Guide
Learn how the BigFix Explorer feature extends the power of BigFix.
WebUI User's Guide
Read this guide for an introduction to the WebUI tools, concepts, and terminology.
WebUI Administration Guide
Read this guide for information about installing and administering the WebUI.
Glossary
This glossary provides terms and definitions for the Modern Client Management for BigFix software and products.

Mac Clients

You can optionally use the clientsettings.cfg file to create custom settings on a Mac Client, for example to assign the new Client to a specific parent relay.

The clientsettings.cfg file must be available in the same directory as the PKG file and the actionsite.afxm file.

To set a relay, create a file named clientsettings.cfg in the BigFix Client installation folder with one of the following contents:

The file can contain one line like the following:
```
IP=http://relay.domain.com:52311/bfmirror/downloads/
```
which is automatically expanded out to define concurrently the following two settings on the Client:
```
__RelaySelect_Automatic=0
__RelayServer1=http://relay.domain.com:52311/bfmirror/downloads/
```

You can directly define the two settings, optionally with other additional settings, such as a secondary relay, for example:

__RelaySelect_Automatic=0
__RelayServer1=http://relay.domain.com:52311/bfmirror/downloads/
__RelayServer2=http://relay2.domain.com:52311/bfmirror/downloads/

The agent installer is launched via the Terminal program as a privileged user by running the following command:

{sudo} /Library/BESAgent/BESAgent.app/Contents/MacOS/BESAgentControlPanel.sh

The sudo command is not strictly needed but, authenticating as a Super User, you can perform the installation with no problems. This script has a few options that are listed if you run it without options.

Note:

The QnA executable is also included in the client installation package. On Macintosh clients, to use it you must launch the Terminal program and run:
```
{sudo} /Library/BESAgent/BESAgent.app/Contents/MacOS/QnA
```
The sudo command is optional but some inspectors run only if you are Super User (root).
The agent uninstaller is available in the .pkg install. It is located in: /Library/BESAgent/BESAgent.app/Contents/MacOS/BESAgentUninstaller.sh
The agent .dmg package is no longer available.
If you want to use the Client Compliance API on the Mac OSX system, you must request the client compliance library to the HCL Support team.