Page tree
Skip to end of metadata
Go to start of metadata

About this release

Access Attaché 21.1 or newer is a required upgrade for STP2 for Attache Payroll for the first payrun of the 2022/23 financial year. 

We recommend your consultant carry out this upgrade. 


This topic describes how to upgrade to Access Attaché 22, including upgrading the Attaché Database Server, the Attaché application and workstations. If you are unsure about the upgrade procedure or need assistance to upgrade, talk to your Attaché consultant before you begin.

Important note: You can upgrade to Attaché 22 only from Attaché BI version 19 or later. If you are using an earlier version, talk to your Attaché consultant. Upgrading from these earlier versions requires a data migration which must be carried out by a certified Attaché installer.

Before you begin

Prior to upgrading, ensure your system:

  • Attaché 22 requires Microsoft .NET Framework version 4.7.2, .NET Core 2.1 and ASP .NET Core 2.1. (Previously.NET 4.5.2 was required.) These have been packaged with the InstallShield wizard. When installing Attaché 20.1 you will be prompted to install .NET 4.7.2, .NET Core 2.1 and ASP .NET Core 2.1 if it is not already installed. 
  • Attaché 22 cannot run on Windows 7, 8, 2008, 2008SP1 or 2008SP2 (or any earlier operating systems).
  • Ensure all workstation and server operating systems are Microsoft-supported versions as per the Microsoft Windows lifecycle fact sheet


Before you begin the upgrade process: 

  • Post any outstanding transactions to the general ledger.
  • Take a backup of your Attaché data
  • Exit Attaché and ensure that no one else is using it 
  • Temporarily disable any antivirus software to ensure it doesn't interfere during the upgrade

Downloading files

Talk to you Attaché consultant or visit the Release Information area of the Access Customer Success Portal to download this version including the Attaché Database Server file (32-bit or 64-bit) and Attaché application. Find out more about the portal and a link to register

Upgrading Attaché Database Server 

You must upgrade Attaché Database Server before you upgrade the Attaché desktop application. 

To upgrade Attaché Database Server:

  1. Ensure all users are logged out of Attaché. 
  2. Stop all four Attaché services through the services console (services.msc).
  3. Disable any antivirus software.
  4. In the saved files directory, right click the attache-database-server-32- (or 64-) bit-installer-22.exe file and select Run as administrator.
  5. When asked Do you want to run this file? choose Run.
    This launches the InstallShield Wizard.
  6. Click Next to start the installation.
  7. When the installation is complete, choose Finish to close the InstallShield Wizard.

Upgrading the Attaché desktop application

To upgrade the Attaché application:

  1. In the saved files directory, right click the attache-application-installer-22.exe file and select Run as administrator. 
  2. When asked Do you want to run this file? choose Run.
    This launches the InstallShield Wizard.
  3. Click Next and then click Install to start the installation.
  4. When the installation is complete, choose Finish to close the InstallShield Wizard.

Updating antivirus exceptions

Update your antivirus software exclusions, if applicable (see Antivirus exclusions list).

Checking your installation

Check the application:

  1. Log in to Attaché and choose Help | About Attaché.
  2. Check that the Release number is Attaché 22.  

Check company-organisation connections: 

  • From the main menu on the Attaché desktop, choose Online Services | Cloud Connector. Click View all company connections and ensure your connections are listed. 

If either of the above checks fail, contact your Attaché consultant for assistance. 

Upgrading Attaché workstation

When you run Attaché at each workstation for the first time after upgrading, you may be prompted to install a new version of Attaché workstation. If an upgrade is required, the message Install the Attaché Workstation components now? is displayed.

To upgrade an Attaché workstation:

  1. At the workstation, right-click the Attaché application desktop shortcut and select Run as administrator

    If a workstation upgrade is required, the message Install the Attaché Workstation components now? is displayed.

  2. Click Yes to open the InstallShield Wizard.
  3. Click Next on the Welcome page to proceed.
    Before upgrading the workstation, the software checks if the Microsoft .NET 4.5 Framework is installed. If not, you will be prompted to install it. You may then be prompted to restart your computer. If so, after the restart, start Attaché again to relaunch the workstation upgrade.
  4. Follow the onscreen instructions.
  5. When finished, the Wizard Complete page is displayed.
  6. Click Finish to close the installation wizard. 
  7. If prompted to restart your computer, do so. After restarting you can then run Attaché as usual. If not prompted to restart your computer, Attaché will start immediately after you close the installation wizard.

Note: Additional antivirus exceptions For each workstation, you may need to update your antivirus exceptions (see Antivirus exclusions list). 

Upgrading related Attaché products

After upgrading Attaché, you should check for upgrades to your other Attaché products including Attaché Server ODBC, Attaché ClearView, Attaché Asset Management (formerly Attaché Fixed Assets) and AlexConnect. See Current Attaché releases (compatibility list)


REF  100522 221 

Applicable versions

  • Attaché 22 suite

See also Current Attaché releases

Upgrade related products

You should check for upgrades for your other Attaché products, especially if you have not upgraded for some time. See Current Attaché releases