Changing Blocklist Configuration

Follow these instructions to change the blocklist configuration in your DPX instance.

Prerequisites

Before you begin, ensure you have the following:

• Access to your DPX instance via SSH.
• Root user privileges.

Changing Blocklist Configuration

1. Log in to Your DPX Instance via SSH, using:

ssh your_username@your_dpx_instance_ip

2. Switch to Root User
3. Navigate to the Services Directory, using:

cd /catalogic/services

4. Edit the dpx.yml Docker Compose file to modify your blocklist configuration.

In the dpx.yml file, locate the section catalog → environment. Depending on your requirements, add or modify the following environment variables:

• Blocklist Network Fetch Enabled: Determines if the blocklist will be downloaded from the internet. Default: false.
• Blocklist Network URL: The URL for the blocklist download. Default: https://catalogic-mysupport.s3.us-west-002.backblazeb2.com/security-updates/block-list-latest.json.
• Blocklist Network Fetch Interval (milliseconds): The frequency of blocklist updates. Default: 43200000 (12 hours).

Example configuration:

catalog:
  environment:
    BLOCKLIST_NETWORK_FETCH_ENABLED=true
    BLOCKLIST_NETWORK_URL=https://catalogic-mysupport.s3.us-west-002.backblazeb2.com/security-updates/block-list-latest.json
    BLOCKLIST_NETWORK_FETCH_INTERVAL_MILLISECONDS=43200000

Tip.

If you encounter any issues while editing the dpx.yml file, ensure that the syntax is correct and that all environment variables are properly indented.

5. Save the changes to the dpx.yml file and exit the text editor.
6. Restart the DPX services to apply the new configuration.

systemctl restart dpx-swarm

Attention!

Restarting the DPX services will temporarily disrupt any ongoing operations. Plan this change during a maintenance window to avoid impacting users.

7. Once the services are running again (this may take a few minutes), check the Events section in the DPX UI to verify that the blocklist has been downloaded.