Uninstalling a UNIX or Linux Build Forge agent

Use the following instructions to uninstall the agent software from UNIX or Linux platforms.

Linux agents

To remove agent software that was installed using the rpm package:

  1. Find the agent software and list package names and versions:
    rpm -qa | grep bfagent
  2. Delete the agent software:
    rpm -e bfagent-<version_number>

Solaris agents

To remove agent software that was installed using the pkgadd program, run the following command:

pkgrm BFAgent

Other agents

For other platforms, the uninstall process is manual and varies by platform. Follow the instructions that apply to your platform and super server implementation.

Note: To run most commands, you need root access and the /sbin and /usr/sbin directories must be set in your current PATH environment variable.
  1. Remove the agent service daemon, bfagent. Use the instructions for the super server implementation (inetd, xinetd, launchd, or SMF) that applies to your platform.
    Super server Procedure
    inetd, common on older UNIX systems
    1. Edit the /etc/inetd.conf file and remove the line for the bfagent.
    2. Find the process ID for inetd.
      ps -ef | grep [i]netd

      For BSD-derived systems, such as FreeBSD and Mac OS/X 10.4 and earlier, substitute ps auwwwx for ps -ef.

    3. Read the updated inetd.conf and start inetd.
      kill -HUP <PID>
    xinetd, common on newer UNIX systems
    1. To remove the agent service, run the following command:
      rm /etc/xinetd.d/bfagent
    2. Find the process ID for inetd.
      ps -ef | grep [i]netd

      For BSD-derived systems, such as FreeBSD and Mac OS/X 10.4 and earlier, substitute ps auwwwx for ps -ef.

    3. Read the updated inetd.conf and start inetd.
      kill -HUP <PID>
    launchd for Mac OS/X and OpenBSD systems
    1. Run launchctl.
    2. Enter stop com.ibm.rational.bfagent.
    3. Enter the following command: unload /Library/LaunchDaemons/com.ibm.rational.bfagent.plist
    4. Enter quit.
    5. Run the following command: rm Library/LaunchDaemons/com.ibm.rational.bfagent.plist
    Solaris System Management Facility (SMF) for Solaris 10
    1. Run inetadm -d network /bfagent/tcp
    2. Run svccfg delete -f network/bfagent/tcp
  2. Remove the agent service from the PAM interface.
    1. Edit /etc/pam.conf and remove all lines that begin with bfagent.
    2. Run rm /etc/pam.d/bfagent
  3. Remove the protocol entry from the etc/services file.

    Edit /etc/services and remove the line for bfagent.

  4. Remove the following files installed by the agent:
    /etc/bfagent.conf
    /etc/bfagent.conf-example
    /usr/local/bin/bfagent
    /usr/local/bin/bfcrypt.dll

Feedback