You can upgrade the RUM Console from a previous version by installing the current version of the RUM Console over the existing installation.
Planning and preparation
- Read the upgrade guidelines for essential planning information:
- The general order of upgrade activities is important. For example, you must upgrade the console before installing the report server.
- Hardware requirements and recommendations.
- Licensing requirements, including third-party licensing. You need licenses for Microsoft Windows Server and Microsoft SQL Server hosting the report server software and database. You need to make decisions related to SQL Server licensing in particular.
- Network preparation.
- The final version of the console must be the same version as the other components of your deployment or the configuration of any new or enhanced features may not possible.
Upgrading RUM Console from 12.4 to 2017
If you are upgrading from a 12.4.x release and you plan to import existing users from the CSS to the RUM Console, make sure your 12.4 CSS is operational and accessible.
Upgrading the DC RUM deployment involves upgrading individual components in a specific order. The 12.4.x CSS installation should continue to operate and administer the components that have not been yet upgraded. We recommend that you maintain your 12.4.x CSS operational until all DC RUM components are upgraded.
The installation wizard walks you through all steps in the correct order.
Exit all other programs before running the setup program.
Double-click the RUM Console setup file.
Depending on your release the file name should be similar to
On the License Agreement screen, indicate that you have read and accepted the license agreement and click Next.
The installer will guide you through the upgrade of the RUM Console. Click Next to advance the wizard.
- Upgrade the application without changing the settings.
The database and the CSS information used during the upgrade is obtained from the previous installation of the RUM Console.
- Reinstall application and change settings for the new version.
You will have to provide the database, user and connection properties for the upgrade.
Import security database
Since DC RUM does not use the CSS to manage DC RUM users (RUM Console took over this role), you may import the users from the existing CSS or proceed with a clean user database and manually add all current and future users.
Import user accounts now.
You import user accounts from the existing CSS. The CSS information is obtained from the previous installation of the RUM ConsoleCannot connect to CSS.
The installer cannot find the CSS that was listed in the configuration of the previous RUM Console. Make sure your the CSS is operational and accessible by the machine with the RUM Console. Provide the valid CSS information on the next screen.Incorrect CSS version.
The CSS that was listed in the configuration of the previous RUM Console did not respond. The problem may be with the address of the CSS or the version of the CSS you are importing users from. You can only import users from 12.4.x versions of CSS. Provide the valid CSS information on the next screen.
Proceed with a clean user database.
The local database will be used and you will have to provide the User name and Password for the new administrator account to be created.
Security database migration
If you choose to import user accounts from an existing CSS installation, you must provide the CSS address and the administrator for import source.
- CSS address
Enter the 12.4.x CSS host name or the IP address.
Enter the 12.4.x CSS port (default port for accessing the CSS is
- User name
Enter the user name of the CSS administrator.
- User password
Enter the password of the CSS administrator.
On the Pre-Installation Summary page, review the summary of your installation choices and click Install.
To change the settings, click Back to return to the appropriate configuration screen.
On the Ready to Start screen, indicate whether to start the console services and then click Done.
Export the audit logs from the existing CSS.
Export CSS security log
Generate a report that shows any authentication attempts, user additions or other events on the CSS.
Open the CSS console.
See Accessing the CSS console.
To see results from a different time range, enter new values in the From Date: and To Date: fields, and then click Apply. The report updates to reflect the time range selected.
- Select Show system user audit events to report on changes to the system user account (used to facilitate communications between CSS and the integrated components).
- Click CSS Audit Purge Configuration to purge audit records.
Note the default values for record retention and when to purge the system. Change these if needed and click Save Purge data.
- Click Export CSS Audit Log to create a
.CSVfile of the audit.
Export CSS configuration log
Records for configuration changes made in the Enterprise Synthetic console are stored in the CSS audit event database. These records appear in a configuration audit report that can be viewed in the CSS console.
The information in this report includes specific details such as the user who made the configuration change, the type of change, the time the change was made, and the IP address and host name of the affected Agent Manager and Agent machines.
To access the report:
From the Enterprise Synthetic console, select File ► Central Security Server ► Console. The CSS console will open, displaying a list of tasks.
By default, the CSS Audit Events tab appears, along with a second tab for Enterprise Synthetic Audit Events.
Select the Enterprise Synthetic Audit Events tab.
Any configuration changes made during the last 24 hours are displayed.
To see results from a different time range, enter new values in the From Date: and To Date: fields, and then click Apply.
The report updates to reflect the time range selected.
Optional: Click Export to create a
.CSV file of the audit.
Upgrading RUM Console 2017 to NAM Console
You can use a standalone NAM Console installer or you can use the full NAM installation set.
- Open the downloads page for NAM.
You need to register with the site and obtain a login before you can access it.
- Download an installer.
You can download a full installation set in one .iso file, or download a NAM Console installer separately if you don't need the full NAM installation set.
- Exit all other programs before running the setup program.
- Run the NAM Console setup file.
- When the installer starts, follow the upgrade steps in order.
Most of the Quick upgrade panels will contain automatically detected values from the existing installation. If you do not want to change these values, click Next to continue the upgrade.
If you want to review or change the settings, use the Full option where all settings can be modified, refer to the console installation topic where all of the installation steps are described.
If you need to change any information after upgrade, see Changing settings after you install the software.
Installer screen details
Read the introduction to make sure you are installing the right product and the right version, and that you have seen any additional recommendations.
You need to read and accept the license agreement before you can install the software.
Existing installation detected
Both options will upgrade (or reinstall) the NAM software from the installer but preserve all of your configuration settings where possible.
- Quick will skip installation screens you don't need to update when installing the software. If a feature is new or changed, however, it will display that installation screen for you to configure.
- Full will step you through all installation screens so you can review the current settings and change them as necessary.
Both options will upgrade the software (or reinstall) from the installer but preserve all of your configuration settings where possible. The difference is in whether you want to review (and possibly change) your configuration.
NAM Console public connectivity
These settings determine the URLs on which each NAM Server in your deployment will access the NAM Console. If a NAM Server cannot reach the NAM Console, the NAM Server user will be unable to sign on to the NAM Server.
For more information, see SSO network configuration requirements and Private addresses and public URLs of NAM components.
Enable HTTPS (secure) remote connections at this URL
- HTTPS URL
When HTTPS is selected, this is the URL on which each NAM Server in your deployment will access the NAM Console.
(NOT recommended) Enable HTTP (unsecure) remote console connections at this URL
HTTP is not secure, so we do not recommend HTTP.
- HTTP URL
When HTTP is selected, this is the URL on which each NAM Server in your deployment will access the NAM Console.
If you need to change this information after installation, see Changing settings after you install the software.
Review this information and copy anything you might need later.
After you install
After you install the NAM Console, you should see:
- Dynatrace > NAM Console on the Windows Start menu
Dynatrace\NAM\Consolein your Windows Program Files directory
See Private addresses and public URLs of NAM components for an explanation of how NAM private addresses and public URLs are used.
After you have installed the NAM Console and at least one NAM Server, verify that you can sign on to the NAM Server. All NAM sign-on activity automatically (and transparently) goes through your NAM Console, so you have to make sure every NAM Server in your deployment can see the NAM Console in your deployment.
Using the public URL for that NAM Server, make sure that you can:
- See the NAM Server in your web browser
- Sign on to the NAM Server
- Access the reports and other screens you need to access
Changing installation settings after you install the software
If you need to change a value (a URL, for example) that you set during installation:
- In Windows, open the Apps & features panel.
- Find the NAM Console in the list, click it, and select Uninstall to start the installer/uninstaller application.
Don't worry if Modify is unavailable. The Uninstall option will not uninstall anything unless you choose the Uninstall NAM Console option on the Welcome screen:
- When the change options are displayed, select the option you need:
- Change HTTP and SSL Server settings
- Change database user password
- Click Next to go to the configuration screens.
If the software must be stopped before you can make your changes, you will receive a warning. It may take a few moments to stop the software.