MacOS Task Worker Installer - Deployment Guide

Component: Diskover Worker (macOS)
Deployment Method: DMG Installer
Platform: macOS
Version: 2.4.0+

Overview

The Mac DMG Installer provides a packaged installer for deploying the Diskover worker (diskoverd) on macOS machines. This allows macOS hosts to act as task workers — running scans and reporting back to the Diskover Web UI.

Use this guide when adding a macOS machine as a Diskover worker node alongside your existing Diskover infrastructure (Elasticsearch, Diskover Web, RabbitMQ).

Dependencies:

• A running Diskover Web instance (the worker connects via API on port 8000)

• A running Elasticsearch instance (the worker fetches its ES connection config from Diskover Admin)

• Internet access to retrieve necessary Pip packages from the PyPI repository

Prerequisites

Installation — Fresh Install

1. Double click the Diskover-v2.x.x.dmg file the Diskover team has provided.

2. Inside this, you will see a Diskover-indexer.pkg file — double click this. This will start the installer.

3. Proceed through the installer modal instructions, agree to the Software License Agreement, and click Install when ready.

Note: This will require Admin privileges to install.

Tip: Pressing Cmd + L will bring up the Installer Log. From here, changing "Show Errors Only" to "Show All Logs" will allow you to see what the installer is working on, and any present errors.

4. Once the installer has finished, you should now have the following installed onto this Mac machine:

   • /opt/diskover/

   • /var/root/.config/diskoverd/config.yaml

   • /Library/LaunchDaemons/com.diskoverdata.diskoverd.plist

5. You will need to escalate to the root user on this machine so you're able to edit a YAML file and start this service.

6. Edit the following file: vi /var/root/.config/diskoverd/config.yaml

   • Line 33: apiUrl: http://localhost:8000/api.php — Change the localhost to the IP of your Diskover Web host, then save & exit this file.

Note: This Mac machine must be able to communicate with Diskover Web over port 8000, or port 443 if SSL is enabled.

7. As the root user, run the following command to start the service:

   launchctl load /Library/LaunchDaemons/com.diskoverdata.diskoverd.plist

8. You can now start tailing the logs to see the Worker service starting up:

   tail -f /opt/diskover/logs/diskoverd.std*

   You should see the following if your worker has started up properly:

   diskoverd - INFO - Worker name: $YourMacHostname
   diskoverd - INFO - Worker pools: []

Configuration

Diskover Admin — Diskoverd Settings

9. Navigate to your Diskover Admin UI:

   • Under Configuration → Diskoverd, you should see your Mac's hostname. Click on this host to edit the settings.

Note: If your Mac hostname is not showing, please review your logs to ensure the service has started up properly.

• Expand the Logger section. Check the Enable Log File box

• For Log Directory, change the location to /opt/diskover/logs/

• Change your Timezone

• For Python Location, change the location to /usr/local/bin/python3.11

• Save these changes

Running Your First Scan

10. Navigate to the Task List page within Diskover Web to create a task for your Mac worker.

Important: While configuring the task object, when you get to Assigned Worker, please be sure to select from the dropdown your Mac host. Otherwise, your task will not run on the correct host.

OVA Elasticsearch Connection

If you are connecting this back to a single stack OVA that likely has the Diskoverd configuration for the Elasticsearch connection set to localhost, you will need to change that to the OVA's IPv4 address so that the Mac Task Worker can fetch that configuration for ES and be able to connect properly.

Build Directories

The DMG will install into the following directories:

Service Management

Note: These commands must be run as the root user or with sudo privileges.

Manual Scan:

python3.11 /opt/diskover/diskover.py -i diskover-$indexName /path/to/be/scanned

Note: ALL indexes must start with diskover-.

Verification

Troubleshooting

Log File Locations

Support

• https://support.diskoverdata.com

• https://support.diskoverdata.com/hc/en-us