Manual Deployment

Agent Deployment Outside the Auditor Management Console

Ensure the Management Server is installed before you deploy any agents. After you confirm the server is installed:

1. Define the database permissions in SQL Server. The Domain Controllers computer group must have the Auditor database role on the Auditor database.
2. Copy the following two files to a central distribution point such as a file share. For example, \\server\share\test (file://server/share/test). Both files must be copied to all Domain Controllers.
   • For versions prior to 5.7 or upgrades to 5.7:
     - C:\Program Files\BeyondTrust\PowerBroker Management Suite\Server\BlackbirdServer.installdata
     - C:\Program Files\BeyondTrust\PowerBroker Management Suite\Server\DataHandler\x64\DataHandler.exe
   • For a new install of version 5.7 or later (not an upgrade):
     - C:\Program Files\BeyondTrust\PowerBroker Auditing & Security Suite\Server\BlackbirdServer.installdata
     - C:\Program Files\BeyondTrust\PowerBroker Auditing & Security Suite\Server\DataHandler\x64\DataHandler.exe
3. In the space chosen for distribution, rename the BlackbirdServer.installdata file to DataHandler.installdata.
4. Copy the files to each Domain Controller and then run the install and the following configuration steps from each Domain Controller:

md "c:\program files\common files\BlackBird"
copy \\servershare\backbird\*.* "c:\program files\common files\BlackBird"
"c:\program files\common files\blackbird\datahandler.exe" /install
sc config datahandler start= auto
net start datahandler

Optionally, use PsExec to call the text file list of Domain Controllers and run the file on each of them. This will save the effort of running the above command on all individual Domain Controllers.

Run command:

psexec @s:\dclist.txt -d -h -u "domain\username" -p "password" cmd /c “\\myserver\myshare\install-pba.bat”

Cross Forest Support

Agent deployment flag for cross forest:

/installex

It takes either the install GUID, which can be found in the BlackbirdServer.installdata file (location indicated in step 2 above).

/installid=<install guid>

OR the database settings can be specified with the following flags:

• /sqlserver=
• /sqldb=
• /sqlauth=NT/SQL
• /dbuser=
• /dbpass=
• /dbuser & /dbpass

Can be either the SQL Authentication credentials, if /sqlauth=SQL, or Windows Domain credentials, if you leave /sqlauth out.

Examples:

/sqlauth=SQL /dbuser=sa /dbpass=password 

or

/dbuser=pbms\dbusername /dbpass=password
        

Then run the following commands:

sc config datahandler start= auto  

net start datahandler
        

There is validation on invalid parameter combinations. Some parameters cannot be validated: correct SQL server, database, and user credentials.

Manual Uninstall

To uninstall, enter the following two commands:

netstop datahandler

c:\program files\common files\blackbird\datahandler.exe" /remove

Manual Agent Upgrade

To manually upgrade an agent to a newer version, replace the DataHandler.exe file with the newer one.

1. Enter the command:

 net stop datahandler

2. Replace the Datahandler.exe file with the upgraded one.
3. Enter command:

net start datahandler