BigFix Enterprise Suite Client Workflows
for
IBM Tivoli Orchestrator V2.1.0


Introduction

This guide contains information on the requirement to use the BifFix Enterprise Suite (BES) Client Workflows. It will outline the BigFix installation requirements with IBM Tivoli Provisioning Manager and show how to use the BigFix Client Workflows to install, uninstall, start and stop the BigFix Client.

This driver is intended for use with the IBM Tivoli Provisioning Manager V2.1.0 and IBM Tivoli Orchestrator V2.1.0.

Driver Components

Driver Components
File Description
BigFix Workflow Help Guide.html A help guide to setting up BigFix and using the Tivoli workflows.
BES_Install_Client.wkf A workflow to install BigFix Clients.
BES_UnInstall_Client.wkf A workflow to uninstall BigFix Clients.
BES_Client_Start.wkf A workflow to start the BigFix Client service.
BES_Client_Stop.wkf A workflow to stop the BigFix Client service.
README.txt Licensing information.
tc-driver.xml The XML file that allows for the correct import of the BigFix Automation Package into Orchestrator.

Requirements

The following software products are required in order to successfully install and configure the BigFix Automation Package:

  • IBM Tivoli Provisioning Manager V2.1.0
  • IBM Tivoli Orchestrator V2.1.0
  • BigFix Component installer

Logical Operations

BigFix workflows make use of several Orchestrator logical operations. The following table summarizes the operations used, along with a description of the logical operation.

Logical Operations
Logical operation Description
Device.ExecuteCommand Executes a cygwin command on the target machine. Used to Unzip files, change file permissions, erase files and start and stop BigFix Client services.
Device.CopyFile Copies files between computers. Used to copy the BigFix Client installation zip file to a target machine.

Installation and Configuration

Perform the following steps to install the BigFix driver:

  1. Copy BigFix_Client_Controls.tcdriver to <TIO_HOME>/drivers
  2. Change directory to <TIO_HOME>/tools
  3. Run <tc-driver-manager> installDriver BigFix_Client_Controls
  4. Run BES_4_1_3_33_es.exe to create the BigFix Installation components on your BigFix Server machine. Visit BigFix Support for more information on installing BigFix Components.
  5. The folder BESInstallers will be created in the previous step. Compress the BESInstallers/Client folder into a zipped file called BigFix_Client.zip.
  6. Place the BigFix_Client.zip in the "bigfix" folder that is created by installing the tc-driver.xml (default location for the bigfix folder is in your tivoli repository, C:\IBM\tivoli\thinkcontrol\repository\bigfix\).

BigFix Workflow Usage

Workflow
File Description
BES_Install_Client.wkf Parameters:
SourceDeviceID - The ID for the computer which is the BigFix_Client.zip file in its repository.
DestinationDeviceID - The ID for the computer to install the BigFix Client on.
Details:
The workflow will copy the BigFix_Client.zip file to the DestinationDeviceID computer, unzip it, change the permissions, run the setup.exe file and erase the copied and unzipped files. Setup.exe runs silently, will automatically install the BigFix Client on the C: drive and the BigFix Client service will automatically start after insallation.
BES_UnInstall_Client.wkf Parameters:
SourceDeviceID - The ID for the computer which is the BigFix_Client.zip file in its repository.
DestinationDeviceID - The ID for the computer to uninstall the BigFix Client on.
Details:
The workflow will copy the BigFix_Client.zip file to the DestinationDeviceID computer, unzip it, change the permissions, run the setup.exe file and erase the copied and unzipped files. Setup.exe runs silently with the uninstall option enabled.
BES_Client_Start.wkf Parameters:
TargetDeviceID - The ID for the computer to start the BigFix Client service.
Details:
This workflow will start the BigFix Client service on the TargetDeviceID computer.
BES_Client_Stop.wkf Parameters:
TargetDeviceID - The ID for the computer to stop the BigFix Client service.
Details:
This workflow will stop the BigFix Client service on the TargetDeviceID computer.

Troubleshooting

Visit the BigFix Support Site for help using BigFix, downloading the installation files, creating the BigFix Installers, configuring BigFix and troubleshooting BigFix. Please read through the BigFix support site and become comfortable using BigFix before trying to deploy the BigFix Client in your system. The workflows are very simple in use to deploy a BigFix Client assuming you are comfortable with the BigFix system.

Please contact enterprisesupport@bigfix.com for help using workflows.