How to uninstall and re-install the Hawk agent and the Administrator server as Windows Services in a BusinessWorks 5.X domain

Emmanuel Marchiset
2 min readOct 19, 2021

By default when a domain is created on a Windows machine a Windows service is created for the Administrator server and the Hawk agent, also when a Windows machine is added to a domain a Windows service is created for the Hawk agent.

This article is to explain how to delete those Windows services and recreate them if needed.

The Windows services can be deleted using the following approach:

. Go in C:\tibco\tra\domain\<DOMAIN NAME> folder

. Launch the hawkagent_<DOMAIN NAME> executable with the — uninstall option (note that you have to put two ‘-’), something like this (you may have to do this from a command window started with the ‘Run as Administrator’ option):

hawkagent_TESTDOM uninstall

. Go in C:\tibco\administrator\domain\<DOMAIN NAME>\bin folder

. Launch the admin_<DOMAIN NAME> executable with the — uninstall option (note that you have to put two ‘-’), something like this (you may have to do this from a command window started with the ‘Run as Administrator’ option):

admin_TESTDOM — uninstall

Note : This is normal to see the Services has disabled after deletion, they will disappear at the next reboot

To re-create the service you just have to do the same with the — install option :

. Go in C:\tibco\tra\domain\<DOMAIN NAME> folder

. Launch the hawkagent_<DOMAIN NAME> executable with the — install option (note that you have to put two ‘-’), something like this (you may have to do this from a command window started with the ‘Run as Administrator’ option:

hawkagent_TESTDOM — install

. Go in C:\tibco\administrator\domain\<DOMAIN NAME>\bin folder

. Launch the admin_<DOMAIN NAME> executable with the — install option (note that you have to put two ‘-’), something like this (you may have to do this from a command window started with the ‘Run as Administrator’ option):

admin_TESTDOM — install

The typical Administrator Server and Hawk agent Windows Services

It is recommended to configure those services with ‘Delayed Start’ and ‘Automatic restart’ options like explained in the following article :
https://emarchiset.medium.com/how-to-run-businessworks-6-x-bwagents-and-appnodes-as-windows-services-4800759c4448

--

--

Emmanuel Marchiset

I work as an Architect at TIBCO Software on Integration products. Opinions here are my own.