999

MDaemon 14.0.x - Moving MDaemon with BlackBerry Enterprise Server to a different path or machine

How do I move MDaemon v14.0.x with BlackBerry Enterprise Server (BES) to a different path or drive on a different machine?

Note: The slow sync process does not add messages older than when the user activated their BlackBerry smartphone. Older messages that synchronized during the initial Enterprise Activation will delete from the device.

Note: This procedure will cause duplication on MDaemon BES activated Smartphones. Step 15 in the procedure will attempt to clean up the database and will then resynchronize the data onto the BlackBerry Smartphones. If you do not wish to cause duplication on the MDaemon BES activated Smartphones, you can then skip Step 13-14, & 17 and reactivate each user manually.

  1. Ensure you have an up to date backup of the BES database (See Related Articles).
  2. On the old machine, remove MDaemon’s service from the OS.
    1. Click the Setup menu
    2. Click Preferences 
    3. Click Windows Service
    4. Click Remove Service button
    5. Click Apply 
    6. Click No to not Restart MDaemon 
  3. On the old machine, deactivate MDaemon and AntiVirus/SecurityPlus:
    1. Click the Help menu
    2. Select Activate your Alt-N Software...
    3. Click Deactivate your MDaemon software... and follow the prompts


      Follow the same steps and choose Deactivate your SecurityPlus software... if you have that installed.
  4. The next steps will stop all MDaemon and BES traffic (This is necessary to avoid any conflicts with the new server):
    1. Click the Setup menu
    2. Click Mobile Device Management... 
    3. Click Options under BlackBerry Enterprise Server
    4. Enable Stop BlackBerry services when MDaemon stops
    5. Enable ...also stop SQL 'MDaemon' database service
    6. Click OK 
    7. Click the File menu
    8. Click Stop MDaemon 
  5. Download and install the same version of MDaemon that was in use on the old machine into the new directory.
  6. Ensure you enable MDaemon as a SYSTEM service at the end of the installation
  7. Start MDaemon on the new machine:
    1. Click the Windows Start button
    2. Click Programs
    3. Click MDaemon
    4. Click Start MDaemon
  8. The next steps will stop all MDaemon and BES traffic (This is necessary to avoid any conflicts with the old server):
    1. Click the Setup menu
    2. Click Mobile Device Management... 
    3. Click Options under BlackBerry Enterprise Server
    4. Enable Stop BlackBerry services when MDaemon stops
    5. Enable ...also stop SQL 'MDaemon' database service
    6. Click OK 
    7. Click the File menu
    8. Uncheck Enable WebAdmin Server
    9. Click Stop MDaemon 
  9. On the new machine, navigate out to the \MDaemon\ directory using Windows Explorer and move the contents of the directory, excluding the \MDaemon\BES\ directory, to a Temporary folder of your choice.
  10. Copy the \MDaemon\ directory, excluding the \MDaemon\BES\ directory, from the old machine to the new machine. Place the directory where you installed MDaemon in step 5.
  11. Edit the following files with a text editor (For example, Windows Notepad) to update any references to the previously used path to the new one (if the files do not exist in your environment, you may skip them):
    • \MDaemon\App\AccountTemplates.dat
    • \MDaemon\App\cfilter.ini
    • \MDaemon\App\mdaemon.ini
    • \MDaemon\App\mdstats.ini
    • \MDaemon\App\autoresp.dat
    • \MDaemon\App\gateways.dat
    • \MDaemon\App\plugins.dat
    • \MDaemon\App\reminders.dat
    • \MDaemon\App\schedule.dat
    • \MDaemon\App\filelist_*LANGUAGE CODE*.dat
      • The filelist_XX.dat file is a description of the various DAT files and directory paths.
      • Changing this effects nothing other than changing the directory descriptions
    • \MDaemon\App\*.grp
      • These files are mailing lists.
      • GRP files may or may not have a reference to the old path.
    • \MDaemon\SpamAssassin\rules\local.cf
    • \MDaemon\WebAdmin\webadmin.ini
    • \MDaemon\WorldClient\domains.ini
    • \MDaemon\WorldClient\worldclient.ini
  12. Update the user's directory within the UserList.dat file:
    1. Click the Windows Start button
    2. Click Run...
    3. Type 'cmd'
    4. Click OK
    5. Navigate to the \MDaemon\App\ directory (For Example: 'cd C:\MDaemon\App\')
    6. Type 'dirreorg /f'
      Note: This process updates the paths in the MDaemon UserList.dat file to the setting in the MDaemon.ini (it sets the existing user mailboxes to use the new default path). If you are using ODBC as your user account database, you will have to manually update the database or use a script to update them.
  13. Start the SQL Server (MDaemon) Instance:
    1. Click the Windows Start button
    2. Click Run...
    3. Type 'services.msc'
    4. Click OK
    5. Right Click SQL Server (MDaemon)
    6. Click Start
  14. Restore the latest MDaemon BES database backup file (See Related Articles). (This will cause duplicates on the MDaemon BES Activated BlackBerry Smartphones. If you do not wish to complete this, please read the Note at the top of this article)
  15. Start MDaemon on the new machine:
    1. Click the Windows Start button
    2. Click Programs
    3. Click MDaemon
    4. Click Start MDaemon
  16. Activate MDaemon:
    1. Click the Help menu
    2. Click Activate Your Alt-N Software
    3. Click Activate Your MDaemon Software... and follow the prompts 
  17. In order to have MDaemon correct the BES database:
    1. Click the Setup menu
    2. Click Mobile Device Management... 
    3. Click Integrated Accounts under BlackBerry Enterprise Server
    4. Click Start a slow sync for all BlackBerry activated accounts 
    5. Acknowledge the MDaemon dialog box and click OK
    6. Click OK
      Note: The Slow Sync process can take a long time depending on how many devices you have activated and how large their mailboxes are. 

Additional Comments

If you have Outlook Connector or SecurityPlus installed on the old machine, you will need to re-install them on the new machine after you complete the above procedure. This procedure will save your existing settings for these applications.

If you are changing your IP address(es) in addition to moving MDaemon, the MDaemon.ini, Domains.dat, and/or Gateways.dat will need to be updated to reflect the new IP address(es).