Submit a ticket

ACA Companion Application Self-Hosted Deployment

Updated on Follow
0 out of 0 found this helpful

 Overview

These ACA Companion application instructions are for self-hosted customers only. For Avionté-hosted customers, there is no installation required. This article provides the steps required to download the ACA Companion Application, the necessary prerequisites for running the ACA Companion application, and information on the Logging Service. 

 

Each time a new release of the ACA Companion application is made available, a new version must be pulled to a self-hosted customer's environment. If a new Avionté Agent ACA package is made available, the old ACA package must be removed and replaced with the updated package. 

 

 

Prerequisites

 

ACA Companion Application Requirements

  • .NET Framework 4.6.2
  • Sub-millisecond latency to the Avionté SQL Server database.
  • Avionté Agent 1.2

 

 

Avionté Suite and Agent Version-Specific Requirements

If you have Suite Version Agent Requirements
Suite 16.1 and newer
  • Update Avionté Agent to the most recent version,Version 1.2. For instructions on updating Agent, visit the Avionté Agent article.

  • Install the ACA Agent Job package to Avionté Agent. Visit the Avionté Agent Manager article for job package installation instructions.
Suite 15.2 and older
  • Download the newest version of Avionté Agent, Version 1.2. The old version of Agent and the new version will run side-by-side.

    The old version of Agent contains specific Avionté core application jobs that will not be duplicated when the new version of Agent is downloaded. For instructions on installing Agent, visit the Avionté Agent article. 

  • Install the ACA Agent Job package to the new Avionté Agent (just downloaded). Visit the Avionté Agent Manager article for package installation instructions.

 

 

 

 

ACA Companion Application Installation

The ACA Companion is a Windows application that does not require an installer, but does require the use of a new executable.

 

Though there are some differences, installation of the ACA Companion application is similar to installation of the Core application. One important difference is that, while the Core application version can be current or one version behind current, the ACA Companion application should be re-installed each time a new version of the ACA Companion application is made available. If a new Avionté Agent ACA package is made available, the old ACA package must be removed and replaced with the updated package. 

 

  1. A copy of the ACA Companion application is available on a central Avionte FTP site. The username/password needed to access this content will be provided to the client by their Client Manager.

  2. Download the ACA Companion.zip folder to its own folder in the same parent directory that contains the Avionté Core application. Name the folder something that will let users know the folder contains the ACA Companion application.
    • The user should ensure the zip file is unblocked – Windows sometimes prevents files from being used if they were downloaded. Right-click the file and click “Unblock” on the first tab. If there is no “Unblock” button, then the file is not blocked. 

  3. Configure the AvionteACACompanion.exe.config connectionstring to point to the existing Avionté database (just like the Core app.)


    The connection string should match the one used by your Avionté Core application, which may be found in that application’s configuration file. The configuration file is located in the same folder as the core application EXE, and is named Avionte.Suite.Win.Application.exe.config. 


  4. A user with admin privileges in Avionté and DBOwner privileges in database should run the Companion application for the first time. The user will be prompted with a database update confirmation message before the install adds tables to your database. Existing database content is NOT affected. The install only adds tables and stored procedures to accommodate the ACA Companion application. Each time the Companion application is opened, your database is checked to ensure it has a structure capable of supporting the ACA Companion application. 


  5. Determine which users should have access to the ACA Companion application then allow those users to access the new Companion directory. Access can be handled through methods such as Active Directory. 

  6. Make the AvionteACACompanion.exe link available to users. Although the Companion application can be distributed by local installation, it is recommended that the application be made available to users through a remote application (i.e. Citrix, Terminal Services) to accommodate future updates. 

    Users may begin using the ACA Companion application. 

 

 

 

ACA Companion Application Update Process

The ACA Companion application will occasionally require an update to accommodate Affordable Care Act changes as well as fixes to existing software. Before announcing that a new version is available, Avionté will make the new version available on the FTP site.

 

To update the ACA Companion application, 

  1. Uninstall the ACA Agent job package
  2. Deploy the new version of the Companion application
  3. Run the application (Step 4 in the ACA Companion Application Installation section) at least once to ensure the database is updated to the latest version.

  4. Install the new ACA Agent job package.

 

 

 

RDL Files

When downloading the ACA Companion application files, RDL files - used to generate 1094 and 1095 reports - are also available in the FTP folder. 

 

Open the "aca-report.zip" file to install all of the ACA report-facilitating files. 

 

 

 

Logging Service

The ACA Companion application is using the logging service Log4Net to produce logs. This can be configured via the ACA Companion Application config file. Documentation regarding this configuration can be found at https://logging.apache.org/log4net/release/config-examples.html 

 

By default the log location is a user's temporary APPDATA folder.

 


Have more questions? Submit a request

0 Comments


This space is for article feedback only. To make a request of the Avionté Support Team, please submit a ticket to https://support.avionte.com.