Skip to main content
Skip table of contents

Document Manager install guide—5.4.31 (Australia & New Zealand)

 

Release date—28 March 2019

This guide explains how to install and upgrade MYOB Document Manager 5.4.31.

This installation of MYOB Document Manager also includes the automatic installation of MYOB Intranet 5.4.31.

This release doesn't include any changes to Document Manager, but because you've updated MYOB AE/AO to version 5.4.31, you need to install Document Manager version 5.4.31.

To see the MYOB AE/AO changes, check out the release notes.

Prerequisites
  1. Identify the servers on your site which may be on one computer, or located separately. This guide refers to these servers as the:
    • Practice Manager Application Server – where Practice Manager is installed. Document Manager installs new software components in the DEPLOY directory on that server.
    • File Store Server – where Document Manager stores documents such as Microsoft Word and Excel, email and PDF. This secure directory may only be accessed by the administrator and must have ample storage.
    • SQL Server – where the Practice Manager database is located. We recommend that the SQL Server is on the same machine as the File Store server. 
  2. Check that your computer meets the system requirements.
  3. Make sure that you know the login name and password for your server and each workstation.

    You must log in as a system administrator to install on the application server, filestore server and all workstations.

    Do not use the default administrator login created by Windows.

  4. Be aware of the type of server/workstation environment you have:
    • Client Server or
    • Terminal Server.
  5. Exit all MYOB software and Windows programs.
  6. Exit all Microsoft Office applications including Microsoft Outlook.
  7. If you are upgrading an existing version of Document Manager, close any Document Manager and PDF Manager icons in the system tray.
  8. Back up all databases that will be upgraded. It's a great idea to keep backups indefinitely.
Defaults for your records

The Document Manager installation uses default values for the interrelated components. We recommend that you use the defaults, but we recognise you may need to customise them. Your system administrator can help you with the changes you'll need to make.

The following table shows the default values. If you use different values, you must keep a record of them as you'll need them for future updates.

Component

Recommended/Standard

Your choice

Document Manager server components

Document Manager server location

C:\MYOB\Knowledge Management\Document Manager\Server

 

Network share name

MYOBDM

 

Deploy folder

(also required for the server configuration)

C:\Program Files\MYOB\Central\Deploy

must be a local drive

MYOB intranet is installed to

C:\MYOB\Knowledge Management\Intranet\Server

MYOB intranet is a standard part of the install so these settings are established automatically.

Intranet network share name

MYOBIntranet

 

Intranet data directory

C:\MYOB\Knowledge Management\Intranet\Data

 

Intranet data store

MYOBIntranetData

 

Multiple SQL databases?:

(server configuration also treats one database at a time)

Yes | No

VPMSER

 

Authentication method

SQL user name:

SQL password:

Windows

SQL | Windows

Backup your Accountants Framework database?

Yes

C:\MYOB\SQLBackup\<machinename>\VPMSER.bak

Yes | No

Document Manager File Store (DMFS)

Is the (application) server the file store server?

Yes

Yes | No

Configuration tool

\\<machine name>\MYOB\Knowledge Management\Document Manager\Server\Utility\DM_Config.exe 

 

File store location

C:\MYOB\Data\DMFS

 

DMFS service directory

C:\Program Files\MYOB \Knowledge Management\DMFSService

We recommend that you don't change these settings.

DMFS port number

4001

 

Index service details

C:\Program Files\MYOB \Knowledge Management\ DMIndexingService

 

Indexing port number

4002

 

Optimise

Yes

 

Workstation components

Workstation executable

\\<machine name>\MYOB\Knowledge Management\Document Manager\Server\Setup\DocMgrWkstn.exe

 

DM workstation components installed to this location

C:\Program files\MYOB\ Knowledge Management\ Document Manager

 
Server installation

Accept default share names, directory names and locations where indicated. This makes it easier for MYOB to support your system, and for you to install upgrades. Changes to defaults must be recorded and used exactly in any future upgrades.

Download the latest version from my.myob and save it to a known location on your local server or computer. The Welcome window opens automatically after downloading and extracting the installation files.

MYOB Document Manager must be installed on the application server where MYOB AE/AO  is installed.

Exit all programs before starting the MYOB Document Manager installation.

To perform the install, log on as an administrator with full access rights. Do not use the default administrator login created by Windows.

You should start at the relevant place for your server type:

If you use a server with client workstations

From the server console:

  1. Click Server Install > Document Manager on the Welcome window.
  2. Alternatively, double-click the DocMgrSetup.exe file within the DM_5.4.31 installation folder.
    The installation will start.
  3. Continue at the Licence screen in Step 6of If your server is a terminal server.
If your server is a terminal server

The following instructions are for a single terminal server that contains your Document Manager data and programs. Programs are accessed after starting a session on the terminal server or via a Citrix system.

