Migrating Insight Media Groups and Shares to LUNA

Owned by Luna
Last updated: Aug 30, 2012Version comment
3 min read

Introduction

You can perform a one time only migration of Media Groups and Share Folders from your Insight Collections to LUNA.
This process is a single direction process and you will NOT be able to synchronize Media Groups between LUNA and Insight.
You should plan your timing of this process carefully. This should be done with your end users knowledge of what and when this process will take place. Your end users may have a significant amount of work invested in creating and managing these Media Groups and Shares. They should also be very familiar with the new LUNA interface and how they can access their Media Groups once migrated.

Migrating the Content


Prerequisites

On the Install disk for LUNA you will find the utility for the migration in
\utilities\media_group_migration_to_LUNA folder

  • You will need access to each Insight Collection Manager on your server and database port access. Basically, if you can run the Admin Tools from the machine doing the migration, then you have sufficient database access to perform the migration.


  • You will need the InsightServer.dat for each collection you plan to migrate the Collection level Groups from.


  • You need the InsightUserServer.dat for the User Manager.


  • You need the LunaServer.dat that was created at the Install time of LUNA. This file is contained in <LUNA Install directory>/resources/For_Media_Group_Migration


  • These files have the database connection information in them and will be used for the migration.


  • You will need access to the User Managers Image-Group-Files folder. This can be a copy or the original.


  • The utility uses Java 1.4 and it will need to be available for the migration. All of the Insight servers use Java 1.4 so you can reference the Insight Server version.


  • Make sure all Shares have an owner. This can be done using the Admin Tools and looking at the Owner Column of the User Shares. If they do not have an owner, please assign one or a random owner will be assigned at the time of migration.



IMPORTANT NOTE
If you are migrating virtual collections, you will need to modify the VCIDToLunaIID.txt file.
On the left enter the Insight VCID for the collection VC_Archivision_Digital_Research_Library_(Base-1)
Then enter a tab character
Next enter the Institution ID for the LUNA collection
ARCHIVISIONACM_Base-3
For example:
VC_Archivision_Digital_Research_Library_(Base-1)ARCHIVISIONACM_Base-3
Do this for each virtual collection you are migrating from.

Steps for the Collection Level Group Migration


  1. Copy the media_group_migration_to_LUNA folder to the location where you will perform the migration.


  1. Copy the LunaServer.dat into your media_group_migration_to_LUNA folder.


  1. Edit the LunaServer.dat.


    1. Modify the MediaGroupDefaultPassword= property to set the password used to Protect the Media Groups in LUNA.
    2. Set the ImageGroupFileDir= to point to the Image-Group-Files folder.


  1. Copy the InsightServer.dat into your media_group_migration_to_LUNA folder.


  1. Edit to the run_collectiongroupexport.bat (windows) or run_collectiongroupexport.sh (Linux or Solaris) to point to a local version of Java 1.4 if it is not in your PATH environment.


  1. Execute the run_collectiongroupexport script (only once) if you run this twice, you will end up with duplicate Media Groups.


  1. Verify that the Media Groups are in your LUNA system located in Explore/Media Groups.


  1. Repeat for each Collection Manager that you are migrating Collection Level Media Groups from by replacing the InsightServer.dat.




Steps for Migrating Insight Shares and Media Groups


  1. Copy the media_group_migration_to_LUNA folder to the location where you will perform the migration.


  1. Copy the LunaServer.dat into your media_group_migration_to_LUNA folder.


  1. Edit the LunaServer.dat.


    1. Modify the MediaGroupDefaultPassword= property to set the password used to Protect the Media Groups in LUNA.
    2. Set the ImageGroupFileDir= to point to the Image-Group-Files folder.


  1. Edit to the run_shareexport.bat (windows) or run_shareexport.sh (Linux or Solaris) to point to a local version of Java 1.4 if it is not in your PATH environment.


  1. Execute the run_shareexport script (only once). If you run this twice, you will end up with duplicate Media Groups.


  1. Verify that the Media Groups are in your LUNA system located in Explore/Media Groups.