Skip to main content

Run MTA on premises

Purpose​

This document describes the MTA implementation steps for customers that bring their own Mendix license and environment, either local or cloud hosted.

This could be any custom cloud environment like a Cloud Foundry or Kubernetes Pod or an on-premise installation. The main difference with Menditect hosting MTA on the Mendix cloud is that the client is responsible for managing the cloud platform.

note

When installing MTA for the first time, always clean up your existing environment first (both the database and the Mendix model).

Configuring a new MTA implementation​

Your cloud needs to meet at least the specifications of the Mendix S21-STANDARD container, see Mendix Cloud Container resources.

Actions​

  • You will receive information from Menditect on how to download the MDA file that you need to set up MTA.
  • Deploy and transport it to the environment in your cloud.
    When deploying MTA on the Mendix Cloud, you need to use at least an S21 Resource Pack.
    When deploying MTA on another Cloud provider, you need to have at least 2 GB of RAM for the App and 1/2 CPU core available.
  • Check the content of the following environment variables for the MTA application:
Environment variablevalue
ApiMendixModule.WebsocketStageproduction
Atlas_Core.Atlas_Core_Version3.0.7
Atlas_Web_Content.Atlas_Web_Content_Version3.0.6
EgalitConfigModule.EsaMultiInstanceModeFalse
MtaDataValidationModule.RunIntervalNrOfDaysBeforeSysdate5
MtaUtils.DeleteObjectBatchSize500
MtaUtils.DeploymentTypeOn-Premises
MtaUtils.InternalToken(empty)
MtaUtils.MtaDocVersion2.5.0
MtaUtils.NodeRevision0
MtaUtils.UrlBaseDocumentationhttps://documentation.menditect.com
MtaUtils.UrlReleaseNotesreleasenotes
MtaUtils.UrlSupportFormhttps://share.hsforms.com/1x-oVL39kRTGw-b3CQ9im8g3twri
PluginRecordModule.RecordingSupportRequestUrlhttps://share.hsforms.com/1RJY9cRw-TSm9QWXD6bZcbw3twri
TestconfigurationModule.TCNF_DaysRemainAfterFlaggedForDeleteDate20
note

You may notice that MTA also contains environment variables from the MTA Plugin Module. This is because Menditect regression-tests MTA with MTA. Menditect on-premise customers and partners do not have to set these values.

SAML SSO​

Environment variablevalue
DeepLink.EnableLeadingSlashFalse
DeepLink.IndexPageindex.html
DeepLink.LoginLocation/SSO/login?f=true&cont=

Scheduled events​

  • Toggle these scheduled events to Currently Enabled:
ApiCiCdModule.RunCtresCleanup
ApplicationModule.RunARVNsContentCleanUp
Deeplink.Cleanup
MtaDataValidationModule.RunInterval
TestconfigurationModule.RunTrunsCleanup
TestconfigurationModule.RunTcnfsCleanup

Firewall and network settings​

info

Below steps are important and MTA will not work if these steps are skipped.

  • Make sure that any firewalls applicable have whitelisted these URLs, on ports 80 and 443:
*.mendix.com/*
*.sprintr.com/*
mtasdkapi-ws.menditect.com/*
hsforms.com/*

  • Make sure the /rest path allows all access (in Mendix: Environment details -> Network -> Path Based Access Restrictions and set the path /rest/ on allow access).

  • Make sure the /rest-doc path denies all access (in Mendix: Environment details -> Network -> Path Based Access Restrictions and set the path /rest-doc/ on deny all access).

  • Start the MTA application.

  • Change the MxAdmin password of the environment to your own MxAdmin password.

  • Create a database backup.

  • DONE!

Upgrading an existing MTA implementation​

MTA actions​

  • Always create a backup of your database before bringing MTA down and upgrading.
  • During deployment, make sure that you check all the values of the Constants for the Mendix model.
  • After upgrading with the provided MDA file in this directory, make sure to login using the admin account (usually MxAdmin).
  • Run all the migrations from the top menu in MTA, from old to new.
  • Wait for all of the migrations to be done.
  • When running into errors, contact Menditect support (support@menditect.com), and do not proceed with test scripting.
  • Logout.
  • Login with a Tester account and check if the test configurations can be executed.

Test application actions​

After updating MTA, make sure that all the test applications have the newest version of the MTA Plugin module installed.

Read how to import and configure the Plugin here

Feedback?​

Missing anything? Let us know!

Last updated 22 November 2023