AMT Help Files

Adding the Websites Manually

AMT web applications consist of the Control Center and the Application Center. To add these web applications manually to the IIS, the following IIS applications need to be created:

IIS Application Description Physical path* Example Virtual Path
AMT Environment The IIS application under which the AMT Web Application will reside. \ /AMT
ControlCenter The front end application of the Control Center. \AmtTools\ControlCenterCore /AMT/ControlCenter
TransactionRendererBlazor A support application to view transactions inside the Control Center. \AmtTools\ControlCenterCore\TransactionRendererBlazor /AMT/ControlCenter/TransactionRendererBlazor
ControlCenterBL The back end application of the Control Center. \AmtTools\ControlCenterWebAPI /AMT/ControlCenterBL
ApplicationCenter The front end application of the Application Center. \AmtTools\ApplicationCenterCore /AMT/ApplicationCenter
ApplicationCenterBL The back end application of the Application Center. \AmtTools\ApplicationCenterWebAPI /AMT/ApplicationCenterBL

*The Physical Path is relative to the System base path of the AMT environment.

Continue in the sections below to follow the steps necessary to add and configure these AMT applications.

Adding the Environment Web Application to the IIS

Follow the steps below to add a new application Environment in the IIS:

  1. Open the IIS Manager.
  2. Right click on the Default Web Site and select Add Application....
  3. In the Add Application dialog, do the following:
    1. Enter an Alias name, such as "AMT".
    2. The Application pool can be left on the default DefaultAppPool, or a new application pool could be created and associated with this application.
    3. Set the Physical path to the Base Path of the AMT environment (..\AMT).
    4. Select the OK button to add the application.

Adding the Control Center and Application Center applications to the IIS

Follow the steps below to add the necessary applications for the Control Center and Application Center as well as their respective Application Pools in the IIS:

  1. Open the IIS Manager.
  2. Create a new Application Pool for the application (such as the ControlCenter) using a .NET CLR version and set Managed Pipeline Mode to Integrated. Create separate application pools for the following applications:
    1. ControlCenter
    2. ControlCenterBL
    3. ApplicationCenter
    4. ApplicationCenterBL
  3. Right click on the Environment application that was created in the previous section and select Add Application....
  4. In the Add Application dialog, do the following:
    1. Enter an Alias name (such as "ControlCenter" for the Control Center).
    2. Select an Application Pool created in step 2 to be associated with this application.
    3. Set the Physical Path of the application to its respective physical path. Use the table at the top of this page as a guide.

    4. Select the OK button to add the application.

  5. Repeat the above steps to create each application with their respective Aliases, Application Pools, and Physical Paths.

Adding the transaction renderer blazor application to the IIS

The TransactionRendererBlazor is the .NET core successor to the previous .NET Framework TransactionRenderer.

Lastly, the Transaction renderer blazor needs to be created. Follow the steps below to add the Transaction Renderer Blazor to the Control Center application in the IIS:

  1. Open the IIS Manager.
  2. Create a new Application Pool for the Transaction Renderer using a .NET CLR version and set Managed Pipeline Mode to Integrated.
  3. Right click on the ControlCenter application created in the previous section and select Add Application....
  4. In the Add Application dialog, do the following:
    1. Enter an Alias name, such as "TransactionRendererBlazor".
    2. Select the Application Pool created in step 2 to be associated with this application.
    3. Set the Physical path to the TransactionRendererBlazor directory (..\AMT\AMTTools\ControlCenterCore\TransactionRendererBlazor).
  5. Select the OK button to create the application.

Creating and Configuring the appsettings.json files

If Setup is not used to automatically configure the appsettings.json files, a copy of the sample files first need to be renamed and configured manually.

  1. Navigate to the following directory: ..\<AMT Environment>\AMTTools.
  2. Within this directory, find and open the SAMPLE_appsettings.json files found in the following locations:
    Appsettings File Directories
    ControlCenterCore
    ControlCenterCore\TransactionRendererBlazor
    ControlCenterWebApi
    ApplicationCenterCore
    ApplicationCenterWebApi

  3. Save a copy of all five files with the name appsettings.json in their respective directories.
  4. Configure the files with the settings found below, under the subheadings ControlCenterCore and ApplicationCenterCore.

ControlCenterCore

In the appsettings.json file located in the \AmtTools\ControlCenterCore\ directory of the AMT installation, the "Address" setting of the "BusinessLogic" section should be set to the URL of the ControlCenterBL Web Application. In the same file the "Address" setting of the "TransactionRenderer" section should be set to the URL of the TransactionRendererBlazor Web Application.

For example:

"BusinessLogic": {
  "Address": "https://amtweb.contoso.local/AMT/ControlCenterBL"
},
"TransactionRenderer": {
  "Address": "https://amtweb.contoso.local/AMT/ControlCenter/TransactionRendererBlazor"
},

After setting the URLs, save and close the file.

ApplicationCenterCore

In the appsettings.json file located in the \AmtTools\ApplicationCenterCore\ directory of the AMT installation, the "Address" setting of the "BusinessLogic" section should be set to the URL of the ApplicationCenterBL Web Application.

For example:

"BusinessLogic": {
  "Address": "https://amtweb.contoso.local/AMT/ApplicationCenterBL"
},

After setting the URL, save and close the file.

Other settings found in these appsettings.json files will be explained in the following help pages.

Configuring Authentication

The authentication method need to be set for web applications after the applications have been added to the IIS Manager. Set up the authentication method for the Control Center and the Application Center by clicking on the authentication method below and follow the instructions on that page.

There is only one possible method to access the Control Center and Application Center.