Side by side migration from LANDESK Management Suite 9.6 to 2016 or 2016 to 2016.3

Version 25

    Verified Product Versions

    LANDESK Management Suite 9.5LANDESK Management Suite 9.6LANDESK Management Suite 2016.x


    DESCRIPTION

     

     

    A side by side migration consists in having both your existing LANDesk Management Suite Core Server and your future Core Server running at the same time.

     

    You can either use a new clean database or use your current database and have it upgraded to the new version.

     

    I will cover here the second choice: migration using the current database.

     

        ATTENTION: Please note that this article covers a basic side by side migration, which means that if you have other LANDESK products like a CSA, then you will first have to think or ask about how to migrate it as well.

     

    Environment tested:

     

    • LANDesk Management Suite 9.5 SP2 to LANDesk Management Suite 9.6        [30.07.2014]

     

    PROCESS OVERVIEW

     

     

    1. Backup your existing Core Server (This is not covered in this article, you may want to have an image of your Core server copied on a media/server)
    2. Backup your database
    3. Backup Critical Core Server Files
    4. Backup Other Needed Files and Information
    5. Prepare your new Microsoft Windows 2012 Server for your future Core server (Installation and configuration of the server are not covered in this article as it depends on the infrastructure you manage)
    6. Install your Microsoft SQL Server 2012
    7. Create and configure your database
    8. Restore your database to the new server
    9. Install LANDesk Management Suite on the new server
    10. Import your certificates
    11. Migrate your clients by deploying a new agent
    12. Additional Considerations
      1. Core Server DNS Redirect

     

     

    WARNINGS

     

     

    This article is not supposed to get you through the issues you may fix, but to give you a good starter guide if you want to do a side by side migration.

    If you actually encounter any error, please contact us through the support portal or our community web site.If you have any customized settings, queries or files, please be aware that you should take screenshots of these configurations, and save the files that may not be saved by our CoreDataMigration tool.

     

    If you plan on changing corenames, then you will need to use the DNS alias for MDM devices to still communicate to the core. Please see doc: Using a Core server DNS alias with the Cloud Service Appliance.

     

     

    I. Backup your existing Core Server

     

     

    You should have a snapshot/image of your Core Server in order to be able to roll back.

     

     

    II. Backup your existing database

     

     

        VIDEO: Backup your LANDesk Management Suite 9.5

     

     

    From Microsoft SQL Server Management Studio, go to Databases, Tasks, Back Up and check where this backup goes to copy it to your future Core Server.

    backupdb.pngbackupdb2.png

     

    In this case, it goes to:

     

        C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Backup\

     

        Remember to copy this ".bak" file as it is your future database.

     

     

    III. Backup Critical Core Server Files

     

     

        VIDEO: Core Data Migration LDMS 9.5

     

     

    LANDESK has created a tool to backup critical files to a share. This tool is called CoreDataMigration.exe.

     

    Newer versions of CoreDataMigration.exe may backup files that were not backed-up in previous versions.

    One of the Management Suite 9.6 installation files is an updated CoreDataMigration.exe and it may be better to use the Management Suite 9.6 version instead of the version that is currently on the Core Server.

    NOTE: The Ivanti 2017.1 CoreDataMigration.exe will not work on previous versions. Instead, just use the CoreDataMigration.exe that is in the \landesk\managementsuite folder on the current core server. Please refer to the CoreDataMigration.exe document for further details. 

     

    The new Management Suite 9.6 version of CoreDataMigration.exe can be found in the Management Suite 9.6 installation media under the:

     

        \LANDESK\PF\LD\MS\_non

     

    If Management Suite 9.6 was downloaded, extract LANDESKSoftware.exe to access this file, situated in the Resources folder:

    extract resources 9.6.png

     

    Once you have copied the folder Resources on your 9.5 Core server, create a folder named CoreBackup, in this example:

     

        C:\CoreBackup\

    extract resources 9.6 2.png

     

    Then open a Command Prompt (CMD) and browse to the folder where you extracted the Resources folder, in this example:

     

        cd C:\Resources extracted from 9.6\

     

    And type the following command (in this example):


        CoreDataMigration.exe GATHER C:\CoreBackup\

     

    It may be necessary in some situations to use a local backup directory to work around NTFS and share permissions.

    CoreDataMigration.pngsaveddata.png

     

    You will be able to find in your CoreBackup folder the critical files you will need for your migration (your scripts, certificates, ldlogon folder with your application packages, etc.), if you want to use them in your new 9.6 environment, you can copy/paste them from this folder to your future Core Server once the full installation is done.

     

     

    IV. Backup Other Needed Files and Information

     

     

        Some files will not be automatically saved, you must be careful in order to be sure you will have a backup of everything:

     

    • Distribution Package installation files, if stored on a package share created on the Core Server

     

    • The Patch directory, if it is stored on the Core Server

     

    • \ldlogon\ldappl3.template, if modifications have been made to it

     

    • \ldlogon\AgentWatcher\*.ini files

     

     

    V. Prepare your new Microsoft Windows 2012 Server

     

     

    In order to be sure that your Windows Server installation is going to match your infrastructure needs, please check the following articles:

     

     

     

    Ensure that your server has the latest updates.

     

        Then do not forget that the following items are NOT SUPPORTED for the Core Server installation:

     

    • A Primary Domain Controller (PDC), Backup Domain Controller (BDC), or an Active Directory

     

    • A Domain Controller

     

    • A server that has been upgraded from a previous version of windows

     

    • Servers running other third-party applications as their primary server function such as a SharePoint server

     

     

    VI. Install Microsoft SQL Server 2012

     

     

        VIDEO: Install SQL Server 2012 for a Side by side migration of LMDS 9.5 to 9.6

     

    The installation and configuration of Microsoft SQL Server 2012 is described in this document:

     

     

    You may also find these links useful:

     

     

     

     

    VII. Create, configure your new database and restore your old one

     

     

        VIDEO: Database creation, configuration and restore for Side by side migration 9.5 to 9.6

     

        An important point here is not to install LANDesk Management Suite on the new server before you restore your old database as the installation process has to convert your old database into the new version.

     

    First you will need to create a new database, so right click on Databases, New Database and put these settings:

    createdb.pngcreatedb2.png

     

    Then create your database administrator by going into Security, right click Logins, New Login:

    createdbadmin.pngcreatedbadmin2.png

     

    Now you need to restore your old Database into this new database we just created, to do so, right click your new database, Tasks, Restore, Database

     

    • In the General tab, check Device and indicate the path of your old database backup file (*.bak) we made in the previous steps, after that double-check that the Destination Database is the one you created earlier

     

    • In the Files tab, check the Relocate all files to folder option

     

    • In the Options tab, check the Overwrite the existing database (WITH REPLACE) option

     

    restoredb.pngrestoredb2.pngrestoredb3.pngrestoredb4.pngsuccess.png

     

    Then validate and you are now ready to install LANDesk Management Suite to the new server. Here is a good article as well about this Backup / Restore process:

     

     

    VIII. Import your certificates

     

     

        VIDEO: Import LDMS 9.5 certificates to your 9.6 Server for a side by side migration

     

    In order to use some features on your new LANDesk Management Suite server with your old clients, you will need to have a certificate they already trust.

     

    The files you will need have normally been saved during our CoreDataMigration done earlier except the keys directory.You will need to manually copy core certificate files. These files must be handled securely and should only be placed in a secure location. You can copy them into the CoreBackup folder, but they must be handled with care. You must copy the following files shown below.

     

     

     

    You will find these files in the CoreBackup folder you created, in:

     

        C:\CoreBackup\landesk\Shared Files\keys\

     

    You must copy the following files:

     

    • C:\Program Files\LANDesk\Shared Files\Keys\*.key
    • C:\Program Files\LANDesk\Shared Files\Keys\*.crt
    • C:\Program Files\LANDesk\Shared Files\Keys\*.0      
    • C:\Program Files\LANDesk\Shared Files\Keys\ldcryptoconfig.xml
    • C:\Program Files\LANDesk\Shared Files\Keys\Compatible\*.xml(These files will only exists if client security mode is enabled)

     

    Copy them into your new keys folder on your new server, it may look like this:    C:\Program Files\LANDesk\Shared Files\KeysYou also have to copy the *.0 file to your new ldlogon folder, which should be there:    C:\Program Files\LANDesk\ManagementSuite\ldlogonOnce this is done, your new LANDesk Management Suite Server will be able to directly remote your clients, with the highest security features enabled.Here is an article that might be interesting:

     

    IX. Install LANDesk Management Suite 9.6 (or the most current version)

     

    Before starting the install on the new core, you should first create the C:\Program Files\LANDesk\Shared Files\Keys directory and copy ldcryptoconfig.xml into it from your CoreBackup.  This will ensure data that was encrypted and written in the database will be decrypted properly.

     

     

    If files were copied from C:\Program Files\LANDesk\Shared Files\Keys\Compatible, then they must also be restored back into this directory

     

        VIDEO: Install LANDesk Management Suite 9.6 for Side by side Migration from 9.5

     

    First, download our 9.6 Core Server installation package from this page:

     

     

    Then extract the files on your server and the installation will begin.

     

        For this installation, you will only have to be careful with the following settings:

     

    • How should LANDESK configure your database: Upgrade an existing 9.5 database

     

    • Database information: Enter your Server name, Database name we created earlier, User we created earlier as well and its Password

     

    ldms1.pngconfirmation.pngconfiguration.png

     

    Here are the articles you may find useful as well for this process:

     

     

     

    X. Migrate your clients by deploying a new agent

     

     

    After having done all of this, you should have your infrastructure looking like this:

    infrastructure.png

     

     

    What we want now is to have our clients directly reporting to our new Server. In order to do that properly, you will have to create new agents (similar to your previous settings if you want) and deploy them gradually with pilot groups/computers.

     

        Keep in mind that once you have deployed an agent to your client, it may not be manageable anymore from your old server.

     

    Once all of your infrastructure has been "moved" to your new LANDesk Management Suite Server, you can shut down your old server, which will look like this:

    infrastructure2.png

     

        You must be aware as well that a side by side migration can be pretty long and complex as you will have to manage both your old and new server until you are sure of your new settings.

     

     

    Additional Considerations

    Creating a Core DNS Redirect

     

    Some administrators after following this document may encounter some issues where existing agents/agent functions are attempting to communicate with the old core rather than the new, despite the old core having already been removed from production. To avoid such issues, it is recommended as a best practice that administrators after performing a side-by-side migration setup a DNS redirect that will take all traffic intended for the previous core name/fqdn and route it to the new core. This can help to avoid complications and ensure that agent functions remain functional through the migration.

     

    ATTENTION: Please note that DNS redirection is problematic for devices behind CSA (Cloud Services Appliance), reinstallation of the agent on these devices will be required to avoid communication issues.

    You will need to manually copy core certificate files. These files must be handled securely and should only be placed in a secure location. You can copy them into the CoreBackup folder, but they must be handled with care. You must copy the following files: