If you are migrating the Server to a new host without upgrading to a new version, you only need to perform the applicable steps.
1. Install the new Server, Collectors, and Clients
Install the new AppMon Server, Collectors and Clients into a new directory, referred to as
<DT_HOME_NEW> in these instructions.
At the end of the installation, you are prompted to start the Server, Collector, and Client. Do not start these components at this time.
See Silent Installation for automation.
2. Deactivate and Upgrade License
3. Shut down the old version
Stop the old Client, Server, Frontend Server, Collector and Memory Analysis Server services.
Disable automatic startup of the old Server, Frontend Server, Collector and Memory Analysis Server:
- Windows: Control Panel > Administrative Tools > Services. In each service's properties, set the Startup type to Manual.
- Unix systems: Use
4. Create backups
Using the configuration information collected during preparation:
- Back up your Performance Warehouse DB.
- Back up your Session Store.
- On *NIX, back up all AppMon scripts in
DT_HOME are backed up during the next step.
5. Data migration (Server, Collector and Memory Analysis Server)
5.1. Data collection
Create a migration archive:
java -jar dynatrace-migration.jar -migration -sourceDTHome "<DT_HOME_OLD>" -targetArchiveDir "<ARCHIVE_DIR>"
<DT_HOME_OLD> is the old AppMon installation path. A
<MIGRATION_ARCHIVE> file named
<Server_name>_<creation_dateTime>.dtma is created in
Keep the resulting file as permanent backup.
5.2. Data migration
On the target host, as Administrator or configured user, migrate the data to
<DT_HOME_NEW> using the following:
java -jar dynatrace-migration.jar -migration -sourceArchive "<ARCHIVE_DIR>/<MIGRATION_ARCHIVE>" -targetDTHome "<DT_HOME_NEW>"
Backups and migration logs are created in a new directory in
5.3. Register and Auto-start additional collector instances
If you used Collector instances in the old installation:
- Windows: In the directory
<DT_HOME_NEW>, for each Collector instance, using the same
<CollectorInstanceName>as in the old version, execute:
dtcollector -service install -instance <CollectorInstanceName>
- *NIX: In
/etc/init.d, for each Collector instance, there is an old startup script named
<NN>is a number. For each such file:
- Take note of the values for the variables
- Replace it with the new version:
cp <DT_HOME_NEW>/init.d/dynaTraceCollector /etc/init.d/dynaTraceCollector<NN>.
/etc/init.d/dynaTraceCollector<NN>and fill in the noted values for
- Take note of the values for the variables
6. Auto-start new services
update-rc.d, make sure that the new Server, Collectors, Memory Analysis Server, and Frontend Server are started automatically with
/etc/init.d shell scripts and that the permissions are correct.
7. Start the new Server components
If you configured a
DT_HOME environment variable, update it to
<DT_HOME_NEW>, and then start the AppMon Server and Frontend Server. When upgrading from 6.3 and earlier, for the first startup, leave a few minutes before starting the Analysis Server after the Frontend and Backender Server startup, to prevent JLT-194884 which could cause the loss of the PWH configuration.
8. Client migration
If users are allowed to reconfigure their client settings such as proxy, skip this step. Otherwise, compare old and new files and carry over your changes:
- After a first client start in each user home the old and new
- Defaults for new users on a machine:
9. Start the new Client
dtclient or use the Webstart Client at
Be sure to connect to the right AppMon Server (hostname) in the Settings > Dynatrace Server > Connectivity pane.
10. Activate licenses for the new Server
If you require a proxy server to access the Internet, manually configure the Client proxy settings to access the online licensing eServices site.
To import the Server and UEM licenses, click Settings > Dynatrace Server > License > Import and follow the instructions.
11. Select server sizing
After the license import, you are presented with different sizing options. Select the Sizing that you identified during the Preparations. It is important to perform this step before starting the new Collectors, to avoid Out-of-Memory problems.
12. Apply update to new AppMon
13. Start new Collectors
Start the new Collectors, then choose Settings > Dynatrace Server > Collectors and verify that all Collectors are connected to the Server. If you applied an update (to the new Server), you should immediately restart the Collectors from this dialog box for the update to be applied.
The AppMon Server and Collectors now accept Agent connections again.
14. Stand-alone Memory Analysis Server
If the Memory Analysis Server resides in a separate installation directory or machine, stop and disable the old version and install and connect the new version. No configuration migration or usage of the migration tool is necessary.
15. Connect the Performance Warehouse
In Settings > Dynatrace Server > Performance Warehouse:
Verify the configuration
Click Test and Connect
Wait for the data migration to complete.
See troubleshooting if you encounter an error.
Next: Upgrade Agents