LDSTechForumWikiProjects

MLS installation and repair

 Ldsorg int.png[Clerk Support]


MLS administration

It is sometimes necessary to do a clean MLS installation or to repair other problems with MLS.

Basic installation

You will need to download MLS using a computer that has an Internet connection. If your Church administrative computer does not have an Internet connection, download MLS to a removable storage device.

  1. Login to the MLS download site.
  2. Click the download MLS link.
  3. Select the option to save the file; save to a removable storage device.
  4. Install MLS from the removable storage device on the administrative computer.
  5. Reboot your computer after installation is complete.

Upgrade installation

Most upgrades of MLS are done automatically during the MLS Transmission process. A restart of MLS (and generally also of the computer) is required after the upgrade to make the changes effective.

For some larger upgrades, it can save precious time on Sunday if the full upgrade is installed a day or more before Sunday. This can be done by following the Basic Installation instructions above.

In either case, the first time MLS is run after the upgrade, a progress bar often displays briefly while the MLS database is updated.

Transfer installation (MLS 3.4.x)

When you need to move a unit's MLS data from one computer to another:

  1. Backup MLS from the old computer to a thumb drive.
  2. Follow the Basic Installation instructions above to install MLS on the new computer.
  3. Start MLS on the new computer.
  4. Enter the unit number, stake unit number, and administrator username and password when prompted.
  5. Restore from Backup File
  6. Call administrative office and have the "security token" reset for your unit.
  7. Do a Send/Receive from the new computer to verify you can send and receive data.
  8. Uninstall MLS on the old machine.


Transfer installation (Older versions of MLS)

When you need to move a unit's MLS data from one computer to another:

  1. Follow the Basic Installation instructions above to install MLS on the new computer.
  2. Backup MLS from the old computer to a thumb drive.
  3. Close MLS on both computers.
  4. Delete the C:\Program Files\LDS Church\MLS and C:\AFARIA files from the new computer.
  5. Copy the entire C:\Program Files\LDS Church\MLS directory from the original computer to the new computer.
  6. Copy the C:\AFARIA directory from the original computer to the new computer.
  7. Start MLS on the new computer.
  8. Restore from Backup.

When you send/receive changes after the swap, you will likely receive a notice of a security violation. Call your administrative office to let them know what's been done, and they can fix the problem in a few minutes.

Clean installation

Occasionally an installation of MLS has so many problems that it is necessary to completely remove the current installation and do a new clean installation.

Preparation

  1. If MLS is in a runnable state:
    • Make a backup of MLS: Within MLS, go to File > Backup to a File. Be sure to save it to removable media or to some location on the hard drive from which it can be easily retrieved.
    • Go to System Properties, and on the System tab locate the dialer phone number(s). Write them down just in case they cannot be restored.
    • Exit MLS
  2. Save the Data folder and dialer settings:
    • Go to C:\Program Files\LDS Church\MLS.
    • Copy and paste the Data folder to the Desktop.
    • Copy and paste the Dialer.properties file to the Desktop.

Uninstall

In Add/Remove Programs:

  1. Remove all instances of MLS
  2. Remove all instances of Afaria Client

If the computer stops while cleaning the registry, click Cancel. If the computer does not respond, press CTRL+ALT+DEL, then end the task in Task Manager.

Clean folders

Check the following places to make sure the appropriate folder/ file is gone. If it is not, delete it.

  1. Check C:\: Make sure AFARIA is gone.
  2. Check C:\: Make sure UDX is gone.
  3. Check C:\Program Files\LDS Church: Make sure AClient is gone. If you can’t delete the AClient folder, then go to your Startup (Start > Programs > Startup) and delete Afaria client generic scheduler.
  4. Check C:\Program Files: Make sure jre5 and jre6 are gone.
  5. Check C:\Program Files\LDS Church: Make sure that the MLS folder is gone.
  6. Check Start > Settings > Control Panel > Network Connections: Make sure MLS is gone.
  7. If the Afaria Client program does not reinstall so that you can see it in the Control Panel under Add or Remove Programs you should delete the contents of the: C:\Documents and Settings\CLERK\Local Settings\Temp> folder and attempt to reinstall MLS. (The symptom of the Afaria Client program not being installed is that the Send/Receive process in MLS causes the MLS program to drop/close.)

