Skip to content
English
Log a Support Call Customer portal
  • There are no suggestions because the search field is empty.

Install the ATRS Web Application

The ATRS Web Application provides browser-based access to ATRS, allowing users to access and manage ATRS functionality through a web browser. This article explains how to install the ATRS Web Application and connect it to the ATRS API.

For best performance, we recommend that the ATRS Web Application (including the required ATRS software + API instance) is installed on a separate, dedicated server. This will ensure smooth operation of the Web Application without adversely affecting the performance of your main ATRS scheduler server.

Before You Begin

Before installing the ATRS Web Application, make sure the server meets the following requirements:

  • IIS version 7 or later is installed and configured.
  • A supported version of ATRS is installed on the server.
  • The ATRS API has been installed and configured.
  • You are logged in to the server using an account with Administrator privileges.
  • You have the ATRS API address available. You will need this during the Web Application installation.

Begin the Installation

Once the prerequisites are in place, you can begin installing the ATRS Web Application.

  1. Locate and double-click ATRSSetupX.
  2. Select Unzip to extract the ATRS installation files.
  1. When the ATRS installer menu opens, locate Install ATRS Web Application and select Go.
  1. Select Unzip to extract the ATRS Web Application installation files.

The ATRS Web Application installer will open automatically when the files have been extracted.

 

Configure the Installation

When the ATRS Web Application installer opens, configure the following settings:

  • Installation Path: Specify where the ATRS Web Application should be installed. You can use the default installation path, which is recommended, or select another location.
  • Port: Enter the port number that the ATRS Web Application should use.
  • ATRS API Address: Enter the address of the ATRS API that the Web Application will use to communicate with ATRS.

Once the settings have been configured, select Install to begin the installation.

The installer will install and configure the ATRS Web Application. Allow the process to complete without closing the installer.

 

 

Complete the Installation

Once the installation process has finished:

  1. Select OK when the installation completion message appears.
  2. Select Finish to close the installer.

The ATRS Web Application installation is now complete.

Access the ATRS Web Application

After installation, open a web browser on the server and navigate to:

http://localhost/

The ATRS Web Application login screen will be displayed.

  1. Enter your ATRS Username.
  2. Enter your ATRS Password.
  3. Select Log In.

Once authenticated, you can begin using the ATRS Web Application.

 

Verify the Installation

Before making the ATRS Web Application available to other users, verify that:

  • The ATRS Web Application opens successfully in the browser.
  • You can log in using valid ATRS credentials.
  • The Web Application can communicate with the configured ATRS API.
  • ATRS information and functionality are available after login.

If these checks are successful, the ATRS Web Application is ready to use.

Troubleshooting

If you experience problems installing or accessing the ATRS Web Application, use the following guidance to identify and resolve common issues.

The ATRS Web Application Installer Does Not Start

Possible cause: The installation files may not have been extracted correctly, or the installer may not have sufficient permissions.

Resolution:

  • Confirm that the ATRS installation files were successfully extracted.
  • Run ATRSSetupX using Run as administrator.
  • Verify that the Windows account performing the installation has Administrator privileges.
  • If necessary, extract the installation files again and restart the installation.

The ATRS Web Application Does Not Open in the Browser

Possible cause: IIS may not be configured correctly, or the Web Application may not have been installed successfully.

Resolution:

  • Confirm that IIS is installed and running on the server.
  • Verify that the ATRS Web Application installation completed successfully.
  • Confirm that the port configured during installation is available and accessible.
  • Restart IIS and try accessing the ATRS Web Application again.

The ATRS Web Application Cannot Connect to the ATRS API

Possible cause: The ATRS API address may be incorrect, or the API may not be running or accessible from the Web Application server.

Resolution:

  • Verify the ATRS API Address entered during installation.
  • Confirm that the ATRS API is installed and running.
  • Verify that the Web Application server can communicate with the server and port used by the ATRS API.
  • Check any firewall or network rules that could prevent communication between the Web Application and ATRS API.

The Login Screen Appears but You Cannot Log In

Possible cause: The credentials may be incorrect, or the Web Application may be unable to communicate with ATRS.

Resolution:

  • Confirm that you are entering a valid ATRS Username and Password.
  • Verify that the ATRS API is running and accessible.
  • Confirm that the Web Application is configured to use the correct ATRS API address.
  • Try logging in again after verifying the connection.

The Web Application Works Locally but Cannot Be Accessed from Another Computer

Possible cause: The Web Application may only be accessible locally, or the configured port may be blocked.

Resolution:

  • Confirm that the ATRS Web Application is running correctly on the server.
  • Verify that the required port is open in Windows Firewall and any network firewalls.
  • Confirm that users can resolve and reach the ATRS Web Application server from their computers.
  • Verify the IIS site bindings and ensure they allow the required connections.

The Issue Persists After Checking the Configuration

If the ATRS Web Application still does not install, open, or communicate with ATRS, review the relevant ATRS logs for additional error information.

The error details can help identify whether the problem is related to the installation, IIS configuration, ATRS API connectivity, authentication, or network access.

Need Additional Help?

If you are unable to resolve the issue using the steps in this article, our Support team can help.

When submitting a support request, include as much information as possible, including any error messages, screenshots, and relevant ATRS logs. Providing these details will help our team investigate the issue more efficiently.

Log a Support Call