Getting Started

This document is for users who want to use the Dothive application and to get information about the application itself. Before going further, if you haven't signed up with Dothive please do so using this link. Let's continue with the agent installation process.

Create Device

First, you have to create a device. For that, you have to go to the devices menu in your Dothive dashboard. Under that, click on the create device button. In the Create Device popup give a name for the device and click, create button, which will create a new device and a unique token. This token will be used later in the process.

Alt for image
Image in lightbox

Agent Installation

Linux

To install the Dothive agent in your Linux system follow the steps below

  1. Create a device with the help of the above step.
  2. Next, run this command in the Linux system which you want to install the agent for
                            sudo su -c "sh <(wget -qO- https://dothive-prod.s3.ap-southeast-1.amazonaws.com/public/dothive_agent_install.sh) i" root
    This command will download the latest agent installation script and run it.
  3. Once the script is started it will prompt for your organization name. Enter the organization which you used during the signup process.
  4. Then the script will ask for a unique token for the agent. Copy the token generated while creating the device in the dashboard (if you have not created a device follow this to create new device) and paste it here.
  5. The script will auto-detect your system architecture. If it failed to find, it will prompt your system architecture. Type your architecture and hit enter.
  6. That is all you have to provide, the script will download the latest agent from the server and set up all the services in your system.
  7. Once the installation is completed the agent service will start automatically. Initially, the device will be blocked. You have to unblock the device from the dashboard. Select your new device from the list of devices and choose, unblock and save to reflect changes. Now the device can communicate with the Dothive servers. You can play around with the features from your Dothive dashboard. For a detailed explanation of all the features in the dashboard, check it out here
Remove Dothive Agent (Linux)

To remove the dothive agent run the following command from the directory where dothive_agent_install.sh is.

$ ./dothive_agent_install.sh delete

Android

Prerequisite: ADB drivers should be pre-installed in your pc for installing the agent to your android device. To download ADB drivers checkout this website

  1. Create a device with the help of the above step
  2. Download the installation script on your system using the link below.
  3. Now you need to connect your android device with the pc using adb. Enable USB debugging in your android device developer settings. Adb can be connected either using an USB cable or wireless.
  4. To connect ADB Wirelessly follow these steps.
    • Enable wireless adb in settings or you can download an app called WADB.
    • Next you need to find your device IP Address, which can be seen in settings under wifi status or if you are using the WADB app, the IP address will be displayed under wireless adb.
    • Now user this command to connect to adb.
      $ adb connect [DEVICE_IP]
      Once adb is connected, Allow access in your android device.
  5. To connect ADB using USB, Connect your device to the PC using a USB cable and allow access in your android device. You can check if your device is connected by running the command.
    $ adb devices
    which lists out the devices connected over ADB. If your device shows up you are good to go.
  6. Now push the downloaded script to your android device using the below command.
    $ adb push dothive_agent_install.sh /data/local/tmp/dothive_agent_install.sh
  7. Now, it's time to remount your system. This step involves changing the mount status of your file system, allowing you to make modifications or access certain areas that might have been restricted. In order to proceed, you can use the following command:
    $ adb remount
  8. If you encounter the following error while using the 'adb remount' command:
    $ adb remount remount of the / superblock failed: Permission deniedremount failed
    This error typically indicates that the attempted remount operation was denied due to insufficient permissions.
  9. In this situation, you might need to take the following steps to resolve the issue:
    $ adb disable-verity$ adb reboot
    • This command can potentially disable the verity check, which might be blocking the remount operation due to security restrictions.
    • After running the 'adb disable-verity' command, it's recommended to reboot your device. This step allows the changes to take effect and clears any previous remount restrictions.
    • Once your device has rebooted, you can attempt the following command again:
    • $ adb remount
  10. Now enter the following commands to gain shell access for your device and run the script.
    $ adb shell$ cd /data/local/tmp$ chmod 777 dothive_agent_install.sh$ ./dothive_agent_install.sh
  11. Once the script is started it will prompt for your organization name. Enter the organization which you used during the signup process. For troubleshooting adb checkout this article.
  12. Then the script will ask for a unique token for the agent. Copy the token generated while creating the device in the dashboard (from step 1) and paste it here.
  13. That is all you have to provide, the script will download the latest agent from the server and set up all the services in your system.
  14. Once the installation is completed the agent service will start automatically. Initially, the device will be blocked. You have to unblock the device from the dashboard. Select your new device from the list of devices and choose, unblock and save to reflect changes. Now the device can communicate with the Dothive servers. You can play around with the features from your Dothive dashboard. For a detailed explanation of all the features in the dashboard, check it out here
Remove Dothive Agent (Android)

To remove the dothive agent run the following command from the directory where dothive_agent_install.sh is.

$ ./dothive_agent_install.sh delete

Windows

  1. Create a device with the help of the above steps.
  2. Download the installation script on your system using the below link. https://dothive-prod.s3.ap-southeast-1.amazonaws.com/public/dothive_windows_install.bat
  3. Once the script is started it will prompt for your organization name. Enter the organization which you used during the signup process.
  4. Then the script will ask for a unique token for the agent. Copy the token generated while creating the device in the dashboard (from step 1) and paste it here.
  5. Once the installation is done its need to be restart your system to run agent. Initially, the device will be blocked. You have to unblock the device from the dashboard. Select your new device from the list of devices and choose, unblock and save to reflect changes. Now the device can communicate with the Dothive servers. You can play around with the features from your Dothive dashboard. For a detailed explanation of all the features in the dashboard, check it out here.

Getting Started