cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

This product reached the end of support date on March 31, 2021.

how to use dtmigration jar to migrate individual collector instance

parveen_shaik
Inactive

Hi Team,

Could you please provide me details how to use dtmigration jar to migrate individual collector instances files on a collector server.

8 REPLIES 8

henry_apletree
Inactive

Hi Praveen,

By default the migration tool takes everything in the -sourceDTHome directory you point it to (so that should include additional collector instances in there).

However if you only want to move a specific collector instance you can use the switch
"-migrateInstances CollectorInstances"

when running the command to migrate only the non-default collector instances to the destinationDTHome.

for example
1) backup existing instance to migration archive

java -jar dynatrace-migration.jar -migration -sourceDTHome "C:\Program Files\dynaTrace\Dynatrace 6.5" -targetArchiveDir practice

2) migrate just the collector instances to the new server

java -jar dynatrace-migration.jar -migration -sourceArchive practice\<archive>.dtma -targetDTHome "C:\Program Files\dynatrace\Dynatrace 6.5" -migrateInstances CollectorInstances

Best regards,
Henry

parveen_shaik
Inactive

Hi Henry,

So let's say on one collector server we have 4 collector instances up and running with 6.1 .
Now, if I have to migrate only 2 instances to 6.5 version. Do I have to first take archive of full dynaTrace 6.1 directory (all 4 instances) and using this archive file to migrate the individual instances.

1) Backup full dynatrace 6.1 directory
java -jar dynatrace-migration.jar -migration -sourceDTHome "C:\Program Files\dynaTrace\Dynatrace 6.1"-targetArchiveDir practice

2) java -jar dynatrace-migration.jar -migration -sourceArchive practice\<archive>.dtma -targetDTHome "C:\Program Files\dynatrace\Dynatrace 6.5"-migrateInstances CollectorInstance01

Again here, in place of CollectorInstance01 - should I specify the actual instance name or the instance startup script file name.

Hello Pravee,

Taking archive is a recommended way to migrate in case.

As @Henry A. mentioned that you can migrate a single collector instance with the name.

java -jar dynatrace-migration.jar -migration -sourceArchive practice\<archive>.dtma -targetDTHome "C:\Program Files\dynatrace\Dynatrace 6.5" -migrateInstances CollectorInstances

Regards,

Babar

henry_apletree
Inactive

Hi Praveen,

Unfortunately (as far as I know) the tool does not let you target individual instances but migrates them all.

so if you run:

java -jar dynatrace-migration.jar -migration -sourceArchive practice\<archive>.dtma -targetDTHome "C:\Program Files\dynatrace\Dynatrace 6.5" -migrateInstances CollectorInstances

it will migrate over all 4 of your collector instances.

So the steps would be:

  1. create a migration archive of all collector instances
  2. use the dynatrace-migration.jar with -migrateInstances CollectorInstances to move all instances to the new installation
  3. Delete the collector instances you do not want (using "sc delete <unwantedInstanceName> and then deleting the corresponding folder from <dthome>/collector/instances

The below image shows the supported options of -migrateInstances.

If it is not possible to do this in your environment for whatever reason, then there is an option to manually migrate accross the required files. If you'd like to pursue this option please raise a ticket with Dynatrace support.

Best regards,
Henry

parveen_shaik
Inactive

Hi Henry,

Why we are looking for individual instance migration is, on the server we have already installed 6.5 version and two of the instances are running on 6.5 and other two are running on 6.1 .

Now we want to migrate to two instances running on 6.1 to 6.5.

Please suggest us on this.

henry_apletree
Inactive

Hi Praveen -
if you have two instances running at 6.5 then these should be under a different directory structure to your 6.1 instances.

the DT Migration tool only migrates instances which fall under a certain directory.
So you will probably have:

C:ProgramFiles\dynatrace\Dynatrace 6.5\Collector\Instances and

C:\ProgramFiles\dynatrace\Dynatrace 6.1\Collector\Instances.

If this is the case then if you run the dtmigration tool on the Dynatrace 6.1 directory, you will only migrate your 6.1 collector instances.

e.g.

java -jar dynatrace-migration.jar -migration -sourceDTHome "C:\Program Files\dynaTrace\Dynatrace 6.1" -targetArchiveDir backupFolder

Followed by

java -jar dynatrace-migration.jar -migration -sourceArchive backupFolder\<archive>.dtma -targetDTHome "C:\Program Files\dynatrace\Dynatrace 6.5" -migrateInstances CollectorInstances

thomasK
Dynatrace Pro
Dynatrace Pro

Hi Praveen,

the desired functionality doesn't exist yet, you can open an Request for Enhancement referencing "JLT-127809 Individual collector instance migration eg by parameter with instance name" for the tool.

Due to the way that instances work the migration is not as easy as it may seem. Several files are shared and likely you would need to shutdown all collectors to be able to migrate any one of them for file collection.

For Linux I would recommend in general to not use collector instances, but simply have multiple installation folders for each collector - this way there are completely independent and separately migratable. Unfortunately this isn't doable on Windows currently due to installer and windows services considerations.

Regards,

Thomas

thomasK
Dynatrace Pro
Dynatrace Pro

Dear all,

This feature JLT-127809 was implemented and released today in migration tool version 10.0.1.1030 with syntax:
-migrateCollectorInstance <NAME> -targetdthome X

Best regards,

Thomas