Install a Low-Scale System

In a standard large-scale deployment, the data aggregator and data collector components require dedicated nodes. For some smaller deployments of 150,000 polled items or less, you can run these components on a shared single node.
HID_DA_DC_shared_host
For some smaller deployments of 150,000 polled items or less, you can run the data aggregator and the data collector on a
shared
single node (a low-scale system install). Install a low-scale system by deploying
DX NetOps Performance Management
with the data aggregator and the data collector on a single node.
For information about the sizing requirements, see the DX NetOps Sizing Tool.
In standard high-scale environments, deploy
DX NetOps Performance Management
with the data aggregator and the data collector on
separate
dedicated nodes.
Limitations
In a low-scale system install, the following options are not supported:
  • Calculated metrics beyond 150,000 metrics per second
  • Fast (1-minute) polling
  • Integration with
    DX NetOps Mediation Manager
    or
    DX NetOps Virtual Network Assurance
  • Multiple data collectors
  • Multiple IP domains
  • Multiple tenants
  • Polling beyond 150,000 items
How to Install a Low-Scale System
Use the following process to deploy
DX NetOps Performance Management
with the data aggregator and data collector on a single node:
  1. Install
    NetOps Portal
    .
    For more information, see Install
    NetOps Portal
    .
  2. Install the data repository.
    Because the data repository in a low-scale system is deployed on a single node, skip the steps that refer to cluster installation.
    For more information, see Install the Data Repository.
  3. Install the data aggregator.
    For more information, see Install the Data Aggregator.
  4. Install and configure the data collector on the same host as the data aggregator using the following procedures:
    The data collector configuration does not persist through upgrades. During the upgrade process, upgrade and configure the data collector according to these procedures.
    3
Install the Data Collector
Install the data collector on the same host as the data aggregator.
Follow these steps:
  1. Log in to the shared host.
  2. Verify that the data aggregator service is running by issuing the following command:
    service dadaemon status
    For RHEL 7.x or OL,
    service
    invokes
    systemctl
    . You can use
    systemctl
    instead.
  3. If the service is not running, do one of the following steps:
    • Start the data aggregator service by issuing the following command:
      service dadaemon start
    • (Fault-tolerant environment) Issue one the following commands to enable the fault tolerant data aggregator so that it can start when necessary:
      • RHEL 6.x:
        service dadaemon activate
      • RHEL 7.x, SLES, or OL:
        <installation_directory>
        /scripts/dadaemon activate
        • installation_directory
          The installation directory for the data aggregator.
          Default:
          /opt/IMDataAggregator
  4. Verify that the Apache ActiveMQ broker is running by issuing the following command:
    service activemq status
    If the service is not running, start the ActiveMQ service by issuing the following command:
    service activemq start
  5. Download the data collector installer:
    wget -nv http://<
    da_host>
    :8581/dcm/InstData/Linux/VM/install.bin
  6. Make the install file executable by issuing the following command:
    chmod a+x install.bin
  7. Do one of the following steps:
    • Stop the data aggregator and ActiveMQ services by issuing the following commands:
      service dadaemon stop
      service activemq stop
    • (Fault-tolerant environment) If the local data aggregator is running, issue one the following commands to shut it down and prevent it from restarting until maintenance is complete:
      • RHEL 6.x:
        service dadaemon maintenance
      • RHEL 7.x, SLES, or OL:
        <installation_directory>
        /IMDataAggregator/scripts/dadaemon maintenance
        • installation_directory
          The installation directory for the data aggregator.
          Default:
          /opt
  8. Install the data collector by issuing the following command:
    ./install.bin -i console
  9. Follow the instructions in the console.
    The installer prompts you for the hostname or IP address of the data aggregator host. Supply the hostname of the shared host. The data collector is installed and the data collector and ActiveMQ services start. After a short time, the data collector service fails because the data aggregator service is not running.
  10. Uninstall the ActiveMQ service on the data aggregator by issuing the following command:
    <installation_directory>
    /IMDataAggregator/scripts/activemq uninstall
    • installation_directory
      The installation directory for the data aggregator.
      Default:
      /opt
  11. Install the ActiveMQ service on the data collector by issuing the following command:
    <DC_installation_directory>
    /IMDataCollector/scripts/activemq install
    • DC_installation_directory
      The installation directory for the data collector.
      Default:
      /opt