Reinstall MLS

Follow the steps above under Basic Installation.

Repair registry

Note: Follow the following three steps only if your computer stopped at the registry while trying to remove MLS in the Add/Remove Programs. This should fix any registry issues that you might have.

  1. Once you have successfully installed MLS; go to Add/Remove Programs in the Control Panel and remove Afaria Client and all instances of MLS.
  2. Re-install MLS and restore your backup.
  3. You might need to call Clerk Support to reset the connection security.

Restore data and settings

Copy the Data folder from the Desktop to C:\Program Files\LDS Church\MLS.

Restore dialer settings

Copy the Dialer.properties file from your Desktop to C:\Program Files\LDS Church\MLS. Then in MLS go to the System tab of System Options.

  • If you use dial-up to connect: Verify that the correct phone numbers are listed. You should always have the toll free number (18884137028), and in most cases you will also have a local number. Make sure that your "connection" is "Use Modem".
  • If you use high speed Internet, it is generally best to use the "Auto Detect" connection setting (so that you can use the modem to transmit if the Internet connection is unavailable), but if you have connection problems, try the "Use Internet" option instead.

Verify connection

If you need to “ping” the server to make sure that you’re connecting:

  • Click on Start, click on Run, type cmd, and the command prompt should come up.
  • In the command prompt type: ping rmt.ldschurch.org

You should get something that looks like the example provided below. If you did not get a response like this, then contact the Global Service Center.

Pinging rmt.ldschurch.org [10.98.250.240] with 32 bytes of data:

Reply from 10.98.250.240: bytes=32 time=2ms TTL=253
Reply from 10.98.250.240: bytes=32 time=2ms TTL=253
Reply from 10.98.250.240: bytes=32 time=2ms TTL=253
Reply from 10.98.250.240: bytes=32 time=2ms TTL=253

Ping statistics for 10.98.250.240:
    Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
    Minimum = 2ms, Maximum = 2ms, Average = 2ms

File paths

MLS 3.3 and later stores files in a folder structure that begins with a base path which is different for Windows XP and Windows 7. The base path is:

  • WinXP: C:\Documents and Settings\All Users\LDS Church\MLS\
  • Win7: C:\ProgramData\LDS Church\MLS\ (note: this is a hidden folder)

When upgrading from WinXP to Win7 you may need to change the owner of the "LDS Church" folder and propagate that change to all children. If you receive a Java error which prevents MLS from running on Win7 do the following:

  • Right-click on the "LDS Church" folder and choose "properties"
  • Select the "Security" tab
  • Click the "Advanced" button
  • Select the "Owner" tab
  • Click the "Edit" button
  • Select "Clerk" and enable the checkbox for "Replace owner on subcontainers and objects"
  • Click "OK" until you have exited the properties window

From the base path, files are located in the following folders:

  • mods: Module folder (Confidential forms, LUCR, etc.)
  • data: Properties and logs
    • product.properties: the old mls.properties file (where you change language)
    • dialer.properties: dialer.properties file (to fix transmission problems)
    • udx.properties: udx.properties file (to fix transmission problems)
    • mlslog.txt: MLS log
  • manual\MLS Manual.pdf: MLS manual (in case you want to look at it outside of MLS)
  • data\units\<unit number>\data: mlsData folder
  • recover\<unit number>\data-backup<number string>: mlsDatabackup folders (to copy data.properties file)
  • data\units\<unit number>\vault: data vault (where saved forms are located)
  • data\udx: UDX folder under Application Data, delete to fix transmission problems
  • data\sync: old UDX folder under root of C drive, delete to fix transmission problems

See also

This page was last modified on 23 July 2012, at 17:49. This page has been accessed 30,393 times.

Note: Content found in this wiki may not always reflect official Church information. See Terms of Use.