From the terminal server console:

  1. Close the Welcome window, if it's open.
  2. Open Control Panel > Classic View.
  3. Click Install Application on Terminal Server.
  4. Click Add New Programs.
    The Run Installation Program wizard opens.

    If necessary, browse to ...\DM_5.4.31\DocMgrSetup.exe in the installation folder.
  5. Click Finish.
    The installation starts.
  6. The Licence Agreement window opens.
  7. Select the I have read and accept the licence agreement checkbox.
  8. Click Next.
    The Server Directory window opens.

  9. Check the Folder Location - Server Program Components.
    We recommend that you accept the default location and option.

     

    Do not select stand alone unless no other client workstation will access the data and no shares or UNC paths are required.

  10. Click Next.
    The Deploy Directory window opens.
  11. Check the Folder Location - Server Program Components.
    We recommend that you accept the default location.

  12. Click Next.

    If you are repeating the server installation because you have more than one Accountants Framework database integrated with Document Manager, the Multi Database Option window opens. Select the Reconfigure a database only checkbox.

  13. Click Next.

    The Accountants Enterprise database window opens.



    Select the database from the list and select the appropriate authentication method.

  14. Click Next.
    When you are installing for the first time the Intranet Location window opens.
    When you are upgrading your existing version, you won't need to install MYOB Intranet again, and this window will not open. Go to Step 19

    1. If you are migrating Intranet data from an existing database, select the Yes option or

    2. If you are not migrating Intranet data from an existing database, select the No option. MYOB Intranet will then be installed in the default Folder Location - Intranet Installation Directory that is displayed.
      Click the Browse button to select a different location.

    3. Check the default Network Share Name.

  15. Click Next.

    The Intranet Data Directory window opens.

  16. Check the Folder Location - Server Data Components.

    Intranet data components will be installed the default location displayed.

    Click the Browse button to select a different data folder.

    You can only select directories on this server. The directory can't be a mapped drive

  17. Check the default Network Share Name.

  18. Click Next.

    The Document Manager Defaults window opens.

    By selecting Australian or New Zealand defaults, the new Document Manager database is preset according to that region with  Filing Cabinets and  Extra Fields

    Defaults can be modified by the practice after installation.

  19. Click Next.
    The Database Backup window opens


    Click Yes to backup the database to the default location
    If you select No, you will need to confirm that you have back up copies already
  20. Click Next.
    The Ready to Install window opens.

    Note:   The installation includes Intranet Server.

  21. Click Next and wait.

    The Register MYOB Products window opens.

    You are prompted to register your product if you are installingDocumentManager for the very first time.

    To register Document Manager:

    1. Click Register.
    2. Contact MYOB Support during business hours to obtain your registration code.
      You will need to provide MYOB Support with your serial number which is displayed on the right-hand side.
    3. Enter the Registration code supplied by MYOB Support.
    4. Click Next.
      Another dialog is displayed listing the products that you have successfully registered.
    5. Click Close.

    To obtain a temporary 7-day trial registration to Document Manager:

    1. Click Temporary.
      You will be provided with a temporary registration. 
      When you are ready to fully register Document Manager, see Registering Document Manager.

  22. Click Next
    The Server Install Complete window opens when the installation is complete.

    The File Store server is where Document Manager documents are stored. The File Store server must be configured when setting up Document Manager.
    There are two options:
    • If the current server is the File Store server, select the Is this server the File Store Server checkbox.
    • If your File Store Server is on a different server, deselect the Is this server the File Store Server checkbox and run the DM_Config.exe on the appropriate server.
  23. Click Finish.
    If the checkbox is selected processing continues at Step 1 on page 12.
    otherwise:
    • Log on to the File Store server.

    • Browse to the Application server using the path just copied.
      For example, \\AppServer\MYOBDM\Utility (where AppServer is replaced with the machine name of the application server).

    • Double-click DM_Config.exe and continue at Step 1 on page 12.
Document Manager configuration

The Document Manager Configuration install sets up the Document Manager File Store location, the File Store service and the Indexing service. It must be run for all available MYOB AE databases.

This Information window has opened automatically or you have opened it by navigating to DM_Config.exe from the File Store Server.

