Installing the DNCA software

Use the following information to install the DNCA software to your physical server or virtual machine. If you are deploying your Network Capture Application to a cloud-based environment, refer to the installation procedures for those environments.

Procedure

  1. Log in to the server by using the root account.
    Note: The installation must be run as root.
  2. Open a command prompt.
  3. If you are using RHEL 8.7 with DNCA 12.1.4 or DNCA 12.1.6, move to Step 4. Otherwise, enter yum install Discover-DNCA-<nn.n.n>-<rrr>.<distro>.<architecture>.rpm to install the DNCA software.

    Where:

    • <nn.n.n> is the build version number.
    • <rrr> is the RPM revision number. The revision numbers is usually a single digit number.
    • <distro> is an identifier for the Linux™ distribution, such as "RHEL n" for Red Hat Enterprise Linux™ release n.
    • <architecture> is i686, x86_64.

    By default, the DNCA software is installed in /usr/local/dncauser. You specify the alternate directory by using the rpm command's --prefix option along with the installation and upgrade commands.

    The following are some sample rpm invocations.

    rpm -i --prefix=/opt/Discover Discover-DNCA-<nn.n.n>-<rrr>.<distro>.i386.rpm
rpm -U --prefix=/home/Discover Discover-DNCA-<nn.n.n>-<rrr>.<distro>.i386.rpm

    When you do not use the --prefix option during an install or upgrade, RPM uses the default installation directory that is specified in the DNCA package file, which is /usr/local/dncauser. Once you relocate a package, you must specify the alternate directory when you apply upgrades so that the package correctly checks for and updates previous installations.

  4. If you are installing DNCA versions 12.1.4 and 12.1.6 on RHEL 8.7, complete the following steps:
    1. Change your role to superuser.
    2. Run the following command: 
      yum downgrade cyrus-sasl

      Running the earlier command downgrades cyrus-sasl rpm to cyrus-sasl-lib-2.1.27-5.el8_5.x86_64 version.

      A prompt appears.
    3. Type Y for the prompt.
    4. After successful downgrade, run the following command: 
      yum install <DNCA rpm>

Results

When the files are extracted from the rpm package, follow the post-installation checklist to validate the installation and begin the configuration process.

Fixing the Cyrus-SASL Update Issue

About this task

If you encounter a Cyrus-SASL update issue, complete the following steps to fix the issue:

Procedure

  1. Take a backup of the following files:
    Location Files
    /usr/local/dncauser/etc
    • dcx-conf.xml
    • httpd.conf
    • fwdr-conf.xml
    • privacy.cfg
    • runtime.conf
    • php.ini
    /usr/local/dncauser/etc/capturekeys
    • myCert.pem
    • myCert.ptl
    /var/www
    • myCert.key
    • myCert.crt
    • DiscoverUIPost.php
  2. Uninstall the current DNCA installation.
  3. Delete the dncauser directory from the system.
  4. Update the Cyrus-SASL package using the following command: 
    yum update cyrus-sasl
  5. Verify that the updated version is installed.
    For example, cyrus-sasl-lib-2.1.27-6.el8_5.x86_64
  6. Reinstall DNCA using the following command: 
    rpm -ivh --replacefiles discover-dnca-12.1-12.RHEL8.x86_64.rpm
  7. Complete the DNCA setup and validate functionality.