We've begun the migration to a new configuration framework. The 'old' method (the `sip-communicator.properties` file and program arguments) will be supported throughout the transition and the bridge will be fully backwards-compatible with the old config. No changes are necessary until we pull the plug on the old config completely, and we'll give ample warning before that time. It's also worth noting that any new properties will only be supported in the new config files.

Moving forward, we'll be using lightbend's [config library]([https://github.com/lightbend/config](https://github.com/lightbend/config)). Their GitHub page gives lots of details, but below are the changes most relevant to configuring the JVB.

During the transition, we'll continue to read from the original locations (`sip-communicator.properties` and program arguments) for all configuration properties, falling back to the new `reference.conf` file for defaults. The `reference.conf` file holds defaults for all configuration properties, and shouldn't be modified in a deployment--though it may be interesting for developers who want to see the defaults.

To override values, users can either put a file named `application.conf` in the classpath or pass a path to a file as a system property via `-Dconfig.file=/path/to/config.conf`. Values in the file given will override ones in `reference.conf`. The lightbend docs do a good job of describing [how configuration is loaded]([https://github.com/lightbend/config#standard-behavior](https://github.com/lightbend/config#standard-behavior)), but here's an example of overriding a configuration value for JVB:

Say we want to override some of the default values in `reference.conf`, namely: the XMPP API server values, the health check interval, and whether or not onstage video suspension is enabled. We'll create an `application.conf` files with the values we want to change:

You can override just the values you want to change, all others will fallback to the defaults set in `reference.conf`

Below are the mappings from old property values to new ones. Note: for new property names, the 'flat paths' are given, i.e. a value of `videobridge.health.interval` corresponds to the setting:

This list will be updated as properties are migrated:

| Old property name | New property name | Notes |

| -------- | ------- | ------- |

| org.jitsi.videobridge.health.INTERVAL | videobridge.health.interval | The new config models this as a duration, rather than an amount of milliseconds |

<version>2.1-SNAPSHOT</version>

<dependency>

<groupId>com.typesafe</groupId>

<artifactId>config</artifactId>

<version>1.3.4</version>

</dependency>

<version>1.0-58-g13fe894</version>

<version>1.0-20-g37eacac</version>

<dependency>

<groupId>org.reflections</groupId>

<artifactId>reflections</artifactId>

<version>0.9.11</version>

</dependency>

import org.jitsi.utils.config.validation.*;

import org.jitsi.videobridge.util.config.*;

import java.util.*;

import java.util.stream.*;

validateConfig();

protected static void validateConfig()

{

ConfigValidator configValidator = new ConfigValidator("org.jitsi");

//TODO: pass command-line args as well

Set<String> configPropNames = JvbConfig.getConfig().withOnlyPath("videobridge").entrySet().stream()

.map(Map.Entry::getKey)

.collect(Collectors.toSet());

configValidator.validate(configPropNames);

}

super(videobridge, HealthIntervalProperty.getValue(), true);

package org.jitsi.videobridge.health;

import org.jitsi.utils.config.*;

import org.jitsi.videobridge.util.config.*;

import java.util.concurrent.*;

public class HealthIntervalProperty extends AbstractConfigProperty<Integer>

{

protected static final String legacyPropName = "org.jitsi.videobridge.health.INTERVAL";

protected static final String propName = "videobridge.health.interval";

private static HealthIntervalProperty singleton = new HealthIntervalProperty();

protected HealthIntervalProperty()

{

super(new JvbPropertyConfig<Integer>()

.fromLegacyConfig(config -> config.getInt(legacyPropName))

.fromNewConfig(config -> (int)config.getDuration(propName, TimeUnit.MILLISECONDS))

.readOnce()

.throwIfNotFound()

);

}

public static Integer getValue()

{

return singleton.get();

}

}

package org.jitsi.videobridge.util.config;

import org.jitsi.cmd.*;

import org.jitsi.utils.config.*;

import java.util.function.*;

public class CommandLineConfigValueSupplier<T> implements Supplier<T>

{

protected final String argName;

protected final Function<CmdLine, T> getter;

/**

@SuppressWarnings("unchecked")

public CommandLineConfigValueSupplier(String argName)

{

this(argName, cmdLine -> (T)cmdLine.getOptionValue(argName, null));

}

public CommandLineConfigValueSupplier(String argName, Function<CmdLine, T> getter)

{

this.argName = argName;

this.getter = getter;

}

@Override

public T get()

{

String[] commandLineArgs = JvbConfig.getCommandLineArgs();

CmdLine cmdLine = new CmdLine();

try

{

cmdLine.parse(commandLineArgs);

T value = getter.apply(cmdLine);

if (value == null)

{

throw new ConfigPropertyNotFoundException(argName);

}

return value;

}

catch (ParseException ignored) { }

throw new ConfigPropertyNotFoundException(argName);

}

}

package org.jitsi.videobridge.util.config;

import com.typesafe.config.*;

import java.util.function.*;

public class ConfigValueSupplier<T> implements Supplier<T>

{

protected final Supplier<T> typesafeConfigSupplier;

/**

public ConfigValueSupplier(Function<Config, T> getter)

{

this.typesafeConfigSupplier =

new TypesafeConfigValueSupplier<>(() -> getter.apply(JvbConfig.getConfig()));

}

/**

@Override

public T get()

{

return typesafeConfigSupplier.get();

}

}