MetaDefender Distributed Cluster Control Center

Ignition file

The ignition file is required only for a fresh installation.

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

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

The ignition file includes keys

Key pathValue typeAccepted valuesRequiredDescription
identity.hoststringrequiredIP address of the server where MDDC Identity Service server locates.
identity.portstringrequiredPort of MDDC Identity Service server is listening for connections from clients.
identity.connection_keystring
  • A string from 4 to 64 character long containing digits from 0 to 9 and characters from a/A to z/Z
requiredThe access key required to connect to the MDDC Identity Service server, ensuring it matches the value used by the server.
database.hoststringrequiredIP address / domain name of the server where PostgreSQL server locates.
database.portnumberrequiredPort of PostgreSQL server is listening for connections from clients.
database.userstringrequired

PostgreSQL server's user.

SUPERUSER privilege is required to setup the server's database and extensions for the first time.

database.passwordstringrequiredPostgreSQL server's user credentials.
secure.encryption_keystringA 32-character plain text composed of characters 'a'-'z' and digits '0'-'9'.requiredThe encryption key is used to encrypt the sensitive data in the database.
rest.portnumberoptionalThe port where the server resides on. Default value is 8892
rest.log_pathstringoptionalLocation where logs are written.
rest.log_levelstring
  • dump
  • debug
  • info
  • warning
  • error
optionalLevel of log message.
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.

Avoid using the loopback IP address (such as localhost or 127.0.0.1 ) for key identity.host .

It may prevent the MetaDefender Distributed Cluster API Gateway from successfully establishing a connection to MetaDefender Distributed Cluster Identity Service.

Configuration file

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

  • Windows: C:\Program Files\OPSWAT\MetaDefender Distributed Cluster Control Center\mddc_control_center.yml
  • Linux: /etc/mddc-control-center/mddc_control_center.yml

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

Sample

database.host, database.port, database.user, and database.password should be updated with the appropriate values of your Postgres host/IP, port, username, and password.

identity.host should be updated with the appropriate host or IP of your MetaDefender Distributed Cluster Identity Service.

YAML
Copy
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard