Prepare to Install the Data Aggregator

To ensure that your data aggregator installation is successful, complete the requirements before you install data aggregator.
HID_Prepare_to_Install_the_Data_Aggregator
To ensure that your data aggregator installation is successful, complete the following requirements before you install a fault-tolerant aggregator or non-fault-tolerant data aggregators:
Verify the Prerequisites
Ensure that you have met following prerequisites before installing a fault-tolerant data aggregator or non-fault-tolerant data aggregators:
  • The installer requires that the data repository be installed and that the service is running. To verify that the service is running, complete the following steps:
    1. Log in to the data repository host.
    2. Issue the following command:
      su -
      dr_admin_user
      -c "/opt/vertica/bin/admintools -t show_active_db"
      The expected return shows the version of the data repository:
      version ------------------------------------ Vertica Analytic Database vx.x.x-x
  • You have verified that port numbers 8581, 61616, 61618, 61620, and 61622 are open on the data aggregator system. Remote access is required to these ports.
    For more information about the ports that are required for
    DX NetOps Performance Management
    to work properly, see Review Installation Requirements and Considerations.
    Throughout the documentation 8182, 8382, 61617, 61619, 61621, and 61623 appear as suggested port numbers for secured communications. In the instances where these ports appear, you are free to use any value you want as long as no other processes are using it. You can change port 616xx to another port after you install the data aggregator.
    For more information, see Complete the Post-Installation Configuration.
  • You have verified that ports 1099 and 11099 are blocked from external access.
    These ports must remain open locally for internal communication.
    For more information about the ports that are required for
    DX NetOps Performance Management
    to work properly, see Review Installation Requirements and Considerations.
  • You have verified that Security Enhanced Linux (SELinux) is disabled or permissive on the computer where you are going to install the data aggregator. By default, some Linux distributions have this feature enabled, which does not allow the data aggregator to function properly. Disable SELinux, set to permissive, or create a policy to exclude data aggregator processes from SELinux restrictions. If you want Security-Enhanced Linux (SELinux) to be enforcing, consult the Red Hat documentation.
    For information more about how to configure an SELinux security policy, see the Red Hat documentation.
  • To avoid potential corruption of data, you have completed the following:
    • Excluded the installation directory, the backup directory, and all subdirectories from antivirus scans.
    • Prevented scanning by a local instance of an antivirus client and scanning by a remote antivirus instance.
  • You have verified that the directory where you are going to install has write privileges for your data aggregator user.
  • The installer requires the zip and unzip packages. If these packages are not installed, you have installed them using
    one
    of the following commands:
    yum -y install zip unzip
    SUSE Linux Enterprise Server (SLES):
    zypper –y install zip unzip
  • For fault-tolerant environments, you have verified the following:
(Optional) Configure the Sudo User Account for the Data Aggregator
If you do not have root access to install and run the data aggregator, configure the sudo user account.
Follow these steps:
  1. Locate the following file on the data aggregator host:
    /etc/sudoers
  2. Add
    one
    of the following command aliases with the following permissions to the file:
    Cmnd_Alias CA_DATAAGG = /tmp/installDA.bin,/sbin/service dadaemon *,
    <installation_directory>
    /Uninstall/Uninstall,
    <installation_directory>
    /RemoteEngineer/re.sh,
    <installation_directory>
    /scripts/sslConfig.sh
    ## Allows the Data Aggregator user to manage the Data Aggregator
    sudouser
    ALL = CA_DATAAGG
    Example:
    Cmnd_Alias CA_DATAAGG = /tmp/installDA.bin,/sbin/service dadaemon *,/opt/IMDataAggregator/Uninstall/Uninstall,/opt/IMDataAggregator/RemoteEngineer/re.sh,/opt/IMDataAggregator/scripts/sslConfig.sh
    ## Allows the Data Aggregator user to manage the Data Aggregator
    sudouser
    ALL = CA_DATAAGG
    • sudouser
      Specify the user who can run the sudo commands.
    This command alias details the commands that the sudo user must be able to run.
    SLES:
    Cmnd_Alias CA_DATAAGG = /tmp/installDA.bin,/usr/sbin/service dadaemon *,/usr/sbin/service activemq *,
    <installation_directory>
    /Uninstall/Uninstall,
    <installation_directory>
    /RemoteEngineer/re.sh,
    <installation_directory>
    /scripts/sslConfig.sh
    ## Allows the Data Aggregator user to manage the Data Aggregator
    dasudouser_name ALL = CA_DATAAGG
    Example:
    Cmnd_Alias CA_DATAAGG = /tmp/installDA.bin,/usr/sbin/service dadaemon *,/usr/sbin/service activemq *,/opt/IMDataAggregator/Uninstall/Uninstall,/opt/IMDataAggregator/RemoteEngineer/re.sh,/opt/IMDataAggregator/scripts/sslConfig.sh
    ## Allows the Data Aggregator user to manage the Data Aggregator
    dasudouser_name ALL = CA_DATAAGG
    • sudouser
      Specify the user who can run the sudo commands.
    This command alias details the commands that the sudo user must be able to run.
  3. Add the sudo prefix to the data aggregator install commands by issuing the following command:
    Example:
    sudo ./installDA.bin
Configure the Limit on the Number of Open Files on the Data Aggregator
Configure the limit on the number of open files to
at least
65536 for the user that is installing the data aggregator. This configuration is permanent.
Follow these steps:
  1. As the root user or a sudo user, log in to the data aggregator host.
  2. Issue the following command:
    ulimit -n
    ulimit_number
    Example:
    ulimit -n 65536
  3. Open the
    /etc/security/limits.conf
    file, and add the following lines:
    # Added by Data Aggregator
    * soft nofile 65536
    # Added by Data Aggregator
    * hard nofile 65536
  4. Restart the data aggregator.
    (If you are upgrading) The upgrade process automatically restarts the data aggregator.
  5. Verify that the number of open files is set properly by issuing the following command:
    ulimit -n
    The command returns the limit that you specified.
Configure UTF-8 Support
Configure the data aggregator host to support UTF-8 encoding. If UTF-8 encoding is not enabled, characters might not display properly during the installation.
The appropriate language packs are also required to support localized deployments.
Some scripts that are used in the installation of selected components are not localized and run in English.
For more information, see Language Support.
Issue
one
of the following commands:
  • From a Korn or bash shell:
    export LANG=LANG_value ; export LC_ALL=$LANG
    • LANG_value
      Specifies the value of the language you want the product to support. The following variables are supported:
      English:
      en_US.utf8
      French:
      fr_FR.utf8
      Japanese
      :
      ja_JP.utf8
      Simplified Chinese:
      zh_CN.utf8
      Traditional Chinese:
      zh_TW.utf8
    For example:
    export LANG=zh_TW.utf8 ; export LC_ALL=$LANG
  • From a Bourne shell:
    LANG=
    LANG_value
    ; export LANG
    LC_ALL=
    LANG_value
    ; export LC_ALL
    For example:
    LANG=zh_CN ; export LANG
    LC_ALL=zh_CN ; export LC_ALL
The language variable is set.