Reconfigure the Data Collector
After you have installed the data collector on the shared host, reconfigure the data collector to use the shared host. On a shared host, the data aggregator and data collector use a single ActiveMQ broker.
Follow these steps:
  1. Stop the data collector and ActiveMQ services by issuing the following commands:
    service dcmd stop
    service activemq stop
  2. Modify the data aggregator startup script:
    1. Edit the
      <installation_directory>
      /scripts/dadaemon
      file.
      • installation_directory
        The installation directory for the data aggregator.
        Default:
        /opt
    2. Modify the
      ACTIVEMQ_HOME
      variable to point to the ActiveMQ broker on the data collector by issuing the following command:
      ACTIVEMQ_HOME="
      <DC_installation_directory>
      /broker/apache-activemq-
      *
      " export ACTIVEMQ_HOME
      • apache-activemq-*
      • The installation directory for ActiveMQ.
        To find the correct version, go to the
        <DC_installation_directory>
        /broker
        directory.
  3. Disable the data aggregator ActiveMQ broker heartbeat:
    1. Create the
      <
      installation_directory
      >/IMDataAggregator/
      apache-karaf-*
      /etc/com.ca.im.dm.core.amq.cfg
      file.
      • installation_directory
        The installation directory for the data aggregator.
        Default:
        /opt
      • apache-karaf-*
        The installation directory for Apache Karaf.
        Example:
        apache-karaf-4.2.6
      Create this file as the user running the data aggregator to ensure the correct permissions are set on the new file.
    2. Edit the file and insert the following property configuration:
      jmsbroker-heartbeat-disabled=true
    3. To disable log messages that are related to the data aggregator heartbeat manager, edit the
      <
      installation_directory
      >/IMDataAggregator/
      apache-karaf-*
      /etc/org.ops4j.pax.logging.cfg
      file.
      • installation_directory
        The installation directory for the data aggregator.
        Default:
        /opt
      • apache-karaf-*
        The installation directory for Karaf.
        Example:
        apache-karaf-4.2.6
    4. Insert the following property configuration:
      # Disable ActiveMQ Health Monitoring log messages in shared DA/data collector mode log4j2.logger.JmsHeartbeatManager.name=com.ca.im.core.jms.heartbeat.JmsHeartbeatManager log4j2.logger.JmsHeartbeatManager.level=OFF
  4. Modify the Karaf JMX management properties:
    1. Edit the
      <DC_installation_directory>
      /IMDataAggregator/
      apache-karaf-*
      /etc/org.apache.karaf.management.cfg
      file.
      • DC_installation_directory
        The installation directory for the data collector.
        Default:
        /opt/IMDataCollector
      • apache-karaf-*
        The installation directory for Karaf.
        Example:
        apache-karaf-4.2.6
    2. Set the following properties:
      rmiRegistryPort = 1199
      rmiServerPort = 44445
  5. (Optional) To support the ability to debug the data aggregator and data collector components simultaneously, modify the Karaf debug port:
    1. Edit the
      <DC_installation_directory
      >/IMDataCollector/
      apache-karaf-*
      /bin/karaf
      file.
      • DC_installation_directory
        The installation directory for the data collector.
        Default:
        /opt
      • apache-karaf-*
        The installation directory for Karaf.
        Example:
        apache-karaf-4.2.6
    2. Set the following property:
      DEFAULT_JAVA_DEBUG_PORT=5006
  6. Do
    one
    of the following steps:
    • Start the data aggregator service by issuing the following command:
      service dadaemon start
    • (Fault-tolerant environment) Issue one the following commands to enable the fault-tolerant data aggregator so that it can start when necessary:
      • RHEL 6.x:
        service dadaemon activate
      • RHEL 7.x, SLES, or OL:
        <installation_directory>
        /scripts/dadaemon activate
        • installation_directory
          The installation directory for the data aggregator.
          Default:
          /opt
  7. Start the data collector service by issuing the following command:
    service dcmd start
  8. The data aggregator and data collector services start on the single host. Complete post installation configuration for your deployment.
Validate the Deployment
Validate the deployment by verifying that the required services are functioning as expected.
Follow these steps:
  1. Validate that the data aggregator service is running by issuing the following command:
    service dadaemon status
  2. Validate that the data collector service is running by issuing the following command:
    service dcmd status
  3. Validate that the ActiveMQ Broker is running by issuing the following command:
    service activemq status
  4. Validate that the ActiveMQ Broker being run is the data collector broker by issuing the following command:
    service activemq status
    The returned message must include the following information:
    Status for ActiveMQ: INFO: Loading '<
    DC_installation_directory
    >/IMDataCollector/broker/
    apache-activemq-*
    /bin/env
    '
    • DC_installation_directory
      The installation directory for the data collector.
      Default:
      /opt
    • apache-activemq-*
      The installation directory for ActiveMQ.
    If the message does not show the data collector installation directory, repeat the step in the previous procedure to modify the data aggregator startup script.