On-Premises Agent Installation Guide

System Requirements

  • Operating System: Ubuntu (Debian-based)

  • Ubuntu Version: 18+ LTS

  • Recommended RAM: 2GB

Prerequisites

Before beginning the installation, ensure you have:

  • Access to a terminal with sudo privileges

  • Bitbucket, GitHub, Jenkins, and SonarQube credentials (if applicable)

Installation Steps

1. Create Workspace Directory

cd ~

mkdir devdynamics-agent

cd devdynamics-agent

2. Download Installation Files

Clone the stormtrooper in the devdynamics-agent directory.

git clone https://frodo-repo@github.com/devdynamics-ai/stormtrooper.git

Contact the DevDynamics team to get the Personal Access token necessary to autheticate the clone request.

3. Update System and Install Tools

sudo apt update

sudo apt install unzip

4. Extract Installation Files

unzip stormtrooper.zip

cd stormtrooper

5. Configure Agent Configuration File

Edit the dd-agent.conf file with the following sections:

Common Configuration

# Common Configuration

CRON_EXPRESSION='0 * * * *' # Runs every hour by default

ORG_CODE='ABCDEF' # Provided Organization Code

REQUEST_SIZE_THRESHOLD_IN_BYTES='200_000' # DO NOT CHANGE

DD_API_KEY='65y34f@haUy#645WWFji7463%Eadbfa543$3fa4' # DO NOT CHANGE

  • CRON_EXPRESSION: Controls the execution frequency. By default, it runs every hour.

  • ORG_CODE: Contact the DevDynamics team if you do not have this code.

  • REQUEST_SIZE_THRESHOLD_IN_BYTES: Do not modify this value.

  • DD_API_KEY: Do not modify this value.

GitHub Configuration

# Github Configuration

GITHUB_ENABLED=true

GITHUB_URL='https://api.github.com' # Replace with your Github URL if different (without port)

GITHUB_PORT='443' # Replace with your port if not default (443)

GITHUB_API_TOKENS='<GITHUB_API1>,<GITHUB_API2>'... # Replace with your Github API tokens

GITHUB_ORG_NAME='<GITHUB_ORG_NAME>' # Replace with your Github Organization name

  • GITHUB_ENABLED: This must remain true.

  • GITHUB_URL: The base URL for your GitHub application (exclude the port number).

  • GITHUB_PORT: Specify the port (default is 443).

  • GITHUB_API_TOKENS: Add the API token for your GitHub account. We recommend providing at least 3 API tokens to avoid the rate-limiting condition.

  • GITHUB_ORG_NAME: Add your GitHub Organization's name.

Bitbucket Configuration

# Bitbucket Configuration

BITBUCKET_ENABLED=true

BITBUCKET_URL='http://X.X.X.X' # Replace with your Bitbucket URL (without port)

BITBUCKET_PORT='80' # Replace with your port if not default (80)

BITBUCKET_API_KEY='<API_KEY>' # Replace with your Bitbucket API Key

BITBUCKET_USER='<USER_NAME>' # Replace with your Bitbucket username

  • BITBUCKET_ENABLED: This must remain true.

  • BITBUCKET_URL: The base URL for your Bitbucket application (exclude the port number).

  • BITBUCKET_PORT: Specify the port (default is 80).

  • BITBUCKET_API_KEY: Add the API token for your Bitbucket account.

  • BITBUCKET_USER: Add your Bitbucket username.

Jenkins Configuration

# Jenkins Configuration

JENKINS_ENABLED=true

JENKINS_URL='http://X.X.X.X' # Replace with your Jenkins URL (without port)

JENKINS_PORT='8765' # Replace with your port if not default (8765)

JENKINS_API_TOKEN='<API_TOKEN>' # Replace with your Jenkins API Key

JENKINS_USERNAME='<USER_NAME>' # Replace with your Jenkins username

  • JENKINS_ENABLED: This must remain true.

  • JENKINS_URL: The base URL for your Jenkins application (exclude the port number).

  • JENKINS_PORT: Specify the port (default is 8765).

  • JENKINS_API_TOKEN: Add the API token for your Jenkins account.

  • JENKINS_USERNAME: Add your Jenkins username.

SonarQube Configuration

# SonarQube Configuration

SONAR_ENABLED=true

SONAR_URL='http://X.X.X.X' # Replace with your SonarQube URL (without port)

SONAR_PORT='8765' # Replace with your port if not default (8765)

SONAR_API_KEY='<API_KEY>' # Replace with your SonarQube API Key

  • SONAR_ENABLED: This must remain true.

  • SONAR_URL: The base URL for your SonarQube application (exclude the port number).

  • SONAR_PORT: Specify the port (default is 8765).

  • SONAR_API_KEY: Add the API token for your SonarQube account.

6. Run Installation Script

sudo chmod +x install-deb.sh

./install-deb.sh <ORG_CODE>

Configuration Notes

  • Modify configuration values carefully

  • Do not change REQUEST_SIZE_THRESHOLD_IN_BYTES or DD_API_KEY

  • Ensure all URLs and credentials are correct

Support

For installation issues or questions, contact:

PreviousAsanaNextMetrics