Diskover Admin Wizard Setup

The Diskover Admin service allows a system administrator to configure Diskover settings for Elasticsearch, Diskover Web, and Diskover Worker services. Prior to Diskover v2.4.0 these services were configured server side inside PHP files. This change ensures that system administrators don’t need to be a Linux sysadmin to configure and maintain their Diskover system. Lets get started!

Getting in contact with the Diskover Support team: https://docs.diskoverdata.com/tech_support_and_troubleshooting/

Configuring settings for the first time:

Diskover Admin endpoint: http://diskover-web-ip-hostname:8000/diskover_admin/config

If you’ve not configured these settings for the first time, you will automatically be routed to the first page of the config wizard. You should see Elasticsearch Connection Configuration for Diskover-Web if you’re in the correct place. If not, please click Diskover Admin → Meta → Wizard → Setup

1. Elasticsearch connection settings for Diskover Web:

   1. You will need to input the IP / AWS / Elastic Cloud endpoint where Elasticsearch is running. If you have a clustered ES setup, click Add item to enter your other IPs / endpoints

   2. Elasticsearch commonly runs on port 9200. If you are running AWS OpenSearch use port 443.

   3. Enable HTTPS if you have your Elasticsearch secure. Otherwise, keep it unchecked for HTTP

      • If HTTPS, enter your Elastic user & pass

      • Enter the path to the Elasticsearch http_ca.crt thats on your Web host inside the CA Certificates Path

   4. Its best to click Test to see if Diskover can connect to your Elasticsearch system. The page will refresh and output the health of your cluster, number of shards, nodes, etc.. If this returns successfully, you’re clear to hit Save & Continue

2. The next step will ask you if you’d like to copy the settings from Diskover Web to the settings for your Diskover Task Workers. You can select Yes to make the setup easier. Be sure to review them!

3. License request:

   1. If you’re upgrading from Diskover v2.2.x or lower, you can copy the contents of the flat file thats on the Diskover Web & Diskover Worker hosts into their respective boxes in the UI

      1. Web: /var/www/diskover-web/src/diskover/diskover-web.lic ; Worker: /opt/diskover/diskover.lic

   2. If this is a brand new install, you can choose the Request License button. Please click it and fill out the required fields:

      1. Email address

      2. Diskover Edition

      3. Elasticsearch Node count

      4. Comments – Your name/company will suffice

      5. Hit Send Request. This will get sent to the Diskover team. We will reach back out with your licenses to enter in the Diskover Admin page

4. Time Zone for Indices:

   1. This is the time / timezone that will be shown for your users in the Indices page. If you choose to enable this functionality for files & directories, this will be the time listed inside the Search page in Diskover

5. Message Queue Configuration:

   1. Diskover supports RabbitMQ and AmazonMQ. Please change the username & password to the actual users that were set up during the installation of the RabbitMQ service, or in AmazonMQ

   2. Host will be either the IP of RabbitMQ, or the AmazonMQ endpoint

   3. The Test button will see if Diskover Web can communicate with this service. If you see a Connection Successful, you can proceed

6. API Configuration:

   1. Please change the API Host & Port to the IP / hostname of your Diskover Web. If HTTP, the port will be 8000. If HTTPs, the port will be 443

You’re finished when you reach Basic setup is complete! Now that you have the Diskover Admin service set up, you need to click DiskoverAdmin at the top of the page to take you back home so you can navigate to the “Task Panel” and create tasks for your index.

If you’re running into issues, please open a Zendesk ticket with the Diskover Support team and we can help assist with any issues.