Admin console

NAM Server ► Tools ► Admin console

Warning
  • These commands are for experts only. Some of them can cause serious configuration problems if they are misused. Contact support before proceeding.
  • Availability of a command may depend on the NAM version or your user roles. Not all commands described below are available to everyone or in all releases.
  1. Open the NAM Server menu.
  2. In the Tools section, select Admin console.

Configuration management

Configuration file manager

Use the Configuration file manager to edit configuration files directly.

  1. Use the file browser to find and select the file you want to open.
    The contents of the selected file are displayed in the file in the File box.
  2. Edit the file
  3. Click Save to write your changes.

General properties editor

Use the General properties editor to edit system properties.

  • Type a string in the Search box to find relevant properties. For example, type "sql" to narrow the list to commands for which the string "sql" occurs in the property name itself or in the description of the property.
  • Click the browse buttons to page through the table of properties.
  • Type or select (if there's a list) a property value in the Value column and click Save to save that property value.
  • Click the Delete button in a row to delete that property value.
  • Enter a property value in the Value column and click Save to save that property value.
  • Click Add new to add a property and value.

Advanced properties editor

Use the Advanced properties editor to edit advanced properties.

  • Type a string in the Search box to find relevant properties. For example, type "sql" to narrow the list to commands for which the string "sql" occurs in the property name itself or in the description of the property.
  • Click the browse buttons to page through the table of properties.
  • Type or select (if there's a list) a property value in the Value column and click Save to save that property value.
  • Enter a property value in the Value column and click Save to save that property value.
  • Click Add new to add a property and value.

Capacity properties editor

Use the Capacity properties editor to edit capacity properties, such as the maximum number of clients, servers, or automatic sites.

  • Type a string in the Search box to find relevant properties. For example, type "sql" to narrow the list to commands for which the string "sql" occurs in the property name itself or in the description of the property.
  • Type or select (if there's a list) a property value in the Value column and click Save to save that property value.
  • Enter a property value in the Value column and click Save to save that property value.

Storage period

Use the Storage period editor to change data retention settings for the following data sources:

  • NAM Probe
  • Synthetic Backbone & Last Mile
  • Enterprise Synthetic
  • RUM Browser (AppMon UEM)

For each of these categories, you can set:

  • Days to store data
  • Days to store daily trends
  • Months to store monthly trends

The defaults have been well-tested. Do not change these values unnecessarily. If you do change retention values, try changes incrementally to see how they affect your data base size.

  • Changes to data retention values (number of days the data is stored) have the most potential to affect overall system performance.
  • Note that if a you retrieve the data using a data view combining various data sources, such as Application, transaction, and tier data or Synthetic and sequence transaction data, you will be able to access the data as old as the lowest settings among the data sources used. For example, Application, transaction, and tier data combines all the available data sources into one view. Using it, even though the NAM Server stores 100 days worth of Enterprise Synthetic data, you will be only able to access the data for 10 days, which is the storage period setting for the NAM Probe data.

Disk space limits

Use the Disk space limits editor to set limits related to the NAM Server drive storage.

Custom data views

Applies to NAM 2019

Use Custom Data Views (select NAM Server ► Tools ► Admin console and click Custom data views) to list custom data views and to create a view from a CSV file.

Protocols/user agents

Use the Protocols/user agents tool to:

  • List all recognized IP protocols and user agents (so-called synthetic traffic) with the corresponding numerical representations in the ID column
  • Change the aggregation setting for a protocol
  • Add new protocols

See Protocols user agents for details.

Class/type of service

Use the Class/Type of service editor to review and edit the class of service assigned to software services.

This report is available only to users with administrator rights.

  1. In the Configuration Management column, click Class/Type of Service.
    Each row lists:
    • TOS – type of service
    • Classes of service
    • Software Services assigned  – the number of the corresponding services using each pair
  2. Click the edit button to edit the class of service name that will be shown on the Network Analysis reports.
    Changes are effective immediately; you do not need to restart the report server.

Export sites (manual only)

Exports sites to the format (JSON, YAML, or Properties) you choose from the menu. You can then edit the definitions and use Import sites to import these sites into another NAM Server.
See Importing site definitions for details on how to import.

Export business hierarchy

Exports sites to the format you choose (JSON or YAML) from the menu. When the Business hierarchy export options window pops up, select check boxes (Applications and TransactionsTiers, and Reporting groups) for what you want to export and then click Export to export the business hierarchy in the selected format. You can then use Import business hierarchy to import this hierarchy into another NAM Server.

Import sites (manual only)

Imports sites that you have exported (typically from another NAM Server) using the Export sites (manual only) command.
See Importing site definitions for details.

Import business hierarchy

Imports a business hierarchy that you have exported (typically from another NAM Server) using the Export business hierarchy command.

Report queues

Applies to NAM 2019

Lists properties to configure how the NAM Server queues report generation based on how resource-intensive reports and users are. See Report queue for details.

HTTP headers

Applies to NAM 2019 Service Pack 1

Use this page to view and change custom HTTP headers: header name, header value, excluded paths.


System management

Task schedule status

Click Task schedule status to review the task schedule or run manual tasks.

Resolve all names now

Click Resolve all names now and then confirm your selection to force DNS resolution.

Start garbage collector

Click Start garbage collector to start the Java garbage collector on demand. The last line of the output displays the amount of memory released.

Purge database

Click Purge database and then confirm your selection to clear the database. You will retain the configuration but lose all data.

Restart report server

Click Restart report server and then confirm your selection to restart the current NAM Server.

Select the Restart in safe mode check box first if your want to restart in safe mode.

Controlled data processing

Data files retrieved from NAM Probes are stored on the report server, where the data can be processed on demand.

Click Controlled data processing to start on-demand processing of data files.

  • Click a time stamp to start processing the data up to a certain date/time. The report server starts processing all data up to the selected time stamp. After the completed data retrieval, the report server stops processing the data and deactivates all the connected NAM Probes.
  • Click Unset limit to enable the normal working mode of the server.
  • Click Stop processing to stop the data processing immediately. This stops data processing, deactivates all the attached NAM Probes, and removes the time limit.

Patch assistant

Click Patch assistant to upload, list, and apply software patches.

  • Click Upload file to browse for and upload patch files.
  • Click Apply patches and restart server now to apply all listed patches (in order of the Pending order column) to this machine and then restart it. If two patches have duplicate names, the later patch overwrites the earlier patch.

Diagnostics

Browse server log

Click Browse server log to open server.log in a file browser with search and filter capabilities:

  • Narrow the time range
  • Include or exclude severity levels
  • Include or exclude search strings
  • Compare to a previous log

Download server log

Click Download server log to download the server.log file.

Print threads stacks

Click Print threads stacks to write the stack to server.log and nds.log.

Commands console

Click Commands console to open the Commands console, where you can issue advanced NAM Server commands.

SQL console

Click SQL console to open the SQL console, where you can open, edit, and execute SQL commands.

  1. On the Code tab, edit a SQL command. You can load one by selecting a script from the list on the right.
  2. Click Execute to run the command displayed on the Code tab.
  3. On the Result tab, view the results of the command.

Groovy console

Click Groovy console to display the Groovy console, where you can open, edit, and execute Groovy scripts.

  1. On the Code tab, edit a Groovy script. You can load one by selecting a script from the list on the right.
  2. Click Execute to run the script displayed on the Code tab.
  3. On the Result tab, view the results of the script.

REST API documentation

Applies to NAM 2019

See NAM Server REST API for details.

Some commands are available only to user roles with elevated privileges.

REST client

Applies to NAM 2019

A REST client with which you can test NAM API calls.

Highcharts sandbox

Applies to NAM 2019

Farm status

Applies to NAM 2019

Shows the farm configuration with status indicators.

Database status report

Click Database status report to open the Database status report, which is a summary of database storage usage.

SQL diagnostic report

The SQL diagnostic report displays the following data breakdowns:

  • Overview
  • Threads
  • Templates
  • Query details (short)
  • Query details

To capture SQL diagnostics:

  1. On the NAM Server, select Admin console from the navigation menu.
  2. Select Command console.
  3. Find and select the SQLDIAG TRACE command.
  4. Execute the SQLDIAG TRACE command with the number of minutes for the trace and optional thread and SQL masks.
    "SQLDIAG TRACE is ON" will display.
  5. When the capture is complete, execute the SQLDIAG SHOW FILES command to list all available files.
    Copy the file name for the trace you want to browse.
  6. Execute the LOAD SQL TRACE FILE command (paste the trace file name) to download the trace file and browse it in the SQL diagnostics report.
  7. To turn off SQLDIAG TRACE, execute SQLDIAG OFF.
    "SQLDIAG TRACE is OFF" will display.

DMI query diagnostic report

Click DMI query diagnostic report to open a report on DMI query performance by

  • Data view
  • Report name
  • Section
  • Details

Utilities sandbox

Click Utilities sandbox to access the following:

  • Css documentation
  • Farm visualization
  • Highcharts debug
  • REST Client

Applies to NAM 2019

Starting with NAM 2019: