Upgrading MobiControl

The following steps outline the procedures for upgrading an existing MobiControl installation. Please read all of these instructions before proceeding.

Once the Manager and  software has been upgraded, the devices will appear in the Manager console with a warning sign. This is an indication that Agent Upgrade must be enabled in order for the automatic upgrade of the to proceed.

For example, if after enabling a few test devices for which problems are found with the agent, the upgrade can be "rolled back" and the majority of devices will avoid the failed upgrade.






  1. Back up MobiControl file store.


    This is only applicable to MobiControl versions 2.06 and earlier. To back up your file store, use the Microsoft File Explorer to copy the contents of the file store to a backup folder.

  2. Back up the MobiControl database.


    This step is optional, since the MobiControl will automatically back up your database. However, as a extra precautionary measure, you may back it up independently. If you are using the lightweight Microsoft SQL Server Desktop Engine (MSDE) you may use the OSQL command-line utility.

    To back up your database using OSQL, you must log in, specify the back-up command, then execute it.


    Example:

    C:\> osql -Usa -P123456
    1:>BACKUP DATABASE MobiControlDB TO DISK='C:\\mydir\\mybackup.bak'
    2:>GO
    1:>QUIT


    Further information about the OSQL utility is provided online by Microsoft at http://support.microsoft.com/default.aspx?scid=kb;en-us;325003.

    If you are running the full Microsoft SQL Server, you can backup your database using the Backup tool provided with Microsoft SQL Server Enterprise Manager. Optionally, you may use a third-party back-up utility.



  3. Close all MobiControl Manager windows and shut down all MobiControl s.



  4. Run the updated Setup program.


    Select the Repair/Upgrade option and follow the setup instructions in the . This must be run on the prior to updating any of the MobiControl Manager consoles.


    Installing MobiControl



    5. In the dialog box about the existing database connection configuration, select Yes.


    Installing MobiControl



    The next dialog box prompts for keeping the old database or getting rid of it and creating a new one. Since we are upgrading, we want to keep the existing database, so select Yes.



    Installing MobiControl



    Another dialog box will appear only if you have a registration code that is an older format. To exchange it and get a new registration code, you must and provide your existing registration code followed by the company name and the person to whom the product is licensed.





  5. Back up the existing SQL database.


    The default option is set to Yes. If you select No, please specify a folder to which to back up.

  6. Enter information.

    A box will be pre-filled with your existing name. To keep the same name, select Next.

    Installing MobiControl

    Select Yes to use the name you specified in the last step.

    Installing MobiControl
  7. Complete the installation.


    Installing MobiControl

    Repeat steps 4-7 on each computer that has MobiControl Manager, Package Studio or a installed.



  1. Verify the s have restarted.


    Click the in the MobiControl Manager to verify the s are active. If a server is not running, you can start it by right-clicking on the icon and selecting Start Server. If the is located on a separate host from that on which you are running the MobiControl Manager, you will have to log in to that host (e.g. Windows Remote Desktop) and re-start the MobiControl Deployment Server by opening the Control Panel, clicking Administrative, and clicking Services.



    Upgrade

    Re-start (s)






    2. Important:

    At this point, all the devices in the device tree will appear with a warning sign. This is an indication that agent upgrade must be enabled in order for the automatic upgrade of the s to proceed. Automatic upgrade is not enabled by default so that agent upgrade can be performed gradually. This allows you to upgrade a controlled set of devices and verify the new agent performs well before upgrading the agents of all your devices. For example, if after enabling for a few test devices, problems are detected with the new agent, the upgrade can be rolled back, and the majority of the devices will avoid the failed upgrade.

  2. Enable upgrade for one device.


    Right-click on a device, select Agent Upgrade, and click Enable. If the device is already online, select Upgrade Now. If the device is not yet online, there is no need to select Upgrade Now, as the new agent will be automatically delivered upon connection to the when upgrade is enabled.



    3. Installing MobiControl






    Note:

    As part of the upgrade process, the device will disconnect from the MobiControl server and go into the offline state. The upgrade will proceed on the device while it is disconnected, and then upon completion it will automatically re-connect and return to the online state. When the device goes offline, the warning sign will re-appear on the device icon in the device tree. This is normal, and done intentionally to prevent the device from repeating its attempt to upgrade if the upgrade process fails on the device. When the upgrade is successful, the warning sign will automatically disappear when the device returns online.

  3. Verify the build number.

    When the device returns online, verify the build number by selecting the device and looking at the Info panel. If there is any conflict with the version you have installed (compare to the version information in the Manager's about window), and the version currently on the device, or if there are any error messages in the log panel, please .


    Installing MobiControl


  4. Verify communication with the selected device.

    Try remote controlling it. Verify the MobiControl configuration by checking for installed packages, s, lockdown, etc. If you are unable to connect to the device or experience any issues, please .

  5. Gradually enable upgrade for all devices.

    Enable one group at a time in the device tree, and verify the devices in each group have been updated successfully.

    The device menu option Agent Upgrade will automatically disappear once all devices have been upgraded. In the event problems are detected during upgrade, select Agent Upgrade and click Disable to prevent the upgrade from taking place on devices for which upgrade has been enabled, but has not yet taken place. If the upgrade does not complete successfully after one attempt (three attempts in Windows Mobile 5 and above) the upgrade agent will disable itself and you will have to enable it again to continue the upgrade process.

    If you experience any difficulties or unexpected behavior, .