23 Feb 2022
05:46 AM
- last edited on
06 May 2022
06:20 AM
by
tomasz_wieremje
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.
Search and book a journey on the easyTravel web frontend with a realistic multi step booking process.
Start all the tiers of easyTravel and enable architecture and performance flaws by selecting a pre-configured scenario.
Check latest published version here: README.txt
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 (x64)) processes. Otherwise, there will be no connection between application and services. See steps below:
⚠️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>
⚠️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.
➡️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
Win32DisableAcceptEx
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:
Application
Technology
Memory
Launcher (includes Java DB) | Java/SWT | 225MB |
Customer Frontend | Java/Tomcat | <190MB |
Business Backend | Java/Tomcat | <190MB |
Credit Card Authorization | C++/ADK | <1MB |
Payment Backend | .NET/MVC | 65MB |
B2B Frontend | .NET/MVC | 65MB |
Overall | - | <800MB |
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.
Customization Example
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.
: 2.0.0.2660
I am with @crazlaz
Links to download and also to readme.txt are not working, Linda. Please check and update the latest ones. That would be great to share the post with everyone.
The download links should work again 😉
Would we put Customer Frontend, Business Backend, and Business Database components into different servers? How will we update the application configurations please?
Thanks.