create_config.py

The create_config.py script updates the configuration settings on either a MATRIXX Engine server or on a TRA-RT-(SI/DR) server using the configuration question answers specified in their create_config.info files and any modifications in sed.extra files.

By default, create_config.py script reads the create_config.info file(s) from these default directories:

  • When run as user mtx, create_config.py processes the configuration question answers in the create_config.info file in /opt/mtx/custom (${MTX_CUSTOM_DIR}) and any modifications in sed.extra files and writes output to the /opt/mtx/conf/mtx_config.xml file. After running this script, run the configure_engine.py script to propagate the configuration changes to the other servers in the engine.
  • When run as the user tra, create_config.py processes the configuration question answers from the create_config.info file in /opt/tra/custom and writes the output to the /opt/tra/conf/mtx_config.xml file.

For more information about the MATRIXX environment variables, see the discussion about container directories and environment variables in MATRIXX Installation and Upgrade.

The create_config.info files contain a list of configuration questions that you answer by editing those files. If you do not specify an answer in the create_config.info file, this script stops and prompts you for the answer before it continues processing. Most questions display help information if you enter the question mark (?) at the prompt. To avoid the prompts, specify the --use_default_values option to accept all default answers to the questions.

You can separate the questions in the default create_config.info file into multiple create_config.info files in different directories in any way that is logical to your implementation. When you run this script, specify those file locations using multiple -i input_directory options. The create_config.info files are processed in the order listed, and they are processed as if they were concatenated.

Warning: If you are specifying a URL that has an ampersand in response to the create_config.info file question EventLoader:What is the address or connection string for the Event Repository?, you must specify it as &. For example, specify mongodb://127.0.0.1:27017/MtxEventDatabase?retryWrites=true\&w=majority to mean mongodb://127.0.0.1:27017/MtxEventDatabase?retryWrites=true\&;w=majority. For information about setting the value of this property, see the discussion about setting the MongoDB connection string for Event Loader in MATRIXX Administration.

Syntax

The create_config.py script has the following options in addition to the general server options. 

create_config.py [-i input_directory, -i input_directory, ... ] [--use_default_values]

Options

-i input_directory
Specifies a directory to read a create_config.info file from. Multiple -i input_directory options are supported, each with a create_config.info file to process. All files in each directory are processed in the order listed, and they are processed as if they were concatenated. This allows you to separate the default create_config.info list of questions into separate files to be managed.
Note: Only existing directories and files are examined. To confirm that the correct directory was specified with this option, examine the list of directories and files displayed in the terminal while the script runs.
--use_default_values
Uses the default values for any create_config.info questions that were not answered.

Configure the Local Server with the ${MTX_CUSTOM_DIR}/create_config.info File

create_config.py

Configure the Local Server with the /var/mtx/test/create_config.info File

create_config.py -i /var/mtx/test