Skip to main content
Skip table of contents

MYOB AO install guide—2023.0 (Australia)

Release date—27 June 2023

Prerequisites

General preparations
  1. Check that your computer meets the system requirements.
  2. Ensure that you have MYOB Logins configured for your practice. See Logging into MYOB AO.

  3. This installation creates and configures a new tax ledger for the coming year. You must prepare your current tax ledger for rollover to the new ledger. Run the Bulk Return Edit (see Preparing for end-of-year tax installation) to mark returns that are to be excluded from the new ledger.

  4. Backing up the MYOB AE or AO database data, using Maintenance > Backup > Back Up Now (if you're upgrading MYOB AO).

  5. Make sure you understand how your system is configured. You need to know if you are installing on a:
    • Standalone computer or Terminal Server network

    • Client Server network or Peer to Peer network
      See What is my system setup? if you are unsure of your system setup.

  6. For information on the new registry setting, see What is Enable Linked Connections?

  7. Disable your anti-virus / malware program before running the install.

  8. Ensure your regional settings for format and location are set to Australia or New Zealand (depending on your location).

  9. Make sure that you have internet access.

  10. Allow sufficient time for installation. It may take more than an hour to complete.

  11. To ensure that your database is upgraded correctly, you MUST reboot the computer which has your existing MYOB AO database.

  12. Make sure that your Windows login has administrator rights when performing the installation.
  13. The installer requires a minimum of 4GB of free disk space on the local disk of your server.

Preparing for end-of-year tax installation

It is important that before you install AO Tax 2023.0 you prepare your data so that the best possible result is achieved during the year-end and rollover of your client’s information from 2022 to 2023.

The year-end routine runs automatically as part of the installation.

Year-end routine

The year-end routine balances forward the lodgment details of all returns except those excluded from rollover.

Returns excluded from rollover remain in the previous year's AO Tax year.

The year-end routine:

  • carries the front cover details to the subsequent year's front cover.

  • sets overseas pension and salary income dates to the next financial year.

  • brings locked returns into the new AO Tax year and keeps them locked.

  • resets lodgment levels and due dates.

  • updates primary production averaging income years, dropping off the earliest and adding the immediate prior year.

  • updates special professional eligible income for averaging years, dropping off the earliest and adding the immediate prior year.

Exclude returns from rollover

The returns that are not to be rolled forward to 2023, such as returns for clients for whom you no longer act, need to be flagged in AO Tax 2022. These returns will remain intact in 2022 and any other prior years.

This step is important for accurate statistical reporting done by the practice, such as the Lodgment Monitoring program and 85% on-time lodgment requirements.

It is important to note that you don't have to Exclude from Rollover returns that:

  • have not been completed and lodged in 2022 or

  • were marked Final on the front cover of the return.

The Exclude from Rollover checkbox is found on Return Properties > PAYG/Lodge under the Current Year section.

Setting the Exclude from Rollover checkbox on this tab excludes this return from rollover.

To exclude a batch of returns from rollover use the Bulk Return edit routine.

The Bulk Return edit procedure is:

  1. Select Maintenance > Bulk Return edit.

  2. At the Return area to change field:

  1. Click the ellipsis button.

  2. Highlight the Exclude from rollover flag entry.

  3. Click Select


  • Select Batch.
  • Deselect Edit individually.

  • Select Override all to apply the change to each selected return.

  • Click OK to close the warning message dialogue.

  • Click OK at the Bulk Return Edit main window. The Select Returns for Update index listing all returns on the system opens.

  • Highlight and select each return to be included in the batch.

    If you sort the list of returns by Return Code, type the code and press Enter to move to that return. Alternatively, if you sort the list by TFN, key the TFN, with or without spaces, and press Enter. Then click Select.

     

    Each return that has a green tick is included in the batch.

  • Click OK. The Edit Rollover flag window opens.

  • Select the Exclude from Rollover checkbox and click OK. The program will tick the checkbox in the Return Properties > Lodgment tab for each of the returns in the batch.

  • Adding a new client return for prior years

    After rolling 2022 into 2023, any new client return added to 2022 will not be in 2023.

    If you create a client return in 2022, you must also create one in 2023. Then, when you open the 2023 return, the RSD (rollover) opens and details from the 2022 year will roll into 2023.

    Upgrading Accountants Office

    Main installation

    You must run the installation on the computer that will store your MYOB AO database. If you have a network this is usually your server. See What is my system setup? for more information on your system setup.

    1. Download the MYOB AO 2023.0 (5.4.47.186) - Lite Install file from my.MYOB.

    2. Exit all programs and reboot the computer you are going to install MYOB AO on to ensure a clean environment.

    3. Log on to the computer as the administrator.

    4. Select the region that applies to you so the correct software for your region is installed and click Next. The Welcome - Licence Agreement window opens.

      At the bottom of the installer screen there are links to the Release Notes.

    5. Read the Licence Agreement carefully, select I have read and accept the licence agreement then click Next.

    6. Click Upgrade now to start the installation.

      The installation may take more than an hour to complete. Ensure that you have allocated enough time for the installation.

    7. When the MYOB AO installation is complete, click Finish.

      If you’re using a proxy server you don’t need to change the ClientFrameWork.exe.config file in the server Deploy folder see Proxy Server Information.

    8. If you are prompted to restart your computer, make sure the Restart now checkbox is selected before clicking Finish.

      Restarting each computer after completing the installation will help to avoid any issues using your MYOB software. See What is Enable Linked Connections and Open File - Security Warning for more information.

    9. If you disabled your anti-virus/malware programs before you installed MYOB AO, re-enable it before continuing.
    10. If you have a network setup and you are running MYOB AO on more than one computer, perform a Workstation installation to update the local deploy folder.

    Instructions on how to log into MYOB AO are launched in a browser window or see Logging into MYOB AO.

    Workstation installation

    An upgrade can either be done by Auto update when you open MYOB AO or you can run a Manual update.

    There are changes to workstation installations as part of this release, refer to workstation install changes for further information.

    If you see this screen, automatic workstation updates have been disabled for your practice, so you should run a Manual update on your workstation.

    Auto update

    If you see this screen when you open MYOB AO, automatic workstation updates are enabled at your practice:

    Click Yes to update your workstation automatically.

    Click No and you will need to run a Manual update (see below).

    Manual update

    The workstation updates for all MYOB AO products are combined into one file for this installer. The file is located at \MYOBAO\AOSQL\WorkstationInstall\setup.exe.

    After the server installation, a manual workstation update should be performed on all workstations that you want to have access to the latest MYOB AO products, in the following instances:

    • if you’re installing MYOB AO on a new workstation for the first time.

    • if the workstation link is not operational.

    • if the automatic update can’t proceed and you’re prompted to run a manual install.

    Instructions

    1. Ensure that you have read the information in General preparations.

    2. Log into the workstation as administrator.

    3. Navigate to \MYOBAO\AOSQL\WorkstationInstall\setup.exe on your server or computer where the server installation was performed.

    4. Double-click setup.exe. The Licence Agreement window opens.

    5. Read and accept the Licence Agreement by selecting the I have read and accept the licence agreement checkbox.

    6. Click Next. The Ready to Install window opens.

    7. Click Install Now. The Installation Progress window opens.

      If you receive the message, If you receive an “Open file security” warning message when opening MYOB Accountants Office Workstation, it is recommended that you restart your computer, click OK.

      On completion, the Installation Complete window opens.

    8. Click Finish. The workstation installation is complete.

    If you're licensed for Document Manager, see the steps below:

    Document Manager installation

    You’ll be prompted for the following information once the main installation of MYOB AO is complete:

     

    If the server you are installing on is your document file store server
    1. Select the Is this server the File Store Server? checkbox, then click Finish

    2. If you have already have Document Manager on your server, you will see this screen. Select Reinstall and click Next.

      The repair is complete. If you don’t already have it, you will be prompted to install Adobe iFilter version 9.0 x64.

    3. Select the checkbox and click Finish.

      The PDF iFilter ensures that PDF documents will be indexed and therefore searchable in Document Manager.

    If the server you are installing on is not your document file store server

    Install the document file store on a different server:

    1. Deselect the Is this server the File Store Server? checkbox, and click Finish to complete the installation.

    2. Run the Configuration tool on your chosen server from C:\MYOB\Knowledge Management\Document Manager\Server\Utility\DM_Config.exe or C:\MYOBAO\AOSQL\Knowledge Management\Document Manager\Server\Utility\DM_Config.exe.

    3. Read and accept the Licence Agreement.

    4. Select the SQL Server instance that contains your MYOB Accountants Enterprise database.

    5. Enter the location and details of the port number for your Document Manager document file store and indexing service.

    6. Follow the onscreen instructions to complete the installation. If you don’t already have it, you will be prompted to install Adobe iFilter version 9.0 x64.

    7. Click Next through the installer screens until it completes.

      The PDF iFilter ensures that PDF documents will be indexed and therefore searchable in Document Manager.

    8. Run a workstation install on each workstation that uses Document Manager. The file is located at C:\MYOBAO\AESQL\WorkstationInstall\setup.exe.
      You’ll only need to do this the very first time. On successive upgrades, the workstation update will occur automatically when you access MYOB AO.

    9. The Adobe PDF iFilter installer will open, click Next through the next few screens until the install is complete.

    If you're licensed for Corporate Compliance, see the steps below:

    Corporate Compliance installation

    If you use Corporate Compliance integrated with Practice Manager, you can upgrade Corporate Compliance using this combined installer.

    If you use Corporate Compliance as a standalone version and not integrated with Practice Manager, use the standalone installer available on my.MYOB.

    Once the main installation of MYOB AO is complete, the post-installation configuration of Corporate Compliance starts automatically. You’ll be prompted for the location of the:

    • electronic lodgment files

    • backup files.

    Follow the on-screen instructions to complete the installation.

    Post-installation

    Check your version numbers
    1. Open MYOB AO.

    2. Select Help > About from the menu bar.
      The install version should be 2023.0.
      The version number should be 5.4.47.186.

    3. Click the Plugins button to access the version number of individual products.

    Product

    Version Number

    AO Tax

    2023.0 (for a 2023 tax return)

    2022.4 (for a 2022 tax return)

    Client Accounting

    5.4.47.186

    Practice Manager

    5.4.47.186

    Document Manager

    5.4.47.186

    Corporate Compliance

    3.2.0.58

    (AU) Tax Homepages7.0.24.186

    Statutory Reporter Formats

    Go to MaintenanceMaintenance MapClient Accounting > Practice Report Settings > About in the Tasks bar on the left.

    Definition version 48

    If you are prompted, reboot your computer after completing the installation to avoid any issues using your MYOB software. See What is Enable Linked Connections?  and Open File - Security Warning for more information.

    If you have Client Accounting

    If you have updated XML mappings for customised CSV imports, you may need to verify and migrate your XML mappings after the upgrade.

    Once the upgrade is complete, a number of files are created in your MYOB installation:

     

    File name

    Description

    Location

    MyobCsvMaps-System.xml

    This system file contains the MYOB default settings for CSV import. Do not modify this file.

    Located in <MYOB directo-ry>\CENTRAL\Deploy.

    MyobCsvMaps-User.xml

    This file is a new mapping XML file that contains user-defined XML mappings.

    Any values in this file will override the system defaults.

    You can modify this file if you wish to add any new mappings or value map sections.

    Standalone installation:

    <MYOB directory>\CENTRAL\Deploy\Client Accounting Templates

    Combined installation:

    AE—C:\MYOBAE\AESQL\Client Accounting Templates

    AO—C:\MYOBAO\AOSQL\Client Accounting Templates

    MyobCsvMaps.xml

    This file is a backup of the file previously located in the CENTRAL\Deploy folder before performing the upgrade.

    <MYOB directory>\CENTRAL\Deploy\Client Accounting Templates

    If you made changes to MyobCsvMaps.xml before the upgrade, MYOB will back up this file to the folder <MYOB directory>\CENTRAL\Deploy\Client Accounting Templates.

    You can open this file and manually copy over any custom mappings to a new Map in the MyobCsvMaps-User.xml file, which is located in the folder indicated in the table above.

    After you have copied your changes, you may delete MyobCsvMaps.xml if you wish. Any future updates should be made in MyobCsvMaps-User.xml.

    Restart the server

    Wherever possible it is a good idea to restart the server after the installation is complete. This will also restart any MYOB services for the PLS.

    JavaScript errors detected

    Please note, these errors can depend on your browser setup.

    If this problem persists, please contact our support.