Installing DNIF


This article gives you a quick walk through of the requirements and steps (text and video) involved to help you set up DNIF in no time.

This article talks about:

  • Installation options
  • Installation prerequisites
  • Installation steps

Installation options

Before you get started on DNIF, you need to complete a simple installation process that will get the product up and running for you. To install DNIF you need to choose from one of the following packages:

NOTE- Click a package name to read its details.

To keep the process simple, we are going to focus on installing the Free Tier DNIF package on single-user systems.

Installation prerequisites

To install DNIF, you need to meet the following prerequisites:

Access prerequisites

You will need access to the following websites:

  • https://www.docker.com/community-edition
  • https://hub.docker.com/

Hardware prerequisites

  • Minimum configuration: 4 Cores, 16 GB RAM, and 200 GB disk space
  • Maximum configuration: 12 Cores, 64GB RAM, and 1TB disk space

NOTE- DNIF is built on a Big Data framework which can be scaled in phases. You can start with the minimum configuration and upgrade your hardware as your usage increases. Big Data Frameworks can be scaled up in phases.

Operating system prerequisites

  • The latest 64-bit version of an OS like Ubuntu or CentOS.

Network prerequisites

  • Outbound access to UNET
  • Outbound access to public DNS
  • SMTP server
  • NTP server

Docker prerequisites

  • Docker version that is compatible with the OS installed on your machine

NOTE- For detailed guidelines on installation prerequisites, click here.

Installation steps

The installation steps for the DNIF platform includes:

  1. Sign up with DNIF

  2. Install Docker (Available for Mac, Linux and Windows systems.)

  3. Install DNIF

  4. Sign in and connect to the datastore

Step 1: Signing up with DNIF

1. From the dnif.it home page, click FREE FOREVER.

Download DNIF for FREE with FREE FOREVER plan

The signup form is displayed.

Fill up the Sign Up form

2. In the signup form, complete the following details:

  • In the Account Details section, enter the relevant details in the corresponding fields
  • In the Setup Details section, complete the following details
Element/Field Mandatory Description
Scope Name Yes The scope is the primary identifier for the data store. By default, the domain name (as entered in the Email address field) is set as the scope. You can change the scope name to make it more relevant to your application/use.
Retention Period in Days Yes Specify the duration after which the data indexes are archived.

3. Click SIGNUP. The account activation link is sent to the email ID mentioned in the form above.

4. From the DNIF - Account Activation email in your inbox, click Activate Account.

Check your email for account activation email

You will be redirected to a page that lets you configure your deployment.

Click on ACTIVATE ACCOUNT button

5. On this page, you can:

  • Select a new plan.
  • Configure the monthly indexing limits.

NOTE- If you decide to upgrade to the community plan after indexing data up to the 100 GB limit, you will be required to enter your credit card details and do a confirmatory transaction.

  • Sign up for the newsletter.
  • Allow DNIF to contact you via email.

6. After you have entered all the details, click ACCEPT.

An email, with the subject DNIF: Getting Started, is sent to your email ID. This email includes the deployment details and installation keys.

Check for an email with subject DNIF Getting Started

NOTE- You can watch a video tutorial on the steps for signing up with DNIF here.

Step 2: Installing Docker

For MAC users

  1. From the DNIF: Getting Started email, click INSTALL DOCKER. You will be redirected to the installation page on Docker’s website.
  2. Click Product.
  3. From the Product page, click GET DOCKER COMMUNITY EDITION.
  4. From the DOCKER COMMUNITY EDITION page, click GET DOCKER FROM STORE.
  5. Scroll down to the Download Docker Community Edition section, and under DOCKER CE FOR MAC, click Download from Docker Store. Download Docker for Mac

  6. Save Docker.dmg in the Applications folder.
  7. From the Applications folder, double click Docker. The Docker installation is verified and the mac bash window is displayed.
  8. Follow the docker documentation here and install docker.
  9. After successful installation, in the terminal window, execute docker –v command to determine the Docker version installed.
  10. In the terminal window, execute docker run hello-world command.

Hello from Docker! message is displayed, acknowledging that your installation is working correctly.

For Linux users

To install Docker CE, you need the 64-bit version of one of these Ubuntu versions:

  • Artful 17.10 (Docker CE 17.11 Edge and higher only)
  • Xenial 16.04 (LTS)
  • Trusty 14.04 (LTS)

Before you install Docker CE for the first time on a new host machine, you need to set up the Docker repository.

To set up the docker repository:

  1. Login to Ubuntu.
  2. Open up the Terminal.
  3. Follow the docker documentation here and install docker.

