for learning, and playing around there is nothing better than having a separate VM that you can break. This can be either an instance in a cloud provider or a virtual machine @ localhost. On your working station you can use a docker container with an ubuntu image or https://multipass.run/. Multipass is a great way to instantiate Ubuntu VMs and runs on Linux, Mac and Windows. it's made by the Ubuntu team highly optimized.

In this Codelab we will learn how to spin a machine on Multipass and run easytravel and the Dynatrace OneAgent in there.

drawing

drawing

drawing

drawing

Recommended

⦿

Optional

○

Download & Install Multipass on your OS

Download multipass and install it depending on your OS https://multipass.run/

Show the help

multipass -h

Create a VM with x size

multipass launch --name <vm-name> --mem 4G --disk 10G --cpus 2
## e.g. for easytravel 
multipass launch --name easytravel --mem 4G --disk 10G --cpus 2

Start the VM

multipass start <vm-name>
## e.g. for easytravel 
multipass start easytravel

Shell into the VM

you can also shell into the vm with the ip but you need to set a password for the user ubuntu and enable password on the SSH service

multipass shell <vm-name> 
## e.g. for easytravel 
multipass shell easytravel

Stop the VM

multipass stop <vm-name>
## e.g. for easytravel 
multipass shell easytravel

List your VMs

multipass list

For the best experience we recommend that you enable Dynatrace monitoring.
By only providing your Dynatrace credentials the script will install the OneAgent OneAgent Operator

If you don't have a Dynatrace tenant yet, sign up for a free trial or a developer account.

Get a PaaS Token for the OneAgent

We will install the Dynatrace OneAgent programatically, for this we need a PaaS token.
Log in to your Dynatrace tenant and go to Settings > Integration > Platform as a Service. Then, create a paas token and save it since we will use it for installing the oneagent later.
Dynatrace PaaS Token

Download install script

Download help script to install Easytravel, Nginx, Docker and other utils

wget https://raw.githubusercontent.com/dynatrace-perfclinics/why-devs-love-dynatrace/main/easytravel/ubuntu-setup-easytravel.sh

Add your Dynatrace credentials

## Set DT_TENANT_URL and API TOKEN
# ---- Define Dynatrace Environment ----
# Sample: https://{your-domain}/e/{your-environment-id} for managed or https://{your-environment-id}.live.dynatrace.com for SaaS
DT_TENANT_URL=
DT_PAAS_TOKEN=

Make it executable

chmod +x ubuntu-setup-easytravel.sh

Execute the script

sudo bash ubuntu-setup-easytravel.sh -i

The command needs sudo rights for installing also utils as docker so you can spin containers in an instant. The script will install easytravel, start it and it will also install the BankJob (a java app for learning how the basline of Davis works) and an NGINX reverse proxy that routes the traffic of all the EasyTravel apps to HTTP. Using a magic ip and subdomains all easytravel apps will be exposed.

Why run it in the background and where is the output of the program you say? Well, this script is actually optimized to be executed for non-interactive shells at the initialization of an instance. This is done programatically passing the script as user data while creating dynatrace environments and spininning multiple instances for each student. This is achieved with the Dynatrace Rest Tenant Automation programm. Yes, we love ❤️ automation 🤖and the customization, creation and configuration of environments and instances is done programatically.

🔍Inspect the script at runtime

This is optional just for you to know where the output of Easytravel is being piped out. Each Easytravel component writes is logs. You can check them on the Admin console of Easytravel
To inspect how the installation is going, type

less +F /tmp/easytravel-install.log

This will open the installation log and read from the input stream. To exit just type CTRL + C and then quit.

A complete installation looks like this:

.
..
[EasyTravel-Installation|INFO] [2021-03-30 11:36:01] |>->-> Configuring EasyTravel Memory Settings, Angular Shop and Weblauncher. <-<-<|
***EasyTravel launched**
Tue Mar 30 11:36:01 UTC 2021
installation done
[EasyTravel-Installation|INFO] [2021-03-30 11:36:01] |======================================================================
[EasyTravel-Installation|INFO] [2021-03-30 11:36:01] |============ Installation complete :) ============
[EasyTravel-Installation|INFO] [2021-03-30 11:36:01] |______________________________________________________________________
[EasyTravel-Installation|INFO] [2021-03-30 11:36:01] |>->-> It took 3 minutes and 1 seconds <-<-<|

Verify the log of the running Easytravel App

less +F /tmp/weblauncher.log

Check running containers

Docker is installed on the system. There are two running containers, one is a java app called "BankJob" another is nginx working as a reverse proxy for multiple endpoints of Easytravel

docker ps

stop all containers

docker stop reverseproxy bankjob

start all containers

docker start reverseproxy bankjob

The load generation for EasyTravel is defined in the easyTravelConfig.properties file which is setted up during the installation. The properties starting with config.baseLoad.. are the ones defining these values (changed at installation). Also you can manage set this values manually by accessing the http://easytravel/admin interface and moving the slider manually.

By default at installation the script will fill the DOMAIN variable with curl ifconfig.me to get the public IP since easytravel classic has some 3rdparty content servers where you can analyze with the RUM capabilities of Dynatrace the impact of 3rd party resources.

http://127.0.0.1.nip.io

drawing

http://classic.127.0.0.1.nip.io

drawing

http://admin.127.0.0.1.nip.io

drawing

http://classic.127.0.0.1.nip.io/amp

drawing

http://rest.127.0.0.1.nip.io

drawing

Internal REST Services of EasyTravel as well as a the Configuration REST Service to activate/deactivate feature flags, problem patterns and deployments remotely.

Kill all processes

ps -ef | grep -i easytravel | awk '{print "sudo kill -9 "$2}' | sh

Start easyTravel as UBUNTU (not root)

If you happen to install easytravel as root, you might want to change recursively all the rights of the easytravel installation folder so all processes can run properly

sudo bash ubuntu-setup-easytravel.sh -s

Fix easyTravel rights

chmod 755 -R /home/ubuntu/easytravel-2.0.0-x64/

Fix easyTravel ownership

chown ubuntu:ubuntu -R /home/ubuntu/easytravel-2.0.0-x64/

Check if there are running easytravel leftovers (processes)

ps -aux | grep -i easytravel

Restart all with a one-liner (must be root)

sudo bash ubuntu-setup-easytravel.sh -k

Disable monitoring of launcher

For RUM to work properly (for the classic app e.g. Loadgenerator) you need to disable deep monitoring for the weblauncher process.

On the entity select edit...
drawing

Then disable monitoring for that process group instance...
drawing

easyTravel documentation

https://confluence.dynatrace.com/community/display/DL/easyTravel