The Document Manager Configuration install:

  • runs automatically after the Application Server install if the Is this server the File Store server? checkbox is selected. Continue at Step 2 below, or

  • may be run separately from the Application Server Installation, that is, if the File Store server is a separate machine.

  1. The Information window lists the tasks that this process performs.
  2. Click Next.
    If all prerequisites are found the Deploy Directory window opens.

    Otherwise, the Prerequisite Check window opens.
    For example, if you don't have Adobe Acrobat Reader 8.0 or above installed, download and install the latest version from http://www.adobe.com/products/acrobat/readstep2.html.
    The installation detects the location of the Practice Manager install.
    If you are on a different server you must browse to the Application server. This path is likely to be: \\AppServer\Central\Deploy.
  3. Click Next.
    If this is a repeat install for an additional database, the Multi Database Option window opens.
  4. Select the Reconfigure a database only checkbox.
  5. Click Next.
    The MYOB Accountants Enterprise database window opens.
  6. Select the database from those available for integration and your authentication method.
  7. Click Next.
    The File Store window opens.

    The File Store Folder Location must be a local drive, not a mapped drive.


    Accept the default location for the File Store folder or click Browse to select another folder.

  8. Click Next.
    The DMFS Service Directory window opens.

    By default, the DMFS Service is installed to the Program Files folder with Port Number 4001.  We recommend that you don't change these defaults.
  9. Click Next.
    The Index Service Details window opens.

    Deselecting the Optimise checkbox will slow down indexing for large documents.
  10. Click Next.
    The Confirmation! window opens listing the configuration details.
  11. Click Next and wait.
    The Configuration Complete! window opens.

    For compatible systems, the PDF iFilter option is only displayed if PDF iFilter 9.0 x64 or 11.0 x64 have not been installed. The checkbox is selected by default and the PDF iFilter installation wizard will start automatically after you click Finish. The PDF iFilter ensures that PDF documents are indexed and therefore searchable in Document Manager.

  12. Click Finish.
    If the PDF iFilter checkbox is selected, the PDF iFilter 9.0 x64 installation wizard will start automatically. 
    When the PDF iFilter has installed, the server installation and configuration is complete. 
    Proceed to the next section to perform a workstation install of Document Manager.
Workstation (client) installation

A workstation (client) install must be performed on each workstation where MYOB Document Manager is used.

For each workstation requiring access to MYOB Document Manager, you must run the Workstation installation as a user with administrator rights totheApplicationserver.

Installation

Different setup procedures are necessary for workstations depending on the server type you use. You should start at the relevant place for your server type:

If you use a server with client workstations

From the client workstation:

  1. Log on to the workstation.
  2. Browse to ....\\<servername>\MYOBDM\setup\DocMgrWkstn.exe where <server name> is the name of your server.
  3. The installation starts.

    Continue at the MYOB Document Manager Workstation Wizard screen at Step 55 below.

If your server is a terminal server

From the terminal server console:

  1. Open Control Panel > Classic View.

  2. Click Install Application on Terminal Server.

  3. Click Add New Programs.
    The Run Installation Program wizard opens.

    Browse to . ..\\<servername>\MYOBDM\setup\DocMgrWkstn.exe where <servername> is the name of your server.

  4. Click Finish.


    The MYOB Document Manager Workstation Wizard opens.

  5. Click Next.
    The Licence Agreement window opens.
  6. Click Yes to accept the agreement.
    The Workstation Location window opens.

    At this point, you must nominate the location where Document Manager client files will be installed.
    You can accept the default location as displayed in the Folder Location - Workstation Components field, or click Browse to select a different location.
  7. Click Next.
    The Ready to Install window opens listing the installation details.
  8. Click Next to start the installation.
    If the defaults have been used the process will complete and the Installation Complete window opens.
  9. Click Finish.

    Your new Document Manager installation must be registered on the administrator’s machine only.

Additional workstations

Repeat the workstation installation for each workstation requiring access to Document Manager.

To register Document Manager

You only need to register if you've installed DocumentManager for the very first time. You may need to register if you had a temporary licence which has now expired.

After completing the install on the administrator’s machine (where MYOB AE/AO is installed), the MYOB licensing process automatically opens at the Select Component window.

Register during business hours as you'll need to call MYOB Support to get your Document Manager registration number. MYOB Support will need information from you, so be next to the server or workstation with the Register MYOB Products window open.

If necessary, run this procedure by selecting:

  • Start > MYOB Accountants Enterprise/Office > System Release Tools > Registration or
  • StartMYOB > Registration.
  1. In the Register MYOB Products window, click Add or remove products.
    In the Add or remove products window, select the components Intranet and Document Manager.
  2. Click Register.
  3. Type the RegistrationCode supplied by MYOB Support.
  4. Click Register.
    You'll see a message listing the products that have been registered.
  5. Click Close.
    MYOB Document Manager and MYOB Intranet have been registered, and are ready to use.
  6. Click Finish in the Installation Complete window.
Post-installation

After installingDocumentManager, you need to perform some checks and operations with the new software and with other integrated software.

Check your version number
  1. Open MYOB AE/AO.

  2. Select Help > About.

  3. Click Plugins.

  4. Scroll through the products listed until you find Document Manager.

    The Document Manager version should be 5.4.31.108.

Back up the upgraded MYOB AE/AO database

Before using MYOB AE/AO, back up your upgraded database:

  1. Open MYOB AE/AO.

  2. Select MaintenanceBackupBack Up Now.

  3. Press F1 on the Back up now window to access online help if you need more information.

JavaScript errors detected

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

If this problem persists, please contact our support.