If you use AppMon Server instances that you created using the
dtserver -instance command, you likely have two or more servers configured. The following steps let you to separate them into two separate installations, or distinct installation folders.
You should not perform an upgrade and separate the instances in a single step.
First, split the instances into two distinct installations, for example
inst2. Once you have split the installation instances, then upgrade each one separately. The following shows the workflow.
Windows requires a separate OS installation for each of the server installations, matching its sizing requirements. This can imply new hardware, virtual machines or Windows licenses. The
.msi installer prohibits multiple installations on the same OS.
With separate server, differentiate between the following:
- The default server instance with most configuration files in
- The (zero to many) server instances with the most configuration files in
Perform the following before making any changes:
- Download the latest Migration Tool.
- Stop all components in all instances running from
- Back up all system before starting, especially the existing full installation directory using the following command:
java -jar dynatrace-migration.jar -migration -sourceDTHome "<DT_HOME>" -targetArchiveDir "<ARCHIVE_DIR>"
Migrate the default server instance using the additional parameter
-migrateInstances default when migrating from the migration archive to
<DT_HOME_NEW> which is the target migration directory. See the Upgrade and Migration Guide for more information.
For the remaining server instances, where
<DT_HOME_OLD> is the original AppMon installation directory, for each AppMon Server instance, where
<INST_NAME> denotes the instance name, perform:
- Install a new AppMon Server using the installer on the target host.
- Migrate all files, including files such as
.inifiles and agent resources shared between the default server instance and the server instance by executing the following command.
java -jar dynatrace-migration.jar -migration -sourceDTHome "<DT_HOME_OLD>" -targetDTHome "<DT_HOME_NEW>"where
<DT_HOME_NEW>is the selected installation folder, for example
- Execute the following command to migrate the server instance files to the default server instance.
java -jar dynatrace-migration.jar -migration -sourceDTHome <DT_HOME_OLD>" -targetDTHome "<DT_HOME_NEW>" -migrateInstances serverinstances -makeServerInstanceDefault "<INST_NAME>".
- Delete the
<DT_HOME_NEW>/server/instancesfolder for cleanup and configuration verification.
Port offsets for the previous instance server remain in place.
- All system profiles of the default instance and the migrated instance are migrated. From
<DT_HOME_NEW>/server/conf/profiles, remove all
*.profilefiles that are only in
<DT_HOME>/server/conf/profilesand not also in
- Dashboard files have server instance references included. Either open each dashboard in the AppMon Client and set correct data source, or replace the server instance name in XML files before starting the server.
- For Linux only, update all
init.dfiles. To do this, remove the variable values for
<DT_FE_INSTANCE>. Keep the
-portoffsetparameter in the
<DT_FE_OPTARGS>for new services (DTANG Adapter).
Apply general rules for multiple installations on the same system, for instance:
- different startup and shutdown scripts referencing the correct installation (init.d)
- separate TCP / UDP ports