MYOB AO install guide—2021.0 (Australia)
Release date—24 June 2021
Prerequisites
- Check that your computer meets the system requirements.
Ensure that you have MYOB Logins configured for your practice. See Logging into MYOB AO.
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.
Backing up the MYOB AE or AO database data, using Maintenance > Backup > Back Up Now (if you're upgrading MYOB AO).
- 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.
For information on the new registry setting, see What is Enable Linked Connections?
Disable your anti-virus / malware program before running the install.
Ensure your regional settings for format and location are set to Australia or New Zealand (depending on your location).
Make sure that you have internet access.
Allow sufficient time for installation. It may take more than an hour to complete.
To ensure that your database is upgraded correctly, you MUST reboot the computer which has your existing MYOB AO database.
- Make sure that your Windows login has administrator rights when performing the installation.
The installer requires a minimum of 4GB of free disk space on the local disk of your server.
It is important that before you install AO Tax 2021.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 2020 to 2021.
The year-end routine runs automatically as part of the installation.
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.
The returns that are not to be rolled forward to 2021, such as returns for clients for whom you no longer act, need to be flagged in AO Tax 2020. These returns will remain intact in 2020 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 2020 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:
Select Maintenance > Bulk Return edit.
At the Return area to change field:
Click the ellipsis button.
Highlight the Exclude from rollover flag entry.
Click Select
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 2020 into 2021, any new client return added to 2020 will not be in 2021.
If you create a client return in 2020, you must also create one in 2021. Then, when you open the 2021 return, the RSD (rollover) opens and details from the 2020 year will roll into 2021.
Likewise, if you create a new return for say 2018, you will also have to create it in 2020 and then open it to roll it into 2020, then repeat the process to roll it into 2021.
Upgrading Accountants Office
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.
Download the MYOB AO 2021.0 (5.4.38.101) - Lite Install file from my.MYOB.
Exit all programs and reboot the computer you are going to install MYOB AO on to ensure a clean environment.
Log on to the computer as the administrator.
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.
Read the Licence Agreement carefully, select I have read and accept the licence agreement then click Next.
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.
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.
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.
- If you disabled your anti-virus/malware programs before you installed MYOB AO, re-enable it before continuing.
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.
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.
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).
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
Ensure that you have read the information in General preparations.
Log into the workstation as administrator.
Navigate to \MYOBAO\AOSQL\WorkstationInstall\setup.exe on your server or computer where the server installation was performed.
Double-click setup.exe. The Licence Agreement window opens.
Read and accept the Licence Agreement by selecting the I have read and accept the licence agreement checkbox.
Click Next. The Ready to Install window opens.
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.
Click Finish. The workstation installation is complete.
If you're licensed for Document Manager, see the steps below:
You’ll be prompted for the following information once the main installation of MYOB AO is complete:
![](../__attachments/12553301/image2019-7-1%2020:42:2.png?inst-v=80cb1b87-5310-4c64-94c8-30209a1770c6)
Select the Is this server the File Store Server? checkbox, then click Finish
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.
Select the checkbox and click Finish.
The PDF iFilter ensures that PDF documents will be indexed and therefore searchable in Document Manager.
Install the document file store on a different server:
Deselect the Is this server the File Store Server? checkbox, and click Finish to complete the installation.
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.
Read and accept the Licence Agreement.
Select the SQL Server instance that contains your MYOB Accountants Enterprise database.
Enter the location and details of the port number for your Document Manager document file store and indexing service.
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.
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.
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.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:
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
Make sure you install the hotfix Tax 2021.0 hotfix KB66322434 (Australia).
This hotfix release fixes the integration issues between the capital gains worksheet(with a prior year loss entered in 2021), with the main labels in the tax return and BW schedule.
Checking the version numbers
Open MYOB AO.
Select Help > About from the menu bar.
The install version should be 2021.0.
The version number should be 5.4.38.101.- Click the Plugins button to access the version number of individual products.
Product | Version Number |
---|---|
AO Tax | 2021.0 (for a 2021 tax return) 2020.3 (for a 2020 tax return) |
Client Accounting | 5.4.38.101 |
Practice Manager | 5.4.38.101 |
Document Manager | 5.4.38.101 |
Corporate Compliance | 3.2.0.58 |
Statutory Reporter Formats | Definition version 38 |
(AU) Tax Homepages | 7.0.16.108 |
Check Statutory reporter formats
Open MYOB AO.
Click Maintenance > Maintenance Map > Client Accounting > Practice Report Settings. The Practice Report Settings page opens.
Click About on the Tasks bar. The About Statutory Reporter dialog lists the Report Definition version number.
Click OK. The About Statutory Reporter dialog closes.
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 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.
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.