When using an INI configuration, installation and updates will still be
done using the tpm command. Instead of providing
configuration information on the command line, the tpm
command requires, by dewfault, /etc/tungsten/tungsten.ini.
If you wish to use an alternative path, filename, or have tpm use multiple files,
then this can be achieved by supplying a comma-separated list using the
--ini option to tpm. For example
--ini /my/directory/myconfig.ini
Extreme care must be taken if using multiple ini files to ensure properties are not duplicated between files as there is no guarantee what order the properties will be applied and the end result may not always be what you expect.
The INI file(s) must be readable by the tungsten system user.
Here is an example of a /etc/tungsten/tungsten.ini file that would
setup a simple dataservice.
shell> vi /etc/tungsten/tungsten.ini[defaults] user=tungsten install-directory=/opt/continuent profile-script=~/.bash_profile replication-user=tungsten replication-password=password replication-port=13306 application-user=app_user application-password=secret application-port=3306 rest-api-admin-user=apiuser rest-api-admin-password=secret install=true connector-rest-api-address=0.0.0.0 manager-rest-api-address=0.0.0.0 replicator-rest-api-address=0.0.0.0[alpha] topology=clustered master=host1 members=host1,host2,host3 connectors=host4
The section name inside of the square brackets is used as the service name. The
[defaults] section should always be included
and is especially useful if defining multiple services in a single file where you
want certain options to apply globally.
Service names should be Alphanumeric characters only, and may include a hyphen (-) or an underscore (_). No other special characters should be used. Whilst there is no enforced max length of string you can define, for simplicity and easy administration, service names shoud be kept short and meaningful, ideally 15 characters or less.
Include any host-specific options in the appropriate section. This configuration will only apply to the local server, so there is no need to put host-specific settings in a different section.