Upgrading from NAM 2018 to NAM 2019

This section describes how to upgrade any NAM 2018 release to the latest NAM 2019 release.

Order is important

This is a short version of the upgrade procedure. It covers major upgrade points. It does not include steps like database upgrade, upgrade paths and deployment backups.

Upgrade all components in the prescribed sequence to perform a successful NAM upgrade:

(if necessary) Upgrade TCAM: TCAM upgrade via GUI

Use this checklist to organize your upgrade or migration to the target release. This checklist is designed for customers who have their Dynatrace products at releases that support a direct upgrade to current release.

Step 1. Learn from others

Review lessons learned from migrations conducted by other users so far and learn what to watch for and what to avoid.

Step 2. Create inventory

Note your current versions, components, databases, and agents.

Components and integrations applicable for NAM upgrade:

  • NAM Server with their MS SQL databases and Windows operating systems.
    Pay attention if your report servers operate in a farm.
  • NAM Console with its MS SQL database and Windows operating system.
  • NAM Probe with its Red Hat Enterprise Linux operating system.
  • TCAM agent installed on Citrix XenApp server.

Choose your path

See upgrade paths, compare it against your inventory, and download all required installation packages at their latest Service Pack release.

Step 3. Get license

You may be required to match the license versions to the upgrade version. Get the NAM license by filling out the licensing form.

Step 4. Review your system

Compare your inventory against official recommendations. Depending on the result, prepare to obtain required operating system installation media and licenses, as well as prepare to upgrade your hardware if necessary.
Check the requirements and recommendations before proceeding.

Apply service packs

Apply any released service packs and updates to your current NAM environment. Go to the downloads page for your product to see whether service packs are available.

Back up your setup

Back up your current NAM environment, including databases.

Step 5. Upgrade the NAM Console

Upgrade the NAM Console from a previous version by installing the latest version of the NAM Console over the existing installation. Go to the downloads page for the installation package.

Step 6. Upgrade NAM Server

Upgrade the NAM Server report server from a previous version by installing the latest version over the existing installation. Go to the downloads page for the installation package.

Farm upgrade
Farm deployments are particularly sensitive to component upgrade order. See Upgrading Farm Deployments for more.

Step 7. Apply component licenses

Skip if you have capacity licenses
If you use capacity licenses, you can skip this step. Capacity licenses should be applied after the NAM Probe (old AMD) upgrade.

In the NAM Console, use either the Online license management or the Offline license management to upload and activate the component licenses:

Apply component licenses to every standalone NAM Server (old CAS) within your deployment.

Farm upgrade
If your deployment uses clusters, apply the component license to the primary NAM Server (old CAS) server of each cluster within your deployment.

Step 8. Upgrade the NAM Probe

Upgrade Linux

Make sure your NAM Probe is running Red Hat Enterprise Linux 7.x (64-bit), the Red Hat Enterprise Linux installation media and license, and access to additional packets required by NAM Probe.

Upgrade monitoring software

Upgrade the monitoring software from a previous version by installing the latest version of the software over the existing installation. Make sure you have the appropriate license and go to the downloads page for the installation package.

Step 9. Apply capacity licenses

Skip if you have component licenses
If you use component licenses, you can skip this step. Component licenses should have been applied after the NAM Server (old CAS) upgrade.

In the NAM Console, use either the Online license management or the Offline license management to upload and activate the capacity licenses:

Apply capacity licenses to every NAM Probe (old AMD) within your deployment.

Step 10. Upgrade TCAM

Upgrade the TCAM agent if you use it to instrument Citrix XenApp or XenDesktop server. Go to the downloads page for the installation package.

Compatibility notes

Citrix 7.x
In general, the NAM ICA decode and TCAM work with all Citrix 7.x releases, but you should be aware of the following limitations concerning NAM and Citrix 7.x:

  • TCAM reports a loopback address as the client IP address if the client comes through NetScaler.
  • The ICA decode does not report on Citrix Framehawk channels or on traffic that uses Citrix EDT transport instead of TCP.