Getting started

Documentation / C/C++ Edition / User Guide / Web / Admin / Introduction / Getting started

Manage runtime configurations

This section describes how to create and manage runtime configurations. The following section describes step by step how to create and activate a new runtime configuration and in a second part how to load and activate an older configuration.

  1. By default the myarmadmin application provides a read-only view of runtime configuration data. Therefore to create or change runtime configurations we need to enter the edit mode by hitting the "Edit" button of the "Control area":

    Figure: The "Edit" button within "Control area"
  2. The "Control area" changes and the "Cancel" and a text field are displayed. Enter in the text field a name of the configuration. This name is to identify the configuration and is presented in the loading configuration dialog later.

    Figure: The "Cancel" button and configuration name text field within "Control area"
  3. Real time statistics are always arranged in groups. Therefore we need to enter a group name to associate real time statistics as depicted in Figure "Entering a RTS group name".
    admin-rts-group-add
    Figure: Entering a RTS group name
    admin-rts-group-added
    Figure: RTS group "MyGroup" added
    Figures: Adding a real time statistics group

    In Figure "RTS group "MyGroup" added" the group is added to the list of RTS groups and automatically selected. Now the "New" is enabled within the real time definition view. Clicking this button will open the following dialog to enter a new real time statistic definition.

  4. The RTS definition dialog is used to create a new definition or to change an existing one. Here we create a new RTS definition. To do so we need first to select the application name for which an real time statistic should be generated:

    Figure: Selecting the application for a RTS definition

    In our case we select the application "httpd" for the Apache-HTTPD-Server. In brackets the associated identity properties of the ARM application definition is shown.

  5. Next we select the appropriate transaction definition name here "HTTP":

    Figure: Selecting the transaction "HTTP" for a RTS definition

    In brackets the associated identity properties and context property names of the ARM transaction definition is shown.

  6. After selecting the application and transaction definition names we want to create a real time statistic for we need to name our new RTS definition:

    Figure: The name and URI filter of the RTS definition

    The real time statistic is named "HTTP-myApp" and it generates statistics for "HTTP" measurements with an URI containing "/myApp" string.

    Note that now all needed data is entered the "Ok" button is enabled thus it is possible to apply our inputs.

  7. However there are some more data we can define for the RTS definition:

    Figure: RTS definition interval and thresholds
    1. the aggregation interval in minutes for the real time statistic
    2. the threshold unit from a drop-down-box selecting
      "12 ms"
      milliseconds
      "12.35 ms"
      milliseconds with fraction
      "12 s"
      seconds
      "12.35 s"
      seconds with fraction
    3. two thresholds to define response time constraints to estimate the response time in three categories:
      • below threshold 1 is the expected response time (good)
      • below threshold 2 is the tolerated response time (tolerated)
      • above threshold 2 is a bad response time (not wanted)

    Given all this data we can click the "Ok" button and the RTS definition is created.

  8. We created a new real time statistic definition called "HTTP-myApp". The next step is to store the complete new runtime configuration into the database. This can be achieved by clicking on the "Save" button within the "Control area":

    Figure: Save complete runtime configuration (Click to enlarge)
  9. After clicking the "Save" button the configuration is stored with a new version number into the database:

    Figure: Newly created RTS definition stored in database (Click to enlarge)

    As depicted in Figure "Newly created RTS definition". The created RTS definition is stored in the database with the configuration name "Demo-Config" at revision number "3" and created by user "demo".

  10. To activate the newly created runtime configuration we need to inform any configured myarmdaemon process about the new runtime configuration. This can be done by clicking the "Activate" button in the "Control area". This will bring up an activation dialog which allows to select the configured hosts where myarmdaemon processes are running:

    Figure: Runtime configuration activation dialog

    As shown three hosts are configured to accept runtime configurations, here "localhost", "myarm.local" and "myarm.info". The check boxes before each host name can be used to exclude a host from the current activation. To activate the runtime configuration just click the "Activate" button:


    Figure: Runtime configuration activation dialog result

    After clicking the "Activate" button and few moments the activation results are displayed in the dialog:

    1. The myarmdaemon running on "localhost" denied the new configuration by resetting the connection. This can happen if the connection was initiated from a not allowed host.
    2. The myarmdaemon running on "myarm.local" successfully received and activated the new runtime configuration.
    3. On "myarm.info" no myarmdaemon is running.