Skip to main content

Setting Up the Integration Manager With the Installer

Dimension is Deprecated

Starting with Element Enterprise Installer 2022-09.06, we are now shipping Integrator, our next generation integration manager. When installing 2022-09.06 or later, you should install Integrator. If you still have Dimension installed, please follow this step to remove it:

kubectl delete dimension/instance -n element-onprem

Now you will need to delete the two configuration files for dimension. Assuming your configuration directory is ~/.element-onpremise-config/, the commands would be:

rm -rf ~/.element-onpremise-config/dimension
rm ~/.element-onpremise-config/element/dimension.json

Once you have finished these steps you may continue with the directions to configure integrator.

If you are on a release prior to 2022-09.06 and need documentation on dimension, please see: Documentation Covering Installers From 2022.07.03 to 2022.09.05

On the hosting machine

  • Create integrator directory in ~/.element-onpremise-config/
  • Copy sample file from config-sample/integrator/integrator.yml to the integrator sub-directory within your config folder
  • Edit the file with the following values :
    • integrator_fqdn: The access address to integrator. It should match something like integrator.<fqdn.tld>
    • postgres_user: PostgreSQL username
    • postgres_db: PostgreSQL integrator database
    • postgres_password: PostgreSQL integrator password (If using postgres_create_in_cluster, set this to a random password, such as you would generate with pwgen 32 1)
    • postgres_fqdn: If using postgres_create_in_cluster, set this to postgres-integrator, otherwise, set this to the fqdn of your postgres server.
    • postgres_create_in_cluster: Whether or not to create the postgres as a k8s statefulset
    • postgres_data_path: If using postgres_create_in_cluster, you should specify a path to store the postgres database.
    • jitsi_domain: OPTIONAL. Allows you to specify the jitsi domain to be used by the jitsi widget.
    • verify_tls: OPTIONAL. If doing a POC with self-signed certs, set this to 0. The default is 1.
  • Restart the install script