After successfully installing Docker, proceed with the installation for DNIF (Step 3).

For Windows users

  1. From the DNIF: Getting Started email, click INSTALL DOCKER. You will be redirected to docker.com’s install page.
  2. Click Docker for Windows (Microsoft Windows 10). You will be redirected to the Docker installation page.
  3. Click Download from Docker Store. You will be redirected to the docker store.
  4. From the Docker Community Edition for Windows page, click Get Docker. The Docker for Windows Installer.exe file will be downloaded.
  5. Execute the Docker for Windows Installer.exe file.
  6. In the Installing Docker for Windows window, select the check boxes corresponding to the configuration options you want.
  7. In the dialog box that acknowledges successful installation, click Close.
  8. Open the Docker for Windows application.
  9. Accept the license, authorize the installer, and proceed with the installation using the Docker install wizard.

    NOTE- During the installation process, you will be required to authorise Docker.app using the system password. Also, a privileged access is needed to install networking components, Docker apps or manage the Hyper-V VMs.

  10. To launch Docker, in the setup complete dialog box, click Finish.

Step 3: Installing DNIF

1. Create a separate folder at a location of your choice and name it A10.

2. Download the A10 configuration file from here .

3.Save the docker-compose.yml file in the a10 folder which you created.

4. Edit the configuration file - docker-compose.yml as shown:

Field Mandatory Change to
/path/to/volume:/dnif Yes /home:/dnif
DKEY=KEY Yes ‘DKEY=’Enter the deployment A10 key which you received on your DNIF Getting Started email’
IP Address Yes CRIP-Enter the IP address of Correlator

5. Save and close the YML file. This will save the changes required to configure DNIF.

6. Open terminal window.

7. Enter the following command in the terminal

sudo docker-compose up

Only For Linux- Enter the following command to install the Python repository pip from the Ubuntu repository. apt-get install -y python-pip Install the latest docker compose file from Python repository using the following command. pip install docker-compose

NOTE- It is recommended to download the latest version of docker compose from the Python repository.

Operating system Additional Steps Commands to execute
Linux Enter the following command to install a python repository pip from the ubuntu repository. apt-get install -y python-pip
Linux Install the latest docker compose file from python repository using the following command. pip install docker-compose

NOTE- It is recommended to download the latest version of docker compose from the python repository.

8. Enter your system password when asked.

After some time, you’ll be greeted with an ASCII art for DNIF. This shows that you’ve successfully installed DNIF.

9. Open the email with subject DNIF-Getting Started and download the license and signature.bin files.

10. Move these files to the LICENSE folder.

NOTE- LICENSE folder can be found within the your_deployment_key folder of your installation directory, as defined in the docker-compose.yml file. The your_deployment_key folder is basically e deployment key you entered while editing the configuration file.

NOTE- You can watch a video tutorial on the steps for signing up with DNIF here

Congratulations! your DNIF installation is complete.

Step 4: Signing in and connecting to the datastore

Now before we move forward, let us know what exactly a datastore is. A datastore is a repository for storing and managing large collections of data continuously.

To sign in and connect to the datastore:

1. From your registered email ID, open the DNIF-Getting Started email.

2. Download the license and signature.bin files attached with the email.

3. From the Downloads folder of your computer, copy the license and signature.bin files.

4. In the DNIF/LICENSE folder, paste the copied files.

5. Open Google Chrome and click Apps.

6. Click Web Store.

7. Search for the Authenticator plugin.

8. Click +ADD TO CHROME.

9. Click Add Extension.

10. Open the DNIF - Sign in to the Web Console email.

11. Copy the Auth Secret OTP.

12. Next to the address bar, click the Authenticator plugin icon.

13. Click Add account icon.

14. Select Manual Entry and enter the following details:

Field Mandatory Change to
Account Name Yes Enter your account name.
Auth Secret Key Yes Enter the copied Auth Secret key.
Type of passcode Yes Select the required type of authentication passcode.

15. Click Ok.

16. Go to go.dnif.it using your browser.

17. Enter your registered email id and click Go.

18. Enter your registered password and the OTP generated by Authenticator.

19. Click Login.

You will be logged in to your DNIF account and by default, the Search query page is
displayed.

20. From the Management menu, click Connections.

21. In the Source Address field, enter your Data Source IP address.

22. Click Enter the IP Address of the Data Store

A hello message is displayed in a new window, acknowledging that you have successfully linked your Data Source.

23. Start typing your queries in the Search box of Web Console after feeding some data in your data source.

NOTE- You can watch a video tutorial on the steps for signing up with DNIF here