MetaDefender Distributed Cluster File Storage

Ignition file

The ignition file is required only for a fresh installation.

To install MetaDefender Distributed Cluster File Storage server, ignition file in YML format is required at the following location:

  • Windows: C:\opswat\mddc_file_storage.yml
  • Linux: /etc/opswat/mddc_file_storage.yml

The ignition file includes keys:

Key pathValue typeAccepted valuesRequiredDescription
secure.connection_keystringA string from 4 to 64 character long containing digits from 0 to 9 and characters from a/A to z/Zrequired

An arbitrary string that enables clients to connect to the server.

Use this value as input when adding a MDDC File Storage in the UI of the MDDC Control Center.

secure.private_keystringrequiredContent of private key in X509 format.
secure.certificatestringrequiredContent of certificate in X509 format.
storage.pathstringrequiredPath to an existing directory where the MDDC File Storage server stores its files. The server requires full permissions to access the path in Linux.
rest.hoststringoptional

IP address (V4/V6) or host where the server resides on. Default value is '*'

Notes: value '*'allows the service to accept connections from all network interfaces.

To bind the service to a specific interface, specify its IP address or domain name. For example, to listen on all IPv4 interfaces, set the host to 0.0.0.0

rest.portnumberoptionalThe port where the server resides on. Default value is 8890
log.streams[@].log_typestring
  • file
  • syslog
optionalType of log device.
log.streams[@].log_levelstring
  • dump
  • debug
  • info
  • warning
  • error
optionalLevel of log message.
log.streams[@].log_pathstring

If log.streams[@].log_type is "file" then log.streams[@].log_path is the path to a file on file system where logs are written.

If log.streams[@].log_type is "syslog" then

  • log.streams[@].log_path can be [tcp/udp]://host:port where host:port is the host and port to a remote syslog server that supports TCP or UDP protocol.
  • log.streams[@].log_path can be "local" to write log to local syslog server (Linux only).
optionalLocation where logs are written.

Configuration file

After successfully installing, MetaDefender Distributed Cluster File Storage generates a configuration file with changeable settings at the following location:

  • Windows: C:\Program Files\OPSWAT\MetaDefender Distributed Cluster File Storage\mddc_file_storage.yml
  • Linux: /etc/mddc-file-storage/mddc_file_storage.yml

The service must be restarted to take the new configurations into effect.

Sample

OpenSSL or a similar tool (e.g., ssh-keygen) can create a pair of public and private keys in X.509 format.

The value of storage.path should be updated with the path of an existing folder according to your selected operating system.
YAML
Copy
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
Next to read:
MetaDefender Distributed Cluster Identity Service
On This Page
MetaDefender Distributed Cluster File StorageIgnition fileConfiguration fileSample