Install the Data Aggregator

Once you have met the requirements to install Data Aggregator, complete the installation as follows:
capm360
Once you have met the requirements to install Data Aggregator, complete the installation as follows:
Install the Data Aggregator
To install a Data Aggregator in silent mode, run the installation and create a response file. Use the response file to run future installations in silent mode. To generate the response file, follow the installation procedure, and add the response file argument when you run the installDA.bin file.
To install the Data Aggregator, the Data Repository must be running. To verify the status of the Data Repository, run the following command on the Data Repository host:
su -
dr_admin_user
-c "/opt/vertica/bin/admintools -t show_active_db"
Follow these steps:
  1. Log in to the Data Aggregator host as the root user or the sudo user.
  2. Copy the installDA.bin file to the /tmp directory.
  3. Change to the /tmp directory:
    cd /tmp
  4. Change permissions for the installation file:
    chmod a+x installDA.bin
  5. To run the console installation, do one of the following steps:
    • To run the installation as the root user, type the following command:
      ./installDA.bin -i console
    • To run the installation as the sudo user, type the following command
      sudo ./installDA.bin -i console
    To generate a response file for silent installation, add the following argument:
    -r
    response_file
    response_file
    specifies the directory the directory path and file name for the response file.
    Example:
    /temp/installer.properties
    Follow the prompts until you get to the summary, type "quit", and press Enter.
    To run the installation in silent mode, use the following command:
    ./installDA.bin -i silent -f
    response_file
    response_file
    is the directory path and file name of the previously generated response file.
  6. Follow the instructions in the console.
    When you are prompted for the data directory, use the default directory. Do not use
    DA_Install_Directory
    /apache-karaf-
    version
    /data
    .
  7. When prompted, specify the following parameters for Data Repository:
    • Data Repository server hostname/IP
      Defines either a name or an IP address for the Data Repository server host.
      For a Data Repository cluster, specify the name or the IP address of any one host in the cluster. The installer automatically determines the name and IP address of the remaining nodes.
    • Data Repository server port
      Defines the port number for the Data Repository server.
      Default:
      5433
    • Database name
      Defines the database name of Data Repository.
    • Data Repository username
      Specifies the username that Data Aggregator uses to connect to the database. The username and the password cannot match. This username and password combination is added to the database during the installation.
      Example:
      dauser
    • Data Repository admin username
      Specify the Linux user account that was used to install Data Repository. This username is needed for administration, such as backing up and restoring Data Repository, or updating the database schema.
      Example:
      dradmin
    • Data Repository admin password
      Defines the password for the Data Repository admin username.
      This database user account password was specified when you created the database after the Data Repository installation.
      Example:
      dbpassword
      If necessary, a
      doEncryption.sh
      script is available to edit the
      dbconnection.cfg
      file. For example, you can use the script to change your Data Repository admin password.
  8. (Optional) When prompted, specify the following parameters for fault tolerance. For more information, see Fault Tolerance.
    • Configure Data Aggregator For Fault Tolerance
      Specify 2 to configure fault tolerance.
      Default:
       1
      The default is for a non-fault tolerant environment.
    • Data Aggregator Proxy Host
      Specify the host name/IP address of the proxy server.
    • Consul HTTP port:
      Specify the port for communication with Consul.
      Default:
       8500
    • Choose host IP address for Consul
      This prompt appears only when multiple public IP addresses are configured.
      Specify the bind address that the Consul agents use to communicate with each other. The Consul agents include the proxy host and both Data Aggregators in the cluster. If prompted for an address, specify an address that the other two hosts in the Consul cluster can reach.
  9. The Data Aggregator is installed and started.
Verify the Data Aggregator Installation
For the Data Aggregator installations, we use the static location of /etc/DA.cfg to store where the Data Aggregators are installed and the chosen installation options for upgrade.
Follow these steps:
  1. Verify that the Data Aggregator service is running:
    service dadaemon status
  2. Review the following log file on the Data Aggregator host:
    /opt/IMDataAggregator/Logs/CA_Performance_Management_Data_Aggregator_Install_
    timestamp
    .log
    If the installation is successful, the log shows 0 Warnings, 0 NonFatalErrors, and 0 FatalErrors.
    If the installation fails early enough in the process, the log file may be available in the home directory of the root or sudo user.
  3. Verify that the ActiveMQ broker is running:
    service activemq status
  4. Open a browser on a computer where you have HTTP access to Data Aggregator. Navigate to the following address:
    http://
    da_host
    :8581/rest    
    da_host
    specifies the Data Aggregator host name or IP address.
    The return is a list of hyperlinks for available web services. When you click a link, the XML content describing the selection displays.
Register Data Aggregator as a Data Source
To connect
Performance Center
to the Data Aggregator, register Data Aggregator as a data source.
Follow these steps:
  1. Log in to
    Performance Center
    as an administrator user. Access
    Performance Center
    at the following URL:
    PC_host:8181/pc/desktop/page
  2. Navigate to
    Administration
    ,
    Data Sources
    .
  3. Click
    Add
    .
  4. Select Data Aggregator for the Source Type, specify the required information, and click
    Save
    .
    For a fault tolerant environment, specify the proxy server host name. For more information, see Fault Tolerance.
    Wait a few minutes for Data Aggregator to synchronize automatically with
    Performance Center
    .