You copied the Doc URL to your clipboard.

Running the gator daemon on your target

When all of the necessary files are in place, you can start gatord, the gator daemon. gatord needs to be actively running for Streamline to initiate a capture session over Ethernet or USB. This setup task applies to both Linux and Android targets.

Note

You can install and run user space gator on the target automatically by clicking the Setup target... button in the Connection Browser dialog.

To run gatord manually, follow these steps:

Procedure

  1. Copy gatord and, optionally, gator.ko into the file system on the target. On Android, you can do this on your host using adb push.
  2. To ensure gatord has execute permission, enter the following command:

    chmod +x gatord

    On Android, you can execute this command using adb shell.
  3. Optional: If gatord is in a different directory to gator.ko on the target, you must do one of the following:
    • Insert the gator.ko module manually using the following command:

      insmod gator.ko

    • Include the path to gator.ko using the -m option to gatord. For example:

      ./gatord -m /home/gator/gator.ko &

    If gatord does not exist in the same directory as gator.ko and you do not either manually insert gator.ko or include a path to it when running gatord, a user-space only version of gatord runs when the command is executed. This user-space version of gatord has most, but not all of the functionality of the standard version of gatord running with the gator.ko module.

    For more information, see README.md located in <DS-5_install_directory>/arm/gator/.

  4. After making sure that you have root privileges, enter the following to execute the gator daemon:

    ./gatord &

    By default, gatord uses port 8080 for communication with the host, but you can adjust this by launching gatord with the port number as a parameter. For example:

    ./gatord -p 5050 &

    Additionally, specify the port number using the Capture & Analysis Options dialog box by appending a colon followed by the port number to the IP address in the address field. For example, if the address is 10.99.28.54 and the port is 5050 you enter 10.99.28.54:5050. If you do not provide a port number, the default port is used.

    If you use Security-Enhanced Linux (SELinux), you might see one of the following errors when running gatord:

    • Unable to mount the gator filesystem needed for profiling.
    • Unable to load (insmod) gator.ko driver:
       >>> gator.ko must be built against the current kernel version & configuration 
       >>> See dmesg for more details

    If you see one of these error messages, enter the dmesg command for more details.

    If the output from dmesg contains the text SELinux: initialized (dev gatorfs, type gatorfs), not configured for labeling, enter the following command to disable SELinux:

    setenforce 0

    After gatord has started, you can re-enable SELinux by using the following command:

    setenforce 1
Was this page helpful? Yes No