Installing using the command line

Preliminary notes

Before you begin the installation, please ensure that the system requirements are met.

If the MetaDefender for Secure Storage installer package dependencies are not installed on your system the installer will attempt to automatically download them over the internet.

Acquire the package

In order to acquire the package please visit https://www.opswat.com/solution

To limit the required resources, use the ENABLED_MODULES environment variable in the customer.env file to select which modules to install when deploying MetaDefender for Secure Storage, you can follow these steps:

Locate the customer.env file in your MetaDefender for Secure Storage deployment. This file contains environment variables used for customization.
Open the customer.env file in a text editor.
Add the ENABLED_MODULES environment variable to the file. The variable should be in the format ENABLED_MODULES=<module_list>, where <module_list> is a comma-separated list of the modules you want to enable. For example, if you want to enable modules Amazon S3, Google Cloud, and Azure Blob storage units, your customer.env file should include the following line: ENABLED_MODULES=azureblob,amazonsdk,googlecloud
Save the customer.env file.
Proceed with the deployment of MetaDefender for Secure Storage.

How to edit the configuration file

Advanced installation

We recommend that production deployments use an external database and ensure that web traffic is encrypted. For detailed information on how to configure an external database or HTTPS see advanced installation section:

Debian / Ubuntu package (.deb)

Update your packages

Bash
    
 
sudo apt update
Copy

Install the necessary package dependencies

Bash
    
 
sudo apt install jq curl gnupg-agent software-properties-common
Copy

Move to the folder containing the installer and install it

Bash
    
 
sudo dpkg -i <name of the file>.deb || sudo apt-get install -f
Copy

After the installation is completed, check if everything went fine

Bash
    
 
man mdss
Copy

or using the help menu

Bash
    
 
sudo mdss -h
Copy

Run the following command in order to initialize MetaDefender for Secure Storage

Bash
    
 
sudo mdss -u init
Copy

Start the service

Bash
    
 
sudo mdss -c start
Copy

Optionally, you can check the status using the following command:

Bash
    
 
sudo mdss -c status
Copy

Open a browser and navigate to the web interface: http://<server> to configure your deployment.

Red Hat Enterprise Linux / CentOS package (.rpm)

Please note that Docker Engine is officially supported only on RHEL s390x architecture, but you may be able to install it manually following the CentOS installation steps: https://docs.docker.com/engine/install/centos/

Update your packages

Bash
    
 
sudo yum -y update
Copy

Move to the folder containing the installer and install it

Bash
    
 
sudo yum install -y <name of the file>.rpm
Copy

After the installation is completed, check if everything went fine

Bash
    
 
sudo man mdss
Copy

or using the help menu

Bash
    
 
sudo mdss -h
Copy

Run the following command in order to initialize MetaDefender for Secure Storage

Bash
    
 
sudo mdss -u init
Copy

Note: If you don’t have docker already installed, the installer will do that for you, but you will be prompted to sign out and sign back in. This is necessary because your current user needs to be added to the docker group.

Start the service

Bash
    
 
sudo mdss -c start
Copy

Optionally, you can check the status using the following command:

Bash
    
 
sudo mdss -c status
Copy

Open a browser and navigate to the web interface: http://<server> to configure your deployment.
If you are using firewall (on CentOS8 and RHEL 8) you may need to update it’s policies:

Bash
    
 
# Check what interface docker is using, e.g. 'docker0'ip link show # Check available firewalld zones, e.g. 'public'sudo firewall-cmd --get-active-zones # Check what zone the docker interface it bound to, most likely 'no zone' yetsudo firewall-cmd --get-zone-of-interface=docker0 # So add the 'docker0' interface to the 'public' zone. Changes will be visible only after firewalld reloadsudo nmcli connection modify docker0 connection.zone public # Masquerading allows for docker ingress and egress (this is the juicy bit)sudo firewall-cmd --zone=public --add-masquerade --permanent# Optional open required incomming ports (wasn't required in my tests)# sudo firewall-cmd --zone=public --add-port=443/tcp# Reload firewalldsudo firewall-cmd --reload# Reload dockerdsudo systemctl restart docker
Copy

Windows package (.exe)

From the command line interface, it is possible to install the product by executing

Powershell
    
 
PS> .\metadefender-for-secure-storage.exe /silent
Copy

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

Key	Description
/silent or /passive	Suppress the installation wizard
InstallFolder=”C:\Program Files\OPSWAT\MetaDefender for Secure Storage”	Customize the installation directory
/uninstall	Perform an uninstallation

Last updated on

Was this page helpful?