easyTravel is a state-of-the-art demo application for Dynatrace. It helps you evaluate or showcase Dynatrace with a realistic heterogeneous multi-tier web application.
easyTravel provides a web portal that allows users to log in, search for journeys to various destinations, select promotional journeys directly that are offered, and book a journey using credit card details.
Additionally, a Business-to-Business (B2B) web portal for travel agencies is provided where travel agencies can manage the journeys that they offer and can review reports about made bookings.
easyTravel is a multi-tier application implemented in .NET and Java. The starting of the various tiers and the enabling/disabling of different problem pattern plugins is done via a separate easyTravel Launcher.
The Launcher allows the user to conveniently switch between different demo scenarios. Each scenario can define load scripts and certain problem pattern plugins that are enabled. The scenarios can be modified or extended by changing an XML file. This is useful when giving demos and allows you to focus on problem areas that are particularly relevant for a specific demo.
Check latest published version here:
Please see this page for the security updates in easyTravel: easyTravel security updates.
You should disable monitoring of launcher (com.dynatrace.easytravel.launcher.jar easyTravel (x*)) and weblauncher (com.dynatrace.easytravel.weblauncher.jar easytravel-*-x*) processes. Otherwise, there will be no connection between application and services.
Disable process monitoring.
Only needed if you need mobile app traffic.
You have to edit "C:\Program Files\Dynatrace\easyTravel (x64)\resources\easyTravelConfig.properties"
Set following configuration properties for SaaS:
config.apmServerDefault = APM config.apmServerHost=live.dynatrace.com config.apmServerWebPort=443 config.apmServerPort=443 config.apmServerWebURL=https://live.dynatrace.com:443 config.apmTenant=<tenant_name>
When connecting to the Dynatrace Managed server:
config.apmServerDefault = APM config.apmServerHost=<managed_server_host> config.apmServerWebPort=443 config.apmServerPort=8443 config.apmServerWebURL=https://<managed_server_host>:443 config.apmTenant=<environment_id>
➡️Error during installation: "Error writing to file: UltiDevCassiniHttpRequestProcessor2.0.dll. Verify that you have access to that directory."
Ensure that Microsoft IIS (Internet Information Server) is installed and working and ensure that .NET Framework 2.0 or higher is installed.
➡️Apache HTTPD does not start, error "An operation was attempted on something that is not a socket" in error.log
This indicates that some other installed software interferes with socket network calls. A workaround is to add the following additional setting to the Apache HTTP config file at <installation_location>/apache2.2/plain_conf/plain_httpd.conf
For details, see the Apache Documentation.
➡️Internet Explorer 9 displays some pages incorrectly in compatibility mode
If Internet Explorer displays some pages with incorrect layout, (e.g. text-fields in one of the login screens are displaced or login box is displayed behind other content), you likely run Internet Explorer in "compatibility mode", where it simulates an Internet Explorer 7.
You can disable compatibility mode by clicking the blue "broken page" icon so that it is displayed in gray again.
➡️.NET Applications do not fully start on an Windows XP or Windows Server 2003 instance
See easyTravel on Windows XP and 2003 for a detailed description of the problem and a number of possible workarounds.
➡️.NET Applications do not start - "An attempt was made to access a socket in a way forbidden by its access permissions"
This problem is likely to be caused by IIS running dotNetBackend and dotNetFrontend thus blocking the port the backend is trying to use. The frontend just gets assigned another port.
➡️"Error while checking Credit Card - The system cannot find the file specified"
In 3.5.1 this can indicate that you need to update your Agent to the latest version in order to make ADK/C++ instrumentation work correctly. I.e. you should at least install the Update "April 2011", make sure to also update the agent dlls as well.
If you rather stay with the current agent and would like to work around this problem you can go to the Problem Patterns tab in the easyTravel launcher and deactivate the plugins “NamedPipeNativeApplication” and “NamedPipeNativeApplication.NET” and instead activate “DummyNativeApplication” and “DummyNativeApplication.NET”
➡️.NET Applications running slow on Firefox
If the .NET-Application seems to be running slow in Firefox on localhost, try using the ip-address instead or add localhost to network.dns.ipv4OnlyDomains in the Firefox configuration, enter the following in the address bar "about:config" to access Firefox configuration.
➡️iOS easyTravel App does not install
This problem is likely to be caused by multiple network interfaces (e.g. from VMWare) on the easyTravel host. To override the host auto detection for the iOS App download configure appleMobileHost in C:\Program Files (x86)\dynaTrace\EasyTravel\resources\easyTravelConfig.properties to the IP address of your easyTravel frontend.
➡️iOS easyTravel App does not install due to connection error
You are getting an error like "Cannot connect to x.x.x.x" or "Cannot install applications because the certificate for x.x.x.x is not valid". This problem is caused by apple by requiring an SSL-Connection to install the app via direct link. You have install the self-signed SSL-Certificate, which can be found in the “iOS App Installation”-section on the "About"-page.
The overall architecture consists of:
Estimated main memory usage of default scenario, measured as "process private bytes" on Windows OS:
Launcher (includes Java DB)
Credit Card Authorization
The easyTravel Launcher starts up all the processes for the different tiers and also allows a user to enable/disable different problem patterns - known as plug-ins. A configuration of running processes and plug-ins is called a scenario.
In order to focus the demo to the interests of the audience, the scenarios are grouped. By default the easyTravel Launcher offers two scenario groups:
Sometimes the default scenarios and groups may not fit your needs. Maybe your audience is not interested in .NET or you want to enable a certain plugin to demonstrate special Dynatrace capabilities. In this case, you have the possibility to set up your own scenarios and groups.
On the first startup of the easyTravel Launcher a default scenario configuration file is created. The scenarios.xml file can be found in USER_HOME\.dynaTrace\easyTravel <version>\easyTravel\config. In order to customize your scenario setup you can edit this configuration.
Because the easyTravel Demo Application and consequently the default scenario configuration may change in further versions, your customized file might be replaced by a new configuration file after an update. The old configuration file is backed up in the original directory.
Since easyTravel for 4.2, you can put your scenario-definitions in a file userScenarios.xml in the config directory and thus avoid this overwriting.
Scenario File Structure
The scenario.xml consists of nested group and scenario tags. The following excerpt shows a common structure:
<group order="1" title="Group Title"> <scenario enabled="true" order="1" title="Scenario Title"> <description>Scenario Description</description> <procedure id="inprocess DBMS" order="1"/> <procedure id="database content creator" order="2"/> <procedure id="business backend" order="3"/> <procedure id="customer frontend" order="4"/> <procedure id="credit card authorization" order="5"/> <procedure id="payment backend" order="6"/> <procedure id="b2b frontend" order="7"/> </scenario> </group>
The procedure elements describe the tiers of the scenario. The order attribute of the group and scenario elements define the sequence they are listed in the easyTravel Launcher. The order attribute of the procedure elements defines the startup sequence of the tiers.
Let's assume we want to define a new group with a single scenario. The scenario should run without B2B Frontend and the "SmallMemoryLeak" plugin has to be enabled in order to simulate a memory leak:
<group order="1" title="Example Group"> <scenario enabled="true" order="1" title="Example Scenario"> <description>This is an example scenario</description> <procedure id="inprocess DBMS" order="1"/> <procedure id="database content creator" order="2"/> <procedure id="business backend" order="3"> <setting name="SmallMemoryLeak" type="plugin" value="on"/> </procedure> <procedure id="customer frontend" order="4"/> <procedure id="credit card authorization" order="5"/> <procedure id="payment backend" order="6"/> </scenario> </group>
Settings on Procedure Level
Procedures support a few specific settings and additionally allow to override any of the global properties that you have in the easyTravelConfig.properties file.
Specific settings are available for the following types of procedures:
<setting name="DatabaseCleanup" type="plugin" value="off"/>
<setting name="DummyPaymentService" type="pluginhosts" value="dynaday13fall" />
Setting global properties on procedure-level via type="procedure_config" only makes sense if you have multiple procedures of the same type and want to set different settings for these or if you use multiple scenarios and one of them requires different settings. Otherwise it is probably easier to specify them in the global property file, ideally in a easyTravelLocal.properties in the C:\Users\...\config directories.
Solved! Go to Solution.
Hi, I've tried to run easyTravel on Raspberrypi 4 with Ubuntu 22.04. The installation process was successful but I was not able to run it because of an error:
/home/ubuntu/easytravel-2.0.0-x64/weblauncher/weblauncher.sh: 13: ../jre/bin/java: Exec format error
Can easyTravel be deployed on Raspberry Pi? Did you have the same issue?
Hi, I am trying to start the application on CentOs Linux 7 hosted on AWS(noGUI). Getting an error :
WebLaunche WARN [DocumentStarter] Exception occurred while opening URL: http://localhost:8094/. Exception: Cannot run program "firefox": error=2, No such file or directory
Can anyone plz provide a solution for this?
You can run the app by executing the runEasyTravelNoGUI.sh script located in the root directory, but no configuration options are available if you use this method.
What I have seen is that no browser traffic is generated this way, but you can access the easyTravel page by browsing to http://<your_easytravel_host_ip>:8079, which should load up the page and RUM data comes through.
Hi, I installed easyTravel on a centos on azure.
I would like that the loadgenerator is presented to the app towards the public IP instead of localhost.
Is this possible?
This would save me from doing manual traffic and creating synthetics to simulate it.
Hi @Lufecita22, the memory requirement for the easyTravel components is around 800MB as measured on Windows using the default scenario, according to the table in the original post. Keep in mind that some scenarios may require more or less memory to run, it depends on what the scenario entails.
From my own tests, I'd say a bare minimum of 2GB memory on Linux, and 4GB memory on Windows. For both Linux and Windows, 2 CPU cores (vCPUs) should suffice. If you find that these values don't work, let us know your experience and settings 🤓
@andre_vdveen I agree with you 100% and is the exact same experience I've had. And those i would say are the absolute minimum (2GB Linux, 4GB Windows). Anything less I get some very odd behavior from the system and moments of unresponsiveness, such that I've had to -9 the VM.
To be reliable, on Windows, I've had to run at 8GB. 8GB is costly so that means I can't run it all the time, instead only when I need it. Even so, it's worth it, this is a really cool tool Dynatrace provides and happy to see are maintaining it.
Hello, the same thing happened to me with these two servers, can anyone tell us which versions of Linux are compatible?
sudo /bin/bash installChromeDeps.sh
Sorry, Ubuntu 22.04.1 LTS is not supported.
Sorry, AlmaLinux 8.7 (Stone Smilodon) is not supported.
Thank you. The original post still says
"You should disable monitoring of launcher (com.dynatrace.easytravel.launcher.jar easyTravel (x*)) and weblauncher (com.dynatrace.easytravel.weblauncher.jar easytravel-*-x*) processes".
I assume that now turning off deep monitoring for weblauncher.jar is sufficient, correct?
Correct. You just have to turn it off for the one you are using and you can find in Dynatrace.
Depending on the way you start easyTravel you will have one "*launcher" jar file monitored - if you don't disable it's monitoring you won't get any RUM data. There are a few ways/scripts to start easyTravel and they may use different "launchers" 🙂
Hello Dynatrace Team,
Currently, the link to download easyTravel is giving me an error of not being able to access the page to download. Not sure if it is something on my end or your end.
Any help is appreciated. Thank you.
Well, it is hard to say what is wrong. So let's go with the flow:
So ... this is all I can think of right now. Can you look through my suggestions and say if there is anything out of order that you have noticed? If there are no discoveries then please tell me:
Hope these will help us recreate the problem.
I have followed all your suggestions but the problem persists.
I think the problem is due to the fact that ports 9000 and 9010 are occupied by another application. As you can see from the window that appeared when I reinstalled the application.
Regarding the previous questions: I have windows 11, the version of easyTravel is 22.214.171.12451, ,I didn't change anything during the installation other than the checkbox for IIS and I ran the standard scenario, but the same problem occurs with the others.
Do you think it is the port? How can I solve it?
Well, if the ports are in use by a different application then that probably is the main cause of the problem. You can double check by going to you local addresses and checking if you see our easyTravel stuff or not, I mean trying to go to:
But I guess these won't work. So I have 3 solutions for you:
Set a different port for PaymentService and Frontend. Just set the same value for range start and end of frontend. Apart from doing this, you need to go into the IID applications and rebind them. Restart the sites in IIS as well. After that restart easyTravel. It should work.
config.paymentBackendPort=9010 config.b2bFrontendPortRangeStart=9000 config.b2bFrontendPortRangeEnd=9009
Running a Linux install. When I try to run the "/bin/bash installChromeDeps.sh" cmd,
I get this error: "Sorry, Red Hat Enterprise Linux 8.7 (Ootpa) is not supported."
Also, When I run "./weblauncher.sh" I am not able to access the weblauncher via "ip.address:8094" with ip.address being the local 10.xx.xx.xx IP. Is there something I'm missing? Could the above error of from the "/bin/bash installChromeDeps.sh" cmd cause the weblauncher to not be accessible?
So... The short answer is: we don't support Red Hat by default, so I don't know what is going on. Please use a supported distribution.
The long answer is:
So in the end, I would suggest to install easyTravel on a linux distribution that is supported. I will update the information above to make this more obvious.
But if you want to play with it on Red Hat, you can try to look into this directory "/home/YOUR_USER/.dynaTrace/easyTravel 2.0.0/easyTravel/log". There you should be able to find some clues to the errors/exceptions happening somewhere...
You can use `com.dynatrace.easytravel.home.dir.correction`. Note it is relative to the c:\Users\<userId>\.dynaTrace\easyTravel 2.0.0 directory. For example adding
will create directories log, config etc in c:\tmp
I tested it by modifying startup script C:\Program Files\dynaTrace\easyTravel (x64)\weblauncher\weblauncher.cmd:
%LAUNCHER_JAVA% -Djava.net.preferIPv4Stack=true ^
%COVERAGE_ARG% %LAUNCHER_ARGS% -Dcom.dynatrace.easytravel.install.dir.correction=.. -Dcom.dynatrace.easytravel.home.dir.correction=\..\..\..\..\tmp -Dorg.eclipse.rap.rwt.enableUITests=true ^ -Djava.security.auth.login.config=../resources/login-module.config ^
-jar ..\com.dynatrace.easytravel.weblauncher.jar %*
Are you running <et_install_dir>\weblauncher\weblauncher.cmd?
I checked again. Only some logs landed in c:\tmp directory.
To get backend and frontend logs modify this line in <et_install_dir>\resources\easyTravelConfig.properties:
However I noticed that after those changes headless load generator (chrome) is crashing. 😞 So I don't recommend using it.