Standalone mode

Windows

Wizard Installation

The Install Wizard is only for the Windows installer (.msi file).

Since MetaDefender Core 4.19.0, we have switched to using PostgreSQL DBMS which needs a dedicated database server. MetaDefender Core supports two modes to setup PostgreSQL server:

Local PostgreSQL server

This is a bundled PostgreSQL. MetaDefender Core will itself install and setup a new PostgreSQL server locally in the same box with the product.

Remote PostgreSQL server

MetaDefender Core will connect to a pre-installed PostgreSQL running remotely.

"Test Connection" button is required, to make sure the PostgreSQL is connected and authenticated successfully. Make sure to check and perform steps at Open Connection On PostgreSQL Server if you are unable to test the connection with remote PostgreSQL server.

Command Line Installation

Ignition File

MetaDefender Core supports two modes to setup PostgreSQL server:

Local PostgreSQL server

MetaDefender Core will install a new PostgreSQL server locally, next to the product.

A sample iginition file for PostgreSQL server information. Only non-Unicode characters are supported for "user" and "password"):

[dbserver] 

type=local 

host=localhost 

port=5432 

user=postgres 

password=non_Unicode_password

Remote PostgreSQL server

MetaDefender Core will connect to a pre-installed PostgreSQL server running remotely and will setup its database.

A sample ignition file for PostgreSQL server information:

[dbserver] 

type=remote 

host=192.168.86.32 

port=5432 

user=existingserver_admin_user

password=existing_server_pass

How to setup a remote PostgreSQL server

1) Download and install PostgreSQL server version 14.x for Windows x64 at https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

2) Configure PostgreSQL for remote access so that your remote existing PostgreSQL server to accept upcoming connection from MetaDefender Core:

2.1) Modify the pg_hba.conf file: file resides in the PostgreSQL data directory. Common locations include: C:\Program Files\PostgreSQL\14\data(adjust the version number if needed).

host    all             all             0.0.0.0/0            scram-sha-256

2.2) Modify the postgresql.conf file. This file is in the same data directory as pg_hba.conf

listen_addresses = '*'

3) Restart postgres service.

Install MetaDefender Core

On Windows systems, it is possible to install the product by executing the corresponding .msi file.

From command line interface, it is also possible to putting the following parameteres

msiexec /qn /i <msi file name> <option key>=<option value>

where the possible keys and their default values are the following:

For details on using msiexec please consult Windows installer documentation.

Linux

Only support command line installation.

Ignition File

MetaDefender Core supports two modes to setup PostgreSQL server:

Local PostgreSQL server

MetaDefender Core will install a new PostgreSQL server locally, next to the product.

A sample iginition file for PostgreSQL server information. Only non-Unicode characters are supported for "user" and "password"):

[dbserver] 

type=local 

host=localhost 

port=5432 

user=postgres 

password=non_Unicode_password

Remote PostgreSQL server

MetaDefender Core will connect to a pre-installed PostgreSQL server running remotely and will setup its database.

A sample ignition file for PostgreSQL server information:

[dbserver] 

type=remote 

host=192.168.86.32 

port=5432 

user=existingserver_admin_user

password=existing_server_pass

How to setup a remote PostgreSQL server

Debian / Ubuntu

1) Update System Packages

sudo apt update

sudo apt upgrade -y

2) Add PostgreSQL APT Repository

sudo apt install -y wget ca-certificates

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo tee /etc/apt/trusted.gpg.d/pgdg.asc

echo "deb http://apt.postgresql.org/pub/repos/apt/ $(lsb_release -c | awk '{print $2}')-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list

3) Install PostgreSQL

sudo apt update

sudo apt install postgresql-14

4) Once installed, the PostgreSQL service should start automatically. You can verify that it is running:

sudo systemctl status postgresql

To start or restart the PostgreSQL service manually, you can run:

sudo systemctl start postgresql

sudo systemctl enable postgresql

sudo systemctl status postgresql

5) By default, the Postgres user is configured without any password. Run the following command to set a password for the Postgres user:

sudo -u postgres psql

postgres=# alter user postgres with password 'password';

6) Install needed extensions:

sudo -u postgres psql

postgres=# CREATE EXTENSION IF NOT EXISTS pg_trgm;

postgres=# CREATE EXTENSION IF NOT EXISTS btree_gin;

7) Configure PostgreSQL for remote access

sudo nano /etc/postgresql/14/main/postgresql.conf

# Change the following line with your server IP address:

listen_addresses = 'your-server-ip'

sudo nano /etc/postgresql/14/main/pg_hba.conf

# Change the following line

# Accept from anywhere

host all all 0.0.0.0/0 scram-sha-256

# Restart PostgreSQL service

sudo systemctl restart postgresql

Red Hat Enterprise Linux 8, 9 / Rocky Linux 9

1) Install the PostgreSQL repository RPM:

sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm

sudo dnf -qy module disable postgresql

sudo dnf install -y postgresql14-14.15 postgresql14-server-14.15

2) Run these CMDs to initialize the PostgreSQL:

sudo /usr/pgsql-14/bin/postgresql-14-setup initdb

sudo systemctl start postgresql-14

sudo systemctl enable postgresql-14

sudo systemctl status postgresql-14

3) By default, the Postgres user is configured without any password. Run the following command to set a password for the Postgres user:

sudo -u postgres psql

postgres=# alter user postgres with password 'password';

4) Install needed extensions:

sudo dnf install -y postgresql14-contrib

sudo -u postgres psql

postgres=# CREATE EXTENSION IF NOT EXISTS pg_trgm;

postgres=# CREATE EXTENSION IF NOT EXISTS btree_gin;

5) Configure PostgreSQL for remote access

sudo nano /var/lib/pgsql/14/data/postgresql.conf

# Change the following line with your server IP address:

listen_addresses = 'your-server-ip'

sudo nano /var/lib/pgsql/14/data/pg_hba.conf

# Change the following line

# Accept from anywhere

host all all 0.0.0.0/0 scram-sha-256

# Restart PostgreSQL service

sudo systemctl restart postgresql-14

A sample ignition file for PostgreSQL server information:

[dbserver] 

type=remote 

host=192.168.86.32 

port=5432 

user=existingserver_admin_user

password=existing_server_pass

After installing MetaDefender Core successfully, you may want to remove all credentials info created for [dbserver] section in ignition file for security reason.

Install MetaDefender Core

Debian / Ubuntu package (.deb)

sudo dpkg -i <filename> || sudo apt-get install -f

Red Hat Enterprise Linux 8, 9 package / Rocky Linux 9 package (.rpm)

sudo dnf install -y <filename>